aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2026-06-09 05:27:48 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2026-06-09 05:27:48 +0000
commit958958d74337a6ddaf649968d188e768984100e0 (patch)
tree7f32dfc1bea9c4d010a344e130707e638620a0fc /doc
parent241d2079a25d77e090beb0b767984928dbbc8cd6 (diff)
downloads6-rc-958958d74337a6ddaf649968d188e768984100e0.tar.gz
Prepare for 0.6.2.0; implement s6-rc reload
Also support reload-signal in the service definition directory.
Diffstat (limited to 'doc')
-rw-r--r--doc/index.html6
-rw-r--r--doc/s6-rc-oneshot-run.html4
-rw-r--r--doc/s6-rc.html21
-rw-r--r--doc/upgrade.html3
4 files changed, 29 insertions, 5 deletions
diff --git a/doc/index.html b/doc/index.html
index ed486bf..426bdb5 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -55,7 +55,7 @@ requirement if you link against the shared version of the skalibs library. </li>
<li> <a href="//skarnet.org/software/execline/">execline</a> version
2.9.9.2 or later. It's a build-time <em>and</em> run-time requirement. </li>
<li> <a href="//skarnet.org/software/s6/">s6</a> version
-2.15.0.1 or later. It's a build-time <em>and</em> run-time requirement. </li>
+2.15.1.0 or later. It's a build-time <em>and</em> run-time requirement. </li>
</ul>
<h3> Licensing </h3>
@@ -69,8 +69,8 @@ requirement if you link against the shared version of the skalibs library. </li>
<ul>
<li> The current released version of s6-rc is
-<a href="s6-rc-0.6.1.2.tar.gz">0.6.1.2</a>.
-You can access its checksum <a href="s6-rc-0.6.1.2.tar.gz.sha256">here</a>. </li>
+<a href="s6-rc-0.6.2.0.tar.gz">0.6.2.0</a>.
+You can access its checksum <a href="s6-rc-0.6.2.0.tar.gz.sha256">here</a>. </li>
<li> Alternatively, you can checkout a copy of the
<a href="//git.skarnet.org/cgi-bin/cgit.cgi/s6-rc/">s6-rc
git repository</a>:
diff --git a/doc/s6-rc-oneshot-run.html b/doc/s6-rc-oneshot-run.html
index ee454ae..15f10aa 100644
--- a/doc/s6-rc-oneshot-run.html
+++ b/doc/s6-rc-oneshot-run.html
@@ -34,7 +34,7 @@ in internal scripts created by
<h2 id="interface"> Interface </h2>
<pre>
- s6-rc-oneshot-run [ -l <em>live</em> ] [ -b ] up|down <em>n</em>
+ s6-rc-oneshot-run [ -l <em>live</em> ] [ -b ] up|down|reload <em>n</em>
</pre>
<ul>
@@ -44,6 +44,8 @@ in the current compiled service database (i.e. the compiled linked from the
live directory). </li>
<li> <tt>up</tt> or <tt>down</tt> are run with the <tt>RC_NAME</tt>
environment variable set to the name of the service. </li>
+ <li> A <tt>reload</tt> command causes the <tt>up</tt> script to be run, with
+an additional <tt>RC_RELOAD</tt> environment variable containing 1. </li>
</ul>
<h2 id="options"> Options </h2>
diff --git a/doc/s6-rc.html b/doc/s6-rc.html
index a7eb9d9..bb16113 100644
--- a/doc/s6-rc.html
+++ b/doc/s6-rc.html
@@ -244,6 +244,27 @@ below. It will run the engine to start a set of services.
below. It will run the engine to stop a set of services.
</p>
+<h3> s6-rc reload </h3>
+
+<p>
+ <tt>s6-rc reload</tt> sends a "reload" command to the list of services
+given on the command line, which must all be up. For a longrun,
+<tt>s6-rc reload</tt> sends an <a href="//skarnet.org/software/s6/s6-svc.html">s6-svc -l</a>
+command to the service, which causes it to receive a SIGHUP, or any
+overriding signal configured in the <tt>reload-signal</tt> file.
+For a oneshot, the service's <tt>up</tt> script is executed, with
+an additional <tt>RC_RELOAD</tt> environment variable containing 1.
+</p>
+
+<p>
+ <tt>s6-rc reload</tt> is special in that it does not use the live state
+at all (except to verify that the services the user wants to reload are
+indeed up) and does not involve the dependency engine. It only operates on
+the services given as arguments on the command line. It is implemented at
+the s6-rc level because it is sometimes useful to ask for a <em>oneshot</em>
+to be reloaded.
+</p>
+
<h3> s6-rc change </h3>
<p>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index d63dc34..0aac5cf 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -31,7 +31,7 @@ minor and bugfix version changes.
<h1> What has changed in s6-rc </h1>
-<h2> in 0.6.1.2 </h2>
+<h2> in 0.6.2.0 </h2>
<ul>
<li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
@@ -40,6 +40,7 @@ dependency bumped to 2.15.0.1. </li>
dependency bumped to 2.9.9.2. </li>
<li> <a href="//skarnet.org/software/s6/">s6</a>
dependency bumped to 2.15.0.1. </li>
+ <li> New <a href="s6-rc.html">s6-rc reload</a> command. </li>
</ul>
<h2> in 0.6.1.1 </h2>