diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/runsvctrl.8 | 121 | ||||
-rw-r--r-- | man/runsvstat.8 | 70 | ||||
-rw-r--r-- | man/svwaitdown.8 | 110 | ||||
-rw-r--r-- | man/svwaitup.8 | 103 |
4 files changed, 0 insertions, 404 deletions
diff --git a/man/runsvctrl.8 b/man/runsvctrl.8 deleted file mode 100644 index b653791..0000000 --- a/man/runsvctrl.8 +++ /dev/null @@ -1,121 +0,0 @@ -.TH runsvctrl 8 -.SH NAME -runsvctrl \- controls a service monitored by -.BR runsv (8). -.SH SYNOPSIS -.B runsvctrl -.I command -.I services -.SH DESCRIPTION -.I services -consists of one or more arguments, each argument naming a directory used by -.BR runsv (8). -.I command -is one of up, down, once, pause, cont, hup, alarm, interrupt, 1, 2, term, -kill, or exit. -.P -For each -.I service -of -.IR services , -.B runsvctrl -sends the command -.I command -to the -.IR service , -which must be controlled by -.BR runsv (8). -.SH COMMANDS -.TP -.B up -If the service is not running, start it. -If the service stops, restart it. -.TP -.B 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. -.TP -.B once -If the service is not running, start it. -Do not restart it if it stops. -.TP -.B pause -If the service is running, send it a STOP signal. -.TP -.B cont -If the service is running, send it a CONT signal. -.TP -.B hup -If the service is running, send it a HUP signal. -.TP -.B alarm -If the service is running, send it a ALRM signal. -.TP -.B interrupt -If the service is running, send it a INT signal. -.TP -.B quit -If the service is running, send it a QUIT signal. -.TP -.B 1 -If the service is running, send it a USR1 signal. -.TP -.B 2 -If the service is running, send it a USR2 signal. -.TP -.B term -If the service is running, send it a TERM signal. -.TP -.B kill -If the service is running, send it a KILL signal. -.TP -.B 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, -.BR 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, -.BR runsv (8) -exits. -This command is ignored if it is given to -.IR service /log/supervise/control. -.P -.BR runsvctrl -actually looks only at the first character of -.IR command . -.SH EXIT CODES -.B runsvctrl -exits 0, if the -.I command -was sent successfully to all -.IR services . -.P -For each -.I service -that caused an error (e.g. the directory is not controlled by a -.BR runsv (8) -process), -.B runsvctrl -increases the exit code by one and exits non zero. -The maximum is 100. -.P -.B runsvctrl -exits 111 on error. -.SH SEE ALSO -sv(8), -runsv(8), -chpst(8), -svlogd(8), -runit(8), -runit-init(8), -runsvdir(8), -runsvchdir(8), -runsvstat(8) -.P -http://smarden.org/runit/ -.SH AUTHOR -Gerrit Pape <pape@smarden.org> diff --git a/man/runsvstat.8 b/man/runsvstat.8 deleted file mode 100644 index e6ac2e1..0000000 --- a/man/runsvstat.8 +++ /dev/null @@ -1,70 +0,0 @@ -.TH runsvstat 8 -.SH NAME -runsvstat \- prints the status of services monitored by -.BR runsv (8). -.SH SYNOPSIS -.B runsvstat -[ -.B \-l -] -.I services -.SH DESCRIPTION -.I services -consists of one or more arguments, each argument naming a directory. -.P -.B runsvstat -checks for each directory if -.BR runsv (8) -is successfully running this -.IR service , -and if so, prints one human-readable line reporting the status of this -.IR service . -Optionally -.BR runsvstat (8) -prints a second line, also in human-readable format, reporting the status -of the corresponding -.I log -.IR service . -.SH OPTIONS -.TP -.B \-l -log service. -Check for each -.I service -if there exists a corresponding -.I log -.IR service . -If so, print an additional, indented, line reporting the status of the -.I log -.IR service . -.SH EXIT CODES -.B runsvstat -exits 0, if the states of all -.I services -were reported successfully. -.P -For each -.I service -that caused an error (e.g. the directory is not controlled by a -.BR runsv (8) -process), -.B runsvstat -increases the exit code by one and exits non zero. -The maximum is 100. -.P -.B runsvstat -exits 111 on error. -.SH SEE ALSO -sv(8), -runsv(8), -chpst(8), -svlogd(8), -runit(8), -runit-init(8), -runsvdir(8), -runsvchdir(8), -runsvctrl(8) -.P -http://smarden.org/runit/ -.SH AUTHOR -Gerrit Pape <pape@smarden.org> diff --git a/man/svwaitdown.8 b/man/svwaitdown.8 deleted file mode 100644 index e224b3c..0000000 --- a/man/svwaitdown.8 +++ /dev/null @@ -1,110 +0,0 @@ -.TH svwaitdown 8 -.SH NAME -svwaitdown \- waits for services controlled by runsv(8) to be down -.SH SYNOPSIS -.B svwaitdown -[ -.B \-v -] [ -.B \-k -] [ -.B \-t -.I sec -] -.I services -.SH DESCRIPTION -.I services -consists of one or more arguments, each argument naming a service directory. -.P -.B svwaitdown -sends each -.I service -given at the command line the ``down'' command, and waits for it to become -down. -The -.I services -given at the command line must be controlled by -.BR runsv (8). -.P -.B svwaitdown -blocks, limited by a -.IR timeout , -until all -.I services -are down or reports errors. -.SH OPTIONS -.TP -.B \-v -verbose. -Print verbose messages to stderr. -.TP -.B \-t \fIsec -Set the timeout for waiting for -.I services -to become down to -.I sec -seconds. -.I sec -must be between 1 and 6000. Default is 600 (10 minutes). -.TP -.B \-k -Kill. -If the timeout is reached before all -.I services -are down, tell the -.BR runsv (8) -processes to send the -.I services -a KILL signal. -.TP -.B \-x -Exit. -Send each -.I service -the ``exit'' command additionally to the ``down'' command, and wait for the -corresponding -.BR runsv (8) -processes to exit instead for the -.I services -to be down. -.SH EXIT CODES -.B svwaitdown -returns 0 as soon as all -.I services -are down. -.P -If a -.I service -is usually controlled by -.B runsv (8), -but no supervisor process is currently running in the directory, -.B svwaitdown -treats this -.I service -as if it would be down. -.P -For each -.I service -that causes an error while checking, -.B svwaitdown -increases the exit code by one and exits non zero. -The maximum is 100. -.P -.B svwaitdown -returns 111 on error, or if the timeout -.I sec -was reached. -.SH SEE ALSO -sv(8), -runsv(8), -chpst(8), -svlogd(8), -runit(8), -runit-init(8), -runsvdir(8), -runsvchdir(8), -svwaitup(8) -.P -http://smarden.org/runit/ -.SH AUTHOR -Gerrit Pape <pape@smarden.org> diff --git a/man/svwaitup.8 b/man/svwaitup.8 deleted file mode 100644 index badfb22..0000000 --- a/man/svwaitup.8 +++ /dev/null @@ -1,103 +0,0 @@ -.TH svwaitup 8 -.SH NAME -svwaitup \- waits for services controlled by runsv(8) to be up -.SH SYNOPSIS -.B svwaitup -[ -.B \-v -] -[ -.B \-s -.I sec -] -.I services -.SH DESCRIPTION -.I services -consists of one or more arguments, each argument naming a service directory. -.P -.B svwaitup -checks each -.I service -given at the command line for being at least the specified number of seconds -.I sec -up. -The -.I services -given at the command line must be controlled by -.BR runsv (8). -.P -.B svwaitup -blocks until all -.I services -were up and running at least -.I sec -seconds when -.B svwaitup -was checking or reports errors. -.SH OPTIONS -.TP -.B \-v -verbose. -Print verbose messages to stderr. -.TP -.B \-s \fIsec -Set the minimum number of seconds each -.I service -has to be up to -.I sec -seconds. -.I sec -must be between 1 and 600. -Default is 2. -.SH EXIT CODES -.B svwaitup -returns 0 as soon as all -.I services -were at least -.I sec -seconds up. -.P -.BR Note : -If -.B svwaitup -exits 0, it does not guarantee that all -.I services -are actually running. -A -.I service -could have crashed immediatly after -.B svwaitup -was successfully checking it to be up -.I sec -seconds. -.I services -should be designed not to rely on -.B svwaitup -to resolve dependencies. -.P -For each -.I service -that is down and not requested to become up, or that causes an error while -checking (e.g. -.BR runsv (8) -is not running), -.B svwaitup -increases the exit code by one and exits non zero. -The maximum is 100. -.P -.B svwaitup -returns 111 on error. -.SH SEE ALSO -sv(8), -runsv(8), -chpst(8), -svlogd(8), -runit(8), -runit-init(8), -runsvdir(8), -runsvchdir(8), -svwaitdown(8) -.P -http://smarden.org/runit/ -.SH AUTHOR -Gerrit Pape <pape@smarden.org> |