Annotation of 43BSDTahoe/man/man2/setregid.2, revision 1.1.1.1

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)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.