Provided by: upstart_1.12.1-0ubuntu4.2_amd64 
NAME
upstart-events - Well-known Upstart events summary
Event Summary
This manual page summarises well-known events generated by Upstart running both as the
init(8) daemon (process ID 1) and a Session Init (process that supervises a user session).
It is not an exhaustive list of all possible events, but rather details a standard set of
events expected to be generated on any Ubuntu system running Upstart.
The primary tables, Table 1 and Table 2, encode the well-known system and session events
respectively, along with the type of each event (listed in Table 3), the emitter of the
event (see Table 4) and the approximate time at which the event could be generated.
Additionally, the Note column indexes into Table 5 for further details on a particular
event.
See init(8) for a table summarising job goals and possible state transitions.
Note that some events listed in Table 1 may be available to session jobs (depending on
when the Session Init starts). Those events that are available will be prefixed with
:sys:. See upstart-event-bridge(8) for further details.
The Ref (Reference) column is used to refer to individual events succinctly in the Time
column.
Note that the '<' and '>' characters in the Time column denote that the event in the Event
column occurs respectively before or after the event specified in the Time column (for
example, the mounting(7) event occurs "at some time" after the startup(7) event, and the
virtual-filesystems(7) event occurs after the last mounted(7) event relating to a virtual
filesystem has been emitted).
For further details on events, consult the manual pages and the system job configuration
files, usually located in /etc/init.
Table 1: Well-Known System Events Summary.
┌────┬──────────────────────────┬──────┬──────┬────────────────────────┬──────┐ ├────┼──────────────────────────┼──────┼──────┼────────────────────────┼──────┤ │ │ all-swaps │ S │ M │ > (5) │ │ │ │ control-alt-delete(7) │ S │ A │ > (5) │ A │ │ │ container │ S │ C │ > /run mounted │ Q │ │ │ desktop-session-start │ H │ D │ > X(7) session created │ B │ │ │ desktop-shutdown │ H │ D │ > X(7) session ended │ O │ │ 7 │ filesystem │ S │ M │ After last (1) │ D │ │ │ keyboard-request(7) │ S │ A │ > (5) │ E │ │ │ local-filesystems(7) │ S │ M │ > (6) │ │ │ 1 │ mounted(7) │ H │ M │ > associated (2) │ G │ │ 2 │ mounting(7) │ H │ M │ > (5) │ H │ │ │ not-container │ S │ C │ > /run mounted │ Q │ │ │ power-status-changed(7) │ S │ I │ > (5) │ I │ │ │ remote-filesystems(7) │ S │ M │ > (6) │ │ │ │ runlevel(7) │ M │ T │ > (7) + (8) │ │ │ │ socket(7) │ S │ S │ > socket connection │ X │ │ 5 │ startup(7) │ S │ I │ Boot │ J │ │ │ started(7) │ S │ I │ > job started │ K │ │ │ starting(7) │ H │ I │ < job starts │ K │ │ │ stopped(7) │ S │ I │ > job stopped │ K │ │ │ stopping(7) │ H │ I │ < job stops │ K │ │ 6 │ virtual-filesystems(7) │ S │ M │ > last virtual FS (1) │ M │ └────┴──────────────────────────┴──────┴──────┴────────────────────────┴──────┘ Key: 'DM' is an abbreviation for Display Manager. 'FS' is an abbreviation for filesystem. 'IF' is an abbreviation for Network Interface.
Table 2: Well-Known User Events Summary.
┌────┬──────────────────┬──────┬──────┬─────────────────────────────────┬──────┐ ├────┼──────────────────┼──────┼──────┼─────────────────────────────────┼──────┤ │ │ desktop-end(7) │ S │ J │ < (2) │ │ │ │ desktop-start(7) │ H │ J │ > (3) │ │ │ 2 │ session-end(7) │ M │ I │ < Session Init end │ │ │ 1 │ startup(7) │ S │ I │ > Session Init start │ J │ │ │ :sys:* │ S │ E │ > upstart-event-bridge(8) start │ │ │ │ :sys:restarted │ S │ E │ > upstart-event-bridge(8) start │ V │ └────┴──────────────────┴──────┴──────┴─────────────────────────────────┴──────┘
Table 3: Event Types.
┌────┬────────────┬──────────────────────────┐ ├────┼────────────┼──────────────────────────┤ │ │ │ events that start on or │ │ │ │ stop on this event. │ └────┴────────────┴──────────────────────────┘
Table 4: Event Emitters.
┌────┬──────────────────────────────────┬─────────────────────────────────┐ ├────┼──────────────────────────────────┼─────────────────────────────────┤ │ B │ dbus-daemon(1) │ Run with "--activation=upstart" │ │ E │ upstart-event-bridge(8) │ │ │ F │ ifup(8) or ifdown(8) │ See /etc/network/. │ │ I │ init(8) │ Either PID 1 or a Session Init. │ │ K │ upstart-file-bridge(8) │ See file-event(7). │ │ L │ upstart-dbus-bridge(8) │ See dbus-event(7). │ │ M │ mountall(8) │ │ │ O │ upstart-dconf-bridge(8) │ See dconf-event(7). │ │ R │ /etc/cron.daily/upstart │ See cron(8). │ │ S │ upstart-socket-bridge(8) │ See socket-event(7). │ │ T │ telinit(8), shutdown(8) │ │ │ U │ upstart-udev-bridge(8) │ │ └────┴──────────────────────────────────┴─────────────────────────────────┘
Table 5: Event Summary Notes.
┌─────┬─────────────────────────────────────────────────────────────────┐ ├─────┼─────────────────────────────────────────────────────────────────┤ │ C │ These are specific examples. upstart-udev-bridge(8) will emit │ │ │ events which match the pattern, "S-device-A" where 'S' is the │ │ │ udev subsystem and 'A' is the udev action. See udev(7) and for │ │ │ /sys/class/ for possible values for subsystem. │ │ H │ Emitted when mount attempt for single entry from fstab(5) for │ │ K │ Although the events are emitted by init(8), the instigator may │ │ │ be initctl(8) if a System Administrator has manually started or │ │ L │ /etc/init/umountnfs.sh. │ │ M │ Emitted when all virtual filesystems (such as /proc) mounted. │ │ N │ Emitted when the --dev-wait-time timeout is exceeded for │ │ │ mountall(8). This defaults to 30 seconds. │ │ O │ Emitted when the X(7) display manager exits at shutdown or │ │ │ grub) as the initial event (rather than startup(7)) to denote │ │ │ successful, the standard startup(7) event is then emitted, │ │ U │ See file-event(7). │ │ │ upstart-event-bridge(8). │ │ X │ See socket-event(7). │ │ │ /usr/share/upstart/sessions/logrotate.conf. │ └─────┴─────────────────────────────────────────────────────────────────┘
AUTHOR
Manual page written by James Hunt <james.hunt@ubuntu.com>
REPORTING BUGS
Report bugs at <https://launchpad.net/ubuntu/+source/upstart/+bugs>
COPYRIGHT
Copyright © 2011-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
all-swaps(7), control-alt-delete(7), dbus-daemon(1), dbus-event(7), dconf-event(7),
file-event(7), filesystem(7), ifdown(8) ifup(8) init(5), init(8), initctl(8),
keyboard-request(7), local-filesystems(7), mountall(8), mounted(7), mounting(7),
power-status-changed(7), remote-filesystems(7), runlevel(7), shutdown(8), socket-event(7),
started(7), starting(7), startup(7), stopped(7), stopping(7), telinit(8),
upstart-dbus-bridge(8), upstart-dconf-bridge(8), upstart-event-bridge(8),
upstart-file-bridge(8), upstart-local-bridge(8), upstart-socket-bridge(8),
upstart-udev-bridge(8), virtual-filesystems(7).