.\" 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)