[src/trunk]: src/crypto/external/bsd/netpgp/dist/src/netpgpkeys sync manual p...

[agc <agc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/2ef830c4fad9
branches:  trunk
changeset: 753921:2ef830c4fad9
user:      agc <agc%NetBSD.org@localhost>
date:      Wed Apr 14 04:01:55 2010 +0000

description:
sync manual page with reality, catch up with key generation

diffstat:

 crypto/external/bsd/netpgp/dist/src/netpgpkeys/netpgpkeys.1 |  40 +++++++++++-
 1 files changed, 36 insertions(+), 4 deletions(-)

diffs (68 lines):

diff -r 105344b7ddf6 -r 2ef830c4fad9 crypto/external/bsd/netpgp/dist/src/netpgpkeys/netpgpkeys.1
--- a/crypto/external/bsd/netpgp/dist/src/netpgpkeys/netpgpkeys.1       Wed Apr 14 00:26:25 2010 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/netpgpkeys/netpgpkeys.1       Wed Apr 14 04:01:55 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: netpgpkeys.1,v 1.6 2010/03/13 23:30:41 agc Exp $
+.\" $NetBSD: netpgpkeys.1,v 1.7 2010/04/14 04:01:55 agc Exp $
 .\"
 .\" Copyright (c) 2009, 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 13, 2010
+.Dd April 13, 2010
 .Dt NETPGPKEYS 1
 .Os
 .Sh NAME
@@ -160,8 +160,16 @@
 If no keyring is provided, the user's public keyring is used.
 .It Fl Fl generate-key
 This command is used to generate a new public and private key pair.
-The user id is taken from the command line, and the user will be
-prompted to provide a suitable pass phrase.
+If provided on the command line, the argument will be given to the
+key generation routine to be used as the identity of the key.
+This is usually the email address and full name, but can be
+any identification token.
+The newly-generated keys are placed in a sub-directory of the
+.Dq home directory
+which is created at key generation time.
+At present, only RSA keys can be generated.
+The hash algorithm and keysize can be specified on the command
+line.
 .It Fl Fl import-key
 Import a public key as retrieved from one of the public key servers.
 This is in the form of a file which has previously been
@@ -293,6 +301,30 @@
 uid              netbsd-vm1.crowthorne.alistaircrooks.co.uk (/etc/ssh/ssh_host_rsa_key.pub) \*[Lt]root%netbsd-vm1.crowthorne.alistaircrooks.co.uk@localhost\*[Gt]
 %
 .Ed
+.Pp
+The following is an example of RSA key generation:
+.Bd -literal
+% netpgpkeys --generate-key
+netpgp: default key set to "C0596823"
+pub 2048/RSA (Encrypt or Sign) 5bc707d1b495aaf2 2010-04-14 
+Key fingerprint: 08cb 4867 eeed 454c ce30 610d 5bc7 07d1 b495 aaf2 
+uid              RSA 2048-bit key \*[Lt]agc@localhost\*[Gt]
+netpgp: generated keys in directory /home/agc/.gnupg/5bc707d1b495aaf2
+% ls -al /home/agc/.gnupg/5bc707d1b495aaf2
+total 8
+drwx------  2 agc  agc   512 Apr 13 18:25 .
+drwx------  6 agc  agc   512 Apr 13 18:25 ..
+-rw-------  1 agc  agc   596 Apr 13 18:25 pubring.gpg
+-rw-------  1 agc  agc  1284 Apr 13 18:25 secring.gpg
+%
+% netpgpkeys --list-keys --home ~/.gnupg/5bc707d1b495aaf2
+1 key
+pub 2048/RSA (Encrypt or Sign) 5bc707d1b495aaf2 2010-04-14 
+Key fingerprint: 08cb 4867 eeed 454c ce30 610d 5bc7 07d1 b495 aaf2 
+uid              RSA 2048-bit key \*[Lt]agc@localhost\*[Gt]
+
+%
+.Ed
 .Sh SEE ALSO
 .Xr netpgp 1 ,
 .Xr ssh 1 ,