lgrp_resources(3LGRP) Locality Group Library Functions lgrp_resources(3LGRP)
NAME
lgrp_resources - get lgroup resources of given lgroup
SYNOPSIS
cc [ flag ... ] file... -llgrp [ library ... ]
#include <sys/lgrp_user.h>
int lgrp_resources(lgrp_cookie_t cookie, lgrp_id_t lgrp,
lgrp_id_t *lgrpids, uint_t count, lgrp_rsrc_t type);
DESCRIPTION
The lgrp_resources() function takes a cookie representing a snapshot of the lgroup hierarchy obtained from lgrp_init(3LGRP) and returns
the number of resources in the lgroup specified by lgrp. The resources are represented by a set of lgroups in which each lgroup directly
contains CPU and/or memory resources.
The type argument should be set to one of the following values to specify whether the CPU or memory resources should be returned:
LGRP_RSRC_CPU /* CPU resources */
LGRP_RSRC_MEM /* Memory resources */
If the lgrpids[] argument is non-null and the count argument is non-zero, lgrp_resources() stores up to the specified count of lgroup IDs
into the lgrpids[] array.
RETURN VALUES
Upon successful completion, lgrp_resources() returns the number of lgroup resources. Otherwise, -1 is returned and errno is set to
indicate the error.
ERRORS
The lgrp_resources() function will fail if:
EINVAL The specified cookie, lgroup ID, or type is not valid.
ESRCH The specified lgroup ID was not found.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
lgrp_children(3LGRP), lgrp_init(3LGRP), lgrp_parents(3LGRP), liblgrp(3LIB), attributes(5)
SunOS 5.11 26 Jan 2005 lgrp_resources(3LGRP)