git: 97722455cce4 - main - fcntl(2): be more precise about third arg type
Date: Mon, 06 Dec 2021 23:27:43 UTC
The branch main has been updated by kib:
URL: https://cgit.FreeBSD.org/src/commit/?id=97722455cce4f8398f6411eaaa80d595dcb5fb3c
commit 97722455cce4f8398f6411eaaa80d595dcb5fb3c
Author: Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2021-12-06 20:14:25 +0000
Commit: Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2021-12-06 23:27:38 +0000
fcntl(2): be more precise about third arg type
Also use the term operation consistently, over the command.
Reviewed by: emaste, jhb, markj
Sponsored by: The FreeBSD Foundation
MFC after: 1 week
Differential revision: https://reviews.freebsd.org/D33277
---
lib/libc/sys/fcntl.2 | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2
index c0a13ee6df18..d6d48f7a4797 100644
--- a/lib/libc/sys/fcntl.2
+++ b/lib/libc/sys/fcntl.2
@@ -53,7 +53,11 @@ Depending on the value of
.Fa cmd ,
.Fn fcntl
can take an additional third argument
-.Fa "long arg" .
+.Fa arg .
+Unless otherwise noted below for a specific operation,
+.Fa arg
+has type
+.Vt int .
.Bl -tag -width F_DUP2FD_CLOEXEC
.It Dv F_DUPFD
Return a new descriptor as follows:
@@ -286,7 +290,7 @@ and
will fail and return
.Dv EINVAL .
.Pp
-Several commands are available for doing advisory file locking;
+Several operations are available for doing advisory file locking;
they all operate on the following structure:
.Bd -literal
struct flock {
@@ -298,6 +302,10 @@ struct flock {
int l_sysid; /* remote system id or zero for local */
};
.Ed
+These advisory file locking operations take a pointer to
+.Vt struct flock
+as the third argument
+.Fa arg .
The commands available for advisory record locking are as follows:
.Bl -tag -width F_SETLKWX
.It Dv F_GETLK