aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2026-06-09 04:44:18 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2026-06-09 04:44:18 +0000
commit923d36dfe83f6f309da7c17fd70e306cd985182c (patch)
treec2951bd1f01418982514d6434be6326b9c9187ca /doc
parent06d97dd40108bc685a4fab846cc156827534d15b (diff)
downloads6-923d36dfe83f6f309da7c17fd70e306cd985182c.tar.gz
Add s6-svc -l and reload-signal
Diffstat (limited to 'doc')
-rw-r--r--doc/s6-svc.html9
-rw-r--r--doc/servicedir.html6
-rw-r--r--doc/upgrade.html3
3 files changed, 17 insertions, 1 deletions
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>