Merge commit 'jrollins/master'
[monkeysphere.git] / man / man1 / monkeysphere-ssh-proxycommand.1
1 .TH MONKEYSPHERE-SSH-PROXYCOMMAND "1" "June 2008" "monkeysphere 0.1" "User Commands"
2
3 .SH NAME
4
5 monkeysphere-ssh-proxycommand \- MonkeySphere ssh ProxyCommand script
6
7 .SH DESCRIPTION
8
9 \fBmonkeysphere-ssh-proxy\fP is an ssh proxy command that can be used
10 to trigger a monkeysphere update of the known_hosts file for the hosts
11 that are being connected to.  It is meant to be run as an ssh
12 ProxyCommand.  This can either be done by specifying the proxy command
13 on the command line:
14
15 .B ssh -o ProxyCommand="monkeysphere-ssh-proxycommand %h %p" ...
16
17 or by adding the following line to your ~/.ssh/config script:
18
19 .B ProxyCommand monkeysphere-ssh-proxycommand %h %p
20
21 The script is very simple, and can easily be incorporated into other
22 ProxyCommand scripts.  It first tests to see if the host is in the
23 known_hosts file.  If it's not, the CHECK_KEYSERVER variable is set to
24 true and "update-known_hosts" is run for the host to check for a host
25 key for that host.  If the host is found in the known_hosts file,
26 CHECK_KEYSERVER is set to false and "update-known_hosts" is run to
27 update from the local keychain.
28
29 Run the following command for more info:
30
31 .B less $(which monkeysphere-ssh-proxycommand)
32
33 .SH AUTHOR
34
35 Written by Jameson Rollins <jrollins@fifthhorseman.net>
36
37 .SH SEE ALSO
38
39 .BR monkeypshere (1),
40 .BR ssh (1),
41 .BR gpg (1)