G. Pape
runit
runsvctrl - controls a service monitored by runsv(8).
runsvctrl
command services
services consists of one or more arguments,
each argument naming a directory used by runsv(8). command is one of up,
down, once, pause, cont, hup, alarm, interrupt, 1, 2, term, kill, or exit.
For each service of services, runsvctrl sends the command command to the
service, which must be controlled by runsv(8).
- up
- If the service
is not running, start it. If the service stops, restart it.
- down
- If the service
is running, send it a TERM signal. If ./run exits, 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
- If the service is running,
send it a STOP signal.
- cont
- If the service is running, send it a CONT signal.
- hup
- If the service is running, send it a HUP signal.
- alarm
- If the service
is running, send it a ALRM signal.
- interrupt
- If the service is running,
send it a INT signal.
- quit
- If the service is running, send it a QUIT signal.
- 1
- If the service is running, send it a USR1 signal.
- 2
- If the service is running, send it a USR2 signal.
- term
- If the service is running, send it a TERM signal.
- kill
- If the service is running, send it a KILL signal.
- exit
- If the service
is running, send it a TERM signal. Do not restart the service. If the service
is down, and no log service exists, runsv(8) exits. If the service is down
and a log service exists, send a TERM signal to the log service. If the
log service is down, runsv(8) exits. This command is ignored if it is given
to service/log/supervise/control.
runsvctrl actually looks only at the first
character of command.
runsvctrl exits 0, if the command was sent
successfully to all services.
For each service that caused an error (e.g.
the directory is not controlled by a runsv(8) process), runsvctrl increases
the exit code by one and exits non zero. The maximum is 100.
runsvctrl exits
111 on error.
sv(8), runsv(8), chpst(8), svlogd(8), runit(8), runit-init(8),
runsvdir(8), runsvchdir(8), runsvstat(8)
http://smarden.org/runit/
Gerrit
Pape <pape@smarden.org>
Table of Contents