Index for Section 3

Alphabetical listing for S

Bottom of page

setruid(3)
NAME
  setruid, seteuid - Set the process's user IDs

SYNOPSIS
  #include <unistd.h>

  int setruid(
	  uid_t ruid );

  int seteuid(
	  uid_t euid );

LIBRARY
  Standard C Library (libc)

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

SEE ALSO
  Functions: getuid(2), , setreuid(2).

Index for Section 3

Alphabetical listing for S

Top of page