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 succesful completion, lgrp_view() returns the view for the snapshot of the lgroup hierarchy represented by the given cookie. Other-
wise, -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)
SunOS 5.11 16 Apr 2003 lgrp_view(3LGRP)