Provided by: upstart_1.12.1-0ubuntu4_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.


┌────┬────────────┬──────────────────────────┐
├────┼────────────┼──────────────────────────┤
│    │            │ 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).