Re: [PATCH v1 0/3] man/man2const: Document fcntls F_DUPFD_QUERY, F_CREATED_QUERY

[Alejandro Colomar <alx@kernel.org>]

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

Hi Yannick,

> Date: 2026-10-12 23:08:13+0200
> From: Yannick Le Pennec <yannick.lepennec@live.fr>
>
> Linux 6.10 and 6.12 added two new fcntl(2) operations, respectively:
> 
>   F_DUPFD_QUERY
>     since linux 6.10  c62b758bae6a ("fcntl: add F_DUPFD_QUERY fcntl()")
>     since glibc 2.41  28f8cee64a32 ("Add F_DUPFD_QUERY from Linux 6.10 to
>                                     bits/fcntl-linux.h")
>     Checks whether two fds point to the same open file description.
> 
>   F_CREATED_QUERY
>     since linux 6.12  820a185896b7 ("fcntl: add F_CREATED_QUERY")
>     since glibc 2.41  322e9d4e4430 ("Add F_CREATED_QUERY from Linux 6.12 to
>                                     bits/fcntl-linux.h")
>     Checks whether a file was created by a call to open(2) with O_CREAT.
> 
> This patch series documents both operations individually, with usage examples,
> then adds a new category in fcntl.2 that references them.
> I hesitated somewhat on whether F_DUPFD_QUERY should belong in the
> 'Duplicating a file descriptor' section of fcntl.2, or whether it should go with
> F_CREATED_QUERY in a separate 'Open file description queries' section, this
> series proposes the latter.

I agree with the proposal, since it doesn't duplicate an fd.  Thanks!


Have a lovely day!
Alex

> 
> Link: <https://lore.kernel.org/dri-devel/CAHk-=wixO-fmQYgbGic-BQVUd9RQhwGsF4bGk8ufWDKnRS1v_A@mail.gmail.com/>
> Link: <https://lore.kernel.org/all/20240724-work-fcntl-v1-1-e8153a2f1991@kernel.org/>
> Link: <https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=28f8cee64a3223636d15c78f69432503d8ef1c22>
> Link: <https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=322e9d4e443084336ea41a8e7bf72456ab273b73>
> 
> Yannick Le Pennec (3):
>   man/man2const/F_DUPFD_QUERY.2const: Add page
>   man/man2const/F_CREATED_QUERY.2const: Add page
>   man/man2/fcntl.2: Add section
> 
>  man/man2/fcntl.2                     |   5 ++
>  man/man2const/F_CREATED_QUERY.2const | 107 +++++++++++++++++++++++++++
>  man/man2const/F_DUPFD_QUERY.2const   | 105 ++++++++++++++++++++++++++
>  3 files changed, 217 insertions(+)
>  create mode 100644 man/man2const/F_CREATED_QUERY.2const
>  create mode 100644 man/man2const/F_DUPFD_QUERY.2const
> 
> Range-diff against v0:
> -:  ---------- > 1:  8fc8c6255e man/man2const/F_DUPFD_QUERY.2const: Add page
> -:  ---------- > 2:  a29379d2a6 man/man2const/F_CREATED_QUERY.2const: Add page
> -:  ---------- > 3:  fcc62e822a man/man2/fcntl.2: Add section
> -- 
> 2.55.0
> 

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

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