Bug 216951

Summary:	close_range(2) needs refreshing for glibc inclusion; closefrom(2) page missing
Product:	Documentation	Reporter:	Sam James (sam)
Component:	man-pages	Assignee:	documentation_man-pages (documentation_man-pages)
Status:	NEEDINFO ---
Severity:	normal
Priority:	P1
Hardware:	All
OS:	Linux
Kernel Version:		Subsystem:
Regression:	No	Bisected commit-id:
Attachments:	signature.asc

Description Sam James 2023-01-19 01:45:57 UTC

This came up at https://github.com/OpenRC/openrc/pull/541#discussion_r1070724653.

man-pages currently doesn't document closefrom(2) at all, and is outdated wrt close_range(2) (it only covers the kernel uapi interface, not the fact it's in glibc & the relevant headers - in since glibc 2.34.).

Comment 1 Alejandro Colomar 2023-05-19 12:49:14 UTC

Hi Sam!

 
I would appreciate a patch from someone experienced in these APIs to the
mailing list, according to ./CONTRIBUTING.  Maybe you can summon someone
by CCing in the mailing list?

Cheers,
Alex

Comment 2 Alyssa Ross 2023-05-24 15:59:21 UTC

Created attachment 304314 [details]
signature.asc

On Thu, Jan 19, 2023 at 01:45:57AM +0000, bugzilla-daemon@kernel.org wrote:
> man-pages currently doesn't document closefrom(2) at all, and is outdated wrt

Shouldn't it be closefrom(3)?  There's no closefrom syscall — Glibc
implements it using close_range (if available).