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
