.TH INITGROUPS 3
.SH NAME
initgroups \- initialize the supplementary group id's from /etc/group
.SH SYNOPSIS
.ft B
.nf
#include <sys/types.h>
#include <grp.h>

int initgroups(char *\fIname\fP, gid_t \fIbasegid\fP)
.fi
.ft P
.SH DESCRIPTION
.B Initgroups()
is used by programs like
.BR login (1),
or
.BR su (1)
to set the supplementery group id's for the user they are changing into.
The routine is called with the login name and the group id of the user as
found in the password file.
.B Initgroups
will then scan the group file for
.I name
in the group member list of each group.  A group the user is a member of
will be added to the supplementary group id set.  The group id
.I basegid
is also added to this set.
.SH DIAGNOSTICS
.B Initgroups
returns the return value of the
.BR setgroups (2)
call.
.SH "SEE ALSO"
.BR getgroups (2),
.BR getgrent (3).
.SH AUTHOR
Kees J. Bot (kjb@cs.vu.nl)
\".
\". $PchId: initgroups.3,v 1.3 1995/11/27 20:21:43 philip Exp $