.TH upstart\-event\-bridge 8 2013-04-02 upstart
.\"
.SH NAME
upstart\-event\-bridge \- Bridge between system Upstart and session Upstart
.\"
.SH SYNOPSIS
.B upstart\-event\-bridge
.RI [ OPTIONS ]...
.\"
.SH DESCRIPTION
.B upstart\-event\-bridge
receives information about Upstart system
.BR events (8)
have completed and creates Upstart session events for them.

It emits events which match the pattern ":sys:*". Forwarding any event that's
triggered on the system upstart as well as a virtual "restarted" event when
upstart itself is restarted (during upgrades).

See \fBupstart-events\fP(7) and for further details.

This bridge should be run as a user, after the session bus has been setup and
only once per session init.

.\"
.SH OPTIONS
.\"
.TP
.B \-\-daemon
Detach and run in the background.
.\"
.TP
.B \-\-debug
Enable debugging output.
.\"
.TP
.B \-\-help
Show brief usage summary.
.\"
.TP
.B \-\-verbose
Enable verbose output.
.\"
.SH NOTES
Since events emitted by this bridge at the session level are copies
of the original system events, the blocking semantics of the
original system events are not retained.
.\"
.SH EXAMPLES

Some examples of Upstart events generated by this bridge:
.IP :sys:restarted
Event emitted when the system Upstart is restarted.
.IP :sys:*
Any event emitted on the system Upstart.
.\"
.SH AUTHOR
Written by Stéphane Graber
.RB < stgraber@ubuntu.com >
.\"
.SH BUGS
Report bugs at 
.RB < https://launchpad.net/ubuntu/+source/upstart/+bugs >
.\"
.SH COPYRIGHT
Copyright \(co 2012 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 events (7)