Re: [PATCH 1/1] man/man2/openat2.2: Document OPENAT2_REGULAR flag

[Alejandro Colomar <alx@kernel.org>]

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

Hey Dorjoy,

On 2026-04-25T21:07:04+0600, Dorjoy Chowdhury wrote:
> > > +.BR openat2 ()
> > > +fails with the error
> > > +.BR EFTYPE .
> >
> > Hmmm, this error code is new to me.
> >
> >         alx@devuan:~$ errno EFTYPE
> >         alx@devuan:~$ echo $?
> >         1
> >         alx@devuan:~$ man 3 errno | grep EFTYPE
> >         alx@devuan:~$ grepc EFTYPE /usr/include/
> >         alx@devuan:~$
> >
> > I don't see it documented, nor defined under </usr/include>.
> > Is this error code available in user space?
> > Is it a new error code?
> >
> 
> Yes. This is a new error code added in the patch series i.e., if the
> path is not a regular file, then this new error code is returned from
> the system call. Does the new error code need to be included anywhere
> else for man pages?

Yes, it should be documented in the errno(3) manual page.

It should also be added to glibc's <errno.h>, of course.

However, that can be done after the code has been merged to Linus's
tree.  But you could write the documentation for errno(3) already.


Cheers,
Alex

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

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