blob: 20e14672c538c422abb6bd4559cdb52fb596525e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\" May be distributed under the GNU General Public License
.\" References consulted:
.\" Linux libc source code
.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\" 386BSD man pages
.\" Modified Sat Jul 24 19:10:36 1993 by Rik Faith (faith@cs.unc.edu)
.TH INITGROUPS 3 "April 5, 1993" "GNU" "Linux Programmer's Manual"
.SH NAME
initgroups \- initialize the supplementary group access list
.SH SYNOPSIS
.nf
.B #include <grp.h>
.B #include <sys/types.h>
.sp
.BI "int initgroups(const char *" user ", gid_t " group );
.fi
.SH DESCRIPTION
The \fBinitgroups()\fP function initializes the group access list by
reading the group database \fI/etc/group\fP and using all groups of
which \fIuser\fP is a member. The additional group \fIgroup\fP is
also added to the list.
.SH "RETURN VALUE"
The \fBinitgroups()\fP function returns 0 on success, or -1 if an error
occurs.
.SH "ERRORS"
.TP
.B EPERM
The calling process does not have sufficient privileges.
.TP
.B ENOMEM
Insufficient memory to allocate group information structure.
.SH FILES
.nf
/etc/group group database file
.fi
.SH "CONFORMING TO"
SVID 3, BSD 4.3
.SH SEE ALSO
.BR getgroups "(2), " setgroups (2)
|
