krs_getrad Subroutine

Purpose

Returns a system resource allocation domain (RAD) contained in an input resource set.

Syntax

#include <sys/rset.h>
int krs_getrad (rad, sdl, index, flags)
rsethandle_t rad;
unsigned int sdl;
unsigned int index;
unsigned int flags;

Description

The krs_getrad subroutine returns a system RAD at a specified system detail level and index.

The system RAD is specified by system detail level sdl and index number index.

The rad parameter must be allocated (using the krs_alloc subroutine) prior to calling the krs_getrad subroutine.

Parameters

Item Description
rad Specifies a resource set handle to receive the desired system RAD.
sdl Specifies the system detail level of the desired system RAD.
index Specifies the index of the system RAD that should be returned from among those at the specified sdl. This parameter must belong to the [0, krs_numrads(rset, sdl, flags)- 1] interval.
flags Reserved for future use. Specify as 0.

Return Values

Upon successful completion, the krs_getrad subroutine returns a 0. If unsuccessful, one or more of the following are true:

Item Description
EINVAL One of the following is true:
  • The flags parameter contains an invalid value.
  • The sdl parameter is greater than the maximum system detail level.
  • The RAD specified by the index parameter does not exist at the system detail level specified by the sdl parameter.
EFAULT Invalid address.