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 can easily be incorporated into other ProxyCommand scripts
  22 by calling it with the "--no-connect" option, ie:
  23
  24 .B monkeysphere-ssh-proxycommand --no-connect "$HOST" "$PORT"
  25
  26 This will run everything but will not exec netcat to make the tcp
  27 connection to the host.
  28
  29 .SH KEYSERVER CHECKING
  30
  31 The proxy command has a fairly nuanced policy for when keyservers are
  32 queried when processing host.  If the host userID is not found in
  33 either the user's keyring or in the known_hosts file, then the
  34 keyserver is queried for the host userID.  If the host userID is found
  35 in the user's keyring, then the keyserver is not checked.  This is
  36 because...  If the host userID is not found in the user's keyring, but
  37 the host is listed in the known_hosts file, then defered check is
  38 scheduled.
  39
  40 .SH ENVIRONMENT VARIABLES
  41
  42 .TP
  43 KEYSERVER The keyserver to query.
  44
  45 .SH AUTHOR
  46
  47 Written by Jameson Rollins <jrollins@fifthhorseman.net>
  48
  49 .SH SEE ALSO
  50
  51 .BR monkeypshere (1),
  52 .BR ssh (1),
  53 .BR gpg (1)