setresuid(2)                                                   setresuid(2)




 NAME    [Toc]    [Back]
      setresuid, setresgid - set real, effective, and saved user and group
      IDs

 SYNOPSIS    [Toc]    [Back]
      #include <unistd.h>

      int setresuid(uid_t ruid, uid_t euid, uid_t suid);

      int setresgid(gid_t rgid, gid_t egid, gid_t sgid);

 DESCRIPTION    [Toc]    [Back]
      setresuid() sets the real, effective and/or saved user ID of the
      calling process.

      If the current real, effective or saved user ID is equal to that of a
      user having appropriate privileges, setresuid() sets the real,
      effective and saved user IDs to ruid, euid, and suid, respectively.
      Otherwise, setresuid() only sets the real, effective, and saved user
      IDs if ruid, euid, and suid each match at least one of the current
      real, effective, or saved user IDs.

      If ruid, euid, or suid is -1, setresuid() leaves the current real,
      effective or saved user ID unchanged.

      setresgid() sets the real, effective and/or saved group ID of the
      calling process.

      If the current real, effective or saved user ID is equal to that of a
      user having appropriate privileges, setresgid() sets the real,
      effective, and saved group ID to rgid, egid, and sgid, respectively.
      Otherwise, setresgid() only sets the real, effective and saved group
      ID if rgid, egid, and sgid each match at least one of the current
      real, effective or saved group ID.

      If rgid, egid, or sgid is -1, setresgid() leaves the current real,
      effective or saved group ID unchanged.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, setresuid() and setresgid() return 0;
      otherwise, they return -1 and set errno to indicate the error.

 ERRORS    [Toc]    [Back]
      setresuid() and setresgid() fail if any of the following conditions
      are encountered:

           [EINVAL]       ruid, euid, or suid (rgid, egid, or sgid) is not a
                          valid user (group) ID.

           [EPERM]        None of the conditions above are met.




 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 setresuid(2)                                                   setresuid(2)




 AUTHOR    [Toc]    [Back]
      setresuid() and setresgid() were developed by HP.

 SEE ALSO    [Toc]    [Back]
      exec(2), getuid(2), setuid(2).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003