39 lines
1.1 KiB
Groff
39 lines
1.1 KiB
Groff
'\"macro stdmacro
|
|
.\" 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.1 (Berkeley) 5/9/85
|
|
.\"
|
|
.TH SETREUID 2
|
|
.UC 4
|
|
.SH NAME
|
|
setreuid \- set real and effective user ID's
|
|
.SH SYNOPSIS
|
|
.B #include <unistd.h>
|
|
.PP
|
|
.B "int setreuid (uid_t ruid, uid_t euid);"
|
|
.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 \f2errno\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(2).
|
|
'\".so /pubs/tools/origin.bsd
|