Common

Common Commandline Options

Unless stated otherwise, the following commandline options are accepted by all tools:

--version

Print version information and exit.

--help, -h

Print this help and exit.

--help-for THING

Print help for THING and exit. This option can be specified multiple times.

Note

This option is only available in the Common Lisp implementation.

--info-stream STREAM-NAME

Stream to which information messages should be sent. Allowed values for STREAM-NAME: stdout, standard-output, stderr, error-output, none. Default info stream is: error-output

Note

This option is only available in the Common Lisp implementation.

--log-level LEVEL

Controls the amount of generated log output. Allowed values for LEVEL: off, trace, info, warn and error. Default log level is warn.

Note

This option is only available in the Common Lisp implementation.

--trace SPEC

Trace specified things. This option can be supplied multiple times to trace multiple things. Each occurrence takes an individual SPEC which has to have one of the following forms:

"PACKAGE"

Trace all functions in the package named PACKAGE.

Note

The double quotes and uppercase.

FUNCTION-NAME

Trace the function named FUNCTION-NAME.

Note

No quotes, actual case of the function name.

Note

This option is only available in the Common Lisp implementation.

--debug

Enable debugging. This does the following things:

• Set the log level such that debug output is emitted
• Enable printing backtraces instead of just condition reports in case of unhandled error conditions
• Optionally, application-specific debugging

Note

This option is only available in the Common Lisp implementation.

--swank

Start a swank listener. Swank will print the port it listens on. In addition, a file named ./swank-port.txt containing the port number is written.

Note

This option is only available in the Common Lisp implementation.

--eval SEXP

Evaluate SEXP as Lisp code. This option can be supplied multiple times. Code fragments are evaluated in the order in which they appear on the commandline.

Note

This option is only available in the Common Lisp implementation.

--load FILE

Load FILE. This option can be supplied multiple times. Files are loaded in the order in which they appear on the commandline.

Note

This option is only available in the Common Lisp implementation.

IDL-related Commandline Options

--idl-path DIRECTORIES, -I DIRECTORIES

DIRECTORIES is a list of paths from which data definitions should be loaded. This option can be supplied multiple times.

Note

This option is only available in the Common Lisp implementation.

--load-idl FILE-OR-GLOB-EXPRESSION, -l FILE-OR-GLOB-EXPRESSION

Load data definition from FILE-OR-GLOB-EXPRESSION. If a glob expression is specified, in addition to the canonical globbing syntax, expressions of the form:

SOMESTUFF/**/MORESTUFF

can be used to search directories recursively. If the file designated by FILE-OR-GLOB-EXPRESSION depend on additional data definition files (i.e. contain import statements), the list of directories supplied via the --idl-path option is consulted to find these files. This option can be supplied multiple times.

Note

This option is only available in the Common Lisp implementation.

Common Environment Variables

In-process Transport

RSB_TRANSPORT_INPROCESS_ENABLED

1: enable in-process transport in this process; 0: disabled in-process transport in this process.

Spread Transport

RSB_TRANSPORT_SPREAD_ENABLED

1: enable Spread transport in this process; 0: disabled Spread transport in this process.

RSB_TRANSPORT_SPREAD_HOST

Name or IP-address of the machine running the Spread daemon.

RSB_TRANSPORT_SPREAD_PORT

Port on which the Spread daemon listens.

TCP-socket-based Transport

RSB_TRANSPORT_SOCKET_ENABLED

1: enable TCP-socket-based transport in this process; 0: disabled TCP-socket-based transport in this process.

RSB_TRANSPORT_SOCKET_HOST

Name or IP-address of the machine running the RSB TCP-socket-based server component.

RSB_TRANSPORT_SOCKET_PORT

Port on which the RSB TCP-socket-based server component listens.

RSB_TRANSPORT_SOCKET_SERVER

1: this process should act the RSB TCP-socket-based server component; 0: this process should connect to the TCP-socket-based server; auto: this process should try to determine whether there already is a TCP-socket-based server for the configured host-port combination and act as a server or client accordingly.