.TH dbus\-event 7 2013-04-25 upstart
.\"
.SH NAME
dbus \- event signalling that a dbus signal has been emitted
.\"
.SH SYNOPSIS
.B dbus
.BI [ "" BUS\fR= BUS_NAME ]
.BI SIGNAL\fR= SIGNAL
.BI INTERFACE\fR= INTERFACE
.BI OBJPATH\fR= PATH
.BI SENDER\fR= SENDER
.BI DESTINATION\fR= DESTINATION
.BI ARG0\fR= VALUE
.BI ARGN\fR= VALUE
.\"
.SH DESCRIPTION

The
.B dbus
event is generated by the
.BR upstart\-dbus\-bridge (8)
daemon when a D-Bus signal is emitted whose details match the
.I dbus
event condition and environment specified in a job's
.B start on
or
.B 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
.B BUS
parameter is optional and only set if the
.BR upstart\-dbus\-bridge (8)
daemon is started with the
.B --bus-name
parameter.  The value of
.B BUS
will be the same as the value passed as the parameter.

.\"
.SH EXAMPLES
.\"
.IP "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
.I NameAcquired
D-Bus signal is received.
.\"
.SH AUTHOR
Written by James Hunt
.RB < james.hunt@canonical.com >
.\"
.SH BUGS
Report bugs at 
.RB < https://launchpad.net/upstart/+bugs >
.\"
.SH COPYRIGHT
Copyright \(co 2013 Canonical Ltd.
.PP
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.\"
.SH SEE ALSO
.BR init (5)
.BR init (8)
.BR upstart\-dbus\-bridge (8)