1pool_component_iPnofool(3CPoOnOfLi)guration Manipulation LibrarpyooFlu_nccotmipoonnsent_info(3POOL)
2
3
4
6 pool_component_info, pool_get_owning_resource - resource pool component
7 functions
8
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
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
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
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
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
84 libpool(3LIB), pool_error(3POOL), attributes(5)
85
86
87
88SunOS 5.11 23 Sep 2003 pool_component_info(3POOL)