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