Tracing

Option: --trace <trace-group>

Each function in the code base, other than utility functions, is assigned to a trace group. This option enables trace messages for a group.

Can be specified more than once to trace multiple groups.

Option: --trcfunc <function name>

Enable trace messages in a particular function.

Can be specified more than once to trace multiple functions.

Option: --trcfile <file name>

Enable trace messages in a single file. The argument is a simple file name, e.g. "ddc_services.c".

Can be specified more than once to trace multiple files.

Option: --timestamp, --ts

Prefix trace messages with the number of seconds since ddcutil startup

Option: --wall-timestamp, --wts

Prefix trace messages with the current clock time.

Option: --thread_id, --tid

Prefix trace messages with the a thread id number. This is the Linux thread id.

Option: --syslog

Write trace messages to the system log as well as the currently active trace message destination (typically the terminal).

Other Debug Options

Option: --force

Override some checks. Usually fatal.

Option: -excp

Portions of the ddcutil code base use an exception-like mechanism that can record the individual errors that contribute to a master error. If this option is specified, the exceptions are displayed before converting them to a single status code.