The Open Group Base Specifications Issue 8
IEEE Std 1003.1-2024
Copyright © 2001-2024 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][Option Start]
void           endgrent(void);
struct group  *getgrent(void);
[Option End]
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][Option Start]
void           setgrent(void);
[Option End]

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:

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 Trademark of The IEEE.
Copyright © 2001-2024 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]