upstart-events (7)
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.
Ref | Event | Type | Emit | Time | Note
|
|
| all-swaps | S | M | > (5) |
|
| control-alt-delete(7) | S | A | > (5) | A
|
| container | S | C | > /run mounted | Q
|
| dbus-activation | S | B | > D-Bus client request |
|
| deconfiguring-networking | H | V | < non-local IFs down | P
|
| desktop-session-start | H | D | > X(7) session created | B
|
| desktop-shutdown | H | D | > X(7) session ended | O
|
| device-not-ready | H | M | > (2) | N
|
| drm-device-added | S | U | > (5) | C
|
| failsafe-boot | S | X | > (7) and local IF | S
|
| file | S | K | > (1) | U
|
7 | filesystem | S | M | After last (1) | D
|
| graphics-device-added | S | U | > (5) | C
|
| keyboard-request(7) | S | A | > (5) | E
|
| local-filesystems(7) | S | M | > (6) |
|
| login-session-start | H | D | < DM running | F
|
1 | mounted(7) | H | M | > associated (2) | G
|
2 | mounting(7) | H | M | > (5) | H
|
3 | net-device-added | S | U | > (5) | C
|
| net-device-changed | S | U | > (5) | C
|
| net-device-down | S | F | < (4) | C
|
4 | net-device-removed | S | U | > (5) | C
|
| net-device-up | S | F,N | > (3) | C
|
| not-container | S | C | > /run mounted | Q
|
| power-status-changed(7) | S | I | > (5) | I
|
| recovery | S | G | Boot (<5) | R
|
| remote-filesystems(7) | S | M | > (6) |
|
| rotate-logs | H | R | daily | Y
|
| 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
|
8 | static-network-up | S | N | > last static IF up |
|
| stopped(7) | S | I | > job stopped | K
|
| stopping(7) | H | I | < job stops | K
|
|
unmounted-:remote-:filesystems
| H | V |
> last remote FS unmounted
| L
|
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.
Table 3: Event Types.
Ref | Event Type | Notes
|
|
H | Hook |
Blocking. Waits for events that start on or stop on this
event.
|
M | Method | Blocking task.
|
S | Signal | Non-blocking.
|
|
Table 4: Event Emitters.
Table 5: Event Summary Notes.
Note | Detail
|
|
A |
Requires administrator to press Control-Alt-Delete key
combination on the console.
|
B | Event generated when user performs graphical login.
|
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 further details. If you have sysfs
mounted, you can look in /sys/class/ for possible values for subsystem.
|
D | Note this is in the singular - there is no 'filesystems' event.
|
E |
Emitted when administrator presses Alt-UpArrow key combination on
the console.
|
F |
Denotes Display Manager running (about to be displayed), but no users
logged in yet.
|
G | Generated for each mount that completes successfully.
|
H |
Emitted when mount attempt for single entry from fstab(5)
for any filesystem type is about to begin.
|
I | Emitted when Upstart receives the SIGPWR signal.
|
J | Initial event (system or Session Init).
|
K |
Although the events are emitted by init(8), the instigator may be
initctl(8) if a System Administrator has manually started or
stopped a job.
|
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 reboot, to
hand off to the shutdown splash manager.
|
P |
Emitted by /etc/init.d/networking just prior to stopping all non-local
network interfaces.
|
Q |
Either 'container' or 'not-container' is emitted (depending
on the environment), but not both.
|
R |
Emitted by either the initramfs or bootloader (for example grub) as the initial
event (rather than startup(7)) to denote the system has booted into
recovery mode. If recovery was successful, the standard startup(7)
event is then emitted, allowing the system to boot as normal.
|
S |
Emitted to indicate the system has failed to boot within the expected
time. This event will trigger other jobs to forcibly attempt to bring
the system into a usable state.
|
T | Only emitted for a graphical session.
|
U | See file-event(7).
|
V |
This is a pseudo-system event emitted directly by the
upstart-event-bridge(8).
|
W |
Emitted by Session Init only since bridge not run as system job by
default.
|
X | See socket-event(7).
|
Y |
Used primary by Session Job
/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).