setruid(3) [osf1 man page]

setruid(3)						     Library Functions Manual							setruid(3)

NAME

       setruid, seteuid - Set the process's user IDs

LIBRARY

       Standard C Library (libc.a)

SYNOPSIS

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

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 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: 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.

RELATED INFORMATION

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

																	setruid(3)

Check Out this Related Man Page

SETRUID(3)						   BSD Library Functions Manual 						SETRUID(3)

NAME

     setruid, setrgid -- set user and group ID

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     int
     setruid(uid_t ruid);

     int
     setrgid(gid_t rgid);

DESCRIPTION

     The setruid() function (setrgid()) sets the real user ID (group ID) of the current process.

RETURN VALUES

     Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the
     error.

COMPATIBILITY

     The use of these calls is not portable.  Their use is discouraged; they will be removed in the future.

ERRORS

     The functions fail if:

     [EPERM]		The user is not the super user and the ID specified is not the real or effective ID.

SEE ALSO

     getgid(2), getuid(2), setegid(2), seteuid(2), setgid(2), setuid(2)

HISTORY

     The setruid() and setrgid() syscalls appeared in 4.2BSD and were dropped in 4.4BSD.

BSD
								   June 2, 1993 							       BSD

Linux and UNIX Man Pages

setruid(3) [osf1 man page]

Check Out this Related Man Page