Technical Reference: Kernel and Subsystems, Volume 1

krs_getrad Subroutine

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

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

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.

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.

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

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.