The Open Group Base Specifications Issue 7
IEEE Std 1003.1-2008, 2016 Edition
Copyright © 2001-2016 The IEEE and The Open Group

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

The following sections are informative.

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

End of informative text.

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2016 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]