LGRP_NLGRPS(3LGRP) Locality Group Library Functions LGRP_NLGRPS(3LGRP)

lgrp_nlgrps - get number of lgroups

cc [ flag ... ] file... -llgrp [ library ... ]
#include <sys/lgrp_user.h>
int lgrp_nlgrps(lgrp_cookie_t cookie);

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.

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

The lgrp_nlgrps() function will fail if:


The cookie is not valid.

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

Interface Stability Evolving
MT-Level MT-Safe

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

April 16, 2003 OmniOS