Manual Pages for UNIX Operating System command usage for man lgrp_resources

Locality Group Library Functions            lgrp_resources(3LGRP)



NAME
     lgrp_resources - get lgroup resources of given lgroup

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

     int lgrp_resources(lgrp_cookie_t cookie, lgrp_id_t lgrp,
          lgrp_id_t *lgrpids, uint_t count, lgrp_rsrc_t type);


DESCRIPTION
     The lgrp_resources() function takes a  cookie   representing
     a   snapshot   of   the   lgroup   hierarchy  obtained  from
     lgrp_init(3LGRP) and returns the number of resources in  the
     lgroup  specified by lgrp.  The resources are represented by
     a set of lgroups in which each lgroup directly contains  CPU
     and/or memory resources.


     The type argument should be set  to  one  of  the  following
     values to specify whether the CPU or memory resources should
     be returned:

       LGRP_RSRC_CPU      /* CPU resources */
       LGRP_RSRC_MEM      /* Memory resources */



     If the lgrpids[] argument is non-null and the count argument
     is  non-zero,  lgrp_resources()  stores  up to the specified
     count of lgroup IDs into the lgrpids[] array.

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

ERRORS
     The lgrp_resources() function will fail if:

     EINVAL    The specified cookie, lgroup  ID, or type  is  not
               valid.


     ESRCH     The specified lgroup ID was not found.


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




SunOS 5.11          Last change: 26 Jan 2005                    1






Locality Group Library Functions            lgrp_resources(3LGRP)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     lgrp_children(3LGRP), lgrp_init(3LGRP), lgrp_parents(3LGRP),
     liblgrp(3LIB), attributes(5)











































SunOS 5.11          Last change: 26 Jan 2005                    2