ssh-copy-id.1 revision 180740 
1180740Sdes.ig \"  -*- nroff -*-
2180740SdesCopyright (c) 1999 Philip Hands Computing <http://www.hands.com/>
3180740Sdes
4180740SdesPermission is granted to make and distribute verbatim copies of
5180740Sdesthis manual provided the copyright notice and this permission notice
6180740Sdesare preserved on all copies.
7180740Sdes
8180740SdesPermission is granted to copy and distribute modified versions of this
9180740Sdesmanual under the conditions for verbatim copying, provided that the
10180740Sdesentire resulting derived work is distributed under the terms of a
11180740Sdespermission notice identical to this one.
12180740Sdes
13180740SdesPermission is granted to copy and distribute translations of this
14180740Sdesmanual into another language, under the above conditions for modified
15180740Sdesversions, except that this permission notice may be included in
16180740Sdestranslations approved by the Free Software Foundation instead of in
17180740Sdesthe original English.
18180740Sdes..
19180740Sdes.TH SSH-COPY-ID 1 "14 November 1999" "OpenSSH"
20180740Sdes.SH NAME
21180740Sdesssh-copy-id \- install your identity.pub in a remote machine's authorized_keys
22180740Sdes.SH SYNOPSIS
23180740Sdes.B ssh-copy-id [-i [identity_file]]
24180740Sdes.I "[user@]machine"
25180740Sdes.br
26180740Sdes.SH DESCRIPTION
27180740Sdes.BR ssh-copy-id
28180740Sdesis a script that uses ssh to log into a remote machine (presumably
29180740Sdesusing a login password, so password authentication should be enabled,
30180740Sdesunless you've done some clever use of multiple identities)
31180740Sdes.PP
32180740SdesIt also changes the permissions of the remote user's home,
33180740Sdes.BR ~/.ssh ,
34180740Sdesand
35180740Sdes.B ~/.ssh/authorized_keys
36180740Sdesto remove group writability (which would otherwise prevent you from logging in, if the remote
37180740Sdes.B sshd
38180740Sdeshas
39180740Sdes.B StrictModes
40180740Sdesset in its configuration).
41180740Sdes.PP
42180740SdesIf the
43180740Sdes.B -i
44180740Sdesoption is given then the identity file (defaults to
45180740Sdes.BR ~/.ssh/identity.pub )
46180740Sdesis used, regardless of whether there are any keys in your
47180740Sdes.BR ssh-agent .
48180740SdesOtherwise, if this:
49180740Sdes.PP
50180740Sdes.B "      ssh-add -L"
51180740Sdes.PP
52180740Sdesprovides any output, it uses that in preference to the identity file.
53180740Sdes.PP
54180740SdesIf the
55180740Sdes.B -i
56180740Sdesoption is used, or the
57180740Sdes.B ssh-add
58180740Sdesproduced no output, then it uses the contents of the identity
59180740Sdesfile.  Once it has one or more fingerprints (by whatever means) it
60180740Sdesuses ssh to append them to
61180740Sdes.B ~/.ssh/authorized_keys
62180740Sdeson the remote machine (creating the file, and directory, if necessary)
63180740Sdes
64180740Sdes.SH "SEE ALSO"
65180740Sdes.BR ssh (1),
66180740Sdes.BR ssh-agent (1),
67180740Sdes.BR sshd (8)
68