Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: July 2017
 
 

lgrp_children(3LGRP)

Name

lgrp_children - get children of given lgroup

Synopsis

cc [ flag … ] file–llgrp [ library … ] 
#include <sys/lgrp_user.h>

int lgrp_children(lgrp_cookie_t cookie, lgrp_id_t parent,
     lgrp_id_t *lgrp_array, uint_t lgrp_array_size);

Description

The lgrp_children() function takes a cookie representing a snapshot of the lgroup hierarchy retrieved from lgrp_init(3LGRP) and returns the number of lgroups that are children of the specified lgroup. If the lgrp_array and lgrp_array_size arguments are non-null, the array is filled with as many of the children lgroup IDs as will fit, given the size of the array.

Return Values

The lgrp_children() function returns the number of child lgroup IDs. Otherwise, it returns −1 and sets errno to indicate the error.

Errors

The lgrp_children() function will fail if:

EINVAL

The specified lgroup ID is not valid or the cookie is NULL.

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 Also

lgrp_init(3LGRP), lgrp_nlgrps(3LGRP), lgrp_parents(3LGRP), liblgrp(3LIB), attributes(5)