INITGROUPS(3) | MidnightBSD Library Functions Manual | INITGROUPS(3) |
initgroups
—
initialize group access list
Standard C Library (libc, -lc)
#include
<unistd.h>
int
initgroups
(const
char *name, gid_t
basegid);
The
initgroups
()
function uses the
getgrouplist(3)
function to calculate the group access list for the user specified in
name. This group list is then setup for the current
process using
setgroups(2). The
basegid is automatically included in the groups list.
Typically this value is given as the group number from the password
file.
The initgroups
() function returns the
value 0 if successful; otherwise the value -1 is returned and
the global variable errno is set to indicate the
error.
The initgroups
() function may fail and set
errno for any of the errors specified for the library
function setgroups(2).
It may also return:
ENOMEM
]initgroups
() function was unable to allocate
temporary storage.The initgroups
() function appeared in
4.2BSD.
October 26, 2014 | midnightbsd-3.1 |