Locality Group Library Functions lgrp_nlgrps(3LGRP)
NAME
lgrp_nlgrps - get number of lgroups
SYNOPSIS
cc [ flag ... ] file... -llgrp [ library ... ]
#include
int lgrp_nlgrps(lgrp_cookie_t cookie);
DESCRIPTION
The lgrp_nlgrps() function takes a cookie representing a
snapshot of the lgroup hierarchy obtained fromlgrp_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 attri-
butes:____________________________________________________________
| 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(5)SunOS 5.11 Last change: 16 Apr 2003 1