Man Fgetgrent en anglais
FGETGRENT(3)               Linux Programmer's Manual              FGETGRENT(3)



 

NAME


       fgetgrent - get group file entry

 

SYNOPSIS


       #include 
       #include 
       #include 

       struct group *fgetgrent(FILE *stream);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       fgetgrent(): _SVID_SOURCE

 

DESCRIPTION






       The  fgetgrent()  function  returns a pointer to a structure containing
       the group information from the file referred to by stream.   The  first
       time  it  is  called it returns the first entry; thereafter, it returns
       successive entries.  The file referred to by stream must have the  same
       format as /etc/group (see group(5)).

       The group structure is defined in  as follows:

           struct group {
               char   *gr_name;        /* group name */
               char   *gr_passwd;      /* group password */
               gid_t   gr_gid;         /* group ID */
               char  **gr_mem;         /* group members */
           };

 

RETURN VALUE


       The  fgetgrent()  function  returns  a pointer to a group structure, or
       NULL if there are no more entries or an error occurs.

 

ERRORS


       ENOMEM Insufficient memory to allocate group structure.

 

CONFORMING TO


       SVr4.

 

SEE ALSO


       endgrent(3), fgetgrent_r(3), fopen(3), getgrent(3), getgrgid(3), getgr-
       nam(3), putgrent(3), setgrent(3), group(5)

 

COLOPHON


       This  page  is  part of release 3.05 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



GNU                               2008-07-10                      FGETGRENT(3)