NAME

grp.h - group structure

SYNOPSIS

#include <grp.h>

DESCRIPTION

The <grp.h> header shall declare the structure group which shall include the following members:

char   *gr_name The name of the group. 
gid_t   gr_gid  Numerical group ID. 
char  **gr_mem  Pointer to a null-terminated array of character 
                pointers to member names. 

The gid_t type shall be defined as described in <sys/types.h>.

The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.

struct group  *getgrgid(gid_t);
struct group  *getgrnam(const char *);
[TSF]
int            getgrgid_r(gid_t, struct group *, char *,
                   size_t, struct group **);
int            getgrnam_r(const char *, struct group *, char *,
                   size_t , struct group **);

[XSI]
struct group  *getgrent(void);
void           endgrent(void);
void           setgrent(void);

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<sys/types.h>, the System Interfaces volume of IEEE Std 1003.1-2001, endgrent(), getgrgid(), getgrnam()

CHANGE HISTORY

First released in Issue 1.

Issue 5

The DESCRIPTION is updated for alignment with the POSIX Threads Extension.

Issue 6

The following new requirements on POSIX implementations derive from alignment with the Single UNIX Specification:

• The definition of gid_t is mandated.

• The getgrgid_r() and getgrnam_r() functions are marked as part of the Thread-Safe Functions option.