Please check the status of this specification in Launchpad before editing it. If it is Approved, contact the Assignee or another knowledgeable person before making changes.


This specification proposes introducing a new emits configuration stanza to aid charting of the relationship between jobs.


There is currently no method to determine what events a job is likely to emit, other than those generated by upstart. This means that it's difficult to automatically chart the relationships between jobs. This new stanza would be optional and advisory, but aid in this.

Use cases


The scope of this specification is limited to the introduction of a new documentation stanza, it does not specify any further use or limitation of use for this stanza.




The implementation is largely confined to the configuration file parser, adding the new stanza and parsing it.

The Job structure in init/job.h will gain a new member to hold a list of these events:

NihList *emits;

Each member will be an Event structure (or possible just a Name).

A method will be added to libupstart to permit the list of emitted events to be queried.

Data preservation and migration

These changes are backwards compatible with the previous behaviour.


Emits (last edited 2006-11-29 11:19:01 by scott)