rs_numrads Subroutine

Purpose

Returns the number of system resource allocation domains (RADs) that have available resources.

Library

Standard C library (libc.a)

Syntax

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

Description

The rs_numrads subroutine returns the number of system RADs at system detail level sdl, that have available resources contained in the resource set identified by the rset parameter.

The number of atomic RADs contained in the rset parameter is returned if the sdl parameter is equal to the maximum system detail level.

Parameters

Item Description
rset Specifies the resource set handle for the resource set being queried.
sdl Specifies the system detail level in which the caller is interested.
flags Reserved for future use. Specify as 0.

Return Values

If successful, the number of available RADs at system detail level sdl, that have resources contained in the specified resource set is returned. If unsuccessful, a value of -1 is returned and the errno global variable is set to indicate the error.

Error Codes

The rs_numrads subroutine is unsuccessful if 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.
EFAULT Invalid address.