From 923d36dfe83f6f309da7c17fd70e306cd985182c Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Tue, 9 Jun 2026 04:44:18 +0000
Subject:  Add s6-svc -l and reload-signal

---
 doc/s6-svc.html     | 9 ++++++++-
 doc/servicedir.html | 6 ++++++
 doc/upgrade.html    | 3 +++
 3 files changed, 17 insertions(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/s6-svc.html b/doc/s6-svc.html
index a8a5192..5bdbcb1 100644
--- a/doc/s6-svc.html
+++ b/doc/s6-svc.html
@@ -29,7 +29,7 @@ knowing their PIDs, and without using horrible hacks such as .pid files.
 <h2> Interface </h2>
 
 <pre>
-     s6-svc [ -wu | -wU | -wd | -wD | -wr | -wR ] [ -T <em>timeout</em> ] [ -s <em>signal</em> | -abqhkti12pcyrPCK ] [ -oduDUxO ] <em>servicedirs...</em>
+     s6-svc [ -wu | -wU | -wd | -wD | -wr | -wR ] [ -T <em>timeout</em> ] [ -s <em>signal</em> | -abqhkti12pcyrlPCK ] [ -oduDUxO ] <em>servicedirs...</em>
 </pre>
 
 <p>
@@ -100,6 +100,13 @@ signal to kill it and letting <a href="s6-supervise.html">s6-supervise</a>
 start it again. By default, the signal is a SIGTERM; this can be configured
 via the <tt>./down-signal</tt> file in the <a href="servicedir.html">service
 directory</a>. </li>
+ <li> <tt>-l</tt>&nbsp;: If the service is up, reload it, by sending it a
+signal that should make it reload its configuration. (Not all services support
+this feature, in which case <tt>-l</tt> will be equivalent to <tt>-r</tt>.)
+By default, the signal is a SIGHUP; this can be configured
+via the <tt>./reload-signal</tt> file in the <a href="servicedir.html">service
+directory</a>. </li>
+
  <li> <tt>-T&nbsp;<em>timeout</em></tt>&nbsp;: if the <tt>-w<em>state</em></tt>
 option has been given, <tt>-T</tt> specifies a timeout
 (in milliseconds) after which s6-svc will exit 1 with an error message if
diff --git a/doc/servicedir.html b/doc/servicedir.html
index ced24d6..6824559 100644
--- a/doc/servicedir.html
+++ b/doc/servicedir.html
@@ -214,6 +214,12 @@ newline. This signal will be used to kill the supervised process when a
 <a href="s6-svc.html">s6-svc -d</a> or <a href="s6-svc.html">s6-svc -r</a>
 command is used. If the file does not exist, SIGTERM will be used by default. </li>
 
+ <li style="margin-bottom:1em"> An optional regular file named <tt>reload-signal</tt>. If such a file
+exists, it must only contain the name or number of a signal, followed by a
+newline. This signal will be sent to the supervised process when a
+<a href="s6-svc.html">s6-svc -l</a> command is used. If the file does not exist,
+SIGHUP will be used by default. </li>
+
  <li style="margin-bottom:1em"> An optional regular file named <tt>flag-newpidns</tt>.
 If such a file exists:
   <ul>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 43bd3f4..cd2d648 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -27,6 +27,9 @@ dependency bumped to 2.15.0.1. </li>
  <li> <a href="//skarnet.org/software/execline/">execline</a>
 recommended dependency bumped to 2.9.9.2. </li>
  <li> New <a href="s6-svscanboot.html">s6-svscanboot</a> binary. </li>
+ <li> New -l option to <a href="s6-svc.html">s6-svc</a>. </li>
+ <li> New optional <tt>reload-signal</tt> file in a
+<a href="servicedir.html">service directory</a>. </li>
 </ul>
 
 <h2> in 2.15.0.0 </h2>
-- 
cgit v1.3.1