Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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 NULL.

Attributes

See attributes(7) for descriptions of the following attributes:

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(7)