


      SETUID(2)                   (UNIX 5.0)                  SETUID(2)



      NAME
           setuid, setgid - set user and group IDs

      SYNTAX
           int setuid (uid)
           int uid;

           int setgid (gid)
           int gid;

      DESCRIPTION
           Setuid (setgid) is used to set the real user (group) ID and
           effective user (group) ID of the calling process.

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

           Setuid (setgid) 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]

      RETURN VALUE
           Upon successful completion, a value of 0 is returned.
           Otherwise, a value of -1 is returned and errno is set to
           indicate the error.

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






















      Page 1                                         (73 A2 02MTA REV1)



