Man Pages

fgetgrent(3) - phpMan fgetgrent(3) - phpMan

Command: man perldoc info search(apropos)  


FGETGRENT(3)               Linux Programmer's Manual              FGETGRENT(3)



NAME
       fgetgrent - get group file entry

SYNOPSIS
       #include <stdio.h>
       #include <sys/types.h>
       #include <grp.h>

       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  succes-
       sive entries.  The file referred to by stream must have the same format as /etc/group (see group(5)).

       The group structure is defined in <grp.h> 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),  getgrnam(3),  putgrent(3),   setgrent(3),
       group(5)

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



GNU                               2008-07-10                      FGETGRENT(3)