upstart-events


Event Summary
       This manual page summarises well-known events generated by Upstart run-
       ning 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 particu-
       lar event.

       See init(8) for a table summarising job goals and possible state  tran-
       sitions.

       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  suc-
       cinctly 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-filesys-
       tems(7) event occurs after the last mounted(7) event relating to a vir-
       tual 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   |
|    | 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-        |  H   |  V   | >   last   remote   FS |  L   |
|    | filesystems              |      |      | unmounted              |      |
| 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.

+----+------------------+------+------+---------------------------------+------+
|Ref |      Event       | Type | Emit |              Time               | Note |
+----+------------------+------+------+---------------------------------+------+
|    | dbus             |  S   |  L   | > (1)                           |  W   |
|    | dconf            |  S   |  O   | > (1)                           |      |
|    | desktop-end(7)   |  S   |  J   | < (2)                           |      |
|    | desktop-start(7) |  H   |  J   | > (3)                           |      |
|    | file             |  S   |  K   | > (1)                           |  U   |
| 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   |
| 3  | xsession         |  M   |  H   | > (1)                           |  T   |
+----+------------------+------+------+---------------------------------+------+

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

| H  | xsession-init session job        |                                 |
| I  | init(8)                          | Either PID 1 or a Session Init. |
| J  | job that starts desktop          | gnome-session job for Ubuntu.   |
| K  | upstart-file-bridge(8)           | See file-event(7).              |
| L  | upstart-dbus-bridge(8)           | See dbus-event(7).              |
| M  | mountall(8)                      |                                 |
| N  | network-interface job            |                                 |
| 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)           |                                 |
| V  | System V init system             |                                 |
| X  | failsafe job                     |                                 |
+----+----------------------------------+---------------------------------+

Table 5: Event Summary Notes.

+-----+-----------------------------------------------------------------+
|Note | Detail                                                          |
+-----+-----------------------------------------------------------------+
| A   | Requires administrator to press Control-Alt-Delete key combina- |
|     | tion 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  moun- |
|     | tall(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 |
| X   | See socket-event(7).                                            |
| Y   | Used primary by Session Job  /usr/share/upstart/sessions/logro- |
|     | tate.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 (C) 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-filesys-
       tems(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).




upstart                           2013-12-20                 upstart-events(7)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2018 Hurricane Electric. All Rights Reserved.