Re: [PATCH man-pages v2 2/2] man/man2const: clean up the F_GETLEASE manpage

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2622 bytes --]

Hi Jeff,

On Wed, Jan 14, 2026 at 12:35:25PM -0500, Jeff Layton wrote:
> - Remove a redundant subsection heading
> - Add in the lease-specific error codes
> - Clean up some semantic newline warts
> 
> Signed-off-by: Jeff Layton <jlayton@kernel.org>

Thanks!  I've applied it, and split it in two commits.


Have a lovely night!
Alex

> ---
>  man/man2const/F_GETLEASE.2const | 22 +++++++++++++++++-----
>  1 file changed, 17 insertions(+), 5 deletions(-)
> 
> diff --git a/man/man2const/F_GETLEASE.2const b/man/man2const/F_GETLEASE.2const
> index 10f7ac7a89a70b83be10a381462d879cff813471..e841f7f8c7c64ba8c6868e68d493716040e3dec2 100644
> --- a/man/man2const/F_GETLEASE.2const
> +++ b/man/man2const/F_GETLEASE.2const
> @@ -20,7 +20,6 @@ Standard C library
>  .BI "int fcntl(int " fd ", F_GETLEASE);"
>  .fi
>  .SH DESCRIPTION
> -.SS Leases
>  .B F_SETLEASE
>  and
>  .B F_GETLEASE
> @@ -43,7 +42,7 @@ values is specified in the integer
>  .RS
>  .TP
>  .B F_RDLCK
> -Take out a read lease.
> +Establish a read lease.
>  This will cause the calling process to be notified when
>  the file is opened for writing or is truncated.
>  .\" The following became true in Linux 2.6.10:
> @@ -52,7 +51,7 @@ A read lease can be placed only on a file descriptor that
>  is opened read-only.
>  .TP
>  .B F_WRLCK
> -Take out a write lease.
> +Establish a write lease.
>  This will cause the caller to be notified when
>  the file is opened for reading or writing or is truncated.
>  A write lease may be placed on a file only if there are no
> @@ -86,8 +85,11 @@ capability may take out leases on arbitrary files.
>  Indicates what type of lease is associated with the file descriptor
>  .I fd
>  by returning either
> -.BR F_RDLCK ", " F_WRLCK ", or " F_UNLCK ,
> -indicating, respectively, a read lease , a write lease, or no lease.
> +.BR F_RDLCK,
> +.BR F_WRLCK,
> +or
> +.BR F_UNLCK,
> +indicating, respectively, a read lease, a write lease, or no lease.
>  .I arg
>  is ignored.
>  .P
> @@ -196,6 +198,16 @@ is set to indicate the error.
>  .SH ERRORS
>  See
>  .BR fcntl (2).
> +These operations can also fail with the following error codes:
> +.TP
> +.B EAGAIN
> +The operation is prohibited because the file is open in a way that conflicts with the requested lease.
> +.TP
> +.B EINVAL
> +The operation is prohibited because the underlying filesystem doesn't support leases,
> +or because
> +.I fd
> +does not represent a regular file.
>  .SH STANDARDS
>  Linux.
>  .SH HISTORY
> 
> -- 
> 2.52.0
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]