setregid(2)

DESCRIPTION

setregid() sets the real and effective group IDs of the calling process.

Only a privileged process can set the real group ID and/or the effective group ID to any valid value. A non-privileged process can set the real group ID to the saved set-group-ID from one of the exec family of functions, or the effective group ID to either the saved set-group-ID or the real group ID.

Any supplementary group IDs of the calling process remain unchanged.

Argument rgid is the read group ID value to be set with. If rgid is set to -1, the real group ID is not be changed.

Argument egid is the effective group ID value to be set with. If egid is set to -1, the effective group ID is not changed.

The real and effective group IDs may be set to different values in the same call.

RETURN VALUE

Upon successful completion errno is set 0. Otherwise, errno is set to indicate the type of error and neither group IDs are changed.

ERRORS

setregid() fails if any of the following conditions are encountered:

AUTHOR

getregid() was developed by AT*T, the University of California, Berkeley and HP.

getregid() was developed by AT*T.

SEE ALSO

exec(2), geteuid(2), getgid(2), getuid(2), setegid(2), setgid(2), setreuid(2), setuid(2).