Index for Section 3

Alphabetical listing for S

Bottom of page

setrgid(3)
NAME
  setrgid, setegid - Set the process's group IDs

SYNOPSIS
  #include <sys/types.h>

  int setrgid(
		  gid_t rgid );

  int setegid(
	  gid_t egid );

LIBRARY
  Standard C Library (libc)

PARAMETERS
  rgid
      Specifies the value of the real group ID to be set.

  egid
      Specifies the value of the effective group ID to be set.

DESCRIPTION
  The setegid() function sets the process's effective group ID to the value
  of the egid parameter if the egid parameter is equal to the current real,
  effective, or saved group ID.

  The setrgid() function sets the process's real group ID to the value of the
  rgid parameter.

  Only the superuser may change the real or effective group ID to a value
  other than the current real or saved group ID of the process.

RETURN VALUES
  Upon successful completion, the setegid() and setrgid() functions return a
  value of 0 (zero). If either function fails, a value of -1 is returned and
  errno is set to indicate the error.

ERRORS
  If the setrgid() or setegid() function fails, errno is set to one of the
  following values:

  [EPERM]
      The rgid or egid parameter is not equal to either the real or saved
      group IDs of the process and the calling process does not have
      superuser privilege.

SEE ALSO
  Functions: getgroups(2), setgroups(2), setluid(3),

  Commands: groups(1).

Index for Section 3

Alphabetical listing for S

Top of page