aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2025-04-28 08:43:57 +0000
committerLaurent Bercot <ska@appnovation.com>2025-04-28 08:43:57 +0000
commit168d89131415de7590daa00dc5929aeb8727078e (patch)
tree79c9cad554e63998bda545965c91caa50f0ba627 /doc
parent63ae0841dcc024464290edf9080ce536a1d7905e (diff)
downloads6-168d89131415de7590daa00dc5929aeb8727078e.tar.gz
Latest batch of fixes
Signed-off-by: Laurent Bercot <ska@appnovation.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/ftrig.html2
-rw-r--r--doc/s6-fdholder-daemon.html4
-rw-r--r--doc/s6-fdholder-errorcodes.html4
-rw-r--r--doc/s6-fdholderd.html6
-rw-r--r--doc/s6-ftrig-listen.html2
-rw-r--r--doc/s6-ftrig-listen1.html2
-rw-r--r--doc/s6-ftrig-wait.html2
-rw-r--r--doc/s6-ioconnect.html2
-rw-r--r--doc/s6-ipcserver-access.html2
-rw-r--r--doc/s6-ipcserver-socketbinder.html4
-rw-r--r--doc/s6-ipcserver.html2
-rw-r--r--doc/s6-log.html2
-rw-r--r--doc/s6-svscan-1.html2
-rw-r--r--doc/s6-svscan.html2
-rw-r--r--doc/servicedir.html2
-rw-r--r--doc/unit-conversion.html2
16 files changed, 21 insertions, 21 deletions
diff --git a/doc/ftrig.html b/doc/ftrig.html
index c8f168d..292cef2 100644
--- a/doc/ftrig.html
+++ b/doc/ftrig.html
@@ -86,7 +86,7 @@ notify process A.
<ul>
<li> Signals. The simplest Unix notification mechanism. Sending events amounts
-to a <a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/kill.html">kill()</a>
+to a <a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/kill.html">kill()</a>
call, and receiving events amounts to installing a signal handler (preferably
using a <a href="//skarnet.org/software/skalibs/libstddjb/selfpipe.html">self-pipe</a>
if mixing signals with an event loop). Unfortunately, Unix signals, even the more
diff --git a/doc/s6-fdholder-daemon.html b/doc/s6-fdholder-daemon.html
index 5e9c592..6eddf61 100644
--- a/doc/s6-fdholder-daemon.html
+++ b/doc/s6-fdholder-daemon.html
@@ -69,7 +69,7 @@ verbose, or more verbose, depending on if <em>verbosity</em> is 0,
1, or more. The default is 1. </li>
<li> <tt>-d</tt>&nbsp;: allow instant rebinding to the same path
even if it has been used not long ago - this is the SO_REUSEADDR flag to
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/setsockopt.html">setsockopt()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/setsockopt.html">setsockopt()</a>
and is generally used with server programs. This is the default. Note that
<em>path</em> will be deleted if it already exists at program start time. </li>
<li> <tt>-D</tt>&nbsp;: disallow instant rebinding to the same path. </li>
@@ -87,7 +87,7 @@ be opened by the s6-fdholder-daemon process minus a few descriptors
needed for correct <a href="s6-fdholderd.html">s6-fdholderd</a>
operation. Before running s6-fdholder-daemon, make sure to
<a href="s6-softlimit.html">properly adjust</a> the
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_resource.h.html">number
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_resource.h.html">number
of openable files</a> of the current process. </li>
<li> <tt>-b&nbsp;<em>backlog</em></tt>&nbsp;: set a maximum of
<em>backlog</em> backlog connections on the socket. Extra
diff --git a/doc/s6-fdholder-errorcodes.html b/doc/s6-fdholder-errorcodes.html
index 46add36..963553b 100644
--- a/doc/s6-fdholder-errorcodes.html
+++ b/doc/s6-fdholder-errorcodes.html
@@ -20,7 +20,7 @@
<p>
The following error messages (and corresponding
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html">errno codes</a>)
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/errno.h.html">errno codes</a>)
can be returned by the
<a href="s6-fdholderd.html">s6-fdholderd</a> daemon to its various clients.
This page explains why they occur.
@@ -47,7 +47,7 @@ attempted to store more file descriptors than the server can hold.
Or, the client attempted to retrieve more file descriptors than it
can hold. You should check the <tt>-n</tt> option to
<a href="s6-fdholderd.html">s6-fdholderd</a>, as well as the
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_resource.h.html">RLIMIT_NOFILE</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_resource.h.html">RLIMIT_NOFILE</a>
resource limits used by the client and the server, and adjust them
accordingly. </li>
<li> <tt>Resource busy</tt> (EBUSY): the client attempted to store
diff --git a/doc/s6-fdholderd.html b/doc/s6-fdholderd.html
index 80f77a7..4053480 100644
--- a/doc/s6-fdholderd.html
+++ b/doc/s6-fdholderd.html
@@ -84,7 +84,7 @@ It is impossible to set it higher than the number of files that can
be opened by the s6-fdholderd process, minus a few descriptors
needed for correct operation. Before running s6-fdholderd, make sure to
<a href="s6-softlimit.html">properly adjust</a> the
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_resource.h.html">number
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_resource.h.html">number
of openable files</a> of the current process. </li>
<li> <tt>-t&nbsp;<em>clienttimeout</em></tt>&nbsp;: disconnect a client
if it's in the middle of an operation and it has not written or read any
@@ -210,7 +210,7 @@ file named <tt>S6_FDHOLDER_STORE_REGEX</tt> is found in the <tt>env/</tt>
subdirectory of one of the subdirectories checked by
<a href="libs6/accessrules.html#uidgid">s6_accessrules_keycheck_uidgid</a>.
This file should contain a single line, which will be interpreted as an
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">Extended
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">Extended
Regular Expression</a> by s6-fdholderd; the regular expression describes the
set of identifiers that the client is allowed to use to store file
descriptors. For instance, <tt>^unix:/tmp/</tt> indicates that a client
@@ -222,7 +222,7 @@ file named <tt>S6_FDHOLDER_RETRIEVE_REGEX</tt> is found in the <tt>env/</tt>
subdirectory of one of the subdirectories checked by
<a href="libs6/accessrules.html#uidgid">s6_accessrules_keycheck_uidgid</a>.
This file should contain a single line, which will be interpreted as an
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">Extended
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">Extended
Regular Expression</a> by s6-fdholderd; the regular expression describes the
set of identifiers that the client is allowed to use to retrieve file
descriptors. For instance, <tt>^unix:/tmp/</tt> indicates that a client
diff --git a/doc/s6-ftrig-listen.html b/doc/s6-ftrig-listen.html
index 76adcc2..8fa8778 100644
--- a/doc/s6-ftrig-listen.html
+++ b/doc/s6-ftrig-listen.html
@@ -40,7 +40,7 @@ to <em>fifodir2</em> with the regexp <em>regexp2</em>, and so on. </li>
<li> It then forks and exec <em>prog...</em> with all its arguments </li>
<li> It waits for the series of events received on <em>fifodir-i</em>
to match <em>regexp-i</em>, The <em>regexp-i</em> must be
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">Extended
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">Extended
Regular Expressions</a>. </li>
<li> When the series of read events matches the <em>regexp</em>s,
s6-ftrig-listen exits 0. </li>
diff --git a/doc/s6-ftrig-listen1.html b/doc/s6-ftrig-listen1.html
index ec3d079..1543dd2 100644
--- a/doc/s6-ftrig-listen1.html
+++ b/doc/s6-ftrig-listen1.html
@@ -40,7 +40,7 @@ started <em>after</em> there is a listener for those events.
<li> It then forks and exec <em>prog...</em> with all its arguments </li>
<li> It waits for the series of events received on <em>fifodir</em>
to match <em>regexp</em>. <em>regexp</em> must be an
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">Extended
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">Extended
Regular Expression</a>. </li>
<li> When the series of read events matches <em>regexp</em>,
s6-ftrig-listen1 prints the last event it received to stdout (one byte followed by a newline),
diff --git a/doc/s6-ftrig-wait.html b/doc/s6-ftrig-wait.html
index 681567b..663a0c6 100644
--- a/doc/s6-ftrig-wait.html
+++ b/doc/s6-ftrig-wait.html
@@ -33,7 +33,7 @@ waits for a pattern of events to occur on this fifodir.
<li> s6-ftrig-wait subscribes to <em>fifodir</em> </li>
<li> It waits for the series of events received on <em>fifodir</em>
to match <em>regexp</em>. <em>regexp</em> must be an
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">Extended
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">Extended
Regular Expression</a>. </li>
<li> When the series of read events matches <em>regexp</em>,
s6-ftrig-wait prints the last event it received to stdout (one byte followed by a newline),
diff --git a/doc/s6-ioconnect.html b/doc/s6-ioconnect.html
index 4f7186b..790aed4 100644
--- a/doc/s6-ioconnect.html
+++ b/doc/s6-ioconnect.html
@@ -74,7 +74,7 @@ examples here involve TCP. Nevertheless, it can be used with connections
across Unix domain sockets as well, and has its place in the s6
package. </li>
<li> If one of the endpoints is a socket, s6-ioconnect will call
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/shutdown.html">shutdown()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/shutdown.html">shutdown()</a>
on it (for reading or writing, depending on the endpoint) when it
needs to transmit EOF. This is a necessary workaround to a
<a href="https://cr.yp.to/tcpip/twofd.html">misdesign</a> of the
diff --git a/doc/s6-ipcserver-access.html b/doc/s6-ipcserver-access.html
index 10da347..8c61cc3 100644
--- a/doc/s6-ipcserver-access.html
+++ b/doc/s6-ipcserver-access.html
@@ -67,7 +67,7 @@ its parent:
<ul>
<li> ${PROTO}LOCALPATH: set to the local "address" of the socket, as
reported by the
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsockname.html">getsockname()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/getsockname.html">getsockname()</a>
system call, truncated to 99 characters max. </li>
</ul>
diff --git a/doc/s6-ipcserver-socketbinder.html b/doc/s6-ipcserver-socketbinder.html
index bdc3d06..02ad0ea 100644
--- a/doc/s6-ipcserver-socketbinder.html
+++ b/doc/s6-ipcserver-socketbinder.html
@@ -33,7 +33,7 @@ socket, then executes a program.
<li> s6-ipcserver-socketbinder creates a Unix domain socket
and binds it to <em>path</em>. It prepares the socket to accept
connections by calling
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/listen.html">listen()</a>. </li>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/listen.html">listen()</a>. </li>
<li> It then execs into <em>prog...</em> with the open socket
as its standard input. </li>
</ul>
@@ -43,7 +43,7 @@ as its standard input. </li>
<ul>
<li> <tt>-d</tt>&nbsp;: allow instant rebinding to the same path
even if it has been used not long ago - this is the SO_REUSEADDR flag to
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/setsockopt.html">setsockopt()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/setsockopt.html">setsockopt()</a>
and is generally used with server programs. This is the default. Note that
<em>path</em> will be deleted if it already exists at program start time. </li>
<li> <tt>-D</tt>&nbsp;: disallow instant rebinding to the same path. </li>
diff --git a/doc/s6-ipcserver.html b/doc/s6-ipcserver.html
index 840e09c..15e1423 100644
--- a/doc/s6-ipcserver.html
+++ b/doc/s6-ipcserver.html
@@ -86,7 +86,7 @@ programs to check when the server is ready to accept connections. </li>
<li> <tt>-v</tt>&nbsp;: be verbose. </li>
<li> <tt>-d</tt>&nbsp;: allow instant rebinding to the same path
even if it has been used not long ago - this is the SO_REUSEADDR flag to
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/setsockopt.html">setsockopt()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/setsockopt.html">setsockopt()</a>
and is generally used with server programs. This is the default. Note that
<em>path</em> will be deleted if it already exists at program start time. </li>
<li> <tt>-D</tt>&nbsp;: disallow instant rebinding to the same path. </li>
diff --git a/doc/s6-log.html b/doc/s6-log.html
index 8a670c0..850da06 100644
--- a/doc/s6-log.html
+++ b/doc/s6-log.html
@@ -190,7 +190,7 @@ line is selected.
<ul>
<li> <strong>+<em>regexp</em></strong>: select yet-unselected lines that match <em>regexp</em>, which must be a
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_04">POSIX
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap09.html#tag_09_04">POSIX
Extended Regular Expression</a>. </li>
<li> <strong>-<em>regexp</em></strong>: deselect yet-selected lines that match <em>regexp</em>, which must be a
POSIX Extended Regular Expression. </li>
diff --git a/doc/s6-svscan-1.html b/doc/s6-svscan-1.html
index c947637..2714d61 100644
--- a/doc/s6-svscan-1.html
+++ b/doc/s6-svscan-1.html
@@ -117,7 +117,7 @@ before it unmounts the filesystems would be bad.)
<p>
init does not have the right to die, but fortunately, <em>it has the right
-to <a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/execve.html">execve()</a>!</em>
+to <a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/execve.html">execve()</a>!</em>
During stage 2, why use precious RAM, or at best, swap space, to store data
that are only relevant to stages 1 or 3-4? It only makes sense to have an
init process that handles stage 1, then executes into an init process that
diff --git a/doc/s6-svscan.html b/doc/s6-svscan.html
index ae815fc..5570d99 100644
--- a/doc/s6-svscan.html
+++ b/doc/s6-svscan.html
@@ -190,7 +190,7 @@ command, s6-svscan runs a <em>reaper</em> routine.
<p>
The reaper acknowledges (via some
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/wait.html">wait()</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/wait.html">wait()</a>
function), without blocking, every terminated child of s6-svscan, even ones it does not
know it has. This is especially important when <a href="s6-svscan-1.html">s6-svscan is
run as process 1</a>.
diff --git a/doc/servicedir.html b/doc/servicedir.html
index 5e93ac0..5cc2fe0 100644
--- a/doc/servicedir.html
+++ b/doc/servicedir.html
@@ -82,7 +82,7 @@ to log <em>stderr</em> as well, so the run script should make sure that its
stderr goes into the log pipe. This
is achieved by <tt><a href="//skarnet.org/software/execline/fdmove.html">fdmove</a>
-c 2 1</tt> in <a href="//skarnet.org/software/execline/">execline</a>,
-and <tt>exec 2&gt;&amp;1</tt> in <a href="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html">shell</a>.
+and <tt>exec 2&gt;&amp;1</tt> in <a href="https://pubs.opengroup.org/onlinepubs/9799919799/utilities/sh.html">shell</a>.
</li>
<li> adjust the environment for your <em>foo</em> daemon. Normally the run script
inherits its environment from <a href="s6-supervise.html">s6-supervise</a>,
diff --git a/doc/unit-conversion.html b/doc/unit-conversion.html
index 13d736c..3375806 100644
--- a/doc/unit-conversion.html
+++ b/doc/unit-conversion.html
@@ -525,7 +525,7 @@ treacherous, because <tt>User=</tt> is a mash of two very different features:
setting users <em>statically</em> (via numeric ID, which don't change meanings
between two invocations) and setting users <em>dynamically</em> (via user name,
which needs to be interpreted by
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/getpwnam.html">getpwnam(3)</a>
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/functions/getpwnam.html">getpwnam(3)</a>
on every invocation of the service. s6 supports both, but since these are two
different things, the way to do them in s6 is different (statically setting the
UID and GID variables and calling