Bug 216951 - close_range(2) needs refreshing for glibc inclusion; closefrom(2) page missing
Summary: close_range(2) needs refreshing for glibc inclusion; closefrom(2) page missing
Status: NEEDINFO
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 normal
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-01-19 01:45 UTC by Sam James
Modified: 2023-05-24 15:59 UTC (History)
0 users

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:

Attachments
signature.asc (833 bytes, application/pgp-signature)
2023-05-24 15:59 UTC, Alyssa Ross 		Details
Add an attachment (proposed patch, testcase, etc.)

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).
Note You need to log in before you can comment on or make changes to this bug.