lshg(1) 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 <[email protected]>.

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 <[email protected]>.

This man-page was written for lsh 2.0 by Pontus Freyhult <[email protected]>, it is based on a template written by J.H.M. Dassen (Ray) <[email protected]>.