 
 <TITLE>setuid</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>
<h3>SETUID(2)           Linux Programmer's Manual           SETUID(2)
</h3>
<h3>NAME
</h3>       setuid - set user identity
<h3>SYNOPSIS
</h3>       #include <unistd.h>
       int setuid(uid_t uid)
<h3>DESCRIPTION
</h3>       setuid  sets the effective user ID of the current process.
       If the caller is the superuser, the real  and  saved  user
       ID's are also set.
       Under   Linux,   setuid  is  implemented  like  SYSV  with
       SAVED_IDS.  This allows a setuid (other than root) program
       to drop all of it's user privileges, do some un-privileged
       work, and then re-engage the original effective user ID in
       a secure manner.
       If the user is root or the program is setuid root, special
       care must be taken. The setuid function checks the  effec-
       tive  uid  of  the  caller and if it is the superuser, all
       process related user ID's are set to uid.  After this  has
       occurred,  it is impossible for the program to regain root
       privileges.
<h3>RETURN VALUE
</h3>       On success, zero is returned.  On error, -1  is  returned,
       and errno is set appropriately.
<h3>ERRORS
</h3>       EPERM   The  user  is not the super-user, and uid does not
               match the effective or saved user ID of the  call-
               ing process.
<h3>CONFORMING TO
</h3>       System V
</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=getuid.htm>getuid</a>, 
<a href=setreuid.htm>setreuid</a>, 
<a href=seteuid.htm>seteuid</a>, 
<pre>
<h3>Linux 1.1.36               29 July 1994                         1
</h3>
</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../index.htm>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/index.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>
This manual page was brought to you by <i>mjl_man V-2.0</i>
| file: /Techref/language/ccpp/Cref/MAN/setuid.htm, 2KB, , updated: 2003/3/20 10:39, local time: 2025/10/30 23:10, 
 
216.73.216.219,10-1-97-123:LOG IN | 
| ©2025 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://ecomorder.com/techref/language/ccpp/Cref/MAN/setuid.htm"> setuid</A> | 
| Did you find what you needed? | 
| Welcome to ecomorder.com! | 
| Welcome to ecomorder.com! | 
.