LGRP_NLGRPS(3LGRP) Locality Group Library Functions 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 not valid.

ATTRIBUTES

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


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

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

April 16, 2003 LGRP_NLGRPS(3LGRP)