1*a77b54d6Sagc.\" $NetBSD: pgp2ssh.1,v 1.4 2014/02/17 07:23:19 agc Exp $
213b8cf66Sagc.\"
313b8cf66Sagc.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
413b8cf66Sagc.\" All rights reserved.
513b8cf66Sagc.\"
613b8cf66Sagc.\" This manual page is derived from software contributed to
713b8cf66Sagc.\" The NetBSD Foundation by Alistair Crooks (agc@NetBSD.org).
813b8cf66Sagc.\"
913b8cf66Sagc.\" Redistribution and use in source and binary forms, with or without
1013b8cf66Sagc.\" modification, are permitted provided that the following conditions
1113b8cf66Sagc.\" are met:
1213b8cf66Sagc.\" 1. Redistributions of source code must retain the above copyright
1313b8cf66Sagc.\"    notice, this list of conditions and the following disclaimer.
1413b8cf66Sagc.\" 2. Redistributions in binary form must reproduce the above copyright
1513b8cf66Sagc.\"    notice, this list of conditions and the following disclaimer in the
1613b8cf66Sagc.\"    documentation and/or other materials provided with the distribution.
1713b8cf66Sagc.\"
1813b8cf66Sagc.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
1913b8cf66Sagc.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
2013b8cf66Sagc.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
2113b8cf66Sagc.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
2213b8cf66Sagc.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
2313b8cf66Sagc.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
2413b8cf66Sagc.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2513b8cf66Sagc.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2613b8cf66Sagc.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
2713b8cf66Sagc.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
2813b8cf66Sagc.\" POSSIBILITY OF SUCH DAMAGE.
2913b8cf66Sagc.\"
30*a77b54d6Sagc.Dd February 16, 2014
3113b8cf66Sagc.Dt PGP2SSH 1
3213b8cf66Sagc.Os
3313b8cf66Sagc.Sh NAME
3413b8cf66Sagc.Nm pgp2ssh
3513b8cf66Sagc.Nd convert a PGP public key to an SSHv2 key
3613b8cf66Sagc.Sh SYNOPSIS
3713b8cf66Sagc.Nm
3813b8cf66Sagc.Op Fl f address-family
3913b8cf66Sagc.Op Fl h hostname
4013b8cf66Sagc.Op Fl p port
41b57aee93Swiz.Ar userid ...
4213b8cf66Sagc.Sh DESCRIPTION
4313b8cf66SagcThe
4413b8cf66Sagc.Nm
4513b8cf66Sagccommand retrieves PGP public key information from the key server daemon
4613b8cf66Sagcusing the HKP protocol, and converts the PGP public
4713b8cf66Sagckey to a format suitable for use by
48b57aee93Swiz.Xr ssh 1 .
4913b8cf66SagcThe
5013b8cf66Sagc.Xr hkpd 1
5113b8cf66Sagcis normally used to serve public key information.
5213b8cf66SagcThe
5313b8cf66Sagc.Nm
5413b8cf66Sagcutility is similar to the
5513b8cf66Sagc.Xr hkpc 1
5613b8cf66Sagcutility in that it retrieves keys in the same way.
5713b8cf66SagcIn addition,
5813b8cf66Sagc.Nm
5913b8cf66Sagcwill convert the format of the key.
6013b8cf66Sagc.Pp
6113b8cf66SagcAt the present time, only RSA keys are supported.
6213b8cf66SagcThere is no intention, at the time of writing, to
6313b8cf66Sagcsupport DSA keys, due to their limitations.
6413b8cf66Sagc.Pp
6513b8cf66SagcIt is quite possible to serve ssh public keys
6613b8cf66Sagcacross a network using
6713b8cf66Sagc.Xr hkpd 1
68b57aee93Swizto serve the key, and
6913b8cf66Sagc.Nm
7013b8cf66Sagcto retrieve the key using the HKP protocol,
7113b8cf66Sagcand to save the key in ssh format on the remote computer,
7213b8cf66Sagcallowing users to login to the remote computer using
7313b8cf66Sagc.Xr ssh 1 .
7413b8cf66Sagc.Sh EXIT STATUS
7513b8cf66SagcThe
7613b8cf66Sagc.Nm
7713b8cf66Sagcutility will return 0 for success,
7813b8cf66Sagcor 1 for failure.
7913b8cf66SagcOutput will be printed on stdout.
8013b8cf66SagcIt can be redirected to a file for use by
8113b8cf66Sagc.Xr ssh 1 .
8213b8cf66Sagc.Sh SEE ALSO
8313b8cf66Sagc.Xr hkpc 1 ,
8413b8cf66Sagc.Xr hkpd 1 ,
8513b8cf66Sagc.Xr netpgpkeys 1 ,
8613b8cf66Sagc.Xr ssh 1 ,
8713b8cf66Sagc.\" .Xr libbz2 3 ,
8813b8cf66Sagc.Xr libnetpgp 3
8913b8cf66Sagc.Sh STANDARDS
90*a77b54d6Sagc.Rs
91*a77b54d6Sagc.%A J. Callas
92*a77b54d6Sagc.%A L. Donnerhacke
93*a77b54d6Sagc.%A H. Finney
94*a77b54d6Sagc.%A D. Shaw
95*a77b54d6Sagc.%A R. Thayer
96*a77b54d6Sagc.%D November 2007
97*a77b54d6Sagc.%R RFC 4880
98*a77b54d6Sagc.%T OpenPGP Message Format
99*a77b54d6Sagc.Re
10013b8cf66Sagc.Sh HISTORY
10113b8cf66SagcThe
10213b8cf66Sagc.Nm
10313b8cf66Sagccommand first appeared in
10413b8cf66Sagc.Nx 6.0 .
10513b8cf66Sagc.Sh AUTHORS
106fb06f38bSwiz.An Alistair Crooks Aq Mt agc@NetBSD.org .
107