Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

lgrp_nlgrps(3LGRP)

Name

lgrp_nlgrps - get number of lgroups

Synopsis

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

int lgrp_nlgrps(lgrp_cookie_t cookie);

Description

The lgrp_nlgrps() function takes a cookie representing a snapshot of the lgroup hierarchy obtained from lgrp_init(3LGRP). It returns the number of lgroups in the hierarchy where the number is always at least one.

Return Values

Upon successful completion, lgrp_nlgrps() returns the number of lgroups in the system. Otherwise, it returns −1 and sets errno to indicate the error.

Errors

The lgrp_nlgrps() function will fail if:

EINVAL

The cookie is NULL.

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)