Previous | Contents | Index | Next

# 1.6 Start the Program

The XTrackCAD executable is named xtrkcad.exe on Windows and xtrkcad on Linux and OSX.

It is usually started by clicking on its icon, or right-click and Open in OSX Catalina, but there are command line options as well.

Command Line

On Windows:

    xtrkcad [/c config] [/v] [/l logfile] [/d logcontrol] layoutfile

On Mac OSX:

    cd /Applications
    ./open xtrkcad --args [-c config] [-v] [-l logfile] [-d logcontrol] layoutfile

On Linux:

    xtrkcad [-c config] [-v] [-l logfile] [-d logcontrol] layoutfile

Command line parameters

`c config`
  configuration to use. This allows you to have several distinct configurations (eg. parameter files, display options).

`layoutfile`
  filename for the layout to load. This parameter takes precedence over the option to resume with the last layout (Section 2.10.7).

Debugging Parameters

The following parameters are for debugging purposes and are mainly of interest to the developers.

`v`
  verbose mode.

`d logcontrol`
  specifies the amount of logging. The argument logcontrol has the format `logmodule[=level]`. logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol parameter.

`l logfile`
  set logfile, only needed in conjunction with the debug option.

`T`
  Runs all Regression tests (Demos) and exits with 0 if all are successful or with 1 if there any failures. Regression progress and failures are logged to stdout (Linux and Mac OSX) or xtclog.txt (Windows).

`V`
  Display the xtrkcad version and exit(0).