osf1 man page for setruid

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)