aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2025-07-12 02:14:40 +0200
committerAlejandro Colomar <alx@kernel.org>2025-07-19 23:30:01 +0200
commit417d039b6095c7e4314a070aea7542877c75ebf3 (patch)
tree229001d9bac2309c84c68700e9e3ced107a9b970
parent5f2d8b3301e9805660782d7edfd9029010b721c0 (diff)
downloadman-pages-417d039b6095c7e4314a070aea7542877c75ebf3.tar.gz
man/man2const/F_DUPFD{,_CLOEXEC}.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man2const/F_DUPFD.2const22
-rw-r--r--man/man2const/F_DUPFD_CLOEXEC.2const1
2 files changed, 8 insertions, 15 deletions
diff --git a/man/man2const/F_DUPFD.2const b/man/man2const/F_DUPFD.2const
index 6c7b8d6475..b3635982ad 100644
--- a/man/man2const/F_DUPFD.2const
+++ b/man/man2const/F_DUPFD.2const
@@ -19,9 +19,8 @@ Standard C library
.BI "int fcntl(int " fd ", F_DUPFD_CLOEXEC, int " arg );
.fi
.SH DESCRIPTION
-.SS Duplicating a file descriptor
.TP
-.BR F_DUPFD \~(\f[I]int\f[])
+.B F_DUPFD
Duplicate the file descriptor
.I fd
using the lowest-numbered available file descriptor greater than or equal to
@@ -36,14 +35,13 @@ See
.BR dup (2)
for further details.
.TP
-.BR F_DUPFD_CLOEXEC "\~(\f[I]int\f[]; since Linux 2.6.24)"
+.B F_DUPFD_CLOEXEC
As for
.BR F_DUPFD ,
but additionally set the
close-on-exec flag for the duplicate file descriptor.
Specifying this flag permits a program to avoid an additional
-.BR fcntl ()
-.B F_SETFD
+.BR F_SETFD (2const)
operation to set the
.B FD_CLOEXEC
flag.
@@ -63,10 +61,6 @@ See
.BR fcntl (2).
.TP
.B EINVAL
-.I op
-is
-.B F_DUPFD
-and
.I arg
is negative or is greater than the maximum allowable value
(see the discussion of
@@ -75,15 +69,12 @@ in
.BR getrlimit (2)).
.TP
.B EMFILE
-.I op
-is
-.B F_DUPFD
-and the per-process limit on the number of open file descriptors
+The per-process limit on the number of open file descriptors
has been reached.
.SH VERSIONS
POSIX.1-2024 specifies
.BR F_DUPFD_CLOFORK ,
-but Linux doesn't support them.
+but Linux doesn't support it.
.SH STANDARDS
POSIX.1-2008.
.SH HISTORY
@@ -92,13 +83,14 @@ POSIX.1-2008.
SVr4, 4.3BSD, POSIX.1-2001.
.TP
.B F_DUPFD_CLOEXEC
+Linux 2.6.24.
POSIX.1-2008.
(To get this definition, define
.B _POSIX_C_SOURCE
with the value 200809L or greater, or
.B _XOPEN_SOURCE
with the value 700 or greater.)
-.SH NOTES
+.SH CAVEATS
The errors returned by
.BR dup2 (2)
are different from those returned by
diff --git a/man/man2const/F_DUPFD_CLOEXEC.2const b/man/man2const/F_DUPFD_CLOEXEC.2const
new file mode 100644
index 0000000000..28cc4b5d54
--- /dev/null
+++ b/man/man2const/F_DUPFD_CLOEXEC.2const
@@ -0,0 +1 @@
+.so man2const/F_DUPFD.2const