Locality Group Library Functions lgrp_view(3LGRP)
NAME
lgrp_view - get view of lgroup hierarchy
SYNOPSIS
cc [ flag ... ] file... -llgrp [ library ... ]
#include
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 fromlgrp_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 isLGRP_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 thegiven 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 attri-
butes:SunOS 5.11 Last change: 16 Apr 2003 1
Locality Group Library Functions lgrp_view(3LGRP)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
lgrp_cookie_stale(3LGRP), lgrp_fini(3LGRP),
lgrp_init(3LGRP), liblgrp(3LIB), attributes(5)
SunOS 5.11 Last change: 16 Apr 2003 2