|
|
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)setregid.2 6.1 (Berkeley) 5/15/85
6: .\"
7: .TH SETREGID 2 "May 15, 1985"
8: .UC 5
9: .SH NAME
10: setregid \- set real and effective group ID
11: .SH SYNOPSIS
12: .ft B
13: setregid(rgid, egid)
14: .br
15: int rgid, egid;
16: .ft R
17: .SH DESCRIPTION
18: The real and effective group ID's of the current process
19: are set to the arguments.
20: Unprivileged users may change the real group
21: ID to the effective group ID and vice-versa; only the super-user may
22: make other changes.
23: .PP
24: Supplying a value of \-1 for either the real or effective
25: group ID forces the system to substitute the current
26: ID in place of the \-1 parameter.
27: .SH "RETURN VALUE
28: Upon successful completion, a value of 0 is returned. Otherwise,
29: a value of \-1 is returned and \fIerrno\fP is set to indicate the error.
30: .SH "ERRORS
31: .TP 15
32: [EPERM]
33: The current process is not the super-user and a change
34: other than changing the effective group-id to the real group-id
35: was specified.
36: .SH "SEE ALSO"
37: getgid(2), setreuid(2), setgid(3)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.