Locality Group Library Functions              lgrpparents(3LGRP)



NAME
     lgrpparents - get parents of given lgroup

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

     int lgrpparents(lgrpcookiet cookie, lgrpidt child,
          lgrpidt *lgrparray, uintt lgrparraysize);


DESCRIPTION
     The lgrpparents() function takes a  cookie  representing  a
     snapshot    of    the   lgroup   hierarchy   obtained   from
     lgrpinit(3LGRP) and returns the number of parent lgroups of
     the  specified  lgroup.  If  lgrparray  is non-null and the
     lgrparraysize is non-zero, the array  is  filled  with  as
     many  of the parent lgroup IDs as will fit given the size of
     the array. For  the  root  lgroup,  the  number  of  parents
     returned is 0 and the lgrparray argument is not filled in.

RETURN VALUES
     Upon  successful  completion,  lgrpparents()  returns   the
     number  of  parent lgroup IDs. Otherwise, -1 is returned and
     errno is set to indicate the error.

ERORS
     The lgrpparents() function will fail if:

     EINVAL    The specified cookie or lgroup ID is not valid.


     ESRCH     The specified lgroup ID was not found.


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

















SunOS 5.11          Last change: 16 Apr 2003                    1






Locality Group Library Functions              lgrpparents(3LGRP)



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


SEE ALSO
     lgrpchildren(3LGRP), lgrpinit(3LGRP),  lgrpnlgrps(3LGRP),
     liblgrp(3LIB), attributes(5)











































SunOS 5.11          Last change: 16 Apr 2003                    2