manpagez: man pages & more
man setreuid(2)
Home | html | info | man
setreuid(2)                 BSD System Calls Manual                setreuid(2)


NAME

     setreuid -- set real and effective user IDs


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <unistd.h>

     int
     setreuid(uid_t ruid, uid_t euid);


DESCRIPTION

     The real and effective user IDs of the current process are set according
     to the arguments.  If ruid or euid is -1, the current uid is filled in by
     the system.  Unprivileged users may change the real user ID to the effec-
     tive user ID and vice-versa; only the super-user may make other changes.

     The setreuid() function has been used to swap the real and effective user
     IDs in set-user-ID programs to temporarily relinquish the set-user-ID
     value.  This purpose is now better served by the use of the seteuid()
     function (see setuid(2)).

     When setting the real and effective user IDs to the same value, the stan-
     dard setuid() function is preferred.


RETURN VALUES

     The setreuid() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.


ERRORS

     [EPERM]            The current process is not the super-user and a change
                        other than changing the effective user-id to the real
                        user-id was specified.


SEE ALSO

     getuid(2), issetugid(2), seteuid(2), setuid(2)


HISTORY

     The setreuid() system call appeared in 4.2BSD.

BSD                            February 8, 2001                            BSD

Mac OS X 10.9.1 - Generated Mon Jan 6 15:24:46 CST 2014
© manpagez.com 2000-2022
Individual documents may contain additional copyright information.