From 75c1645ab09a12338af5fd561dace177dc4693e2 Mon Sep 17 00:00:00 2001 From: Gerrit Pape Date: Sun, 16 Apr 2006 12:28:49 +0000 Subject: 1.5.0. --- doc/install.html | 12 ++++----- doc/replaceinit.html | 4 +-- doc/runsvdir.8.html | 54 ++++++++++++++++++++------------------ doc/svlogd.8.html | 74 +++++++++++++++++++++++++++------------------------- doc/upgrade.html | 4 +++ 5 files changed, 79 insertions(+), 69 deletions(-) (limited to 'doc') diff --git a/doc/install.html b/doc/install.html index b7b2e51..0c7651f 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.4.1.tar.gz into /package +runit-1.5.0.tar.gz into /package and unpack the archive 
  # cd /package
- # gunzip runit-1.4.1.tar
- # tar -xpf runit-1.4.1.tar
- # rm runit-1.4.1.tar
- # cd admin/runit-1.4.1
+ # gunzip runit-1.5.0.tar
+ # tar -xpf runit-1.5.0.tar
+ # rm runit-1.5.0.tar
+ # cd admin/runit-1.5.0
On MacOSX, do 
@@ -43,7 +43,7 @@ hierarchy, do:
To report success: 
- # mail pape-runit-1.4.1@smarden.org <compile/sysdeps
+ # mail pape-runit-1.5.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 82929ba..a669ad4 100644 --- a/doc/replaceinit.html +++ b/doc/replaceinit.html @@ -116,7 +116,7 @@ default Unix process no 1 runit. To report success: 
- # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.4.1@smarden.org
+ # ( uname -a ; cat /etc/runit/[123] ) |mail pape-runit-1.5.0@smarden.org
@@ -205,7 +205,7 @@ This will cause runit to enter stage 3 which runs

To report success: 

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

Step 5: Service migration

The goal is to migrate all services from /etc/rc.* scheme to the diff --git a/doc/runsvdir.8.html b/doc/runsvdir.8.html index 14faa1e..f4053db 100644 --- a/doc/runsvdir.8.html +++ b/doc/runsvdir.8.html @@ -17,42 +17,44 @@ runsvdir - starts and monitors a collection of runsv(8) processes dir must be a directory. log is a space holder for a readproctitle log, and must be at least seven characters long or absent.

-runsvdir starts a runsv(8) process for each subdirectory in the -services directory dir, up to a limit of 1000 subdirectories. runsvdir skips -subdirectory names starting with dots. runsv(8) must be in runsvdir’s PATH. +runsvdir starts a runsv(8) process for each subdirectory, or symlink +to a directory, in the services directory dir, up to a limit of 1000 subdirectories, +and restarts a runsv(8) process if it terminates. runsvdir skips subdirectory +names starting with dots. runsv(8) must be in runsvdir’s PATH.

+At least every +five seconds runsvdir checks whether the time of last modification, the +inode, or the device, of the services directory dir has changed. If so, +it re-scans the service directory, and if it sees a new subdirectory, or +new symlink to a directory, in dir, it starts a new runsv(8) process; if +runsvdir sees a subdirectory being removed that was previously there, it +sends the corresponding runsv(8) process a TERM signal, stops monitoring +this process, and so does not restart the runsv(8) process if it exits.

-At least every five seconds runsvdir checks whether the services directory -dir has changed. If it sees a new subdirectory in dir, it starts a new runsv(8) -process. If it sees an old sudirectory where a runsv(8) process has exited, -it restarts the runsv(8) process. If runsvdir sees a subdirectory being -removed that was previously there, it sends the corresponding runsv(8) -process a TERM signal, stops monitoring this process, and so does not restart -the runsv(8) process if it exits.

-If the log argument is given to runsvdir, -all output to standard error is redirected to this log, which is similar -to the daemontools’ readproctitle log. To see the most recent error messages, -use a process-listing tool such as ps(1). runsvdir writes a dot to the readproctitle -log every 15 minutes so that old error messages expire. +If the log argument is given to runsvdir, all output to standard error +is redirected to this log, which is similar to the daemontools’ readproctitle +log. To see the most recent error messages, use a process-listing tool such +as ps(1). runsvdir writes a dot to the readproctitle log every 15 minutes +so that old error messages expire.

Options

-P
-
use setsid(2) -to run each runsv(8) process in a new session and separate process group. -
+
use setsid(2) to run each runsv(8) +process in a new session and separate process group.

Signals

-If runsvdir receives a TERM signal, it exits with 0 immediately. -

-If runsvdir receives a HUP signal, it sends a TERM signal to each runsv(8) -process it is monitoring and then exits with 111. +If runsvdir +receives a TERM signal, it exits with 0 immediately.

+If runsvdir receives +a HUP signal, it sends a TERM signal to each runsv(8) process it is monitoring +and then exits with 111.

See Also

-sv(8), runsv(8), -runsvchdir(8), runit(8), runit-init(8), chpst(8), svlogd(8), utmpset(8), -setsid(2)

-http://smarden.org/runit/ +sv(8), runsv(8), runsvchdir(8), runit(8), +runit-init(8), chpst(8), svlogd(8), utmpset(8), setsid(2)

+http://smarden.org/runit/ +

Author

Gerrit Pape <pape@smarden.org>

diff --git a/doc/svlogd.8.html b/doc/svlogd.8.html index d85ed79..196059a 100644 --- a/doc/svlogd.8.html +++ b/doc/svlogd.8.html @@ -70,58 +70,62 @@ On startup, and after receiving a HUP signal, svlogd checks for each log directory log if the configuration file log/config exists, and if so, reads the file line by line and adjusts configuration for log as follows:

-If the line is empty, less than two characters long, or starts -with a ‘‘#’’, it is ignored. A line of the form +If the line is empty, or starts with a ‘‘#’’, it is ignored. A line +of the form

ssize
-
sets the maximum file -size of current when svlogd should rotate the current log file to size -bytes. Default is 1000000. If size is zero, svlogd doesn’t rotate log files. -You should set size to at least (2 * len).
+
sets the maximum file size of current when svlogd should +rotate the current log file to size bytes. Default is 1000000. If size is +zero, svlogd doesn’t rotate log files. You should set size to at least (2 +* len).
nnum
-
sets the number of old log -files svlogd should maintain to num. If svlogd sees more that num old log -files in log after log file rotation, it deletes the oldest one. Default -is 10. If num is zero, svlogd doesn’t remove old log files.
+
sets the number of old log files svlogd should maintain to +num. If svlogd sees more that num old log files in log after log file rotation, +it deletes the oldest one. Default is 10. If num is zero, svlogd doesn’t remove +old log files.
Nmin
-
sets the -minimum number of old log files svlogd should maintain to min. min must -be less than num. If min is set, and svlogd cannot write to current because -the filesystem is full, and it sees more than min old log files, it deletes -the oldest one.
+
sets the minimum number of old log files svlogd should +maintain to min. min must be less than num. If min is set, and svlogd cannot +write to current because the filesystem is full, and it sees more than +min old log files, it deletes the oldest one.
ttimeout
-
sets the maximum age of the current log file when -svlogd should rotate the current log file to timeout seconds. If current -is timeout seconds old, and is not empty, svlogd forces log file rotation. -
+
sets the maximum +age of the current log file when svlogd should rotate the current log file +to timeout seconds. If current is timeout seconds old, and is not empty, +svlogd forces log file rotation.
!processor
-
tells svlogd to feed each recent log file through processor -(see above) on log file rotation. By default log files are not processed. -
+
tells svlogd to feed each recent +log file through processor (see above) on log file rotation. By default +log files are not processed.
ua.b.c.d[:port]
-
tells svlogd to transmit the first len characters of selected -log messages to the IP address a.b.c.d, port number port. If port isn’t set, -the default port for syslog is used (514). len can be set through the -l -option, see below. If svlogd has trouble sending udp packets, it writes -error messages to the log directory. Attention: logging through udp is unreliable, -and should be used in private networks only.
+
tells svlogd to transmit the first +len characters of selected log messages to the IP address a.b.c.d, port number +port. If port isn’t set, the default port for syslog is used (514). len can +be set through the -l option, see below. If svlogd has trouble sending udp +packets, it writes error messages to the log directory. Attention: logging +through udp is unreliable, and should be used in private networks only. +
Ua.b.c.d[:port]
-
is the same as -the u line above, but the log messages are no longer written to the log -directory, but transmitted through udp only. Error messages from svlogd -concerning sending udp packages still go to the log directory.
+
is the same as the u line above, but the log messages are +no longer written to the log directory, but transmitted through udp only. +Error messages from svlogd concerning sending udp packages still go to +the log directory.
+ +
pprefix
+
tells svlogd to prefix each line to be written +to the log directory, to standard error, or through UDP, with prefix.

-If a line -starts with a -, +, e, or E, svlogd matches the first len characters of -each log message against pattern and acts accordingly: +If +a line starts with a -, +, e, or E, svlogd matches the first len characters +of each log message against pattern and acts accordingly:

-pattern
diff --git a/doc/upgrade.html b/doc/upgrade.html index 15e3f88..24b34a3 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -9,6 +9,10 @@

runit - upgrading from previous versions

+

1.4.0 or 1.4.1 to 1.5.0

+The svlogd program supports a new configuration +option p to optionally prefix each line written to logs, standard error, or +through UDP with a string, and no longer strips empty lines from the logs.

1.3.x to 1.4.0 or 1.4.1

With this version the runsvctrl, runsvstat, svwaitdown, and svwaitup programs no longer are being -- cgit 1.4.1