summaryrefslogtreecommitdiffstats
path: root/man2/setreuid.2
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--man2/setreuid.226
1 files changed, 13 insertions, 13 deletions
diff --git a/man2/setreuid.2 b/man2/setreuid.2
index 121deb4..e887619 100644
--- a/man2/setreuid.2
+++ b/man2/setreuid.2
@@ -15,7 +15,7 @@
.\" 2004-07-04 by aeb
.\" 2004-05-27 by Michael Kerrisk
.\"
-.TH setreuid 2 2023-03-30 "Linux man-pages 6.05.01"
+.TH setreuid 2 2023-10-31 "Linux man-pages 6.7"
.SH NAME
setreuid, setregid \- set real and/or effective user or group ID
.SH LIBRARY
@@ -24,16 +24,16 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <unistd.h>
-.PP
+.P
.BI "int setreuid(uid_t " ruid ", uid_t " euid );
.BI "int setregid(gid_t " rgid ", gid_t " egid );
.fi
-.PP
+.P
.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.RE
-.PP
+.P
.BR setreuid (),
.BR setregid ():
.nf
@@ -45,22 +45,22 @@ Feature Test Macro Requirements for glibc (see
.SH DESCRIPTION
.BR setreuid ()
sets real and effective user IDs of the calling process.
-.PP
+.P
Supplying a value of \-1 for either the real or effective user ID forces
the system to leave that ID unchanged.
-.PP
+.P
Unprivileged processes may only set the effective user ID to the real user ID,
the effective user ID, or the saved set-user-ID.
-.PP
+.P
Unprivileged users may only set the real user ID to
the real user ID or the effective user ID.
-.PP
+.P
If the real user ID is set (i.e.,
.I ruid
is not \-1) or the effective user ID is set to a value
not equal to the previous real user ID,
the saved set-user-ID will be set to the new effective user ID.
-.PP
+.P
Completely analogously,
.BR setregid ()
sets real and effective group ID's of the calling process,
@@ -70,7 +70,7 @@ On success, zero is returned.
On error, \-1 is returned, and
.I errno
is set to indicate the error.
-.PP
+.P
.IR Note :
there are cases where
.BR setreuid ()
@@ -137,18 +137,18 @@ and the effective group ID can be changed to the value of
the real group ID or the saved set-group-ID.
The precise details of what ID changes are permitted vary
across implementations.
-.PP
+.P
POSIX.1 makes no specification about the effect of these calls
on the saved set-user-ID and saved set-group-ID.
.SH STANDARDS
POSIX.1-2008.
.SH HISTORY
POSIX.1-2001, 4.3BSD (first appeared in 4.2BSD).
-.PP
+.P
Setting the effective user (group) ID to the
saved set-user-ID (saved set-group-ID) is
possible since Linux 1.1.37 (1.1.38).
-.PP
+.P
The original Linux
.BR setreuid ()
and