LGRP_VIEW(3LGRP)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 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)
Apr 16, 2003 LGRP_VIEW(3LGRP)