Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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 is NULL, or the lgroup ID or type is not valid.

ESRCH

The specified lgroup ID was not found.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See Also

lgrp_children(3LGRP), lgrp_init(3LGRP), lgrp_parents(3LGRP), liblgrp(3LIB), attributes(7)