1lgrp_children(3LGRP)   Locality Group Library Functions   lgrp_children(3LGRP)
2
3
4

NAME

6       lgrp_children - get children of given lgroup
7

SYNOPSIS

9       cc [ flag ... ] file... -llgrp [ library ... ]
10       #include <sys/lgrp_user.h>
11
12       int lgrp_children(lgrp_cookie_t cookie, lgrp_id_t parent,
13            lgrp_id_t *lgrp_array, uint_t lgrp_array_size);
14
15

DESCRIPTION

17       The  lgrp_children() function takes a cookie representing a snapshot of
18       the lgroup hierarchy retrieved from lgrp_init(3LGRP)  and  returns  the
19       number  of  lgroups  that  are children of the specified lgroup. If the
20       lgrp_array and lgrp_array_size arguments are  non-null,  the  array  is
21       filled  with  as many of the children lgroup IDs as will fit, given the
22       size of the array.
23

RETURN VALUES

25       − returns the number of child lgroup IDs. Otherwise, it returns −1  and
26       sets errno to indicate the error.
27

ERRORS

29       The lgrp_children() function will fail if:
30
31       EINVAL    The  specified  lgroup  ID  is  not  valid  or  the cookie is
32                 invalid.
33
34
35       ESRCH     The specified lgroup ID was not found.
36
37

ATTRIBUTES

39       See attributes(5) for descriptions of the following attributes:
40
41
42
43
44       ┌─────────────────────────────┬─────────────────────────────┐
45       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
46       ├─────────────────────────────┼─────────────────────────────┤
47       │Interface Stability          │Evolving                     │
48       ├─────────────────────────────┼─────────────────────────────┤
49       │MT-Level                     │MT-Safe                      │
50       └─────────────────────────────┴─────────────────────────────┘
51

SEE ALSO

53       lgrp_init(3LGRP),       lgrp_nlgrps(3LGRP),        lgrp_parents(3LGRP),
54       liblgrp(3LIB), attributes(5)
55
56
57
58SunOS 5.11                        16 Apr 2003             lgrp_children(3LGRP)
Impressum