[unix-history] / usr / man / man3 / initgroups.3x

.TH INITGROUPS 3X "25 February 1983"
.UC 4
.SH NAME
initgroups \- initialize group access list
.SH SYNOPSIS
.B initgroups(name, basegid)
.br
.B char *name;
.br
.B int basegid;
.SH DESCRIPTION
.I Initgroups
reads through the group file and sets up,
using the
.IR setgroups (2)
call, the group access list for the user
specified in
.IR name .
The
.I basegid
is automatically included in the groups list.
Typically this value is given as
the group number from the password file.
.SH FILES
/etc/group
.SH SEE ALSO
setgroups(2)
.SH DIAGNOSTICS
.I Initgroups
returns \-1 if it was not invoked by the super-user.
.SH BUGS
.I Initgroups
uses the routines based on
.IR getgrent (3).
If the invoking program uses any of these routines,
the group structure will
be overwritten in the call to
.IR initgroups .
.PP
Noone seems to keep /etc/group up to date.
Commit	Line	Data
b55bd7ed C	1	.TH INITGROUPS 3X "25 February 1983"
	2	.UC 4
	3	.SH NAME
	4	initgroups \- initialize group access list
	5	.SH SYNOPSIS
	6	.B initgroups(name, basegid)
	7	.br
	8	.B char *name;
	9	.br
	10	.B int basegid;
	11	.SH DESCRIPTION
	12	.I Initgroups
	13	reads through the group file and sets up,
	14	using the
	15	.IR setgroups (2)
	16	call, the group access list for the user
	17	specified in
	18	.IR name .
	19	The
	20	.I basegid
	21	is automatically included in the groups list.
	22	Typically this value is given as
	23	the group number from the password file.
	24	.SH FILES
	25	/etc/group
	26	.SH SEE ALSO
	27	setgroups(2)
	28	.SH DIAGNOSTICS
	29	.I Initgroups
	30	returns \-1 if it was not invoked by the super-user.
	31	.SH BUGS
	32	.I Initgroups
	33	uses the routines based on
	34	.IR getgrent (3).
	35	If the invoking program uses any of these routines,
	36	the group structure will
	37	be overwritten in the call to
	38	.IR initgroups .
	39	.PP
	40	Noone seems to keep /etc/group up to date.