d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
5f302628d0
freebsd-dev/usr.bin/ssh-copy-id/ssh-copy-id.1

91 lines
2.8 KiB
Groff
Raw Normal View History

Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.\"-
.\" Copyright (c) 2012 Eitan Adler
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
Fix date.
2014-06-15 10:18:57 +00:00
.Dd February 28, 2014
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.Dt SSH-COPY-ID 1
.Os
.Sh NAME
.Nm ssh-copy-id
.Nd copy public keys to a remote host
.Sh SYNOPSIS
.Nm
ssh-copy-id: avoid sending private keys; add -v option To help avoid confusion: when attempting to send a key file check to see if a file of the same name exists with a '.pub' suffix and send that instead. This mimics the behavior of other ssh-copy-id scripts. Add -v passthrough. Reported by: dweimer <dweimer@dweimer.net> Reported by: feld MFC After: 1 week
2014-03-01 03:17:46 +00:00
.Op Fl lv
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.Op Fl i Ar keyfile
.Op Fl o Ar option
.Op Fl p Ar port
.Oo Ar user Ns @ Oc Ns Ar hostname
.Sh DESCRIPTION
The
.Nm
utility copies public keys to a remote host's
Clarify where the authorized_key file lives. Approved by: bcr (mentor) MFC after: 3 days
2012-11-12 14:16:39 +00:00
.Pa ~/.ssh/authorized_keys
file (creating the file and directory, if required).
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl i Ar file
ssh-copy-id: avoid sending private keys; add -v option To help avoid confusion: when attempting to send a key file check to see if a file of the same name exists with a '.pub' suffix and send that instead. This mimics the behavior of other ssh-copy-id scripts. Add -v passthrough. Reported by: dweimer <dweimer@dweimer.net> Reported by: feld MFC After: 1 week
2014-03-01 03:17:46 +00:00
Copy the public key contained in
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.Ar file .
This option can be specified multiple times and can be combined with
the
.Fl l
option.
ssh-copy-id: avoid sending private keys; add -v option To help avoid confusion: when attempting to send a key file check to see if a file of the same name exists with a '.pub' suffix and send that instead. This mimics the behavior of other ssh-copy-id scripts. Add -v passthrough. Reported by: dweimer <dweimer@dweimer.net> Reported by: feld MFC After: 1 week
2014-03-01 03:17:46 +00:00
If a private key is specified and a public key is found then the public key
will be used.
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.It Fl l
Copy the keys currently held by
.Xr ssh-agent 1 .
This is the default if the
.Fl i
option was not specified.
.It Fl o Ar ssh-option
Pass this option directly to
.Xr ssh 1 .
This option can be specified multiple times.
.It Fl p Ar port
Connect to the specified port on the remote host instead of the
default.
ssh-copy-id: avoid sending private keys; add -v option To help avoid confusion: when attempting to send a key file check to see if a file of the same name exists with a '.pub' suffix and send that instead. This mimics the behavior of other ssh-copy-id scripts. Add -v passthrough. Reported by: dweimer <dweimer@dweimer.net> Reported by: feld MFC After: 1 week
2014-03-01 03:17:46 +00:00
.It Fl v
Pass -v to
.Xr ssh 1 .
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.El
.Pp
The remaining arguments are a list of remote hosts to connect to,
each one optionally qualified by a user name.
Add the standard exit status to the ssh-copy-id man page. Approved by: bcr (mentor) MFC after: 3 days
2012-11-11 15:34:58 +00:00
.Sh EXIT STATUS
.Ex -std
Add examples to the ssh-copy-id script. Approved by: bcr (mentor) MFC after: 3 days
2012-11-13 13:06:57 +00:00
.Sh EXAMPLES
To send a specific key to multiple hosts:
.Dl $ ssh-copy-id -i /path/to/keyfile.pub user@host1 user@host2 user@host3
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
.Sh HISTORY
The
.Nm
utility was written by
use .Mt to mark up email addresses consistently (part3) PR: 191174 Submitted by: Franco Fichtner <franco at lastsummer.de>
2014-06-23 08:23:05 +00:00
.An Eitan Adler Aq Mt eadler@FreeBSD.org
Add a clean-room reimplementation of a script originally found in openssh's contrib directory. This version has more features and is better written. I intend to submit this upstream as well. Reviewed by: bapt Reviewed by: des Approved by: cperciva MFC after: 1 week
2012-10-22 03:57:00 +00:00
as a drop-in replacement for an existing utility included with
OpenSSH.
Reference in New Issue Copy Permalink