diff options
| author | Laurent Bercot <ska-skaware@skarnet.org> | 2025-04-28 08:43:57 +0000 |
|---|---|---|
| committer | Laurent Bercot <ska@appnovation.com> | 2025-04-28 08:43:57 +0000 |
| commit | 168d89131415de7590daa00dc5929aeb8727078e (patch) | |
| tree | 79c9cad554e63998bda545965c91caa50f0ba627 /doc | |
| parent | 63ae0841dcc024464290edf9080ce536a1d7905e (diff) | |
| download | s6-168d89131415de7590daa00dc5929aeb8727078e.tar.gz | |
Latest batch of fixes
Signed-off-by: Laurent Bercot <ska@appnovation.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ftrig.html | 2 | ||||
| -rw-r--r-- | doc/s6-fdholder-daemon.html | 4 | ||||
| -rw-r--r-- | doc/s6-fdholder-errorcodes.html | 4 | ||||
| -rw-r--r-- | doc/s6-fdholderd.html | 6 | ||||
| -rw-r--r-- | doc/s6-ftrig-listen.html | 2 | ||||
| -rw-r--r-- | doc/s6-ftrig-listen1.html | 2 | ||||
| -rw-r--r-- | doc/s6-ftrig-wait.html | 2 | ||||
| -rw-r--r-- | doc/s6-ioconnect.html | 2 | ||||
| -rw-r--r-- | doc/s6-ipcserver-access.html | 2 | ||||
| -rw-r--r-- | doc/s6-ipcserver-socketbinder.html | 4 | ||||
| -rw-r--r-- | doc/s6-ipcserver.html | 2 | ||||
| -rw-r--r-- | doc/s6-log.html | 2 | ||||
| -rw-r--r-- | doc/s6-svscan-1.html | 2 | ||||
| -rw-r--r-- | doc/s6-svscan.html | 2 | ||||
| -rw-r--r-- | doc/servicedir.html | 2 | ||||
| -rw-r--r-- | doc/unit-conversion.html | 2 |
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> : 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> : 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 <em>backlog</em></tt> : 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 <em>clienttimeout</em></tt> : 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> : 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> : 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> : be verbose. </li> <li> <tt>-d</tt> : 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> : 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>&1</tt> in <a href="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html">shell</a>. +and <tt>exec 2>&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 |
