Locality Group Library Functions             lgrpchildren(3LGRP)



NAME
     lgrpchildren - get children of given lgroup

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

     int lgrpchildren(lgrpcookiet cookie, lgrpidt parent,
          lgrpidt *lgrparray, uintt lgrparraysize);


DESCRIPTION
     The lgrpchildren() function takes a cookie  representing  a
     snapshot    of   the   lgroup   hierarchy   retrieved   from
     lgrpinit(3LGRP) and returns the number of lgroups that  are
     children  of  the  specified  lgroup.  If the lgrparray and
     lgrparraysize arguments are non-null, the array is  filled
     with  as  many of the children lgroup IDs as will fit, given
     the size of the array.

RETURN VALUES
     - returns the number of  child  lgroup  IDs.  Otherwise,  it
     returns -1 and sets errno to indicate the error.

ERORS
     The lgrpchildren() function will fail if:

     EINVAL    The specified lgroup ID is not valid or the cookie
               is invalid.


     ESRCH     The specified lgroup ID was not found.


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



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


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



SunOS 5.11          Last change: 16 Apr 2003                    1