SETUID(S)                XENIX System V                 SETUID(S)



     Name
          setuid, setgid - Sets user and group IDs.

     Syntax
          int setuid (uid)
          int uid;

          int setgid (gid)
          int gid;

     Description
          setuid is used to set the real user ID and effective user ID
          of the calling process.

          setgid is used to set the real group ID and effective 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 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 is out of range.  [EINVAL]

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

     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(S), intro(S)












     Page 1                                           (printed 8/7/87)