dbus-event

Section: Environments, Tables, and Troff Macros (7)
Updated: 2013-04-25
Index Return to Main Contents

NAME

dbus - event signalling that a dbus signal has been emitted

SYNOPSIS

dbus [BUS=BUS_NAME] SIGNAL=SIGNAL INTERFACE=INTERFACE OBJPATH=PATH SENDER=SENDER DESTINATION=DESTINATION ARG0=VALUE ARGN=VALUE

DESCRIPTION

The dbus event is generated by the upstart-dbus-bridge(8) daemon when a D-Bus signal is emitted whose details match the dbus event condition and environment specified in a job's start on or stop on stanza is modified.

Arguments that are simple types (string, int, etc.) are translated into strings and placed as parameters on the event with the pattern ARG and the number representing the placement in the event prototype. Parameters that are not a simple type are skipped, with the number being incremented the same.

The BUS parameter is optional and only set if the upstart-dbus-bridge(8) daemon is started with the --bus-name parameter. The value of BUS will be the same as the value passed as the parameter.

EXAMPLES

start on dbus SIGNAL=NameAcquired INTERFACE=org.freedesktop.DBus OBJPATH=/org/freedesktop/DBus SENDER=org.freedesktop.DBus ARG0=com.mycorp.foo: Start job when a particular NameAcquired D-Bus signal is received.

AUTHOR

Written by James Hunt <james.hunt@canonical.com>

BUGS

Report bugs at <https://launchpad.net/upstart/+bugs>

COPYRIGHT

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.