Manual Pages for UNIX Operating System command usage for man lgrp_parents

Locality Group Library Functions              lgrp_parents(3LGRP)



NAME
     lgrp_parents - get parents of given lgroup

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

     int lgrp_parents(lgrp_cookie_t cookie, lgrp_id_t child,
          lgrp_id_t *lgrp_array, uint_t lgrp_array_size);


DESCRIPTION
     The lgrp_parents() function takes a  cookie  representing  a
     snapshot    of    the   lgroup   hierarchy   obtained   from
     lgrp_init(3LGRP) and returns the number of parent lgroups of
     the  specified  lgroup.  If  lgrp_array  is non-null and the
     lgrp_array_size 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 lgrp_array argument is not filled in.

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

ERRORS
     The lgrp_parents() function will fail if:

     EINVAL    The specified cookie or lgroup ID 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: 16 Apr 2003                    1






Locality Group Library Functions              lgrp_parents(3LGRP)



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


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











































SunOS 5.11          Last change: 16 Apr 2003                    2