[Contents] [Index]

About This Document>>     Installing SSH Tectia Client >>     Getting Started >>     Configuring SSH Tectia Client >>         Defining Profile Settings >>         Defining Global Settings >>         Editing the Configuration Files >>         Using Command-Line Options         Customizing the User Interface>>     Connecting to a Remote Host Computer>>     Transferring Files>>     Tunneling Applications>>     GUI Reference>>     Troubleshooting >>     Command-Line Tools >>

Using Command-Line Options

For some purposes it may be useful to operate SSH Tectia Client from the command line (command prompt).

The command-line syntax for SSH Tectia Client (SSHClient.exe) is the following:

sshclient [-r] [-p port] [-u user] [-h host] [profile.ssh2]

The meaning of the command-line parameters is the following:

• -r

  The -r option will reset all customizations made to the user interface (toolbars and menus). A confirmation dialog is displayed.

• -p [port_number]

  The -p option specifies the port number used for the connection. If this option is not specified, the port number defined in the default profile is used.

• -u [user_name]

  The -u option specifies the user name for the connection. If this option is not specified, the user name defined in the default profile is used.

• -h [host_name]

  The -h option specifies the host name for the connection. If this option is not specified, the host name defined in the default profile is used.

• [profile.ssh2]

  If a profile is specified, it must be the last option on the command line. Any command-line parameters override the profile settings. If no profile is specified, the default profile (default.ssh2) is used.

• -f

  The -f (or /f) option starts the default SFTP file transfer profile.

For example, the following command would immediately start a connection to a host called remotehost and connect as guest. The port number is not specified, so the connection would use the port specified in the default profile.

sshclient -h remotehost -u guest

The following command would immediately start a connection to remotehost using the settings defined in the profile file custom.ssh2.

sshclient -h remotehost custom.ssh2

If the host is not specified (using the -h option) and no profile is specified, the login dialog opens, automatically filled with the values specified on the command line.

For example, the following command would display the login dialog with the port number already defined as 222 and guest as the user name.

sshclient -u guest -p 222

Note: A pure command-line version of SSH Tectia Client is shipped with the Windows client. The command line client ssh.exe is a port of the Unix version of SSH Tectia Client, and may be useful also in the Windows command-line environment, especially for creating scripts. For a more detailed description of the ssh.exe syntax, see Appendix ssh.exe.

Also several other command-line utilities are shipped with the Windows and command-line clients. For more information, see Appendix Command-Line Tools.