krs_getassociativity Subroutine
Purpose
Gets the hardware associativity values for a resource.
Syntax
#include <sys/rset.h>
int krs_getassociativity (type, id, assoc_array, array_size)
unsigned int type;
unsigned int id;
unsigned int *assoc_array;
unsigned int array_size;Description
The krs_getassociativity subroutine returns the array of hardware associativity values for a specified resource.
This is a special purpose subroutine intended for specialized root applications needing the hardware associativity value information. The krs_getinfo, krs_getrad, and krs_numrads subroutines are provided for typical applications to discover system hardware topology.
The calling process must have root authority to get hardware associativity values.
Parameters
| Item | Description |
|---|---|
| type | Specifies the resource type whose associativity values are requested. The only value supported to retrieve values for a processor is R_PROCS. |
| id | Specifies the logical resource id whose associativity values are requested. |
| assoc_array | Specifies the address of an array of unsigned integers to receive the associativity values. |
| array_size | Specifies the number of unsigned integers in assoc_array. |
Return Values
Upon
successful completion, the krs_getassociativity subroutine
returns a 0. The assoc_array parameter array contains the resource's
associativity values. The first entry in the array indicates the number
of associativity values returned. If the hardware system does not
provide system topology data, a value of 0 is returned in the first
array entry. If unsuccessful, one or more of the following are returned:
| Item | Description |
|---|---|
| EINVAL | One of the following occurred:
|
| ENODEV | The resource specified by the id parameter does not exist. |
| EFAULT | Invalid address. |
| EPERM | The calling process does not have root authority. |