NAME

setruid, seteuid − Set the process’s user IDs

SYNOPSIS

#include <unistd.h>
int setruid(
        uid_t ruid ); int seteuid(
        uid_t euid );

LIBRARY

Standard C Library (libc)

PARAMETERS

euidSpecifies the effective user ID to set. 

ruidSpecifies the real user ID to set. 

DESCRIPTION

The setruid() and seteuid() functions reset the process’s real and effective user IDs,  respectively. 

A process with the superuser privilege can set either ID to any value.  An unprivileged process can only set the effective user ID if the euid parameter  is equal to either the real, effective, or saved user ID of the  process.  An unprivileged process cannot set the real user ID. 

RETURN VALUES

Upon successful completion, the seteuid() and setruid()functions return a value of 0 (zero).  Otherwise, a value of -1 is returned and errno is  set to indicate the error. 

ERRORS

If the seteuid() or setruid()function fails, errno is set to the following value:

[EPERM]
The euid parameter is  not equal to either the real or saved user IDs of the process and  the calling process does not have appropriate privilege. 

SEE ALSO

Functions: getuid(2), , setreuid(2).