Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

setreuid(2)							   setreuid(2)

NAME
       setreuid - set real and effective user IDs

SYNOPSIS
DESCRIPTION
       The  function  sets  the	 real  and  effective  user IDs of the current
       process to the values specified by the ruid and euid arguments. If ruid
       or  euid is −1, the corresponding effective or real user ID of the cur‐
       rent process is left unchanged.

       A process with appropriate privileges can set either ID to  any	value.
       An  unprivileged process can only set the effective user ID if the euid
       argument is equal to either the real, effective, or saved  user	ID  of
       the process.

       It  is  unspecified whether a process without appropriate privileges is
       permitted to change the real user ID to match the current real,	effec‐
       tive or saved user ID of the process.

RETURN VALUE
       Upon  successful	 completion,  0 is returned. Otherwise, −1 is returned
       and is set to indicate the error.

ERRORS
       The function will fail if:

	      [EINVAL]		       The value of the ruid or euid  argument
				       is invalid or out-of-range.

	      [EPERM]		       The   current  process  does  not  have
				       appropriate privileges, and  either  an
				       attempt	was  made to change the effec‐
				       tive user ID to a value other than  the
				       real  user  ID or the saved set-user-ID
				       or an attempt was made  to  change  the
				       real  user  ID to a value not permitted
				       by the implementation.

SEE ALSO
       getuid(2), setuid(2), <unistd.h>.

CHANGE HISTORY
       First released in Issue 4, Version 2.

								   setreuid(2)

Vote for polarhome