lgrp_resources(3LGRP) Locality Group Library Functions lgrp_resources(3LGRP)NAMElgrp_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 spec‐
ify 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 indi‐
cate 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 │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlgrp_children(3LGRP), lgrp_init(3LGRP), lgrp_parents(3LGRP),
liblgrp(3LIB), attributes(5)SunOS 5.11 26 Jan 2005 lgrp_resources(3LGRP)