dbus-test-runner-19.04.0 - Man Page

manual page for dbus-test-runner 19.04.0

Description

Usage

dbus-test-runner [OPTION?] - run multiple tasks under an independent DBus session bus

Help Options

-h,  --help

Show help options

--help-all

Show all help options

--help-task-control

Options that are used to control how the task is handled by the test runner.

Task control options

-t,  --task=executable

Defines a new task to run under our private DBus session.

-n,  --task-name=name

A string to label output from the previously defined task.  Defaults to taskN.

--task-bus={session|system|both}

Configures which bus the task expects to connect to. Default: both

-r,  --ignore-return

Do not use the return value of the task to calculate whether the test passes or fails.

-i,  --invert-return

Invert the return value of the task before calculating whether the test passes or fails.

-p,  --parameter

Add a parameter to the call of this utility.  May be called as many times as you'd like.

-f,  --wait-for=dbus-name

A dbus-name that should appear on the bus before this task is started

-c,  --wait-until-complete

Signal that we should wait until this task exits even if we don't need the return value

Application Options

--dbus-daemon=executable

Path to the DBus deamon to use.  Defaults to 'dbus-daemon'.

-d,  --dbus-config=config_file

Configuration file for newly created DBus server.  Defaults to '/usr/share/dbus-test-runner/session.conf'.

--bustle-monitor=executable

Path to the Bustle DBus Monitor to use.  Defaults to 'bustle-dbus-monitor'.

-b,  --bustle-data=data_file

A file to write out data from the bustle logger to.

-m,  --max-wait=seconds

The maximum amount of time the test runner will wait for the test to complete.  Default is 30 seconds.

--keep-env

Whether to propagate the execution environment to the dbus-server and all the services activated by it.  By default the environment is cleared.

--bus-type={session|system|both}

Configures which buses are represented by the tool to the tasks. Default: session

Info

February 2024 dbus-test-runner 19.04.0