diff options
author | Gerrit Pape <pape@smarden.org> | 2008-04-20 20:47:39 +0000 |
---|---|---|
committer | Gerrit Pape <pape@smarden.org> | 2008-04-20 20:48:13 +0000 |
commit | 29c4521100d47a589c89ef3145db61f9e4a00cf9 (patch) | |
tree | b507e644dbeb58afa4eecec9874d24e02e4fc43e /doc | |
parent | ed673f8f525aead9418d34faea94b83c71b4eaa7 (diff) | |
download | runit-29c4521100d47a589c89ef3145db61f9e4a00cf9.tar.gz runit-29c4521100d47a589c89ef3145db61f9e4a00cf9.tar.xz runit-29c4521100d47a589c89ef3145db61f9e4a00cf9.zip |
* change default directory for services from /var/service/ to /service/.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/benefits.html | 2 | ||||
-rw-r--r-- | doc/faq.html | 8 | ||||
-rw-r--r-- | doc/replaceinit.html | 8 | ||||
-rw-r--r-- | doc/runlevels.html | 14 | ||||
-rw-r--r-- | doc/runscripts.html | 2 | ||||
-rw-r--r-- | doc/runsv.8.html | 4 | ||||
-rw-r--r-- | doc/runsvchdir.8.html | 4 | ||||
-rw-r--r-- | doc/sv.8.html | 4 | ||||
-rw-r--r-- | doc/useinit.html | 4 | ||||
-rw-r--r-- | doc/utmpset.8.html | 2 |
10 files changed, 26 insertions, 26 deletions
diff --git a/doc/benefits.html b/doc/benefits.html index 57f0d94..193e734 100644 --- a/doc/benefits.html +++ b/doc/benefits.html @@ -149,7 +149,7 @@ sysvinit</a>. Stage 2 is packaging friendly: all a software package that provides a service needs to do is to include a <i>service directory</i> in the package, and to provide a symbolic link -to this directory in <tt>/var/service/</tt>. +to this directory in <tt>/service/</tt>. The service will be started within five seconds, and automatically at boot time. The package's install and update scripts can use the reliable control diff --git a/doc/faq.html b/doc/faq.html index 7fdf734..a2eae27 100644 --- a/doc/faq.html +++ b/doc/faq.html @@ -216,12 +216,12 @@ How do I tell runit about the new service directory, so that it picks up and runs the service by default? <p> Answer: -Create a symbolic link in <tt>/var/service/</tt> pointing to the service +Create a symbolic link in <tt>/service/</tt> pointing to the service directory, runit will pick up the service within the next five seconds, and automatically start it on system boot. E.g.: <pre> - # ln -s /etc/sv/getty-2 /var/service/ + # ln -s /etc/sv/getty-2 /service/ </pre> <hr> @@ -283,13 +283,13 @@ supervision. How do I tell runit? <p> Answer: -Remove the symbolic link in <tt>/var/service/</tt> pointing to the service +Remove the symbolic link in <tt>/service/</tt> pointing to the service directory, runit recognizes the removed service within the next five seconds, then stops the service, the optional log service, and finally the supervisor process. E.g.: <pre> - # rm /var/service/getty-2 + # rm /service/getty-2 </pre> <hr> diff --git a/doc/replaceinit.html b/doc/replaceinit.html index b154dd3..010d064 100644 --- a/doc/replaceinit.html +++ b/doc/replaceinit.html @@ -52,8 +52,8 @@ running any getty (edit <tt>/etc/inittab</tt> and <tt>kill -HUP 1</tt> if needed), and tell <a href="runsvdir.8.html">runsvdir</a> about the getty-5 <i>service</i>: <pre> - # mkdir -p /var/service - # ln -s /etc/sv/getty-5 /var/service/ + # mkdir -p /service + # ln -s /etc/sv/getty-5 /service/ </pre> Start <i>runit</i>'s stage 2 for testing: <pre> @@ -177,8 +177,8 @@ FreeBSD 4.4: and tell <a href="runsvdir.8.html">runsvdir</a> about the <tt>getty-5</tt> <i>service</i>: <pre> - # mkdir -p /var/service - # ln -s /etc/sv/getty-5 /var/service/ + # mkdir -p /service + # ln -s /etc/sv/getty-5 /service/ </pre> Start <i>runit</i>'s stage 2 for testing: <pre> diff --git a/doc/runlevels.html b/doc/runlevels.html index b2a5604..c0e49c3 100644 --- a/doc/runlevels.html +++ b/doc/runlevels.html @@ -25,17 +25,17 @@ Create the following directories and symbolic links: # ln -s /etc/sv/getty-5 /etc/runit/runsvdir/single/ # ln -s default /etc/runit/runsvdir/current </pre> -Copy the contents of <tt>/var/service/</tt> to -<tt>/etc/runit/runsvdir/current/</tt> and replace <tt>/var/service/</tt> +Copy the contents of <tt>/service/</tt> to +<tt>/etc/runit/runsvdir/current/</tt> and replace <tt>/service/</tt> with a symbolic link: <pre> - # cp -pR /var/service/* /etc/runit/runsvdir/current/ - # mv -f /var/service /var/service.old && \ - ln -s /etc/runit/runsvdir/current /var/service + # cp -pR /service/* /etc/runit/runsvdir/current/ + # mv -f /service /service.old && \ + ln -s /etc/runit/runsvdir/current /service </pre> You have now created two runlevels: <tt>default</tt> and <tt>single</tt>. The <tt>current</tt> runlevel is <tt>default</tt>. -It is safe to remove <tt>/var/service.old/</tt> if you don't need it anymore. +It is safe to remove <tt>/service.old/</tt> if you don't need it anymore. <p> Finally edit <tt>/etc/runit/2</tt> to set the <tt>default</tt> runlevel when stage 2 starts: @@ -47,7 +47,7 @@ stage 2 starts: <b>runsvchdir default >/dev/null</b> exec env - PATH=$PATH \ - runsvdir /var/service 'log: ...........................................................................................................................................................................................................................................................................................................................................................................................................' + runsvdir /service 'log: ...........................................................................................................................................................................................................................................................................................................................................................................................................' </pre> <hr> <a name="switch"><h3>Switching runlevels</h3></a> diff --git a/doc/runscripts.html b/doc/runscripts.html index aa275ce..f832b63 100644 --- a/doc/runscripts.html +++ b/doc/runscripts.html @@ -390,7 +390,7 @@ to be set up. <pre> #!/bin/sh exec 2>&1 - sv start /var/service/portmap || exit 1 + sv start /service/portmap || exit 1 exec famd -T 0 -f </pre> <hr> diff --git a/doc/runsv.8.html b/doc/runsv.8.html index 91646e8..3f430f1 100644 --- a/doc/runsv.8.html +++ b/doc/runsv.8.html @@ -108,9 +108,9 @@ command is ignored if it is given to <i>service</i>/log/supervise/control. </dd> <p> Example: to send a TERM signal to the socklog-unix service, either do # sv term -/var/service/socklog-unix<br> +/service/socklog-unix<br> or<br> - # printf t >/var/service/socklog-unix/supervise/control<br> + # printf t >/service/socklog-unix/supervise/control<br> <p> <i><b>printf</b>(1)</i> usually blocks if no <b>runsv</b> process is running in the service directory. diff --git a/doc/runsvchdir.8.html b/doc/runsvchdir.8.html index d9a6e43..ea3e585 100644 --- a/doc/runsvchdir.8.html +++ b/doc/runsvchdir.8.html @@ -20,8 +20,8 @@ If <i>dir</i> does not start with a slash, it is searched in /etc/runit/runsvdir <b>runsvchdir</b> switches to the directory <i>/etc/runit/runsvdir/</i>, copies <i>current</i> to <i>previous</i>, and replaces <i>current</i> with a symlink pointing to <i>dir</i>. <p> -Normally <i>/var/service</i> is a symlink to <i>current</i>, and <i><b>runsvdir</b>(8)</i> -is running <i>/var/service/</i>. +Normally <i>/service</i> is a symlink to <i>current</i>, and <i><b>runsvdir</b>(8)</i> +is running <i>/service/</i>. <h2><a name='sect3'>Exit Codes</a></h2> <b>runsvchdir</b> prints an error message and exits 111 on error. <b>runsvchdir</b> exits 0 on success. diff --git a/doc/sv.8.html b/doc/sv.8.html index fc688b5..1fb4d84 100644 --- a/doc/sv.8.html +++ b/doc/sv.8.html @@ -21,7 +21,7 @@ monitored by the <i><b>runsv</b>(8)</i> supervisor. <p> <i>services</i> consists of one or more arguments, each argument naming a directory <i>service</i> used by <i><b>runsv</b>(8)</i>. If <i>service</i> doesn’t start with a dot or slash, it is searched in the default services directory -<i>/var/service/</i>, otherwise relative to the current directory. <p> +<i>/service/</i>, otherwise relative to the current directory. <p> <i>command</i> 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, @@ -157,7 +157,7 @@ implies <i>-v</i>. </dd> <dt><b>SVDIR</b> </dt> <dd>The environment variable $SVDIR overrides the -default services directory <i>/var/service/</i>. </dd> +default services directory <i>/service/</i>. </dd> <dt><b>SVWAIT</b> </dt> <dd>The environment variable diff --git a/doc/useinit.html b/doc/useinit.html index eb420b9..58adec2 100644 --- a/doc/useinit.html +++ b/doc/useinit.html @@ -21,10 +21,10 @@ adding <tt>/sbin/runsvdir-start</tt> to the system's <tt>StartupItems</tt>. <p> In any case, you first need to copy the <i>stage 2</i> script to <tt>/sbin/runsvdir-start</tt>, and create the services directory -<tt>/var/service/</tt>: +<tt>/service/</tt>: <pre> # install -m0750 /package/admin/runit/etc/2 /sbin/runsvdir-start - # mkdir -p /var/service + # mkdir -p /service </pre> <hr> <a href="#sysv">How to use with sysvinit and inittab</a><br> diff --git a/doc/utmpset.8.html b/doc/utmpset.8.html index f433c3e..3b96cb6 100644 --- a/doc/utmpset.8.html +++ b/doc/utmpset.8.html @@ -23,7 +23,7 @@ update the utmp file, the <i><b>getty</b>(8)</i> processes are handled the same other services. <p> To enable local login accounting, add <b>utmpset</b> to the <i><b>getty</b>(8)</i> <i>finish</i> scripts, e.g.: <p> - $ cat /var/service/getty-5/finish<br> + $ cat /service/getty-5/finish<br> #!/bin/sh<br> exec utmpset -w tty5<br> $<br> |