lgrp_view(3LGRP) Locality Group Library Functions lgrp_view(3LGRP)NAMElgrp_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 con‐
tains what is available to the operating system.
RETURN VALUES
Upon succesful completion, lgrp_view() returns the view for the snap‐
shot 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 ALSOlgrp_cookie_stale(3LGRP), lgrp_fini(3LGRP), lgrp_init(3LGRP),
liblgrp(3LIB), attributes(5)SunOS 5.10 16 Apr 2003 lgrp_view(3LGRP)