Module Name: othersrc Committed By: wiz Date: Wed Apr 2 08:55:38 UTC 2014
Modified Files: othersrc/external/bsd/starsign/dist: starsign.1 Log Message: Fix xref, consistent casing, use EXIT STATUS instead of RETURN VALUES, fix typo. To generate a diff of this commit: cvs rdiff -u -r1.1.1.1 -r1.2 othersrc/external/bsd/starsign/dist/starsign.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: othersrc/external/bsd/starsign/dist/starsign.1 diff -u othersrc/external/bsd/starsign/dist/starsign.1:1.1.1.1 othersrc/external/bsd/starsign/dist/starsign.1:1.2 --- othersrc/external/bsd/starsign/dist/starsign.1:1.1.1.1 Wed Apr 2 04:03:33 2014 +++ othersrc/external/bsd/starsign/dist/starsign.1 Wed Apr 2 08:55:38 2014 @@ -1,4 +1,4 @@ -.\" $NetBSD: starsign.1,v 1.1.1.1 2014/04/02 04:03:33 agc Exp $ +.\" $NetBSD: starsign.1,v 1.2 2014/04/02 08:55:38 wiz Exp $ .\" .\" Copyright (c) 2014 Alistair Crooks <a...@netbsd.org> .\" All rights reserved. @@ -61,7 +61,7 @@ The .Nm command signs data, typically a -.Xr tar 4 +.Xr tar 1 archive, although it can be any data whatsoever, which can be verified using the .Nm starverify @@ -115,7 +115,7 @@ The public key is not normally included .Dq star data to allow for out of band communication of public keys, which is safer in general. -For example, it would be sub\-optimal to sign the ephemeral key on a piece +For example, it would be sub\-optimal to sign the ephemeral key on a piece of data if the public key was not available on the remote host. .Pp For verification, the @@ -137,7 +137,7 @@ The type of the key is encoded in the si archive, and is used during verification. .Pp The following options are available in -.Nm +.Nm : .Bl -tag -width keyring1234567 .It Fl d Ar duration This is the period (in seconds) for which the signature is valid. @@ -152,15 +152,15 @@ and in days. The default duration, if none is otherwise specified, is 5 years. .It Fl f Ar seconds -The time (in seconds since the spart of the epoch) +The time (in seconds since the start of the epoch) from which the signature is valid. .It Fl h -print a help message and exit. +Print a help message and exit. .It Fl k Ar keyring When signing, use the argument as the source of truth for the signing key (to sign the public part of the ephemeral key) to establish trust. .It Fl o Ar outname -Use the argument as the output file name +Use the argument as the output file name. .It Fl t Ar keytype Sign the data using the requested key type. At the present time, two key types are available: @@ -178,29 +178,29 @@ be verbose in operation. .El .Pp The following options are available in -.Nm starverify +.Nm starverify : .Bl -tag -width keyring1234567 .It Fl h -print a help message and exit. +Print a help message and exit. .It Fl k Ar keyring Use the argument as the keyring for the public key which will be used to verify the signature on the ephemeral key. .It Fl v -be verbose in operation. +Be verbose in operation. .El .Pp The following options are available in -.Nm starcat +.Nm starcat : .Bl -tag -width keyring1234567 .It Fl h -print a help message and exit. +Print a help message and exit. .It Fl k Ar keyring When signing, use the argument as the source of truth for the signing key (to sign the public part of the ephemeral key) to establish trust. .It Fl o Ar outname Use the argument as the output file name .It Fl s -sign the data, rather than verifying it (the default) +Sign the data, rather than verifying it (the default). .It Fl t Ar keytype Sign the data using the requested key type. At the present time, two key types are available: @@ -214,19 +214,19 @@ keys. Use the argument as the PGP/GPG identity of the key which signs the public part of the ephemeral key. .It Fl v -be verbose in operation. +Be verbose in operation. .El .Pp The following options are available in -.Nm starinfo +.Nm starinfo : .Bl -tag -width keyring1234567 .It Fl h -print a help message and exit. +Print a help message and exit. .It Fl k Ar keyring Use the argument as the keyring for the public key which will be used to verify the signature on the ephemeral key. .It Fl v -be verbose in operation. +Be verbose in operation. .El .Pp In normal operation, a @@ -250,11 +250,10 @@ a verification of the two signatures use integrity and provide trust for the data, and the information for the host on which the signing was performed. -.Sh RETURN VALUES +.Sh EXIT STATUS The .Nm -utilities will return 0 for success, -and non-zero for failure. +utilities exit 0 on success, and >0 if an error occurs. .Sh EXAMPLES .Bd -literal % starcat -s -t pgp < Makefile | starcat > m2