initgroups(3) [bsd man page]

INITGROUPS(3)						     Library Functions Manual						     INITGROUPS(3)

NAME

       initgroups - initialize group access list

SYNOPSIS

       initgroups(name, basegid)
       char *name;
       int basegid;

DESCRIPTION

       Initgroups  reads  through  the	group file and sets up, using the setgroups(2) call, the group access list for the user specified in name.
       The basegid is automatically included in the groups list.  Typically this value is given as the group number from the password file.

FILES

       /etc/group

SEE ALSO

       setgroups(2)

DIAGNOSTICS

       Initgroups returns -1 if it was not invoked by the super-user.

BUGS

       Initgroups uses the routines based on getgrent(3).  If the invoking program uses any of these routines, the group structure will  be  over-
       written in the call to initgroups.

4.2 Berkeley Distribution					   May 12, 1986 						     INITGROUPS(3)

initgroups(3C)															    initgroups(3C)

NAME

       initgroups() - initialize group access list

SYNOPSIS

DESCRIPTION

       reads the login group file, and sets up the group access list for the user specified by name, using the system call (see setgroups(2)).	If
       the value of basegid is zero or positive, it is automatically included in the groups list.  Typically this value is given as the group num-
       ber  from the password file.  If the login group file is empty, basegid is the only member of the list.	If the number of groups, including
       the basegid entry, exceeds {NGROUPS_MAX}, then subsequent group entries are ignored (see limits(5)).

RETURN VALUE

       Upon successful completion, returns 0; otherwise it returns -1 and sets to indicate the error.

ERRORS

       fails if any of the following conditions are encountered:

	      The calling process does not have the appropriate privilege.

	      Insufficient memory available to hold gidset.

	      An entry in gidset is not a valid group ID.

WARNINGS

       uses the routines based on getgrent(3C).  If the invoking program uses any of these routines, the group structure  is  overwritten  by  the
       call to Subsequent calls to with the same name parameter override the actions of previous calls.

       On many systems, no one seems to keep up to date.

       uses the Dynamic Name Service Switch.  (See nsswitch.conf(4).)  An application that uses this interface cannot be fully archive bound.

NETWORKING FEATURES

   NFS
       If  is  linked to tries to use the Network Information Service (NIS) for entries beginning with a plus sign If group membership for name is
       managed by NIS, and no NIS server is able to respond, a call to does not return until a server does respond.  This lack	of  action  causes
       commands such as and to wait indefinitely.

       See group(4) for proper syntax and operation.

AUTHOR

       was developed by the University of California, Berkeley.

FILES

       login group file

SEE ALSO

       login(1), su(1), getgroups(2), setgroups(2), group(4), thread_safety(5).

																    initgroups(3C)