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)