Description of available command line arguments

Here follows a description for all available command line arguments.

-?, --help

Display a help summary.

--version

Display client version information and exit.

-a, --advanced

Start client in advanced mode. Advanced mode means that the client will show the Server field, Options... button and the End existing session checkbox. The advanced mode is the normal mode used when you start the ThinLinc client. A simpler mode, where those interface components are hidden, is used automatically when you enter a server name as a command line argument. By adding this argument you override that and always use the advanced mode.

-c, --controlpanel

Enable the Control Panel and apply stored mouse and keyboard speed and acceleration settings if any. Only available on UNIX versions of the client.

-C, --configfile FILE

Specifies an additional configuration file. Parameter values in this configuration file overrides the values specified by the system wide and user configuration file. Settings changed from the GUI will be stored in this configuration file, instead of the user's configuration file.

-d, --debug LEVEL

The ThinLinc client logs information about the current session to the file ~/.thinlinc/tlclient.log on UNIX systems and $TEMP\tlclient.log on Windows systems. This file is truncated every time tlclient is started, making it only show information about the most recent session. The amount of information to log can be configured with this option followed by a number from 1 to 5. A low number gives less logging than a higher number. The default is a log level of 3. For more information about log file placement, see Section 7.7, “ Logfile placement ” below.

-u, --user USER

This option sets the user name that should be filled in into the Name field. This can be used to override the name that is automatically saved from last session. If you for example, in a school classroom, want it to always start with an empty Name field, then you can use this parameter with the empty string "".

-p, --password PASSWORD

This option sets the password that should be filled in into the Password field. When this option is used and a user name exists (either saved from previous session or entered with the -u parameter) the client will automatically try to login, directly after start. If the login try fails it will return focus to the client interface, making it possible to adjust the values. Note that the command line of tlclient, and therefore the password, will be visible to other processes running on the client operating system. If this is a problem in your environment, consider using the -P option documented below.

-P, --askpass PROGRAM

This option makes it possible to specify an askpass program that should be used to achieve the password. This program should in some way ask the user for a password and then return that password together with an exit code. This triggers the auto login (see argument -p above).

-e, --encodings ENCODING, ...

This option makes it possible to select which VNC encoding you want to use (see Section 7.4.4, “ Optimization tab ” for more information about VNC encodings). Valid encodings for this option are: Tight, ZRLE, Hextile and Raw.

-l, --lock ITEM, ...

This option makes it possible to lock different parts of the client interface. This can be used to prevent things from being changed. Locked parts will still be shown, but will be "grayed out", which means that they can't be made active for change. The items that should be locked should follow this option as a comma separated list. The following items are possible to lock.

• server: server entry field

• thinlinc: ThinLinc tab

• options: options tab

• screen: screen tab

• optimization: optimization tab

• ssh: SSH tab

-h, --hide ITEM, ...

This option makes it possible to hide different parts of the client interface. This can be used to remove parts of the interface that can confuse novice users, or to prevent them from reaching parts of the interface. The following items are possible to hide.

• options: options button

• controlpanel: control panel button (only in XDM mode)

-f, --force SETTING, ...

This option makes it possible to force a setting to a value. This can be used to preset a client with values and to force them to reset to those values each time, even if the users make changes. When an option is forced it is turned on. The following items are possible to force.

• terminate: terminate session

• fullscreen: fullscreen mode

• sound: sound mode

• sshcrypt: ssh encryption

• sshcomp: ssh compression

-M, --minimize

This option causes all other applications to be minimized when the ThinLinc client starts.

-s, --startprogram

Specifies the program to start in the session. Overrides the START_PROGRAM_ENABLED and START_PROGRAM_COMMAND configuration parameters.