Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GETGRENT(3)		   Linux Programmer's Manual		   GETGRENT(3)

NAME
       getgrent, setgrent, endgrent - get group	file entry

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

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);

DESCRIPTION
       The getgrent() function returns a pointer to a structure	containing the
       group information from /etc/group.  The first time it is	called it  re-
       turns the first entry; thereafter, it returns successive	entries.

       The  setgrent()	function  rewinds the file pointer to the beginning of
       the /etc/group file.

       The endgrent() function closes the /etc/group file.

       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 getgrent() function returns the  group  information	structure,  or
       NULL if there are no more entries or an error occurs.

ERRORS
       ENOMEM Insufficient memory to allocate group information	structure.

FILES
       /etc/group
	       group database file

CONFORMING TO
       SVID 3, BSD 4.3

SEE ALSO
       fgetgrent(3), getgrnam(3), getgrgid(3)

GNU				  1993-04-04			   GETGRENT(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | FILES | CONFORMING TO | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getgrent&sektion=3&manpath=Red+Hat+9>

home | help