1*0a6a1f1dSLionel Sambuc.\" $NetBSD: pgp2ssh.1,v 1.4 2014/02/17 07:23:19 agc Exp $ 2ebfedea0SLionel Sambuc.\" 3ebfedea0SLionel Sambuc.\" Copyright (c) 2010 The NetBSD Foundation, Inc. 4ebfedea0SLionel Sambuc.\" All rights reserved. 5ebfedea0SLionel Sambuc.\" 6ebfedea0SLionel Sambuc.\" This manual page is derived from software contributed to 7ebfedea0SLionel Sambuc.\" The NetBSD Foundation by Alistair Crooks (agc@NetBSD.org). 8ebfedea0SLionel Sambuc.\" 9ebfedea0SLionel Sambuc.\" Redistribution and use in source and binary forms, with or without 10ebfedea0SLionel Sambuc.\" modification, are permitted provided that the following conditions 11ebfedea0SLionel Sambuc.\" are met: 12ebfedea0SLionel Sambuc.\" 1. Redistributions of source code must retain the above copyright 13ebfedea0SLionel Sambuc.\" notice, this list of conditions and the following disclaimer. 14ebfedea0SLionel Sambuc.\" 2. Redistributions in binary form must reproduce the above copyright 15ebfedea0SLionel Sambuc.\" notice, this list of conditions and the following disclaimer in the 16ebfedea0SLionel Sambuc.\" documentation and/or other materials provided with the distribution. 17ebfedea0SLionel Sambuc.\" 18ebfedea0SLionel Sambuc.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19ebfedea0SLionel Sambuc.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20ebfedea0SLionel Sambuc.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21ebfedea0SLionel Sambuc.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22ebfedea0SLionel Sambuc.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23ebfedea0SLionel Sambuc.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24ebfedea0SLionel Sambuc.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25ebfedea0SLionel Sambuc.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26ebfedea0SLionel Sambuc.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27ebfedea0SLionel Sambuc.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28ebfedea0SLionel Sambuc.\" POSSIBILITY OF SUCH DAMAGE. 29ebfedea0SLionel Sambuc.\" 30*0a6a1f1dSLionel Sambuc.Dd February 16, 2014 31ebfedea0SLionel Sambuc.Dt PGP2SSH 1 32ebfedea0SLionel Sambuc.Os 33ebfedea0SLionel Sambuc.Sh NAME 34ebfedea0SLionel Sambuc.Nm pgp2ssh 35ebfedea0SLionel Sambuc.Nd convert a PGP public key to an SSHv2 key 36ebfedea0SLionel Sambuc.Sh SYNOPSIS 37ebfedea0SLionel Sambuc.Nm 38ebfedea0SLionel Sambuc.Op Fl f address-family 39ebfedea0SLionel Sambuc.Op Fl h hostname 40ebfedea0SLionel Sambuc.Op Fl p port 41ebfedea0SLionel Sambuc.Ar userid ... 42ebfedea0SLionel Sambuc.Sh DESCRIPTION 43ebfedea0SLionel SambucThe 44ebfedea0SLionel Sambuc.Nm 45ebfedea0SLionel Sambuccommand retrieves PGP public key information from the key server daemon 46ebfedea0SLionel Sambucusing the HKP protocol, and converts the PGP public 47ebfedea0SLionel Sambuckey to a format suitable for use by 48ebfedea0SLionel Sambuc.Xr ssh 1 . 49ebfedea0SLionel SambucThe 50ebfedea0SLionel Sambuc.Xr hkpd 1 51ebfedea0SLionel Sambucis normally used to serve public key information. 52ebfedea0SLionel SambucThe 53ebfedea0SLionel Sambuc.Nm 54ebfedea0SLionel Sambucutility is similar to the 55ebfedea0SLionel Sambuc.Xr hkpc 1 56ebfedea0SLionel Sambucutility in that it retrieves keys in the same way. 57ebfedea0SLionel SambucIn addition, 58ebfedea0SLionel Sambuc.Nm 59ebfedea0SLionel Sambucwill convert the format of the key. 60ebfedea0SLionel Sambuc.Pp 61ebfedea0SLionel SambucAt the present time, only RSA keys are supported. 62ebfedea0SLionel SambucThere is no intention, at the time of writing, to 63ebfedea0SLionel Sambucsupport DSA keys, due to their limitations. 64ebfedea0SLionel Sambuc.Pp 65ebfedea0SLionel SambucIt is quite possible to serve ssh public keys 66ebfedea0SLionel Sambucacross a network using 67ebfedea0SLionel Sambuc.Xr hkpd 1 68ebfedea0SLionel Sambucto serve the key, and 69ebfedea0SLionel Sambuc.Nm 70ebfedea0SLionel Sambucto retrieve the key using the HKP protocol, 71ebfedea0SLionel Sambucand to save the key in ssh format on the remote computer, 72ebfedea0SLionel Sambucallowing users to login to the remote computer using 73ebfedea0SLionel Sambuc.Xr ssh 1 . 74ebfedea0SLionel Sambuc.Sh EXIT STATUS 75ebfedea0SLionel SambucThe 76ebfedea0SLionel Sambuc.Nm 77ebfedea0SLionel Sambucutility will return 0 for success, 78ebfedea0SLionel Sambucor 1 for failure. 79ebfedea0SLionel SambucOutput will be printed on stdout. 80ebfedea0SLionel SambucIt can be redirected to a file for use by 81ebfedea0SLionel Sambuc.Xr ssh 1 . 82ebfedea0SLionel Sambuc.Sh SEE ALSO 83ebfedea0SLionel Sambuc.Xr hkpc 1 , 84ebfedea0SLionel Sambuc.Xr hkpd 1 , 85ebfedea0SLionel Sambuc.Xr netpgpkeys 1 , 86ebfedea0SLionel Sambuc.Xr ssh 1 , 87ebfedea0SLionel Sambuc.\" .Xr libbz2 3 , 88ebfedea0SLionel Sambuc.Xr libnetpgp 3 89ebfedea0SLionel Sambuc.Sh STANDARDS 90*0a6a1f1dSLionel Sambuc.Rs 91*0a6a1f1dSLionel Sambuc.%A J. Callas 92*0a6a1f1dSLionel Sambuc.%A L. Donnerhacke 93*0a6a1f1dSLionel Sambuc.%A H. Finney 94*0a6a1f1dSLionel Sambuc.%A D. Shaw 95*0a6a1f1dSLionel Sambuc.%A R. Thayer 96*0a6a1f1dSLionel Sambuc.%D November 2007 97*0a6a1f1dSLionel Sambuc.%R RFC 4880 98*0a6a1f1dSLionel Sambuc.%T OpenPGP Message Format 99*0a6a1f1dSLionel Sambuc.Re 100ebfedea0SLionel Sambuc.Sh HISTORY 101ebfedea0SLionel SambucThe 102ebfedea0SLionel Sambuc.Nm 103ebfedea0SLionel Sambuccommand first appeared in 104ebfedea0SLionel Sambuc.Nx 6.0 . 105ebfedea0SLionel Sambuc.Sh AUTHORS 106ebfedea0SLionel Sambuc.An Alistair Crooks Aq Mt agc@NetBSD.org . 107