setroles Subroutine

Purpose

Set the role IDs of the current process.

Library

Standard C Library (libc.a)

Syntax

#include <unistd.h>
#include <sys/types.h>
#include <sys/cred.h> 
int setroles(roles, nroles)
rid_t *roles;
int nroles;

Description

The setroles subroutine sets the supplementary role ID of the process. The number of roles that the setroles subroutine can set is no greater than the value specified by the MAX_ROLES constant in the cred structure of a process. The MAX_ROLES constant is defined in the sys/cred.h header file.

Parameters

Item	Description
roles	Points to the array of role IDs to be established.
nroles	Indicates the number of entries in the roles parameter.

Return Values

Item	Description
0	The subroutine ran successfully.
-1	An error occurred. The errno global variable is set to indicate the error.

Error Codes

The setroles subroutine fails if any of the following are true:

Item	Description
EFAULT	The roles and nroles parameters specify an array that is partially or completely outside of the process' allocated address space.
EINVAL	The value of the nroles parameter is either less than 0 or greater than the MAX_ROLES value.
EPERM	The calling process does not have the PV_DAC_RID privilege in its effective privilege set.