setruid(3)setruid(3)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
Specifies the effective user ID to set. Specifies 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 fol‐
lowing value: 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).
setruid(3)