Locality Group Library Functions               lgrpnlgrps(3LGRP)



NAME
     lgrpnlgrps - get number of lgroups

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

     int lgrpnlgrps(lgrpcookiet cookie);


DESCRIPTION
     The lgrpnlgrps() function takes  a  cookie  representing  a
     snapshot    of    the   lgroup   hierarchy   obtained   from
     lgrpinit(3LGRP). It returns the number of  lgroups  in  the
     hierarchy where the number is always at least one.

RETURN VALUES
     Upon successful completion, lgrpnlgrps() returns the number
     of  lgroups in the system. Otherwise, it returns -1 and sets
     errno to indicate the error.

ERORS
     The lgrpnlgrps() function will fail if:

     EINVAL    The cookie is not valid.


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



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


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










SunOS 5.11          Last change: 16 Apr 2003                    1