---
name: "dbus-event"
section: "7"
platform: "linux"
package: "upstart"
version: "1.11-5"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/dbus-event"
---

# dbus-event(7)

event signalling that a dbus signal has been emitted

## 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)](/upstart-dbus-bridge/8.md) 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)](/upstart-dbus-bridge/8.md) 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

Copyright © 2013 Canonical Ltd.

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

## SEE ALSO

[**init**(5)](/init/5.md) [**init**(8)](/init/8.md) [**upstart-dbus-bridge**(8)](/upstart-dbus-bridge/8.md)