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


NAME


lgrp_view - get view of lgroup hierarchy

SYNOPSIS


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

lgrp_view_t lgrp_view(lgrp_cookie_t cookie);


DESCRIPTION


The lgrp_view() function takes a cookie representing the snapshot of the
lgroup hierarchy obtained from lgrp_init(3LGRP) and returns the
snapshot's view of the lgroup hierarchy.


If the given view is LGRP_VIEW_CALLER, the snapshot contains only the
resources that are available to the caller (such as those with respect to
processor sets). When the view is LGRP_VIEW_OS, the snapshot contains
what is available to the operating system.

RETURN VALUES


Upon successful completion, lgrp_view() returns the view for the snapshot
of the lgroup hierarchy represented by the given cookie. Otherwise, -1
is returned and errno is set to indicate the error.

ERRORS


The lgrp_view() 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 ALSO


lgrp_cookie_stale(3LGRP), lgrp_fini(3LGRP), lgrp_init(3LGRP),
liblgrp(3LIB), attributes(5)


April 9, 2016 LGRP_VIEW(3LGRP)