initgroups - initialize group access lists

Syntax	#include <grp.h> #include <sys/types.h> initgroups(const char *name, gid_t basegid);
Description	The initgroups() function can only be called by the system administrator. The initgroups() function initializes the additional group access list of the calling process. To do this, initgroups() reads the group database /etc/group and uses all groups whose user specified by the name parameter is a member. Groups that are additionally specified by the basegid parameter are also entered in the list. Generally, the primary group number is passed in basegid, as defined in the BS2000 SRPM (System Resources and Privileges Management) with the /MOD-POSIX-USER- ATTR or /MOD-POSIX-USER-DEFAULTS command. The initgroups() function also exists as an ASCII function.
Return val.	0 -1	Execution was successful. Otherwise. errno indicates the cause of the error.
Errors	initgroups() schlägt fehl, wenn gilt:
	EPERM	The effective user number is not the user number of the system administrator.