|
|
1.1 ! root 1: .\" Copyright (c) 1983 The Regents of the University of California. ! 2: .\" All rights reserved. ! 3: .\" ! 4: .\" Redistribution and use in source and binary forms are permitted provided ! 5: .\" that: (1) source distributions retain this entire copyright notice and ! 6: .\" comment, and (2) distributions including binaries display the following ! 7: .\" acknowledgement: ``This product includes software developed by the ! 8: .\" University of California, Berkeley and its contributors'' in the ! 9: .\" documentation or other materials provided with the distribution and in ! 10: .\" all advertising materials mentioning features or use of this software. ! 11: .\" Neither the name of the University nor the names of its contributors may ! 12: .\" be used to endorse or promote products derived from this software without ! 13: .\" specific prior written permission. ! 14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED ! 15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF ! 16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ! 17: .\" ! 18: .\" @(#)setregid.2 6.3 (Berkeley) 6/23/90 ! 19: .\" ! 20: .TH SETREGID 2 "June 23, 1990" ! 21: .UC 5 ! 22: .SH NAME ! 23: setregid \- set real and effective group ID ! 24: .SH SYNOPSIS ! 25: .ft B ! 26: setregid(rgid, egid) ! 27: .br ! 28: int rgid, egid; ! 29: .ft R ! 30: .SH DESCRIPTION ! 31: The real and effective group ID's of the current process ! 32: are set to the arguments. ! 33: Unprivileged users may change the real group ! 34: ID to the effective group ID and vice-versa; only the super-user may ! 35: make other changes. ! 36: .PP ! 37: Supplying a value of \-1 for either the real or effective ! 38: group ID forces the system to substitute the current ! 39: ID in place of the \-1 parameter. ! 40: .SH "RETURN VALUE ! 41: Upon successful completion, a value of 0 is returned. Otherwise, ! 42: a value of \-1 is returned and \fIerrno\fP is set to indicate the error. ! 43: .SH "ERRORS ! 44: .TP 15 ! 45: [EPERM] ! 46: The current process is not the super-user and a change ! 47: other than changing the effective group-id to the real group-id ! 48: was specified. ! 49: .SH "SEE ALSO" ! 50: 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.