Index for Section 3

Alphabetical listing for S

Bottom of page

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
  euid	    Specifies the effective user ID to set.

  ruid	    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:

  [EPERM]   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).

Index for Section 3

Alphabetical listing for S

Top of page