1pool_component_iPnofool(3CPoOnOfLi)guration Manipulation LibrarpyooFlu_nccotmipoonnsent_info(3POOL)
2
3
4

NAME

6       pool_component_info, pool_get_owning_resource - resource pool component
7       functions
8

SYNOPSIS

10       cc [ flag... ] file... -lpool [ library... ]
11       #include <pool.h>
12
13       const char *pool_component_info(pool_conf_t *conf,
14            pool_component_t *component, int flags);
15
16
17       pool_resource_t *pool_get_owning_resource(pool_conf_t *conf,
18            pool_component_t *component);
19
20

DESCRIPTION

22       Certain resources, such as processor sets,  are  composed  of  resource
23       components.  Informational  and ownership attributes of resource compo‐
24       nents  are  made   available   with   the   pool_component_info()   and
25       pool_get_owning_resource()  functions. The conf argument for each func‐
26       tion refers to the target configuration to which the operation applies.
27
28
29       The pool_component_info() function returns a string  describing  compo‐
30       nent. The string is allocated with malloc(3C). The caller is reponsible
31       for freeing the returned string. The flags argument is ignored.
32
33
34       The pool_get_owning_resource() function returns the resource  currently
35       containing component.  Every component is contained by a resource.
36

RETURN VALUES

38       Upon  successful  completion,  pool_component_info()  returns a string.
39       Otherwise it returns NULL and pool_error(3POOL) returns  the  pool-spe‐
40       cific error value.
41
42
43       Upon successful completion, pool_get_owning_resource() returns the own‐
44       ing resource. Otherwise it returns NULL and  pool_error()  returns  the
45       pool-specific error value.
46

ERRORS

48       The pool_component_info() function will fail if:
49
50       POE_BADPARAM        The   supplied   configuration's   status   is  not
51                           POF_VALID or the flags paramter is neither 0 or 1.
52
53
54       POE_INVALID_CONF    The configuration is invalid.
55
56
57       POE_SYSTEM          A system error has occurred. Check the system error
58                           code for more details.
59
60
61
62       The pool_get_owning_resource() function will fail if:
63
64       POE_BADPARAM    The supplied configuration's status is not POF_VALID.
65
66

ATTRIBUTES

68       See attributes(5) for descriptions of the following attributes:
69
70
71
72
73       ┌─────────────────────────────┬─────────────────────────────┐
74       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
75       ├─────────────────────────────┼─────────────────────────────┤
76       │CSI                          │Enabled                      │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Unstable                     │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT-Level                     │Safe                         │
81       └─────────────────────────────┴─────────────────────────────┘
82

SEE ALSO

84       libpool(3LIB), pool_error(3POOL), attributes(5)
85
86
87
88SunOS 5.11                        23 Sep 2003       pool_component_info(3POOL)
Impressum