• 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 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 <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.19 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/.

Current Users: 83 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.