initctl; man page

Man Pages Index

SYNOPSIS
       initctl [OPTION]... COMMAND [OPTION]... ARG...

DESCRIPTION
       initctl allows a system administrator to communication with the init(8)
       daemon and perform various actions depending on COMMAND.

       Normally it is invoked directly with the command specified as the first
       non-option argument, however symbolic or hard links may be used so that
       it is invoked as the name of  a  command,  in  which  case  it  behaves
       accordingly.

OPTIONS
       --show-ids
              Usually  a  job’s  name is sufficient to identify it, except for
              instance jobs which may have multiple running instances with the
              same  name.  To query or stop a specific instance, its unique id
              is necessary.

              This option causes all commands to output the unique id of  jobs
              and events, in addition to their name.

       --by-id
              Applies to the start, stop and status commands.

              Normally  these  accept  the  job  name  as arguments; with this
              option they expect job ids instead.

       --no-wait
              Applies to the start, stop and emit commands.

              Normally these commands wait for the named jobs or events to  be
              started,  stopped  or finished respectively.  This option causes
              them to return without waiting once the request  has  been  con‐
              firmed.

       --quiet
              Reduces output of all commands to errors only.

COMMANDS
       start JOB...
              Requests that the named jobs be started.  The status of the jobs
              will be output to standard output  until  they  are  succesfully
              running, or in the case of tasks, until they have completed.

              See status for a description of the output format.

       stop JOB...
              Requests that the named jobs be stopped.  The status of the jobs
              will be output to standard output until  they  are  successfully
              stopped.

              Some  job  states  may  have  multiple processes associated, for
              example when the job is in the post-start  or  pre-stop  states.
              The  extra  processes follow on consecutive lines, indented by a
              tab.

                job (start) post-start, process 1347
                        main process 1234

              If no post-start or pre-stop process exists, only  one  line  is
              output.   If there’s a main process running, that is included on
              the same line preceeded by (main).

                job (stop) pre-stop, (main) process 1234

              Instance jobs are output with the first line giving the name  of
              the job, and consecutive lines giving the state of each instance
              indented by four spaces.

                job (instance)
                    (start) running, process 1234
                    (start) post-start, process 2358
                        main process 2345
                    (stop) pre-stop, (main) process 3456

       list [PATTERN]
              Requests a list of the  known  jobs  and  their  statuses.   The
              optional  pattern  may contain the usual shell wildcard and glob
              characters, if omitted all known jobs are returned.

              See status for a description of the output format.

       emit EVENT
              Requests that the named event be  emitted,  potentially  causing
              jobs to be started and stopped.  The event information is output
              once handling begins followed by each job status changed  caused
              by the event until handling is finished.

                fstab-device-added hda1
                    FSTAB_FSNAME=/dev/hda1
                    FSTAB_DIR=/
                    FSTAB_TYPE=ext3
                    FSTAB_OPTS=default

              The  event  name is given first followed by each argument to the
              event separated by a space.  Consecutive lines are indented  and
              give  the environment variables passed to any job changed by the
              event.

              See status for a description of the output format  for  the  job
              status changes.

       jobs   Requests  notification  of  all job state changes be sent to the
              Changes the minimum priority of messages logged by the init dae‐
              mon.

              PRIORITY  may  be  one  of  debug, info, message, warn, error or
              fatal.

AUTHOR
       Written by Scott James Remnant.

REPORTING BUGS
       Report bugs at https://launchpad.net/products/upstart/+bugs

COPYRIGHT
       Copyright © 2007 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
       init(8) telinit(8)



Upstart                           March 2007                        initctl(8)
--TechZilla