NAME

grp.h — group structure

SYNOPSIS

#include <grp.h>

DESCRIPTION

The <grp.h> header shall declare the group structure, 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 <grp.h> header shall define the gid_t and size_t types 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.

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

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

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<sys/types.h>

XSH 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.

Issue 7

SD5-XBD-ERN-56 is applied, adding a reference to <sys/types.h> for the size_t type.

POSIX.1-2008, Technical Corrigendum 1, XBD/TC1-2008/0049 [24] is applied.