From 2b973a642eafc9c79ef4bae6e1472d11e5fcf811 Mon Sep 17 00:00:00 2001 From: Gerrit Pape Date: Mon, 5 May 2008 22:02:22 +0000 Subject: version 1.9.0. --- doc/install.html | 12 +++--- doc/replaceinit.html | 4 +- doc/runsvchdir.8.html | 8 ++-- doc/sv.8.html | 117 +++++++++++++++++++++++++------------------------- 4 files changed, 71 insertions(+), 70 deletions(-) (limited to 'doc') diff --git a/doc/install.html b/doc/install.html index eb19e43..1c8e505 100644 --- a/doc/install.html +++ b/doc/install.html @@ -17,14 +17,14 @@ If you don't have a /package directory, create it now: # chmod 1755 /package Download -runit-1.8.0.tar.gz into /package +runit-1.9.0.tar.gz into /package and unpack the archive 
  # cd /package
- # gunzip runit-1.8.0.tar
- # tar -xpf runit-1.8.0.tar
- # rm runit-1.8.0.tar
- # cd admin/runit-1.8.0
+ # gunzip runit-1.9.0.tar
+ # tar -xpf runit-1.9.0.tar
+ # rm runit-1.9.0.tar
+ # cd admin/runit-1.9.0
On MacOSX, do 
@@ -43,7 +43,7 @@ hierarchy, do:
To report success: 
- # mail pape-runit-1.8.0@smarden.org <compile/sysdeps
+ # mail pape-runit-1.9.0@smarden.org <compile/sysdeps
If you use runit regularly, please contribute to the project. diff --git a/doc/replaceinit.html b/doc/replaceinit.html index 010d064..aad85ff 100644 --- a/doc/replaceinit.html +++ b/doc/replaceinit.html @@ -122,7 +122,7 @@ default Unix process no 1 runit. To report success: 
- # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.8.0@smarden.org
+ # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.9.0@smarden.org
@@ -211,7 +211,7 @@ This will cause runit to enter stage 3 which runs

To report success: 

- # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.8.0@smarden.org
+ # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.9.0@smarden.org

Step 5: Service migration

The goal is to migrate all services from /etc/rc.* scheme to the diff --git a/doc/runsvchdir.8.html b/doc/runsvchdir.8.html index ea3e585..54e66a5 100644 --- a/doc/runsvchdir.8.html +++ b/doc/runsvchdir.8.html @@ -20,11 +20,11 @@ If dir does not start with a slash, it is searched in /etc/runit/runsvdir runsvchdir switches to the directory /etc/runit/runsvdir/, copies current to previous, and replaces current with a symlink pointing to dir.

-Normally /service is a symlink to current, and runsvdir(8) -is running /service/. +Normally /service is a symlink to current, and runsvdir(8) is running +/service/.

Exit Codes

-runsvchdir prints an error message and -exits 111 on error. runsvchdir exits 0 on success. +runsvchdir prints an error message and exits 111 on +error. runsvchdir exits 0 on success.

Files

/etc/runit/runsvdir/previous
/etc/runit/runsvdir/current
diff --git a/doc/sv.8.html b/doc/sv.8.html index 1fb4d84..f8c6b26 100644 --- a/doc/sv.8.html +++ b/doc/sv.8.html @@ -20,88 +20,89 @@ The monitored by the runsv(8) supervisor.

services consists of one or more arguments, each argument naming a directory service used by runsv(8). If service doesn’t -start with a dot or slash, it is searched in the default services directory -/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’’. +start with a dot or slash and doesn’t end with a slash, it is searched in +the default services directory /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.
+
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.
+
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 exits, start ./finish if it exists. After it -stops, do not restart service.
+
If the service +is running, send it the TERM signal, and the CONT 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.
+
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.
+
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) -exits. If the service is down and a log service exists, send the TERM signal -to the log service. If the log service is down, runsv(8) exits. This command -is ignored if it is given to an appendant log service.
+
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) exits. If the service is down and a +log service exists, send the TERM signal to the log service. If the log +service is down, runsv(8) exits. This command is ignored if it is given +to an appendant log service.

-sv actually looks -only at the first character of these commands. -

Commands compatible to LSB -init script actions

+sv actually looks only at the first character +of these commands. +

Commands compatible to LSB init script actions

-
status
+
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.
+
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.
+
Same as down, but wait up to 7 seconds for the service to become +down. Then report the status or timeout.
-
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.
+
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) process to terminate. Then report the status or timeout.
+
Same as exit, but wait up to 7 seconds for the runsv(8) +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-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
@@ -160,9 +161,9 @@ implies -v. default services directory /service/.
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.
+
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

-- cgit 1.4.1