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);

The following sections are informative.

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

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

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(3) and getgrnam_r(3) functions are marked as part of the Thread-Safe Functions option.

End of informative text. footer end