1SSH-INSTALLKEYS(1) Internet SSH-INSTALLKEYS(1)
2
6 _ssh-installkeys - install ssh keys on local and remote servers
7
9 ssh-installkeys [-h] [-c] [-p port] [-d] [-v] name@host...
10
12 This script tries to export ssh public keys to a specified site. It
13 will walk the user through generating key pairs if it doesn't find any
14 to export. It handles all the fiddly details, like remembering the ssh
15 keyfile names and making sure local and remote permissions are correct.
16 It tells you what it's doing if it has to change anything.
17 The name@host argument is the name of the host where your public keys
19 should be installed. If it contains a @, the part before the @ will be
20 clipped off and used as the login name. Otherwise your local login name
21 will be used.
22 Note: this script does not parse your ssh configuration — therefore, if
24 you have specified a different remote user in your configuration, this
25 script will not know that. You can use the user@host syntax to force
26 the remote username.
27
29 If either of the files ~/.config/ssh/installkeys or ~/.ssh/installkeys
30 exists, places where you install keys will be recorded in it. This
31 record will also be updated when you use the check option, so you can
32 use that option to check sites where you may have previously installed
33 keys and add them to the list. Entries are removed when you delete
34 remote keys.
35 Beware that if your account is cracked, this record will offer the
37 intruder a menu of other systems to attack, escalating security risks.
38 Thus, to enable the recording feature, you must explicitly create
39 ~/.ssh/installkeys using touch(1) or some other means. This tool will
40 not create the file for you.
41
43 Invoked with the -h option, the program prints a usage summary and
44 exits.
45 Invoked with the -c option, the program checks your local and remote
47 ssh configuration for problems without changing anything (except that
48 your record of where you have installed keys is updated).
49 The -p option allows you to set a port number, overriding the default
51 22. This may be useful if you have a firewall and port forwarding
52 setup.
53 Invoked with the -d option, the program deletes any public keys under
55 the specified login at the specified host. The configuration entries
56 for any such keys are also removed.
57 The -v option says to report all commands and responses during the
59 session. It's mainly useful for debugging.
60
62 Sites where keys have been installed may be recorded in
63 ~/.ssh-installkeys or ~/.config/ssh-installkeys.
64
66 ssh-installkeys was written in Python 2.2a1. It will not work under
67 Python 1.5.2.
68
70 This program relies on ptys to work correctly in combination with exec,
71 but some implementations (notably under FreeBSD) don't. Suspect this if
72 you see termination with the message "Remote ls returned empty string,
73 bailing out"
74 If you encounter this or any other bug, the first thing to do is run
76 with -v and see if that clarifies matters. If not, send the maintainer
77 a session transcript.
78
80 ssh(1), ssh-keygen(1).
81
83 Eric S. Raymond <esr@thyrsus.com>.
84 There is a project web page at
86 http://www.catb.org/~esr/ssh-installkeys/.
87ssh-installkeys 07/15/2018 SSH-INSTALLKEYS(1)