---
name: "dbus-test-runner"
section: "1"
platform: "linux"
package: "dbus-test-runner"
version: "19.04.0-1.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dbus-test-runner"
---

# dbus-test-runner(1)

run multiple tasks under an independent DBus session bus

## NAME

dbus-test-runner - run multiple tasks under an independent DBus session bus

## SYNOPSIS

**dbus-test-runner**  \[ *options* \]

## DESCRIPTION

**dbus-test-runner** is a simple little executable for running a couple of programs under a new DBus session.

Use this DBus tool for unit testing of code that accesses DBus at runtime.

## HELP OPTIONS

**dbus-test-runner** accepts the following help options on the command line:

- FC**-h, --help**F\[0\]

  Display a short help text with application and help command line options and exit.

- FC**--help-all**F\[0\]

  Display the full list of available command line options (help, task control, application) and exit.

- FC**--help-task-control**F\[0\]

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

## TASK CONTROL OPTIONS

**dbus-test-runner** accepts the following task control options on the command line:

- FC**-t, --task=\<executable\>**F\[0\]

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

- FC**-n, --task-name=\<name\>**F\[0\]

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

- FC**--task-bus={session\|system\|both}**F\[0\]

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

- FC**-r, --ignore-return**F\[0\]

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

- FC**-i, --inverteturn**F\[0\]

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

- FC**-p, --parameter**F\[0\]

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

- FC**-f, --wait-for=\<dbus-name\>**F\[0\]

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

- FC**-c, --wait-until-complete**F\[0\]

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

## APPLICATION OPTIONS

**dbus-test-runner** accepts the following application options on the command line:

- FC**--dbus-daemon=\<executable\>**F\[0\]

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

- FC**-d, --dbus-config=\<config\_file\>**F\[0\]

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

- FC**--bustle-monitor=\<executable\>**F\[0\]

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

- FC**-b, --bustle-data=\<data\_file\>**F\[0\]

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

- FC**-m, --max-wait=\<seconds\>**F\[0\]

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

- FC**--keep-env**F\[0\]

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

- FC**--bus-type={session\|system\|both}**F\[0\]

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

## SEE ALSO

**http://launchpad.net/dbus-test-runner**

## AUTHOR

This manual has been written for the Debian project by Mike Gabriel \<mike.gabriel@das-netzwerkteam.de\> and may be used by others.