From f706ab3b309a4c9a0425ac23d5ffff7ead48fcb2 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Mon, 5 Oct 2026 18:03:35 +0000
Subject:  Add -L catchall to s6-rc-compile and s6-rc-fdholder-filler

---
 doc/s6-rc-compile.html         | 7 ++++++-
 doc/s6-rc-fdholder-filler.html | 4 +++-
 2 files changed, 9 insertions(+), 2 deletions(-)

(limited to 'doc')

diff --git a/doc/s6-rc-compile.html b/doc/s6-rc-compile.html
index fc4a9c6..09e71d6 100644
--- a/doc/s6-rc-compile.html
+++ b/doc/s6-rc-compile.html
@@ -37,7 +37,7 @@ the current service database via
 <h2> Interface </h2>
 
 <pre>
-     s6-rc-compile [ -v <em>verbosity</em> ] [ -h <em>fdhuser</em> ]  [ -b ] <em>compiled</em> <em>source...</em>
+     s6-rc-compile [ -v <em>verbosity</em> ] [ -h <em>fdhuser</em> ] [ -L <em>catchall</em> ] [ -b ] <em>compiled</em> <em>source...</em>
 </pre>
 
 <ul>
@@ -70,6 +70,11 @@ what s6-rc-compile is doing. 3 or more is heavy debug output. </li>
 program, which maintains the pipes for the longrun pipelines, to run
 as user <em>fdhuser</em>. By default, it runs as the user owning
 the supervision tree, i.e. most likely <tt>root</tt>. </li>
+ <li> <tt>-L&nbsp;<em>catchall</em></tt>&nbsp;: assume that a catch-all
+logger service will be running on <em>catchall</em> and ensure that its
+fifo is properly held in the fdholder (which avoids services getting killed
+by SIGPIPE if they're writing uncaught logs while the catch-all logger is
+restarting). </li>
  <li> <tt>-b</tt>&nbsp;: make
 <a href="s6-rc-oneshot-run.html">s6-rc-oneshot-run</a>
 invocations wait instead of fail on lock contention. This
diff --git a/doc/s6-rc-fdholder-filler.html b/doc/s6-rc-fdholder-filler.html
index 5f47ec4..b160573 100644
--- a/doc/s6-rc-fdholder-filler.html
+++ b/doc/s6-rc-fdholder-filler.html
@@ -35,7 +35,7 @@ in internal scripts created by
 <h2> Interface </h2>
 
 <pre>
-     s6-rc-fdholder-filler [ -1 ] [ -t <em>timeout</em> ] &lt; <em>longrunnamesfile</em>
+     s6-rc-fdholder-filler [ -1 ] [ -t <em>timeout</em> ] [ -L <em>catchall</em> ] &lt; <em>longrunnamesfile</em>
 </pre>
 
 <ul>
@@ -63,6 +63,8 @@ successful operation. This is used as a notification mechanism. </li>
  <li> <tt>-t&nbsp;<em>timeout</em></tt>&nbsp;: if the operation cannot be
 achieved in <em>timeout</em> milliseconds, abort and report failure. By
 default, <em>timeout</em> is 0, meaning infinite. </li>
+ <li> <tt>-L&nbsp;<em>catchall</em></tt>&nbsp;: also store the fifo for
+the catch-all logger whose service directory is <em>catchall</em>. </li>
 </ul>
 
 <h2> Exit codes </h2>
-- 
cgit v1.3.1