INITGROUPS
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
BSD 4.2
NAME
initgroups
- initialize supplementary group IDs
SYNOPSIS
Fd #include <unistd.h>
Ft int
Fn initgroups const char *name int basegid
DESCRIPTION
The
Fn initgroups
function
uses the
getgrouplist(3)
function to calculate the supplementary group IDs for the user
specified in
Fa name .
This group list then set up for the current process using
setgroups(2).
The
Fa basegid
is automatically included in the group list.
Typically this value is given as
the group number from the password file.
RETURN VALUES
The
Fn initgroups
function
returns -1 if it was not invoked by the super-user.
SEE ALSO
setgroups(2),
getgrouplist(3)
HISTORY
The
Fn initgroups
function appeared in
BSD 4.2
BUGS
The
Fn getgrouplist
function called by
Fn initgroups
uses the routines based on
getgrent(3).
If the invoking program uses any of these routines,
the group structure will
be overwritten in the call to
Fn initgroups .
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- SEE ALSO
-
- HISTORY
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 15:52:50 GMT, January 15, 2023