NAME

       lshg - secsh (SSH2) client

SYNOPSIS

       lshg [OPTION...] HOST [COMMAND]

DESCRIPTION

       CAUTION!  The  information  in  this  manpage  may be invalid or outdated. For authorative
       information on lsh, please see it's Texinfo manual (see the SEE ALSO section).

       Connects to the the remote machine HOST through a previously established lsh  gateway  and
       perform  one  or  more  actions, i.e.  command execution, various forwarding services. The
       default action is to start a remote interactive shell or execute a given  command  on  the
       remote machine.

OPTIONS

       --debug
              Print huge amounts of debug information

       --log-file=File name
              Append messages to this file.

       -q, --quiet
              Suppress all warnings and diagnostic messages

       --trace
              Detailed trace

       -v, --verbose
              Verbose diagnostic messages

       --askpass=Program
              Program to use for reading passwords. Should be an absolute filename.

       -l, --user=User name
              Login as this user.

       -p, --port=Port
              Connect to this port.

       Actions:

       -B, --background
              Put process into the background. Implies -N.

       -D, --forward-socks[=port] Enable socks dynamic forwarding

       -E, --execute=command
              Execute a command on the remote machine

       -L, --forward-local-port=local-port:target-host:target-port

       -N, --nop
              No operation (suppresses the default action, which is to spawn a remote shell)

       --subsystem=subsystem-name
              Connect to given subsystem. Implies --no-pty.

       -S, --shell=command
              Spawn a remote shell

       Universal not:

       -n, --no
              Inverts the effect of the next modifier

       Modifiers that apply to port forwarding:

       -g, --remote-peers
              Allow remote access to forwarded ports

       --no-remote-peers
              Disallow remote access to forwarded ports (default).

       Modifiers that apply to remote execution:

       --detach
              Detach from terminal at session end.

       --no-detach
              Do not detach session at end, wait for all open channels (default).

       --no-pty
              Don't request a remote pty.

       --no-stderr
              Redirect stderr to /dev/null

       --no-stdin
              Redirect stdin from /dev/null

       --no-stdout
              Redirect stdout to /dev/null

       --stderr=Filename
              Redirect stderr

       --stdin=Filename
              Redirect stdin

       --stdout=Filename
              Redirect stdout

       -t, --pty
              Request a remote pty (default).

       Miscellaneous options:

       -e, --escape-char=Character
              Escape  char.  `none'  means  disable.  Default  is  to  use  `~' if we have a tty,
              otherwise none.

       --write-pid
              Make -B write the pid of the backgrounded process to stdout.

       -G     If no usable gateway is found, launch lsh instead.

       --send-debug=Message
              Send a debug message to the remote machine.

       --send-ignore=Message
              Send an ignore message to the remote machine.

       -?, --help
              Give this help list

       --usage
              Give a short usage message

       -V, --version
              Print program version

       Mandatory or optional arguments to long options are also mandatory  or  optional  for  any
       corresponding short options.

DIAGNOSTICS

       See the --verbose , --trace and --debug options.

EXAMPLES

       Using  the  -G  option,  for  example in LSHGFLAGS it's easy to use an existing gateway if
       there is any and connect using lsh if not.

REPORTING BUGS

       Report bugs to <bug-lsh@gnu.org>.

ENVIRONMENT

       LSHG_FLAGS may be used for passing additional parameters. The parsing order is undefined.

COPYING

       The lsh suite of programs is distributed under the GNU General  Public  License;  see  the
       COPYING and AUTHORS files in the source distribution for details.

AUTHOR

       The lsh program suite is written mainly by Niels Möller <nisse@lysator.liu.se>.

       This  man-page was written for lsh 2.0 by Pontus Freyhult <pont_lsh@soua.net>, it is based
       on a template written by J.H.M. Dassen (Ray) <jdassen@wi.LeidenUniv.nl>.

SEE ALSO

       lsftp(1), lsh(1), lsh-authorize(1),  lsh-export-key(1),  lsh-keygen(1),  lsh-make-seed(1),
       lsh-upgrade(1), lsh-upgrade-key(1), lsh-writekey(1), lshd(8), ssh-conv(1)

       The  full  documentation  for  lsh is maintained as a Texinfo manual.  If the info and lsh
       programs are properly installed at your site, the command

              info lsh

       should give you access to the complete manual.