[unix-history] / usr / man / man2 / setregid.2

.TH SETREGID 2 "12 February 1983"
.UC 4
.SH NAME
setregid \- set real and effective group ID
.SH SYNOPSIS
.ft B
setregid(rgid, egid)
.br
int rgid, egid;
.ft R
.SH DESCRIPTION
The real and effective group ID's of the current process
are set to the arguments.
Only the super-user may change the real group ID
of a process.  Unpriviledged users may change the
effective group ID to the real group ID, but to
no other.
.PP
Supplying a value of \-1 for either the real or effective
group ID forces the system to substitute the current
ID in place of the \-1 parameter.
.SH "RETURN VALUE
Upon successful completion, a value of 0 is returned.  Otherwise,
a value of \-1 is returned and \fIerrno\fP is set to indicate the error.
.SH "ERRORS
.TP 15
[EPERM]
The current process is not the super-user and a change
other than changing the effective group-id to the real group-id
was specified.
.SH "SEE ALSO"
getgid(2), setreuid(2), setgid(3)
Commit	Line	Data
9814591b C	1	.TH SETREGID 2 "12 February 1983"
	2	.UC 4
	3	.SH NAME
	4	setregid \- set real and effective group ID
	5	.SH SYNOPSIS
	6	.ft B
	7	setregid(rgid, egid)
	8	.br
	9	int rgid, egid;
	10	.ft R
	11	.SH DESCRIPTION
	12	The real and effective group ID's of the current process
	13	are set to the arguments.
	14	Only the super-user may change the real group ID
	15	of a process. Unpriviledged users may change the
	16	effective group ID to the real group ID, but to
	17	no other.
	18	.PP
	19	Supplying a value of \-1 for either the real or effective
	20	group ID forces the system to substitute the current
	21	ID in place of the \-1 parameter.
	22	.SH "RETURN VALUE
	23	Upon successful completion, a value of 0 is returned. Otherwise,
	24	a value of \-1 is returned and \fIerrno\fP is set to indicate the error.
	25	.SH "ERRORS
	26	.TP 15
	27	[EPERM]
	28	The current process is not the super-user and a change
	29	other than changing the effective group-id to the real group-id
	30	was specified.
	31	.SH "SEE ALSO"
	32	getgid(2), setreuid(2), setgid(3)