# man > sv(8)

[_sv_(8)](https://www.chedong.com/phpMan.php/man/sv/8/markdown)                                  System Manager's Manual                                 [_sv_(8)](https://www.chedong.com/phpMan.php/man/sv/8/markdown)

## NAME
       sv - control and manage services monitored by [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown)

## SYNOPSIS
       **sv **[-v] [-w _sec_] _command_ _services_

       **/etc/init.d/_**service_ [-w _sec_] _command_

## DESCRIPTION
       The **sv **program reports the current status and controls the state of services monitored by the
       [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown) supervisor.

       _services_  consists of one or more arguments, each argument naming a directory _service_ used by
       [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown).  If _service_ doesn't start with a dot or slash and doesn't end with a slash,  it  is
       searched  in  the default services directory _/etc/service/_, otherwise relative to the current
       directory.

       _command_ is one of up, down, status, once, pause, cont, hup, alarm,  interrupt,  1,  2,  term,
       kill,  or  exit,  or start, stop, restart, shutdown, force-stop, force-reload, force-restart,
       force-shutdown.

       The **sv **program can be sym-linked to _/etc/init.d/_ to provide an  LSB  init  script  interface.
       The _service_ to be controlled then is specified by the base name of the ``init script''.

## COMMANDS
       **status **Report  the current status of the service, and the appendant log service if available,
              to standard output.

       **up     **If the service is not running, start it.  If the service stops, restart it.

       **down   **If the service is running, send it the TERM signal, and the CONT signal.  If ./run ex‐
              its, start ./finish if it exists.  After it stops, do not restart service.

       **once   **If the service is not running, start it.  Do not restart it if it stops.

### pause cont hup alarm interrupt quit 1 2 term kill
              If the service is running, send it the STOP, CONT, HUP, ALRM, INT, QUIT,  USR1,  USR2,
              TERM, or KILL signal respectively.

       **exit   **If  the  service  is  running,  send  it the TERM signal, and the CONT signal.  Do not
              restart the service.  If the service is down, and no log service exists, [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown)  ex‐
              its.   If  the  service is down and a log service exists, [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown) closes the standard
              input of the log service and waits for it to terminate.  If the log service  is  down,
              [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown) exits.  This command is ignored if it is given to an appendant log service.

       **sv **actually looks only at the first character of these _command_s.

### Commands compatible to LSB init script actions
       **status **Same as _status_.

       **start  **Same  as _up_, but wait up to 7 seconds for the command to take effect.  Then report the
              status or timeout.  If the script _./check_ exists in the  service  directory,  **sv  **runs
              this  script  to  check whether the service is up and available; it's considered to be
              available if _./check_ exits with 0.

       **stop   **Same as _down_, but wait up to 7 seconds for the service to become  down.   Then  report
              the status or timeout.

       **reload **Same as _hup_, and additionally report the status afterwards.

### restart
              Send  the commands _term_, _cont_, and _up_ to the service, and wait up to 7 seconds for the
              service to restart.  Then report the status or timeout.  If the script _./check_  exists
              in  the  service directory, **sv **runs this script to check whether the service is up and
              available again; it's considered to be available if _./check_ exits with 0.

### shutdown
              Same as _exit_, but wait up to 7 seconds for the [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown) process  to  terminate.   Then
              report the status or timeout.

### force-stop
              Same  as  _down_,  but wait up to 7 seconds for the service to become down.  Then report
              the status, and on timeout send the service the _kill_ command.

### force-reload
              Send the service the _term_ and _cont_ commands, and wait up to 7 seconds for the  service
              to restart.  Then report the status, and on timeout send the service the _kill_ command.

### force-restart
              Send the service the _term_, _cont_ and _up_ commands, and wait up to 7 seconds for the ser‐
              vice  to  restart.   Then  report the status, and on timeout send the service the _kill_
              command.  If the script _./check_ exists in the service directory, **sv **runs  this  script
              to  check  whether the service is up and available again; it's considered to be avail‐
              able if _./check_ exits with 0.

### force-shutdown
              Same as _exit_, but wait up to 7 seconds for the [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown) process  to  terminate.   Then
              report the status, and on timeout send the service the _kill_ command.

### try-restart
              if  the  service is running, send it the _term_ and _cont_ commands, and wait up to 7 sec‐
              onds for the service to restart.  Then report the status or timeout.


### Additional Commands
       **check  **Check for the service to be in the state that's been requested.  Wait up to 7  seconds
              for  the  service to reach the requested state, then report the status or timeout.  If
              the requested state of the service is _up_, and the script _./check_ exists in the service
              directory, **sv **runs this script to check whether the service is up  and  running;  it's
              considered to be up if _./check_ exits with 0.

## OPTIONS
### -v     
              the command to take effect.  Then report the status or timeout.

### -w _

## ENVIRONMENT
       **SVDIR  **The environment variable $SVDIR overrides the  default  services  directory  _/etc/ser‐_
              _vice/_.

       **SVWAIT **The environment variable $SVWAIT overrides the default 7 seconds to wait for a command
              to take effect.  It is overridden by the -w option.

## EXIT CODES
       **sv  **exits  0,  if  the  _command_ was successfully sent to all _services_, and, if it was told to
       wait, the _command_ has taken effect to all services.

       For each _service_ that caused an error (e.g. the directory is not  controlled  by  a  [**runsv**(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown)
       process,  or  **sv  **timed  out  while waiting), **sv **increases the exit code by one and exits non
       zero.  The maximum is 99.  **sv **exits 100 on error.

       If **sv **is called with a base name other than **sv**: it exits 1 on timeout or trouble sending  the
       command;  if the _command_ is **status**, it exits 3 if the service is down, and 4 if the status is
       unknown; it exits 2 on wrong usage, and 151 on error.

## SEE ALSO
       [runsv(8)](https://www.chedong.com/phpMan.php/man/runsv/8/markdown), [chpst(8)](https://www.chedong.com/phpMan.php/man/chpst/8/markdown), [svlogd(8)](https://www.chedong.com/phpMan.php/man/svlogd/8/markdown), [runsvdir(8)](https://www.chedong.com/phpMan.php/man/runsvdir/8/markdown), [runsvchdir(8)](https://www.chedong.com/phpMan.php/man/runsvchdir/8/markdown), [runit(8)](https://www.chedong.com/phpMan.php/man/runit/8/markdown), [runit-init(8)](https://www.chedong.com/phpMan.php/man/runit-init/8/markdown)

       <http://smarden.org/runit/>

## AUTHOR
       Gerrit Pape <<pape@smarden.org>>

                                                                                               [_sv_(8)](https://www.chedong.com/phpMan.php/man/sv/8/markdown)