LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / getgrent.3

diff --git a/original/man3/getgrent.3 b/original/man3/getgrent.3
index 956b7fa..a77dc9e 100644 (file)
--- a/original/man3/getgrent.3
+++ b/original/man3/getgrent.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,13 +20,14 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\"     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  2010-10-21 "" "Linux Programmer's Manual"
+.TH GETGRENT 3  2014-10-02 "" "Linux Programmer's Manual"
 .SH NAME
 getgrent, setgrent, endgrent \- get group file entry
 .SH SYNOPSIS
@@ -91,17 +93,18 @@ The \fIgroup\fP structure is defined in \fI<grp.h>\fP as follows:
 .in +4n
 .nf
 struct group {
-    char   *gr_name;       /* group name */
-    char   *gr_passwd;     /* group password */
-    gid_t   gr_gid;        /* group ID */
-    char  **gr_mem;        /* group members */
+    char   *gr_name;        /* group name */
+    char   *gr_passwd;      /* group password */
+    gid_t   gr_gid;         /* group ID */
+    char  **gr_mem;         /* NULL-terminated array of pointers
+                               to names of group members */
 };
 .fi
 .in
 .PP
 For more information about the fields of this structure, see
 .BR group (5).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR getgrent ()
 function returns a pointer to a
@@ -126,6 +129,11 @@ or
 .BR free (3).)
 .SH ERRORS
 .TP
+.B EAGAIN
+The service was temporarily unavailable; try again later.
+For NSS backends in glibc this indicates a temporary error talking to the backend.
+The error may correct itself, retrying later is suggested.
+.TP
 .B EINTR
 A signal was caught.
 .TP
@@ -138,6 +146,11 @@ The calling process already has too many open files.
 .B ENFILE
 Too many open files in the system.
 .TP
+.\" not in POSIX
+.B ENOENT
+A necessary input file cannot be found.
+For NSS backends in glibc this indicates the backend is not correctly configured.
+.TP
 .B ENOMEM
 .\" not in POSIX
 Insufficient memory to allocate
@@ -150,9 +163,20 @@ Insufficient buffer space supplied.
 .TP
 .I /etc/group
 local group database file
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR getgrent ()
+function is not thread-safe.
+.LP
+The
+.BR setgrent ()
+and
+.BR endgrent ()
+functions are thread-safe.
+.SH CONFORMING TO
 SVr4, 4.3BSD, POSIX.1-2001.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR fgetgrent (3),
 .BR getgrent_r (3),
 .BR getgrgid (3),
@@ -160,3 +184,12 @@ SVr4, 4.3BSD, POSIX.1-2001.
 .BR getgrouplist (3),
 .BR putgrent (3),
 .BR group (5)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.