commit ef7aef6ba0d90174e9079944eaf3010de3555cc0
parent e557bab0dcaf35f003fa755b74e4c80000e05e42
Author: Laurent Bercot <ska-skaware@skarnet.org>
Date: Wed, 9 Dec 2020 17:26:11 +0000
Reflect changes in doc
Diffstat:
5 files changed, 40 insertions(+), 31 deletions(-)
diff --git a/NEWS b/NEWS
@@ -10,6 +10,10 @@ unconditionally deleting the socket.
so it does the right thing instead of clobbering sockets.
- Complete revamping of the pathexec functions, see exec.h.
- Revamping of the locking functions.
+ - Use of standard O_NONBLOCK and O_CLOEXEC instead of adhoc
+DJBUNIX_FLAG_NB and DJBUNIX_FLAG_COE.
+ - Better header separation; webipc.h removed (stuff moved to
+socket.h)
In 2.9.3.0
diff --git a/doc/libstddjb/exec.html b/doc/libstddjb/exec.html
@@ -0,0 +1,28 @@
+<html>
+ <head>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>skalibs: the exec header</title>
+ <meta name="Description" content="skalibs: the exec header" />
+ <meta name="Keywords" content="skalibs header exec environment char** execve" />
+ <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
+ </head>
+<body>
+
+<p>
+<a href="index.html">libstddjb</a><br />
+<a href="../libskarnet.html">libskarnet</a><br />
+<a href="../index.html">skalibs</a><br />
+<a href="//skarnet.org/software/">Software</a><br />
+<a href="//skarnet.org/">skarnet.org</a>
+</p>
+
+<h1> The <tt>skalibs/exec.h</tt> header </h1>
+
+<p>
+ TODO: write this documentation page. (Sorry!)
+</p>
+
+</body>
+</html>
diff --git a/doc/libstddjb/index.html b/doc/libstddjb/index.html
@@ -62,6 +62,7 @@ wrappers</a> around I/O functions, extra I/O functions </li>
<li> <a href="djbunix.html">skalibs/djbunix.h</a>: management of basic Unix concepts </li>
<li> <a href="envalloc.html">skalibs/envalloc.h</a>: management of dynamically allocated <em>argv</em> and <em>envp</em> </li>
<li> <a href="env.html">skalibs/env.h</a>: management of <em>argv</em> and <em>envp</em> </li>
+ <li> <a href="exec.html">skalibs/exec.h</a>: execution functions, with or without a newly built environment </li>
<li> <a href="fmtscan.html">skalibs/fmtscan.h</a>: formatters (printers) and scanners (parsers) for basic C types </li>
<li> <a href="genalloc.html">skalibs/genalloc.h</a>: generic advanced management of dynamically allocated structures </li>
<li> <a href="genwrite.html">skalibs/genwrite.h</a>: interface to generic writes either to strallocs or to buffers </li>
@@ -82,12 +83,11 @@ how to safely handle signals in event loops) </li>
<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_uio.h.html">iovec</a>
structure </li>
<li> <a href="skamisc.html">skalibs/skamisc.h</a>: general string quoting and parsing; miscellaneous, unclassifiable functions </li>
- <li> <a href="socket.html">skalibs/socket.h</a>: INET domain sockets </li>
+ <li> <a href="socket.html">skalibs/socket.h</a>: UNIX, INET and INET6 domain sockets </li>
<li> <a href="stralloc.html">skalibs/stralloc.h</a>: advanced management of dynamically allocated strings </li>
<li> <a href="strerr.html">skalibs/strerr.h</a>: basic error messages </li>
<li> <a href="strerr2.html">skalibs/strerr2.h</a>: advanced error messages </li>
<li> <a href="tai.html">skalibs/tai.h</a>: time, timers and system clock </li>
- <li> <a href="webipc.html">skalibs/webipc.h</a>: UNIX domain sockets </li>
</ul>
<p>
@@ -117,7 +117,6 @@ are not associated with any code and are mostly self-explanatory:
<li> skalibs/diuint.h: for associative arrays of unsigned integers </li>
<li> skalibs/diuint32.h: for associative arrays of 32-bit unsigned integers </li>
<li> skalibs/disize.h: for associative arrays of size_t </li>
- <li> skalibs/environ.h: declaration of the <em>environ</em> variable </li>
<li> skalibs/nsig.h: the number of system signals, for systems that do not define it </li>
<li> skalibs/nonposix.h: feature test macros for non-POSIX-compliant systems </li>
</ul>
diff --git a/doc/libstddjb/webipc.html b/doc/libstddjb/webipc.html
@@ -1,28 +0,0 @@
-<html>
- <head>
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <meta http-equiv="Content-Language" content="en" />
- <title>skalibs: the webipc header</title>
- <meta name="Description" content="skalibs: the webipc header" />
- <meta name="Keywords" content="skalibs header webipc socket unix domain network local" />
- <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
- </head>
-<body>
-
-<p>
-<a href="index.html">libstddjb</a><br />
-<a href="../libskarnet.html">libskarnet</a><br />
-<a href="../index.html">skalibs</a><br />
-<a href="//skarnet.org/software/">Software</a><br />
-<a href="//skarnet.org/">skarnet.org</a>
-</p>
-
-<h1> The <tt>skalibs/webipc.h</tt> header </h1>
-
-<p>
- TODO: write this documentation page. (Sorry!)
-</p>
-
-</body>
-</html>
diff --git a/doc/upgrade.html b/doc/upgrade.html
@@ -27,6 +27,12 @@ uses it, so it won't unconditionally clobber sockets in the filesystem anymore.
<li> Complete revamping of the pathexec functions, see <tt>exec.h</tt>. </li>
<li> Revamping of the locking functions, see
<a href="libstddjb/djbunix.html>djbunix.h</a>. </li>
+ <li> Use of standard O_NONBLOCK and O_CLOEXEC (defined in
+<a href="https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/fcntl.h.html"></a>
+instead of adhoc <tt>DJBUNIX_FLAG_NB</tt> and <tt>DJBUNIX_FLAG_COE</tt>. </li>
+ <li>Better header separation; <tt>webipc.h</tt> removed (stuff moved to
+<tt>socket.h</tt>)
+
</ul>
<h2> in 2.9.3.0 </h2>
