Locality Group Library Functions                 lgrpview(3LGRP)



NAME
     lgrpview - get view of lgroup hierarchy

SYNOPSIS
     cc [ flag ... ] file... -llgrp [ library ... ]
     #include 

     lgrpviewt lgrpview(lgrpcookiet cookie);


DESCRIPTION
     The lgrpview() function takes  a  cookie  representing  the
     snapshot    of    the   lgroup   hierarchy   obtained   from
     lgrpinit(3LGRP) and returns  the  snapshot's  view  of  the
     lgroup hierarchy.


     If the given view is LGRPVIEWCALER, the snapshot contains
     only the resources that are available to the caller (such as
     those with respect to processor sets).   When  the  view  is
     LGRPVIEWOS, the snapshot contains what is available to the
     operating system.

RETURN VALUES
     Upon succesful completion, lgrpview() 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.

ERORS
     The lgrpview() function will fail if:

     EINVAL    The cookie is not valid.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

















SunOS 5.11          Last change: 16 Apr 2003                    1






Locality Group Library Functions                 lgrpview(3LGRP)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     lgrpcookiestale(3LGRP),                  lgrpfini(3LGRP),
     lgrpinit(3LGRP), liblgrp(3LIB), attributes(5)











































SunOS 5.11          Last change: 16 Apr 2003                    2