summaryrefslogtreecommitdiff
path: root/reference/C/MAN/seteuid.htm
blob: de43dee463c8ba7a09b9ac1961ac0cd24f2de032 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
<TITLE>setreuid</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>SETREUID(2)         Linux Programmer's Manual         SETREUID(2)
</h3>

<h3>NAME
</h3>       setreuid, seteuid - set real and / or effective user ID

<h3>SYNOPSIS
</h3>       #include &lt;unistd.h&gt;

       int setreuid(uid_t ruid, uid_t euid);
       int seteuid(uid_t euid);

<h3>DESCRIPTION
</h3>       setreuid  sets real and effective user ID's of the current
       process.  Un-privileged users may change the real user  ID
       to the effective user ID and vice-versa.

       Prior  to  Linux  1.1.37, the saved ID paradigm, when used
       with setreuid or seteuid was broken.

       Starting at 1.1.37, it is also possible to set the  effec-
       tive user ID from the saved user ID.

       Only the super-user may make other changes.

       Supplying  a  value of -1 for either the real or effective
       user ID forces the system to leave that ID unchanged.

       Currently  (libc-4.x.x),  seteuid(euid)  is   functionally
       equivalent to setreuid(-1, euid).

       If the real user ID is changed or the effective user ID is
       set to a value not equal to the previous real user ID, the
       saved user ID will be set to the new effective user ID.

<h3>RETURN VALUE
</h3>       On  success,  zero is returned.  On error, -1 is returned,
       and errno is set appropriately.

<h3>ERRORS
</h3>       EPERM   The current process  is  not  the  super-user  and
               changes other than (i) swapping the effective user
               ID with the real user ID or (ii)  setting  one  to
               the value of the other or (iii) setting the effec-
               tive user ID to the value of the saved user ID was
               specified.

<h3>HISTORY
</h3>       The setreuid function call appeared in BSD 4.2.

<h3>CONFORMING TO
</h3>       BSD 4.3

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=getuid.htm>getuid</a>, 
<a href=setuid.htm>setuid</a>, 
<pre>





<h3>Linux 1.1.38             2nd August 1994                        1
</h3>


</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>