SETUID(2)            INTERACTIVE UNIX System            SETUID(2)



          NAME
               setuid, setgid - set user and group IDs

          SYNOPSIS
               int setuid (uid)
               int uid;

               int setgid (gid)
               int gid;

          DESCRIPTION
               The setuid (setgid) system call is used to set the real user
               (group) ID and effective user (group) ID of the calling pro-
               cess.

               If the effective user ID of the calling process is super-
               user, the real user (group) ID and effective user (group) ID
               are set to uid (gid).

               If the effective user ID of the calling process is not
               super-user, but its real user (group) ID is equal to uid
               (gid), the effective user (group) ID is set to uid (gid).

               If the effective user ID of the calling process is not
               super-user, but the saved set-user (group) ID from exec(2)
               is equal to uid (gid), the effective user (group) ID is set
               to uid (gid).

               The setuid (setgid) system call will fail if the real user
               (group) ID of the calling process is not equal to uid (gid)
               and its effective user ID is not super-user.  [EPERM]

               The uid (gid) is out of range.  [EINVAL]

          SEE ALSO
               getuid(2), intro(2).

          DIAGNOSTICS
               Upon successful completion, a value of 0 is returned.  Oth-
               erwise, a value of -1 is returned, and errno is set to indi-
               cate the error.














          Rev. C Software Development Set                            Page 1