usr/src/lib/libc/compat-43/setreuid.2

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)setreuid.2	6.2 (Berkeley) %G%
.\"
.TH SETREUID 2 ""
.UC 4
.SH NAME
setreuid \- set real and effective user ID's
.SH SYNOPSIS
.ft B
.nf
setreuid(ruid, euid)
int ruid, euid;
.fi
.ft R
.SH DESCRIPTION
The real and effective user ID's of the
current process are set according to the arguments.
If
.I ruid
or
.I euid
is \-1, the current uid is filled in by the system.
Unprivileged users may change the real user
ID to the effective user ID and vice-versa; only the super-user may
make other changes.
.SH "RETURN VALUE
Upon successful completion, a value of 0 is returned.  Otherwise,
a value of \-1 is returned and \fIerrno\fP is set to indicate the error.
.SH "ERRORS
.TP 15
[EPERM]
The current process is not the super-user and a change
other than changing the effective user-id to the real user-id
was specified.
.SH "SEE ALSO"
getuid(2), setregid(2), setuid(3)
Commit	Line	Data
	1	.\" Copyright (c) 1980 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	.\" @(#)setreuid.2 6.2 (Berkeley) %G%
	6	.\"
	7	.TH SETREUID 2 ""
	8	.UC 4
	9	.SH NAME
	10	setreuid \- set real and effective user ID's
	11	.SH SYNOPSIS
	12	.ft B
	13	.nf
	14	setreuid(ruid, euid)
	15	int ruid, euid;
	16	.fi
	17	.ft R
	18	.SH DESCRIPTION
	19	The real and effective user ID's of the
	20	current process are set according to the arguments.
	21	If
	22	.I ruid
	23	or
	24	.I euid
	25	is \-1, the current uid is filled in by the system.
	26	Unprivileged users may change the real user
	27	ID to the effective user ID and vice-versa; only the super-user may
	28	make other changes.
	29	.SH "RETURN VALUE
	30	Upon successful completion, a value of 0 is returned. Otherwise,
	31	a value of \-1 is returned and \fIerrno\fP is set to indicate the error.
	32	.SH "ERRORS
	33	.TP 15
	34	[EPERM]
	35	The current process is not the super-user and a change
	36	other than changing the effective user-id to the real user-id
	37	was specified.
	38	.SH "SEE ALSO"
	39	getuid(2), setregid(2), setuid(3)