Linux-man Archive on lore.kernel.org
 help / color / Atom feed
* Re: openat2.h location (openat2.2)
       [not found] <20200630141703.GB12757@laura.suse.cz>
@ 2020-06-30 19:35 ` Michael Kerrisk (man-pages)
  2020-06-30 22:33   ` Aleksa Sarai
  0 siblings, 1 reply; 3+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-06-30 19:35 UTC (permalink / raw)
  To: pgajdos; +Cc: eppers, Aleksa Sarai, linux-man

[CC += Aleksa, linux-man@]

Hello Petr,

I'm bringing Aleksa, the creator of the system call, into CC.

Aleksa, the issue is that the header file (<openat2.h>) documented in
the manual page that you sent does not (yet) exist (and the bug
reporter therefore suggests that the manual page should say to include
<linux/openat2.h>.

I'm guessing that there is (or was) a plan to add a <openat2.h> header
file to glibc. What is the status?

With best regards,

Michael

On Tue, 30 Jun 2020 at 16:17, pgajdos <pgajdos@suse.cz> wrote:
>
> Hello Michael,
>
> https://bugzilla.suse.com/show_bug.cgi?id=1173382
>
> reporter proposes
>
> Index: man-pages-5.07/man2/openat2.2
> ===================================================================
> --- man-pages-5.07.orig/man2/openat2.2  2020-06-09 14:45:54.000000000 +0200
> +++ man-pages-5.07/man2/openat2.2       2020-06-30 16:07:09.655352702 +0200
> @@ -29,7 +29,7 @@ openat2 \- open and possibly create a fi
>  .B #include <sys/types.h>
>  .B #include <sys/stat.h>
>  .B #include <fcntl.h>
> -.B #include <openat2.h>
> +.B #include <linux/openat2.h>
>  .PP
>  .BI "int openat2(int " dirfd ", const char *" pathname ,
>  .BI "            struct open_how *" how ", size_t " size ");
>
> Thanks,
> Petr
>
> --
> Have a lot of fun!



--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: openat2.h location (openat2.2)
  2020-06-30 19:35 ` openat2.h location (openat2.2) Michael Kerrisk (man-pages)
@ 2020-06-30 22:33   ` Aleksa Sarai
  2020-07-02  9:41     ` Florian Weimer
  0 siblings, 1 reply; 3+ messages in thread
From: Aleksa Sarai @ 2020-06-30 22:33 UTC (permalink / raw)
  To: Michael Kerrisk (man-pages)
  Cc: pgajdos, eppers, linux-man, libc-alpha, Florian Weimer


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

On 2020-06-30, Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:
> [CC += Aleksa, linux-man@]
> 
> Hello Petr,
> 
> I'm bringing Aleksa, the creator of the system call, into CC.
> 
> Aleksa, the issue is that the header file (<openat2.h>) documented in
> the manual page that you sent does not (yet) exist (and the bug
> reporter therefore suggests that the manual page should say to include
> <linux/openat2.h>.
> 
> I'm guessing that there is (or was) a plan to add a <openat2.h> header
> file to glibc. What is the status?

Yes, Florian asked me to put the openat2 definitions into a separate
header (openat2.h) so that it could be just copied by glibc rather than
having to do any more hacks around <fcntl.h>.

I guess those plans haven't come to fruition yet? I'm fine with telling
users to use <linux/openat2.h> in the meantime.

> With best regards,
> 
> Michael
> 
> On Tue, 30 Jun 2020 at 16:17, pgajdos <pgajdos@suse.cz> wrote:
> >
> > Hello Michael,
> >
> > https://bugzilla.suse.com/show_bug.cgi?id=1173382
> >
> > reporter proposes
> >
> > Index: man-pages-5.07/man2/openat2.2
> > ===================================================================
> > --- man-pages-5.07.orig/man2/openat2.2  2020-06-09 14:45:54.000000000 +0200
> > +++ man-pages-5.07/man2/openat2.2       2020-06-30 16:07:09.655352702 +0200
> > @@ -29,7 +29,7 @@ openat2 \- open and possibly create a fi
> >  .B #include <sys/types.h>
> >  .B #include <sys/stat.h>
> >  .B #include <fcntl.h>
> > -.B #include <openat2.h>
> > +.B #include <linux/openat2.h>
> >  .PP
> >  .BI "int openat2(int " dirfd ", const char *" pathname ,
> >  .BI "            struct open_how *" how ", size_t " size ");
> >
> > Thanks,
> > Petr
> >
> > --
> > Have a lot of fun!

-- 
Aleksa Sarai
Senior Software Engineer (Containers)
SUSE Linux GmbH
<https://www.cyphar.com/>

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

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: openat2.h location (openat2.2)
  2020-06-30 22:33   ` Aleksa Sarai
@ 2020-07-02  9:41     ` Florian Weimer
  0 siblings, 0 replies; 3+ messages in thread
From: Florian Weimer @ 2020-07-02  9:41 UTC (permalink / raw)
  To: Aleksa Sarai
  Cc: Michael Kerrisk (man-pages), pgajdos, eppers, linux-man, libc-alpha

* Aleksa Sarai:

> On 2020-06-30, Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:
>> [CC += Aleksa, linux-man@]
>> 
>> Hello Petr,
>> 
>> I'm bringing Aleksa, the creator of the system call, into CC.
>> 
>> Aleksa, the issue is that the header file (<openat2.h>) documented in
>> the manual page that you sent does not (yet) exist (and the bug
>> reporter therefore suggests that the manual page should say to include
>> <linux/openat2.h>.
>> 
>> I'm guessing that there is (or was) a plan to add a <openat2.h> header
>> file to glibc. What is the status?
>
> Yes, Florian asked me to put the openat2 definitions into a separate
> header (openat2.h) so that it could be just copied by glibc rather than
> having to do any more hacks around <fcntl.h>.

We still need to document the original *at functions. 8-( That's a
precondition for adding openat2 (which should come with its own
documentation right from the start).

<https://sourceware.org/pipermail/libc-alpha/2020-May/113545.html>

> I guess those plans haven't come to fruition yet? I'm fine with telling
> users to use <linux/openat2.h> in the meantime.

If we include <linux/openat2.h> from the glibc header, the transition
should be unproblematic because there won't be any multi-definition
errors.

Thanks,
Florian


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, back to index

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <20200630141703.GB12757@laura.suse.cz>
2020-06-30 19:35 ` openat2.h location (openat2.2) Michael Kerrisk (man-pages)
2020-06-30 22:33   ` Aleksa Sarai
2020-07-02  9:41     ` Florian Weimer

Linux-man Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-man/0 linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ https://lore.kernel.org/linux-man \
		linux-man@vger.kernel.org
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-man


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git