From 958958d74337a6ddaf649968d188e768984100e0 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Tue, 9 Jun 2026 05:27:48 +0000
Subject:  Prepare for 0.6.2.0; implement s6-rc reload

 Also support reload-signal in the service definition directory.
---
 doc/index.html             |  6 +++---
 doc/s6-rc-oneshot-run.html |  4 +++-
 doc/s6-rc.html             | 21 +++++++++++++++++++++
 doc/upgrade.html           |  3 ++-
 4 files changed, 29 insertions(+), 5 deletions(-)

(limited to 'doc')

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>
-- 
cgit v1.3.1