Command line options

The command line options of the Genero Desktop Client, organized by category.

Table 1. Genero Desktop Client command line options: Information.
This table presents Genero Desktop Client command line options. Some options share the same attribute and description - these options are interchangeable.
Option	Parameter	Description
`-h`		Displays About Box and exits.
`-V`
`--Version`
`-c`		Defines an additional configuration file. See Apply an additional configuration file.
`--config`

Table 2. Genero Desktop Client command line options: Network, System.
This table presents Genero Desktop Client command line options. Some options share the same attribute and description - these options are interchangeable.
Option	Parameter	Description
`-n`		Starts a new instance of Genero Desktop Client.
`--new`		Starts a new instance of Genero Desktop Client.
`-p`	`new_port`	Genero Desktop Client will listen on the first available port starting with `new_port`. Important: If an instance is already running, `-p` has no effect if `-n` is not specified.
`--port`	`new_port`
`-q`		If the expected port (either 6400, or port specified by `--port)` is not available, Genero Desktop Client will stop (exit with -1).
`-D`		Starts Genero Desktop Client in debug mode, where the debug tree and debug console are active. When set: The Debug tab in the Monitor becomes visible. If used in conjunction with the `-a` option, the Copy to clipboard button in the About box copies various debug information to the clipboard, to include config.xml and hosts.xml content. This enables you to send information to support when needed. If a connection is selected, the menu option Debug Tree is added to the context menu of the connection table. Selecting this option displays the AUI tree. To activate the debug tree, press Ctrl and right-click within the application. To activate the debug widget tree, press Ctrl-Shift and right-click within the application. If not specified with the --listen option, the listening mode is set to `ANY` when this option is specified.
`-A`	`security_level`	Sets Genero Desktop Client's security level regarding the Runtime System's connection.
`--Authentication`	`security_level`
`--listen`	`ANY\|LOCALHOST\|NONE\|AUTO`	Specify the network listening mode of the Genero Desktop Client. `ANY`: Listen to any network for a new connection. `LOCALHOST`: Listen to localhost only, DVM must be on the same host as Genero Desktop Client or must be on a host connected with port forwarding `NONE`: No listening at all. Only HTTP connection will work, this is the most secure operating mode. `AUTO`: Like `LOCALHOST`, but Genero Desktop Client will switch back to `LOCALHOST` when no more connections and no more terminals are active, after a two minutes timeout. Important: AUTO is the default, which means connections from the outside that are launched without using the shortcut system will not work anymore.

Table 3. Genero Desktop Client command line options: Start Application.
This table presents Genero Desktop Client command line options. Some options share the same attribute and description - these options are interchangeable.
Option	Parameter	Description
	`.gdc file`	Starts Genero Desktop Client with the shortcut specified in the .gdc file. If the file contains several shortcuts, it starts with the first alphabetically. See The Shortcut Sysytem.
`-S`	`shortcut_name`	If Genero Desktop Client has not been launched, Genero Desktop Client will start minimized; then, the shortcut named `shortcut_name` will be started.
`--Start`	`shortcut_name`
`-s`		If Genero Desktop Client has not been launched, Genero Desktop Client will start minimized, using the information given by -U, -H, -T, -P and -C to connect to a DVM.
`--startDirect`
`-U`	`username`	The specified `user` name will be used when a Direct Connection starts. This option can be used if you share Genero Desktop Client; then each user can create a link to the bin and differentiate the shortcut that will be launched.
`--User`	`username`
`-H`	`hostname`	The specified `host` name will be used when a Direct Connection starts with a defined shortcut (with -S), or starts directly (with -s).
`--Host`	`hostname`
`-P`	`password`	The specified `password` will be used when a Direct Connection starts with a defined shortcut (with -S), or starts directly (with -s).
`--Password`	`password`
`-K`		The password specified with -P option will be kept in memory and no longer requested.
`--KeepPassword`
`-C`	`command_line`	The specified `command_line` will be used when a Direct Connection starts with a defined shortcut (with -S) or starts directly (with -s).
`--Cmd`	`command_line`
`-T`	`connection_type`	Defines which protocol should be used when an application starts with `-s`. Values can be: `TELNET`, `SSH`, `SSH2`. Default is `SSH2`. Note: Default is now SSH2.
`--Type`	`connection_type`
`-w`		Defines whether the terminal window is visible (when `--startDirect` option is used). The terminal is hidden by default.
`--ShowTerminal`
`-f`		If a password is provided with `--Password`, Genero Desktop Client won't display a login box when starting a shortcut. If you explicitly want the login box to be shown, with password and user pre-entered, use the `-f` option.
`--ShowFirstLogin`
`-e`		Allows the user to save the password in a persistent way (It will not be asked again, even if Genero Desktop Client is stopped and restarted).
`--AllowPersistentSave`
`-k`	`Putty Key file (.ppk)`	Uses the given `Putty Key File` as authentication method when Direct Connection.
`--PuttyKey`	`Putty Key file (.ppk)`
`-u`	`Genero application URL`	Starts the HTTP Genero application given by the `URL`.
`--url`	`Genero application URL`	Starts the HTTP Genero application given by the `URL`.
`-g`	`remote .gdc file`	Starts directly the `remote .gdc file`.
`--gdcfile`	`remote .gdc file`	Starts directly the `remote .gdc file`.

Table 4. Genero Desktop Client command line options: Start Genero Desktop Client.
This table presents Genero Desktop Client command line options. Some options share the same attribute and description - these options are interchangeable.
Option	Parameter	Description
`-a`		Starts the GDC in admin mode. When set: The Options tab in the Monitor becomes visible. The Shortcuts list includes New ..., Edit, Delete, and Duplicate ... buttons. If used in conjunction with the `-D` option, the content of config.xml and hosts.xml are written to the clipboard when using the "Copy to clipboard" button in the About box. The GDC monitor configuration can be saved, as monitor configuration is only saved when in admin mode.
`--admin`
`-c`		Defines an additional configuration file. See Apply an additional configuration file.
`--config`
`-M`		Starts the GDC minimized.
`--Minimized`		Starts the GDC minimized.
`-i`		Starts the GDC with ignore Stored Settings on.
`--ignoreSettings`		Starts the GDC with ignore Stored Settings on.
`-X`		Closes the GDC if there is no longer an application or terminal running.
`--close`

Table 5. Genero Desktop Client command line options: Logging Mechanism.
This table presents Genero Desktop Client command line options. Some options share the same attribute and description - these options are interchangeable.
Important: Sensitive and personal data may be written to the output. Make sure that the log output is written to files that can only be read by application administrators.
Option	Parameter	Description
`-l`	`Log file`	Starts Genero Desktop Client and replays the given `Log File`
`--logplay`	`Log file`
`-L`	`Log file directory`	Starts Genero Desktop Client and replays all the Log Files inside a given`directory`
`--logdir`	`Log file directory`
`-r`	`Log file`	Starts Genero Desktop Client, records a log, and saves the given `Log File`.
`--logrec`	`Log file`
`-t`	`delay`	By default, replays Log Files at their recording speed. You can change the `delay` (in milliseconds) between the steps. Important: A delay that is too small will overcharge Genero Desktop Client. Please consider 100 milliseconds as the smallest acceptable value.
`--logtimeout`	`delay`
`-W`	`[address:]Port Number`	Defines the TCP port where a Chrome browser can connect to, in order to use the QT WebEngine Developer Tools. Usage examples: --webengine-remote-debugging=9000 --webengine-remote-debugging=127.0.0.1:9000 --webengine-remote-debugging 9002 -W 9000 For more information, see Debug Web content.
`--webengine-remote-debugging`	`[address:]Port Number`

macOS™ users

The command line can be used in either of the following ways:

Start the terminal application (Applications, Utilities) then enter: ./Applications/gdc.app/Contents/MacOS/gdc command_line. macOS™ expects the path to be absolute and not relative.
Using the following Apple® Script: do shell script "./Applications/gdc.app/Contents/MacOS/gdc command_line"

Warnings

The -S and -s options must be used separately; -S is used to start an existing shortcut, and-s to start an application using the command line.
When using -s, you must specify at least the host and the command line. The username and password will be prompted if needed.
Even if you're using the -q option, Genero Desktop Client will first check whether another instance is already running. If you really want your Genero Desktop Client instance to stop if the port is not available, use -n and -q together. Using-q alone will stop Genero Desktop Client if the port is not free and not being used by another Genero Desktop Client.