tags 380241 + patch thanks Attached please find a patch which produces and installs a man page for gpgkey2ssh(1), so that this command is no longer completely undocumented. The man page is installed in the gnupg-agent package, along with the binary itself.
Thanks for maintaining gpg2 in debian!
--dkg
--- gnupg2-2.0.9/doc/Makefile.in 2009-02-27 21:58:50.000000000 -0500
+++ gnupg2-2.0.9.dkg/doc/Makefile.in 2009-02-27 21:56:25.000000000 -0500
@@ -338,9 +338,9 @@
--release "GnuPG @PACKAGE_VERSION@" --source "GNU Privacy Guard"
myman_sources = gnupg7.texi gpg.texi gpgsm.texi gpg-agent.texi \
scdaemon.texi tools.texi
-myman_pages = gpg2.1 gpgsm.1 gpg-agent.1 scdaemon.1 gpgv2.1 \
+myman_pages = gpg2.1 gpgsm.1 gpg-agent.1 scdaemon.1 gpgkey2ssh.1 gpgv2.1 \
watchgnupg.1 gpgconf.1 addgnupghome.8 gpg-preset-passphrase.1 \
gpg-connect-agent.1 gpgparsemail.1 symcryptrun.1 \
gpgsm-gencert.sh.1 applygnupgdefaults.8
--- gnupg2-2.0.9/debian/gnupg-agent.install 2009-02-27 19:38:47.000000000 -0500
+++ gnupg2-2.0.9.dkg/debian/gnupg-agent.install 2009-02-27 21:57:23.000000000 -0500
@@ -2,6 +2,7 @@
debian/tmp/usr/bin/gpg-connect-agent
debian/tmp/usr/bin/gpgkey2ssh
debian/tmp/usr/bin/symcryptrun
+debian/tmp/usr/share/man/man1/gpgkey2ssh.1
debian/tmp/usr/share/man/man1/gpg-agent.1
debian/tmp/usr/share/man/man1/gpg-connect-agent.1
debian/tmp/usr/share/man/man1/symcryptrun.1
--- gnupg2-2.0.9/doc/tools.texi 2009-02-27 22:38:56.000000000 -0500
+++ gnupg2-2.0.9.dkg/doc/tools.texi 2009-02-27 22:34:38.000000000 -0500
@@ -18,6 +18,7 @@
* gpg-connect-agent:: Communicate with a running agent.
* gpgparsemail:: Parse a mail message into an annotated format
* symcryptrun:: Call a simple symmetric encryption tool.
+* gpgkey2ssh:: Emit GPG public keys in OpenSSH format.
@end menu
@c
@@ -1485,3 +1486,78 @@
@end ifset
@include see-also-note.texi
+
+...@c
+...@c GPGKEY2SSH
+...@c
+
+...@manpage gpgkey2ssh.1
+...@node gpgkey2ssh
+...@section
+...@ifset manverb
+.B gpgkey2ssh
+\- Emit GPG public keys in OpenSSH format
+...@end ifset
+
+...@mansect synopsis
+...@ifset manverb
+.B gpgkey2ssh
+.I keyid
+...@end ifset
+
+...@mansect description
+...@code{gpgkey2ssh} is a tool for emitting the public key material of a
+known OpenPGP RSA or DSA key in a format readable by OpenSSH clients
+and servers.
+
+It takes only a single argument, which is either a normal key ID (the
+final 8 hex digits of the key fingerprint) or a ``long key ID'' (the
+final 16 hex digit of the key fingerprint), referring to the exact
+primary key or subkey whose public key material should be extracted.
+
+The key ID should use upper-case (A-F, not a-f) for all hex digits
+greater than 9, and the key in question must be present in
+...@code{gpg}'s public keyring.
+
+The output of a successful run can be used verbatim as an entry in an
+...@code{authorized_keys} file for @code{sshd}, or can be prefixed with a
+host name and appended to a @code{known_hosts} file for @code{ssh}.
+
+...@mansect return value
+
+The program returns 0 if the key was successfully identified and
+non-zero if there was an error (e.g. if the key ID was malformed, the
+key was not present in the public keyring, or if the key so identified
+is not an RSA or DSA key).
+
+...@mansect environment
+...@subsection Environment
+
+...@table @asis
+
+...@item HOME
+Used to locate the default home directory.
+
+...@item GNUPGHOME
+If set directory used instead of "~/.gnupg".
+
+...@end table
+
+...@mansect files
+...@subsection FILES
+
+...@table @asis
+
+...@item ~/.gnupg/pubring.gpg
+The keyring searched for the requested key.
+
+...@end table
+
+...@mansect see also
+...@ifset isman
+...@command{gpg2}(1),
+...@command{sshd}(8),
+...@command{ssh}(1)
+...@end ifset
+...@include see-also-note.texi
+
signature.asc
Description: OpenPGP digital signature
