NAME    [Toc]    [Back]

       setruid, seteuid - Set the process's user IDs

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int setruid(
               uid_t ruid ); int seteuid(
               uid_t euid );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies  the  effective  user  ID to set.  Specifies the
       real user ID to set.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       If  the seteuid() or setruid()function fails, errno is set
       to the following 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    [Toc]    [Back]

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



                                                       setruid(3)