A simulation program built with Qtenv accepts the following command line switches:
-h: The program prints a help message and exits.
-u Qtenv: Causes the program to start with Qtenv. (This is the default, unless the program
hasn't been linked with Qtenv, or has another, custom environment library with a higher priority
than Qtenv.)
-f filename: Specifies the name of the configuration file. The default is omnetpp.ini. Multiple -f
switches can be given; this allows you to partition your configuration file. For example, one file can
contain your general settings, another one most of the module parameters, and a third one the module
parameters you change frequently. The -f switch is optional and can be omitted.
-l filename: Loads a shared library (.so file on Unix, .dll on Windows,
and .dylib on Mac OS X). Multiple -l switches are accepted. Shared libraries
may contain simple modules and other, arbitrary code. File names may be specified without
the file extension and the lib name prefix (i.e. foo instead of libfoo.so).
-n filepath: When present, overrides the NEDPATH environment variable and sets
the source locations for simulation NED files.
-c configname: Selects an INI configuration for execution.
-r runnumber: It has the same effect as (but takes priority over) the qtenv-default-run=
INI file configuration option. Run filters are also accepted.
If there is more than one matching run, they are grouped to the top of the combobox.
OMNETPP_IMAGE_PATH: It controls where Qtenv will load images for network
graphics (modules, background, etc.) from. The value should be a semicolon-separated
list of directories, but on non-Windows systems, the colon is also accepted as separator.
The default is ./bitmaps;./images;<omnetpp>/images, that is, by default Qtenv
looks into the bitmaps and images folder of the simulation, and images folder
in the working directory of your installation. The directories will be scanned recursively,
and subdirectory names become part of the icon name; for example, if an images/ directory
is listed, the file images/misc/foo.png will be registered as icon misc/foo.
PNG, JPG and GIF files are accepted.OMNETPP_DEBUGGER_COMMAND: When set, overrides the factory default for the command
used to launch the just-in-time debugger (debugger-attach-command). It must contain '%u'
(which will be substituted with the process ID of the simulation), and must not contain any
additional '%' characters. Since the command has to return immediately, on Linux and macOS
it is recommended that it ends with an ampersand ('&'). Settings on the command line
or in an .ini file take precedence over this environment variable.Qtenv accepts the following configuration options in the INI file.
qtenv-extra-stack: Specifies the extra amount of stack (in kilobytes) that is reserved for each
activity() simple module when the simulation is run under Qtenv. This value is significantly
higher than the similar one for Cmdenv (handling GUI events requires a large amount of stack space).
qtenv-default-config: Specifies which INI file configuration Qtenv should set up automatically after
startup. If there is no such option, Qtenv will ask which configuration to set up.
qtenv-default-run: Specifies which run of the selected configuration Qtenv should set up
after startup. If there is no such option, Qtenv will ask.
All other Qtenv settings can be changed via the GUI, and are saved into the .qtenvrc file
in the user's home directory or in the current directory.