LSHG(1) 							    Lsh Manuals 							   LSHG(1)

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  execu-
       tion,  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 Moller <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.

LSHG
								   NOVEMBER 2004							   LSHG(1)