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

NAME

6       lgrp_parents - get parents of given lgroup
7

SYNOPSIS

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

DESCRIPTION

17       The  lgrp_parents()  function takes a cookie representing a snapshot of
18       the lgroup hierarchy obtained from  lgrp_init(3LGRP)  and  returns  the
19       number of parent lgroups of the specified lgroup. If lgrp_array is non-
20       null and the lgrp_array_size is non-zero, the array is filled  with  as
21       many  of the parent lgroup IDs as will fit given the size of the array.
22       For the root lgroup, the number  of  parents  returned  is  0  and  the
23       lgrp_array argument is not filled in.
24

RETURN VALUES

26       Upon successful completion, lgrp_parents() returns the number of parent
27       lgroup IDs. Otherwise, −1 is returned and errno is set to indicate  the
28       error.
29

ERRORS

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

ATTRIBUTES

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

SEE ALSO

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