Provided by: upstart_1.12.1-0ubuntu4.2_amd64 bug

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.


┌────┬────────────┬──────────────────────────────┐
├────┼────────────┼──────────────────────────────┤
│    │            │ that  start  on  or  stop on │
└────┴────────────┴──────────────────────────────┘

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).