From 3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:07 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man3/getgrent.3 | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) (limited to 'man3/getgrent.3') diff --git a/man3/getgrent.3 b/man3/getgrent.3 index cd5beda..66c478a 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:29:54 1993 by Rik Faith (faith@cs.unc.edu) -.TH getgrent 3 2023-07-20 "Linux man-pages 6.05.01" +.TH getgrent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getgrent, setgrent, endgrent \- get group file entry .SH LIBRARY @@ -18,18 +18,18 @@ Standard C library .nf .B #include .B #include -.PP +.P .B struct group *getgrent(void); -.PP +.P .B void setgrent(void); .B void endgrent(void); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR setgrent (): .nf _XOPEN_SOURCE >= 500 @@ -37,7 +37,7 @@ Feature Test Macro Requirements for glibc (see || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi -.PP +.P .BR getgrent (), .BR endgrent (): .nf @@ -62,19 +62,19 @@ The first time .BR getgrent () is called, it returns the first entry; thereafter, it returns successive entries. -.PP +.P The .BR setgrent () function rewinds to the beginning of the group database, to allow repeated scans. -.PP +.P The .BR endgrent () function is used to close the group database after all processing has been performed. -.PP +.P The \fIgroup\fP structure is defined in \fI\fP as follows: -.PP +.P .in +4n .EX struct group { @@ -86,7 +86,7 @@ struct group { }; .EE .in -.PP +.P For more information about the fields of this structure, see .BR group (5). .SH RETURN VALUE @@ -96,14 +96,14 @@ function returns a pointer to a .I group structure, or NULL if there are no more entries or an error occurs. -.PP +.P Upon error, .I errno may be set. If one wants to check .I errno after the call, it should be set to zero before the call. -.PP +.P The return value may point to a static area, and may be overwritten by subsequent calls to .BR getgrent (), @@ -180,8 +180,7 @@ T} Thread safety T{ MT-Unsafe race:grent locale T} .TE -.sp 1 -.PP +.P In the above table, .I grent in -- cgit v1.2.3