1starting(7)            Miscellaneous Information Manual            starting(7)
2
3
4

NAME

6       starting - event signalling that a job is starting
7

SYNOPSIS

9       starting JOB=JOB INSTANCE=INSTANCE [ENV]...
10

DESCRIPTION

12       The  starting  event  is generated by the Upstart init(8) daemon when a
13       new instance of a job begins starting.  The  JOB  environment  variable
14       contains  the  job name, and the INSTANCE environment variable contains
15       the instance name which will be empty for single-instance jobs.
16
17       init(8) will wait for all services started by this event to be running,
18       all  tasks  started by this event to have finished and all jobs stopped
19       by this event to be stopped before allowing the job to continue  start‐
20       ing.
21
22       This  allows  jobs  to effectively insert themselves as dependencies of
23       other jobs.  The event is typically combined with the stopped(7)  event
24       by services.
25
26       Job configuration files may use the export stanza to export environment
27       variables from their own environment  into  the  starting  event.   See
28       init(5) for more details.
29

EXAMPLE

31       A  service  that wishes to be running whenever another service would be
32       running, started before and stopped after it, might use:
33
34              start on starting apache
35              stop on stopped apache
36
37       A task that must be run before another task or service is started might
38       use:
39
40              start on starting postgresql
41

SEE ALSO

43       started(7) stopping(7) stopped(7) init(5)
44
45
46
47Upstart                           2009-07-09                       starting(7)