Add manpages for O_CLOFORK flag and others

Author: ricardobranco777

lib/libc/gen/dup3.3

@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 16, 2013
+.Dd May 17, 2025
 .Dt DUP3 3
 .Os
 .Sh NAME
@@ -47,6 +47,11 @@ The close-on-exec flag on the new file descriptor is determined by the
 bit in
 .Fa flags .
 .Pp
+The close-on-fork flag on the new file descriptor is determined by the
+.Dv O_CLOFORK
+bit in
+.Fa flags .
+.Pp
 If
 .Fa oldd
 \*(Ne
@@ -91,7 +96,9 @@ argument.
 The
 .Fa flags
 argument has bits set other than
-.Dv O_CLOEXEC .
+.Dv O_CLOEXEC
+or
+.Dv O_CLOFORK .
 .El
 .Sh SEE ALSO
 .Xr accept 2 ,
@@ -112,3 +119,7 @@ The
 .Fn dup3
 function appeared in
 .Fx 10.0 .
+The
+.Dv O_CLOFORK
+flag appeared in
+.Fx 15.0 .

lib/libsys/accept.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 9, 2014
+.Dd May 17, 2025
 .Dt ACCEPT 2
 .Os
 .Sh NAME
@@ -85,6 +85,13 @@ and the close-on-exec flag on the new file descriptor can be set via the
 flag in the
 .Fa flags
 argument.
+Similarly, the
+.Dv O_CLOFORK
+property can be set via the
+.Dv SOCK_CLOFORK
+flag in the
+.Fa flags
+argument.
 .Pp
 If no pending connections are
 present on the queue, and the original socket
@@ -234,3 +241,8 @@ The
 .Fn accept4
 system call appeared in
 .Fx 10.0 .
+.Pp
+The
+.Dv SOCK_CLOFORK
+flag appeared in
+.Fx 15.0 .

lib/libsys/closefrom.2

@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 3, 2022
+.Dd May 17, 2025
 .Dt CLOSEFROM 2
 .Os
 .Sh NAME
@@ -60,6 +60,10 @@ Supported
 .It Dv CLOSE_RANGE_CLOEXEC
 Set the close-on-exec flag on descriptors in the range instead of closing them.
 .El
+.Bl -tag -width ".Dv CLOSE_RANGE_CLOFORK"
+.It Dv CLOSE_RANGE_CLOFORK
+Set the close-on-fork flag on descriptors in the range instead of closing them.
+.El
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn close_range
@@ -90,3 +94,8 @@ The
 .Fn closefrom
 function first appeared in
 .Fx 8.0 .
+.Pp
+The
+.Dv CLOSE_RANGE_CLOFORK
+flag appeared in
+.Fx 15.0 .

lib/libsys/fcntl.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 7, 2021
+.Dd May 17, 2025
 .Dt FCNTL 2
 .Os
 .Sh NAME
@@ -80,6 +80,13 @@ associated with the new file descriptor is cleared, so the file descriptor is
 to remain open across
 .Xr execve 2
 system calls.
+.It
+The fork-on-exec flag
+.Dv FD_CLOFORK
+associated with the new file descriptor is cleared, so the file descriptor is
+to remain open across
+.Xr fork 2
+system calls.
 .El
 .It Dv F_DUPFD_CLOEXEC
 Like
@@ -90,6 +97,15 @@ flag associated with the new file descriptor is set, so the file descriptor
 is closed when
 .Xr execve 2
 system call executes.
+.It Dv F_DUPFD_CLOFORK
+Like
+.Dv F_DUPFD ,
+but the
+.Dv FD_CLOFORK
+flag associated with the new file descriptor is set, so the file descriptor
+is closed when
+.Xr fork 2
+system call executes.
 .It Dv F_DUP2FD
 It is functionally equivalent to
 .Bd -literal -offset indent
@@ -101,22 +117,32 @@ Like
 but the
 .Dv FD_CLOEXEC
 flag associated with the new file descriptor is set.
+.It Dv F_DUP2FD_CLOFORK
+Like
+.Dv F_DUP2FD ,
+but the
+.Dv FD_CLOFORK
+flag associated with the new file descriptor is set.
 .Pp
 The
 .Dv F_DUP2FD
-and
+,
 .Dv F_DUP2FD_CLOEXEC
+and
+.Dv F_DUP2FD_CLOFORK
 constants are not portable, so they should not be used if
 portability is needed.
 Use
 .Fn dup2
 instead of
 .Dv F_DUP2FD .
+.It Dv F_DUP3FD
+Used to implement the
+.Fn dup3
+call.  Do not use it.
 .It Dv F_GETFD
-Get the close-on-exec flag associated with the file descriptor
+Get the close-on-exec and close-on-fork flags associated with the file descriptor
 .Fa fd
-as
-.Dv FD_CLOEXEC .
 If the returned value ANDed with
 .Dv FD_CLOEXEC
 is 0,
@@ -125,16 +151,19 @@ the file will remain open across
 otherwise the file will be closed upon execution of
 .Fn exec
 .Fa ( arg
-is ignored).
+is ignored).  The same happens with
+.Dv FD_CLOFORK .
 .It Dv F_SETFD
-Set the close-on-exec flag associated with
+Set the close-on-exec and close-on-fork flags associated with
 .Fa fd
 to
 .Fa arg ,
 where
 .Fa arg
-is either 0 or
-.Dv FD_CLOEXEC ,
+is either 0,
+.Dv FD_CLOEXEC
+or
+.Dv FD_CLOFORK
 as described above.
 .It Dv F_GETFL
 Get descriptor status flags, as described below
@@ -762,8 +791,10 @@ for the reasons as stated in
 .Sh STANDARDS
 The
 .Dv F_DUP2FD
-constant is non portable.
-It is provided for compatibility with AIX and Solaris.
+and
+.Dv F_DUP3FD
+constants are not portable.
+They are provided for compatibility with AIX and Solaris.
 .Pp
 Per
 .St -susv4 ,
@@ -788,3 +819,12 @@ The
 .Dv F_DUP2FD
 constant first appeared in
 .Fx 7.1 .
+.Pp
+The
+.Dv F_DUPFD_CLOFORK
+,
+.Dv F_DUP2FD_CLOFORK
+and
+.Dv F_DUP3FD
+flags appeared in
+.Fx 15.0 .

lib/libsys/fork.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 5, 2021
+.Dd May 17, 2024
 .Dt FORK 2
 .Os
 .Sh NAME
@@ -68,6 +68,15 @@ by the parent.
 This descriptor copying is also used by the shell to
 establish standard input and output for newly created processes
 as well as to set up pipes.
+Any file descriptors that were marked with the close-on-fork flag,
+.Dv FD_CLOFORK
+(see
+.Fn fcntl 2
+and
+.Dv O_CLOFORK
+in
+.Fn open 2
+), will not be present in the child process, but remain open in the parent.
 .It
 The child process' resource utilizations
 are set to 0; see

lib/libsys/open.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 28, 2025
+.Dd May 17, 2025
 .Dt OPEN 2
 .Os
 .Sh NAME
@@ -195,6 +195,16 @@ error if file is not a directory
 .It Dv O_CLOEXEC
 automatically close file on
 .Xr execve 2
+.It Dv O_CLOFORK
+If set, the file descriptor returned will be closed in any child processses created with the
+.Fn fork 2
+family of functions.  The file descriptor will remain open in the parent.
+This sets the
+.Dv FD_CLOFORK flag on the file descriptor.
+If not performed at open time, this can later be set with the
+.Dv F_SETFD
+.Fn fcntl 2
+command.
 .It Dv O_VERIFY
 verify the contents of the file with
 .Xr mac_veriexec 4
@@ -793,7 +803,12 @@ The
 function was introduced in
 .Fx 8.0 .
 .Dv O_DSYNC
-appeared in 13.0.
+appeared in
+.Fx 13.0 .
+.Pp
+.Dv O_CLOFORK
+flag appeared in
+.Fx 15.0 .
 .Sh BUGS
 The
 .Fa mode

lib/libsys/pipe.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 1, 2017
+.Dd May 17, 2025
 .Dt PIPE 2
 .Os
 .Sh NAME
@@ -64,6 +64,8 @@ list, defined in
 .Bl -tag -width ".Dv O_NONBLOCK"
 .It Dv O_CLOEXEC
 Set the close-on-exec flag for the new file descriptors.
+.It Dv O_CLOFORK
+Set the close-on-fork flag for the new file descriptors.
 .It Dv O_NONBLOCK
 Set the non-blocking flag for the ends of the pipe.
 .El
@@ -173,3 +175,8 @@ function became a wrapper around
 .Fn pipe2
 in
 .Fx 11.0 .
+.Pp
+The
+.Dv O_CLOFORK
+flag appeared in
+.Fx 15.0 .

lib/libsys/recv.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd July 30, 2022
+.Dd May 17, 2025
 .Dt RECV 2
 .Os
 .Sh NAME
@@ -164,6 +164,7 @@ one or more of the values:
 .It Dv MSG_WAITALL Ta wait for full request or error
 .It Dv MSG_DONTWAIT Ta do not block
 .It Dv MSG_CMSG_CLOEXEC Ta set received fds close-on-exec
+.It Dv MSG_CMSG_CLOFORK Ta set received fds close-on-fork
 .It Dv MSG_WAITFORONE Ta do not block after receiving the first message
 (only for
 .Fn recvmmsg

lib/libsys/socket.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 15, 2023
+.Dd May 17, 2025
 .Dt SOCKET 2
 .Os
 .Sh NAME
@@ -121,6 +121,7 @@ argument:
 .Pp
 .Bd -literal -offset indent -compact
 SOCK_CLOEXEC	Set close-on-exec on the new descriptor,
+SOCK_CLOFORK	Set close-on-fork on the new descriptor,
 SOCK_NONBLOCK	Set non-blocking mode on the new socket
 .Ed
 .Pp
@@ -331,7 +332,10 @@ argument of
 .Fn socket .
 The
 .Dv SOCK_CLOEXEC
-flag is expected to conform to the next revision of the
+and
+.Dv SOCK_CLOFORK
+flags are expected to conform to
+.St -p1003.1-2024 .
 .Tn POSIX
 standard.
 The
@@ -347,3 +351,8 @@ The
 .Fn socket
 system call appeared in
 .Bx 4.2 .
+.Pp
+The
+.Dv SOCK_CLOFORK
+flag appeared in
+.Fx 15.0 .

lib/libsys/socketpair.2

@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 10, 2018
+.Dd May 17, 2025
 .Dt SOCKETPAIR 2
 .Os
 .Sh NAME
@@ -56,7 +56,8 @@ and
 The two sockets are indistinguishable.
 .Pp
 The
-.Dv SOCK_CLOEXEC
+.Dv SOCK_CLOEXEC ,
+.Dv SOCK_CLOFORK
 and
 .Dv SOCK_NONBLOCK
 flags in the