Provided by: upstart_1.5-0ubuntu5_amd64 bug

NAME

       init - Upstart process management daemon

SYNOPSIS

       init [OPTION]...

DESCRIPTION

       init  is  the  parent  of all processes on the system, it is executed by the kernel and is
       responsible for starting all other processes; it is the  parent  of  all  processes  whose
       natural parents have died and it is responsible for reaping those when they die.

       Processes  managed  by  init  are  known as jobs and are defined by files in the /etc/init
       directory.  See init(5) for more details on configuring Upstart.

   Events
       init(8) is an event-based init daemon.  This means that jobs will be automatically started
       and  stopped  by  changes  that  occur  to the system state, including as a result of jobs
       starting and stopping.

       This is different to dependency-based init daemons which start a  specified  set  of  goal
       jobs,  and  resolve  the  order in which they should be started and other jobs required by
       iterating their dependencies.

       For more information on starting and stopping jobs, as well as emitting events  that  will
       automatically start and stop jobs, see the manual page for the initctl(8) tool.

       The  primary  event  is the startup(7) event, emitted when the daemon has finished loading
       its configuration.  Other useful events are the starting(7), started(7),  stopping(7)  and
       stopped(7) events emitted as jobs change state.

       See upstart-events(7) for a summary of well-known events.

   System V compatibility
       The  Upstart  init(8)  daemon  does  not  keep track of runlevels itself, instead they are
       implemented entirely by its userspace tools.  The event emitted to  signify  a  change  of
       runlevel is the runlevel(7) event.  For more information see its manual page.

OPTIONS

       Options are passed to init(8) by placing them on the kernel command-line.

       --confdir directory
              Read job configuration files from a directory other than /etc/init.

       --default-console value
              Default  value  for jobs that do not specify a 'console' stanza. This could be used
              for example to set the default  to  'none'  but  still  honour  jobs  that  specify
              explicitly 'console log'. See init(5) for all possible values of console.

       --logdir directory
              Write job output log files to a directory other than /var/log/upstart.

       --no-log
              Disable  logging  of  job  output.  Note that jobs specifying 'console log' will be
              treated as if they had specified 'console none'.  See init(5) for further details.

       --no-sessions
              Disable user and chroot sessions.

       --no-startup-event
              Suppress emission of the initial startup event. This option should only be used for
              testing since it will stop the init(8) daemon from starting any jobs automatically.

       --session
              Connect to the D-Bus session bus. This should only be used for testing.

       --startup-event event
              Specify a different initial startup event from the standard startup(7).

       --verbose
              Outputs  verbose messages about job state changes and event emissions to the system
              console or log, useful for debugging boot.

NOTES

       init is not normally executed by a user process, and expects to have a process  id  of  1.
       If  this  is  not  the case, it will actually execute telinit(8) and pass all arguments to
       that.  See that manual page for further details.

FILES

       /etc/init.conf

       /etc/init/*.conf

       $HOME/.init/

AUTHOR

       Written by Scott James Remnant <scott@netsplit.com>

REPORTING BUGS

       Report bugs at <https://launchpad.net/upstart/+bugs>

COPYRIGHT

       Copyright © 2009-2011 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

       control-alt-delete(7)  init(5)  initctl(8)  runlevel(7)  startup(7) starting(7) started(7)
       stopping(7) stopped(7) telinit(8) upstart-events(7)