lgrp_nlgrps(3LGRP) Locality Group Library Functions lgrp_nlgrps(3LGRP)NAMElgrp_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 not valid.
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)SunOS 5.10 16 Apr 2003 lgrp_nlgrps(3LGRP)