Provided by: x2goclient_4.1.2.2-2build2_amd64 bug

NAME

       x2goclient - Client application to launch server-side X2Go sessions.

SYNOPSIS

       x2goclient  <options>

DESCRIPTION

       x2goclient is a GUI application for launching server-side X2Go sessions.

HELP AND DEBUG OPTIONS

       x2goclient has the following help and debugging options:

       --help Show available command line options.

       --help-pack
              Show available pack methods and exit.

       -v, --version
              Output X2Go Client version to stderr.

       --debug
              Enable extensive console output for debugging X2Go Client.

       --changelog
              Show changelog file.

       --git-info
              Show Git commit history (not available on all X2Go Client builds).

GUI OPTIONS

       The following options can be used for controlling the GUI behaviour:

       --no-menu
              Hide menu-/toolbar (default: false).

       --maximize
              Start client maximized (default: false).

       --hide Hide client (start hidden, default: false).

       --keep-trayicon
              Always keep the "accelerated X" icon in the system tray. Without this option the
              default behaviour is: Switch the tray icon to the session's icon on successful
              session startup/resumption.

       --tray-icon
              Show tray icon (default: false). This option overrides the global tray icon
              settings and also forces the tray icon to be shown in hidden X2Go Client mode.

       --hide-foldersharing
              Hide all elements in X2Go Client GUI that are related to folder sharing.

       --close-disconnect
              Close X2Go Client after a session got disconnected.

       --client-ssh-port
              Local ssh port (for filesystem export, default: 22).

       --autostart=<app>
              Launch <app> by session start in "published applications" mode. This parameter
              should go along with --session=<session-profile-name>, where the given session
              profile should be configured as a session profile of type "Published Applications".

       --support-menu=<html-file>
              Add a "Support..." submenu item to X2Go Client's "Help" menu.

              The support information is provided via a simple HTML file. Example:

                   <html><body>
                   <h1>IT-Support for X2Go</h1>
                   DAS-NETZWERKTEAM | Mike Gabriel:<br />
                   <a href="mailto:support@das-netzwerkteam.de">
                       support@das-netzwerkteam.de
                   </a><br />
                   <br />
                   Thanks for using X2Go...
                   </body></html>

       --background=<svg-file|dir>
              Use a custom/branded background image (SVG format) for X2Go Client's main window
              (i.e. replace the blue gradient area in X2Go Client by some background of your own
              (business/workgroup/project).  If a directory is given, will randomly pick an SVG
              file inside of it.

       --branding=<svg-file>
              Use a custom icon (SVG format) for additional branding to replace the default in
              the lower left corner of X2Go Client's main window.

MISCELLANEOUS OPTIONS

       These options change X2Go Client's behavior globally. Some might not be available on all
       platforms.

       --xserver-start-limit=<num> (Windows-only)
              Limit the X.Org Server start count to at most <num> tries. Default: 3.  If <num> is
              zero or a negative number, no limit is imposed.  The limits for <num> are platform
              dependent. If the passed value is out of bounds, X2Go Client falls back to the
              default value.

SESSION PROFILE DEFAULTS

       You can set certain defaults for session profiles via command line switches using the
       following options:

       --user Pre-selection of user at client startup (LDAP mode only).

       --command=<default-command>
              Default command for session startup.

       --ssh-port
              Use this default TCP/IP port for connection (default: 22).

       --ssh-key
              Use this SSH private key file by default.

       --autologin
              By default, search for standard SSH key file names or try using an SSH agent.

       --link Set default link type (modem,isdn,adsl,wan or lan, default: adsl).

       --pack Set default pack method (default: '16m-jpeg').

       --quality
              Set default image quality(0-9, default: 9).

       --set-kbd
              Overwrite current keyboard settings, no override by default.

       --kbd-layout
              Set keyboard layout (default: 'de').

       --kbd-type
              Set keyboard type (default: pc105/us, depend on our clients language setup,
              though).

       --clipboard=<both|client|server|none>
              Set default clipboard mode.

       --geometry=<W>x<H>|fullscreen
              Set default geometry, default '800x600'.

       --dpi=<dpi>
              set DPI of X2Go Agent to <dpi>, default set to same as local display.

       --sound
              Activate sound for session, not enabled by default.

       --sound-system
              Which soundsystem to use: arts, esd, pulse (default: pulse).

       --xinerama
              Use Xinerama by default.

       --session-icon=<128x128px-icon-png-file>
              Use a custom session icon by default.

THIN CLIENT OPTIONS

       The following command line options are primarily interesting if x2goclient is used as a
       login manager on X2Go thin clients.

       --thinclient
              Let X2Go Client run without window manager.

       --sessionid=<session-profile-id>
              Pre-selection of a session profile (by its session profile ID) at client startup.

       --session=<session-profile-name>
              Pre-selection of a session profile (by its session profile name) at client startup.

       --no-session-edit
              Disable session editing.

       --pgp-card
              Use openPGP Card authentication (default: false).

       --external-login=<smartcard-logins>
              Authenticate via SMART card, path to login notification file.

       --add-to-known-hosts
              Add DSA/RSA host key fingerprint to .ssh/known_hosts in case of "authenticity of
              server can't be established".

       --read-exports-from
              Specifies a directory where some external mechanism (e.g. script) can notify
              x2goclient on new block devices (CD/DVDs, USB sticks, etc.).

       --haltbt
              Show a "Shutdown" button in the top left corner of X2Go Client. When pressed, X2Go
              Client will create the file $HOME/.halt. An external script has to watch for this
              file and trigger a thinclient shutdown once it appears.

PORTABLE OPTIONS

       X2Go Client can be installed on a USB-Flashdrive as a portable applications. If installed
       that way, the following options support the portable setup of X2Go Client:

       --portable
              Start X2Go Client in "portable" mode. This implies... (TODO).

       --home=<dir>
              Set the users home directory. This is the directory where X2Go Client will store
              settings and cache files.

       --session-conf=<file>
              Path to alternative session profile config (default: $HOME/.x2goclient/sessions).

       --clean-all-files
              In portable mode, X2Go Client removes several directories it has created (and
              probably directories you don't want to have removed on a normal system):

                      $HOME/.ssh
                      $HOME/ssh
                      $HOME/.x2go

              If --clean-all-files is used on the command line, also the directory containing the
              configuration files of X2Go Client gets removed:

                      $HOME/.x2goclient

BROKER OPTIONS

       In case you want to retrieve x2goclient session profiles from an X2Go Session Broker use
       the following options:

       --broker-url=<URL>
              Specify the <URL> of the X2Go Session Broker. X2Go Client can access http:// and
              ssh:// style URLs.

              Syntax of <URL> for HTTP brokerage:

              http(s)://<user>:<password>@<hostname>:<port>/path/to/broker

              Syntax of <URL> for  SSH brokerage:

              ssh://<user>:<password>@<hostname>:<port>/usr/bin/x2gobroker (or any executable
              that provides the broker via SSH).

       --broker-cacertfile=</path/to/cafile.crt>
              Specify a special (self-signed) root-CACert file that shall get used when
              connecting to an X2Go Session Broker via https (SSL).

       --broker-noauth
              The X2Go Session Broker is accessible without authentication.

       --broker-krblogin
              Login to X2Go Session Broker via GSSAPI. Only supported with ssh:// broker URLs.

       --auth-id=<USERNAME>
              Use this <USERNAME> for authenticating against the X2Go Session Broker. This option
              mostly makes sense together with --broker-autologin or --broker-ssh-key.

       --broker-autologin
              For SSH based X2Go Session Brokers. If an SSH agent is available or default key
              files exist then try those for authentication against the X2Go Session Broker.

       --broker-autologoff
              Enforce re-authentication against X2Go Session Broker after a session has been
              suspended or terminated.

       --broker-ssh-key=<SSHPRIVKEY>
              For SSH based X2Go Session Brokers. Full path to a valid SSH private key file.

       --broker-name=<NAME>
              Sets the broker name to display in X2Go Client. This parameter is optional.

       --connectivity-test
              Run a connectivity test against X2Go Session Broker. Not supported by all broker
              implementations.

       --change-broker-pass
              Send a change-password request to an X2Go Session Broker. Not supported by all
              broker implementations.

       --broker-noauth-with-session-username
              Informs the broker to use the username you entered for X2Go Server authentication
              when selecting a server/session. Only has functionality if --broker-noauth is used.

       --broker-use-creds-for-session
              Use broker credentials as session user/password credentials when using broker mode
              with broker authentication. Currently only affects direct RDP sessions.

       --broker-logoutbt
              Show a "Logout" button in the top left corner of X2Go Client. When logged in to a
              broker, pressing this button X2Go Client lets you login to the broker again.

LDAP OPTIONS (deprecated)

       NOTE: LDAP support won't be continued in X2Go Client 2 (next generation of X2Go Client).

       A slightly different approach than X2Go Client's LDAP functionality is available via the
       X2Go Session Brokerage feature.

       In case you want to control x2goclient via an LDAP server use the following options:

       --ldap=<host:port:dn>
              Start with LDAP support (disabled by default). Example:
              --ldap=ldapserver:389:o=organization,c=de

       --ldap1=<host:port:dn>
              Failover LDAP URI No. 1.

       --ldap2=<host:port:dn>
              Failover LDAP URI No. 2.

       --ldap-printing
              Allow client side printing in LDAP mode.

AUTHOR

       This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the
       X2Go project (https://www.x2go.org).