sshg3

sshg3 — Secure Shell terminal client - Generation 3

Synopsis

sshg3 [options...]
[user@] host [#port]
[command]

Description

sshg3 (sshg3.exe on Windows) is a program for logging in to a remote machine and executing commands on a remote machine. sshg3 provides secure, encrypted communication channels between two hosts over an unsecured network. It can be used to replace the unsecured rlogin, rsh, and telnet programs. Also X11 connections and arbitrary TCP/IP ports can be forwarded over secure channels with sshg3.

sshg3 connects to the specified remote host using the Secure Shell version 2 protocol. The users must prove their identities to the remote machine using some authentication method.

sshg3 launches ssh-broker-g3 as a transport. ssh-broker-g3 will ask for passwords or passphrases if they are needed for authentication. sshg3 uses the configuration specified in the ssh-broker-config.xml file.

Options

The following options are available:

-?

Displays help.

+a

Enables authentication agent forwarding. This is the default value.

-a

Disables authentication agent forwarding.

--abort-on-failing-tunnel

Aborts on failing tunnel.

-B

Uses batch processing.

-e char

Sets escape character (none: disabled, default: ~).

-f

Forks into background mode (Unix).

-g

Gateways ports, which means that remote hosts may connect to locally forwarded ports. Note the logic of + and - in this option.

+g

Does not gateway ports. Listens to tunneling connections originating only from the localhost. Note the logic of + and - in this option.

-h

Displays help and exits.

-l login_name

Logs in using this username.

-L listen-port:host:port

Forwards local port to remote address.

This causes sshg3 to listen to connections on a port, and forward them to the other side by connecting to host:port.

-n

Redirects input from /dev/null (Unix).

-o 'option'

Processes the option as if it was read from a configuration file (options: ForwardX11, ForwardAgent).

-p port

Connects to this port. Server must be on the same port.

-P

Sets password. Supplying the password on the command line is not a secure option. You should set up a more secure way to authenticate.

-R listen-port:host:port

Forwards remote port to local address.

This causes sshg3 to listen to connections on a port, and forward them to the other side by connecting to host:port.

-s subsystem

Sets subsystem.

-S

Does not request a session channel.

-t

Tty; allocates a tty even if a command is given.

-V

Displays version string and exits.

+w

Tries an empty password.

-w

Does not try an empty password.

+x

Enables X11 connection forwarding.

-x

Disables X11 connection forwarding. This is the default value.

The command can be either of the following:

remote_command [arguments] ...: Runs the command on a remote host.
-s service: Enables a service in remote server.

Type sshg3 -h to see the command-line syntax, the location of the configuration files, supported ciphers, and your license type.

Exit Values

On normal execution, sshg3 exits with the status of the command run. On successful runs this is normally 0 (zero).

If sshg3 encounters an error, you usually see the reason in an error message. In this case, the exit value is 1.

Authors

SSH Communications Security Corp.

For more information, see http://www.ssh.com.