xref: /csrg-svn/lib/libc/sys/Xsetregid.2 (revision 20261)
Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)Xsetregid.2 5.1 (Berkeley) 05/15/85

SETREGID 2 "12 February 1983"
C 5
NAME
setregid - set real and effective group ID
SYNOPSIS
setregid(rgid, egid)

int rgid, egid;

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.

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.

"RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.
"ERRORS

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.

"SEE ALSO"
getgid(2), setreuid(2), setgid(3)