LGRP_RESOURCES(3LGRP)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 │ Evolving │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSOlgrp_children(3LGRP), lgrp_init(3LGRP), lgrp_parents(3LGRP),
liblgrp(3LIB), attributes(5)
Jan 26, 2005 LGRP_RESOURCES(3LGRP)