Print this page
11583 Some man3lib pages are missing parts of the SYNOPSIS
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3lib/libpool.3lib
+++ new/usr/src/man/man3lib/libpool.3lib
1 1 '\" te
2 2 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.
3 3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 -.TH LIBPOOL 3LIB "April 9, 2016"
6 +.TH LIBPOOL 3LIB "Aug 19, 2019"
7 7 .SH NAME
8 8 libpool \- pool configuration manipulation library
9 9 .SH SYNOPSIS
10 -.LP
11 10 .nf
12 -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... [ \fIlibrary\fR... ]
11 +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpool\fR [ \fIlibrary\fR... ]
13 12 #include <\fBpool.h\fR>
14 13 .fi
15 14
16 15 .SH DESCRIPTION
17 -.LP
18 16 The functions in this library define the interface for reading and writing
19 17 resource pools configuration files, as well as that for committing an existing
20 18 configuration to becoming the running OS configuration (with respect to
21 19 partitioning subsystems). The <\fBpool.h\fR> header provides type and function
22 20 declarations for all library services.
23 21 .sp
24 22 .LP
25 23 The resource pools facility brings together process-bindable resources into a
26 24 common abstraction called a pool. Processor sets and other entities can be
27 25 configured, grouped, and labelled in a persistent fashion such that workload
28 26 components can be associated with a subset of a system's total resources. The
29 27 \fBlibpool\fR library provides a C language API for accessing this
30 28 functionality, while \fBpooladm\fR(1M), \fBpoolbind\fR(1M), and
31 29 \fBpoolcfg\fR(1M) make this facility available through command invocations from
32 30 a shell. Each of those manual pages describes aspects of the pools facility;
33 31 this page describes the properties available to the various entities managed
34 32 within the pools facility. These entities include the system, pools, and the
35 33 \fBpset\fR resources for processor sets.
36 34 .sp
37 35 .LP
38 36 When the pools facility is enabled on a system, the behavior of the following
39 37 functions is modified.
40 38 .sp
41 39
42 40 .sp
43 41 .TS
44 42 c c
45 43 l l .
46 44 System Call Error Value
47 45 _
48 46 \fBpset_assign\fR(pset !=\fBPS_QUERY\fR) \fBENOTSUP\fR
49 47 \fBpset_bind\fR(pset !=\fBPS_QUERY\fR) \fBENOTSUP\fR
50 48 \fBpset_create()\fR \fBENOTSUP\fR
51 49 \fBpset_destroy()\fR \fBENOTSUP\fR
52 50 \fBpset_setattr()\fR \fBENOTSUP\fR
53 51 .TE
54 52
55 53 .sp
56 54 .LP
57 55 Each active entity within the resource pools framework can have an arbitrary
58 56 collection of named, typed properties associated with it. Properties supported
59 57 by the pools framework are listed, with descriptions, under each entity below.
60 58 In general, resource properties can be one of five types: boolean (\fBbool\fR),
61 59 signed (\fBint64\fR) and unsigned (\fBuint64\fR) integers, floating point
62 60 (\fBdouble\fR), and \fBstring\fR values.
63 61 .sp
64 62 .LP
65 63 All entities and resources support a string property for commenting purposes;
66 64 this property is available for use by management applications to record
67 65 descriptions and other administrator oriented data. The comment field is not
68 66 used by the default pools commands, except when a configuration is initiated by
69 67 the \fBpoolcfg\fR utility, in which case an informative message is placed in
70 68 the \fBsystem.comment\fR property for that configuration.
71 69 .SS "System"
72 70 .TS
73 71 c c c
74 72 l l l .
75 73 Property name Type Description
76 74 \fBsystem.allocate-method\fR \fBstring\fR T{
77 75 Allocation method to use when this configuration is instantiated
78 76 T}
79 77 \fBsystem.bind-default\fR \fBbool\fR T{
80 78 If specified pool not found, bind to pool with 'pool.default' property set to true
81 79 T}
82 80 \fBsystem.comment\fR \fBstring\fR User description of system
83 81 \fBsystem.name\fR \fBstring\fR User name for the configuration
84 82 \fBsystem.version\fR \fBint64\fR T{
85 83 \fBlibpool\fR version required to manipulate this configuration
86 84 T}
87 85 \fBsystem.poold.log-level\fR \fBstring\fR \fBpoold\fR logging level
88 86 \fBsystem.poold.log-location\fR \fBstring\fR \fBpoold\fR logging location
89 87 \fBsystem.poold.history-file\fR \fBstring\fR \fBpoold\fR decision history location
90 88 \fBsystem.poold.monitor-interval\fR \fBuint64\fR \fBpoold\fR monitoring sample interval
91 89 \fBsystem.poold.objectives\fR \fBstring\fR \fBpoold\fR objectives for a system.
92 90 .TE
93 91
94 92 .sp
95 93 .LP
96 94 The \fBsystem.allocate-method\fR, \fBsystem.bind-default\fR,
97 95 \fBsystem.comment\fR, \fBsystem.name\fR, \fBsystem.poold.log-level\fR,
98 96 \fBsystem.poold.log-location\fR, \fBsystem.poold.history-file\fR,
99 97 \fBsystem.poold.monitor-interval\fR, and \fBsystem.poold.objectives\fR
100 98 properties are writable; the \fBsystem.version\fR property is not.
101 99 .sp
102 100 .LP
103 101 The \fBsystem.allocate-method\fR property accepts only two values, "importance
104 102 based" and "surplus to default". The default value for this property is
105 103 "importance based". The property is optional and if it is not present the
106 104 library will allocate resources as though it were present and had the default
107 105 value. These strings are defined in <\fBpool.h\fR> as \fBPOA_IMPORTANCE\fR and
108 106 \fBPOA_SURPLUS_TO_DEFAULT\fR.
109 107 .sp
110 108 .LP
111 109 If "importance based" allocation is defined, then during a commit the library
112 110 will allocate resources to pools using an algorithm that observes minimum and
113 111 maximum constraints for resources but favors those resources with greater
114 112 importance.
115 113 .sp
116 114 .LP
117 115 If "surplus to default" is defined, then during a commit the library will
118 116 allocate minimum resources to all resource sets apart from default which will
119 117 receive any surplus.
120 118 .sp
|
↓ open down ↓ |
93 lines elided |
↑ open up ↑ |
121 119 .LP
122 120 The \fBsystem.bind-default\fR property defaults to true. This property
123 121 interacts with the \fBproject.pool\fR resource control to specify the binding
124 122 behavior for processes associated with a project. If \fBproject.pool\fR is not
125 123 specified, then this property has no effect. If \fBproject.pool\fR is specified
126 124 and the specified pool exists, this property has no effect. If the specified
127 125 pool does not exist, perhaps because of a reconfiguration, then this property
128 126 controls the binding behavior for the project member. If
129 127 \fBsystem.bind-default\fR is true, then the project member is bound to the
130 128 default pool (identified as the pool for which \fBpool.default\fR is true);
131 -otherise the project member is refused access to the system. Care should be
129 +otherwise the project member is refused access to the system. Care should be
132 130 taken with the pools configuration if this property is set to false, so as to
133 131 avoid denying users access to the system.
134 132 .sp
135 133 .LP
136 134 The various \fBpoold\fR properties are used to configure the operation of
137 135 \fBpoold\fR(1M).
138 136 .sp
139 137 .LP
140 138 The \fBsystem.poold.log-level\fR property is used to specify the level of
141 139 detail provided in log messages. Valid values are: \fBALERT\fR, \fBCRIT\fR,
142 140 \fBERR\fR, \fBWARNING\fR, \fBNOTICE\fR, \fBINFO\fR, and \fBDEBUG\fR.
143 141 .sp
144 142 .LP
145 143 \fBALERT\fR provides the least level of detail, \fBDEBUG\fR the greatest. See
146 144 \fBsyslog\fR(3C) for more information about the meaning of these debug levels.
147 145 If this property is not specified, the default value \fBNOTICE\fR is used.
148 146 .sp
149 147 .LP
150 148 The \fBsystem.poold.log-location\fR property is used to specify the location of
151 149 the logfiles generated by \fBpoold\fR. The special value of "syslog" indicates
152 150 that logged messages should be written to \fBsyslog()\fR. If this property is
153 151 not specified, the default location \fB/var/log/pool\fR is used.
154 152 .sp
155 153 .LP
156 154 The \fBsystem.poold.history-file\fR specifies the location of the decision
157 155 history file which is used by \fBpoold\fR to improve the quality of its
158 156 decision making over time. If this property is not specified, the default
159 157 location \fB/var/adm/pool\fR is used.
160 158 .sp
161 159 .LP
162 160 The \fBsystem.poold.monitor-interval\fR property specifies the monitoring
163 161 interval (in milliseconds) to be used by \fBpoold\fR when sampling utilization
164 162 statistics. If this property is not specified, the default value of 15 seconds
165 163 is used.
166 164 .sp
167 165 .LP
168 166 The \fBsystem.poold.objectives\fR property specifies any system wide
169 167 objectives. An objectives property has the following syntax:
170 168 .sp
171 169 .in +2
172 170 .nf
173 171 objectives = objective [; objective]*
174 172 objective = [n:] keyword [op] [value]
175 173 .fi
176 174 .in -2
177 175
178 176 .sp
179 177 .LP
180 178 All objectives are prefixed with an optional importance. The importance acts as
181 179 a multiplier for the objective and thus increases the significance of its
182 180 contribution to the objective function evaluation. If no importance is
183 181 specified, the default value is 1.
184 182 .sp
185 183 .LP
186 184 The "wt-load" objective is the only objective to which a system element can be
187 185 set. This objective favors configurations that match resource allocations to
188 186 resource utilization. A resource set that uses more resources will be given
189 187 more resources when this objective is active. An administrator should use this
190 188 objective when he is relatively satisfied with the constraints established
191 189 using the minimum and maximum properties and would like the DRP to manipulate
192 190 resources freely within those constraints.
193 191 .SS "Pools"
194 192 .TS
195 193 c c c
196 194 l l l .
197 195 Property name Type Description
198 196 \fBpool.active\fR \fBbool\fR Mark this pool as active, if true.
199 197 \fBpool.comment\fR \fBstring\fR User description of pool.
200 198 \fBpool.default\fR \fBbool\fR T{
201 199 Mark this pool as the default pool, if true; see system.bind-default property.
202 200 T}
203 201 \fBpool.importance\fR \fBint64\fR T{
204 202 Relative importance of this pool; for possible resource dispute resolution.
205 203 T}
206 204 \fBpool.name\fR \fBstring\fR T{
207 205 User name for pool; used by \fBsetproject\fR(3PROJECT) as value for 'project.pool' project attribute in \fBproject\fR(4) database.
208 206 T}
209 207 \fBpool.scheduler\fR \fBstring\fR T{
210 208 Scheduler class to which consumers of this pool will be bound. This property is optional and if not specified, the scheduler bindings for consumers of this pool are not affected.
211 209 T}
212 210 \fBpool.sys_id\fR \fBint64\fR System-assigned pool ID.
213 211 \fBpool.temporary\fR \fBbool\fR T{
214 212 Mark this pool as a temporary resource; if true, this pool can exist only in the dynamic configuration and cannot be committed to a configuration file.
215 213 T}
216 214 .TE
217 215
218 216 .sp
219 217 .LP
220 218 The \fBpool.default\fR, \fBpool.sys_id\fR, and \fBpool.temporary\fR properties
221 219 are not writable; all other listed properties are writable.
222 220 .sp
223 221 .LP
224 222 If pool.scheduler is specified, it must be set to the name of a valid
225 223 scheduling class for the system. See the \fB-c\fR option for \fBpriocntl\fR(1)
226 224 for a list of valid class names.
227 225 .SS "Processor Sets"
228 226 .TS
229 227 c c c
230 228 l l l .
231 229 Property name Type Description
232 230 \fBpset.comment\fR \fBstring\fR User description of resource.
233 231 \fBpset.default\fR \fBbool\fR Marks default processor set.
234 232 \fBpset.load\fR \fBuint64\fR The load for this processor set.
235 233 \fBpset.max\fR \fBuint64\fR T{
236 234 Maximum number of CPUs permitted in this processor set.
237 235 T}
238 236 \fBpset.min\fR \fBuint64\fR T{
239 237 Minimum number of CPUs permitted in this processor set.
240 238 T}
241 239 \fBpset.name\fR \fBstring\fR User name for resource.
242 240 \fBpset.size\fR \fBuint64\fR T{
243 241 Current number of CPUs in this processor set.
244 242 T}
245 243 \fBpset.sys_id\fR \fBint64\fR System-assigned processor set ID.
246 244 \fBpset.temporary\fR \fBbool\fR T{
247 245 Mark this processor set as a temporary resource; if true, this processor set can exist only in the dynamic configuration and cannot be committed to a configuration file.
248 246 T}
249 247 \fBpset.type\fR \fBstring\fR T{
250 248 Names resource type; value for all processor sets is \fBpset\fR.
251 249 T}
252 250 \fBpset.units\fR \fBstring\fR T{
253 251 Identifies meaning of size-related properties; value for all processor sets is \fBpopulation\fR.
254 252 T}
255 253 \fBpset.poold.objectives\fR \fBstring\fR T{
256 254 Specifies the poold objectives for a pset.
257 255 T}
258 256 .TE
259 257
260 258 .sp
261 259 .LP
262 260 The \fBpset.comment\fR, \fBpset.max\fR, \fBpset.min\fR, \fBpset.name\fR, and
263 261 \fBpset.poold.objectives\fR properties are writable; the \fBpset.default\fR,
264 262 \fBpset.load\fR, \fBpset.size\fR, \fBpset.sys_id\fR, \fBpset.temporary\fR,
265 263 \fBpset.type\fR, and \fBpset.units\fR properties are not.
266 264 .sp
267 265 .LP
268 266 The \fBpset.load\fR property represents the load on a processor set. The lowest
269 267 value for this property is 0. The value of \fBpset.load\fR increases in a
270 268 linear fashion with the load on the set, as measured by the number of jobs in
271 269 the system run queue.
272 270 .sp
|
↓ open down ↓ |
131 lines elided |
↑ open up ↑ |
273 271 .LP
274 272 The \fBpset.poold.objectives\fR property specifies an objective which is
275 273 specific to a particular \fBpset\fR. See the \fBsystem.poold.objectives\fR
276 274 entry for the specification of this property's syntax.
277 275 .sp
278 276 .LP
279 277 There are two types of objectives that can be set on a \fBpset\fR:
280 278 .sp
281 279 .ne 2
282 280 .na
283 -\fB\fBlocality\fR\fR
281 +\fBlocality\fR
284 282 .ad
285 283 .RS 15n
286 284 This objective influences the impact that locality, as measured by lgroup data,
287 285 has upon the chosen configuration. This objective can take one of three values:
288 286 .sp
289 287 .ne 2
290 288 .na
291 -\fB\fBtight\fR\fR
289 +\fBtight\fR
292 290 .ad
293 291 .RS 9n
294 292 If set, configurations that maximize resource locality are favored.
295 293 .RE
296 294
297 295 .sp
298 296 .ne 2
299 297 .na
300 -\fB\fBloose\fR\fR
298 +\fBloose\fR
301 299 .ad
302 300 .RS 9n
303 301 If set, configurations that minimize resource locality are favored.
304 302 .RE
305 303
306 304 .sp
307 305 .ne 2
308 306 .na
309 -\fB\fBnone\fR\fR
307 +\fBnone\fR
310 308 .ad
311 309 .RS 9n
312 310 This is the default value for this objective. If set, configuration
313 311 favorability is uninfluenced by resource locality.
314 312 .RE
315 313
316 314 .RE
317 315
318 316 .sp
319 317 .ne 2
320 318 .na
321 -\fB\fButilization\fR\fR
319 +\fButilization\fR
322 320 .ad
323 321 .RS 15n
324 322 This objective favors configurations that allocate resources to partitions that
325 323 are failing to preserve the specified utilization objective.
326 324 .RE
327 325
328 326 .sp
329 327 .LP
330 328 These objectives are specified in terms of an operator and a value. The
331 329 operators are
332 330 .sp
333 331 .ne 2
334 332 .na
335 -\fB\fB<\fR\fR
333 +\fB<\fR
336 334 .ad
337 335 .RS 5n
338 336 The ``less than'' operator is used to indicate that the specified value should
339 337 be treated as a maximum target value.
340 338 .RE
341 339
342 340 .sp
343 341 .ne 2
344 342 .na
345 -\fB\fB>\fR\fR
343 +\fB>\fR
346 344 .ad
347 345 .RS 5n
348 346 The ``greater than'' operator is used to indicate that the specified value
349 347 should be treated as a minimum target value.
350 348 .RE
351 349
352 350 .sp
353 351 .ne 2
354 352 .na
355 -\fB\fB~\fR\fR
353 +\fB~\fR
356 354 .ad
357 355 .RS 5n
358 356 The ``about'' operator is used to indicate that the specified value should be
359 357 treated as a target value about which some fluctuation is acceptable.
360 358 .RE
361 359
362 360 .sp
363 361 .LP
364 362 Only one objective of each type of operator can be set. For example, if the
365 363 \fB~\fR operator is set, the \fB<\fR and \fB>\fR operators cannot be set. It is
366 364 possible to set a \fB<\fR and a \fB>\fR operator together; the values will be
367 365 validated to ensure that they do not overlap.
368 366 .SS "Processors"
369 367 .TS
370 368 c c c
371 369 l l l .
372 370 Property name Type Description
373 371 _
374 372 \fBcpu.comment\fR \fBstring\fR User description of CPU.
375 373 \fBcpu.pinned\fR \fBbool\fR CPU pinned to this processor set.
376 374 \fBcpu.status\fR \fBint64\fR T{
377 375 Processor status, on-line, offline or interrupts disabled.
378 376 T}
379 377 \fBcpu.sys_id\fR \fBint64\fR System-assigned processor ID.
380 378 .TE
381 379
|
↓ open down ↓ |
16 lines elided |
↑ open up ↑ |
382 380 .sp
383 381 .LP
384 382 The \fBcpu.comment\fR, \fBcpu.pinned\fR, and \fBcpu.status\fR properties are
385 383 writable.
386 384 .sp
387 385 .LP
388 386 The \fBcpu.status\fR property can be set only to the following values:
389 387 .sp
390 388 .ne 2
391 389 .na
392 -\fB\fBoff-line\fR\fR
390 +\fBoff-line\fR
393 391 .ad
394 392 .RS 12n
395 393 Set the CPU offline.
396 394 .RE
397 395
398 396 .sp
399 397 .ne 2
400 398 .na
401 -\fB\fBon-line\fR\fR
399 +\fBon-line\fR
402 400 .ad
403 401 .RS 12n
404 402 Set the CPU online.
405 403 .RE
406 404
407 405 .sp
408 406 .ne 2
409 407 .na
410 -\fB\fBno-intr\fR\fR
408 +\fBno-intr\fR
411 409 .ad
412 410 .RS 12n
413 411 Disable interrupt processing on the CPU.
414 412 .RE
415 413
416 414 .sp
417 415 .LP
418 416 These values are defined in <\fBsys/processor.h\fR> as the \fBPS_OFFLINE\fR,
419 417 \fBPS_ONLINE\fR, and \fBPS_NOINTR\fR macros.
420 418 .SH INTERFACES
421 -.LP
422 419 The shared object \fBlibpool.so.1\fR provides the public interfaces defined
423 420 below. See \fBIntro\fR(3) for additional information on shared object
424 421 interfaces.
425 422 .sp
426 423
427 424 .sp
428 425 .TS
429 426 l l
430 427 l l .
431 428 \fBpool_associate\fR \fBpool_component_info\fR
432 429 \fBpool_component_to_elem\fR \fBpool_conf_alloc\fR
433 430 \fBpool_conf_close\fR \fBpool_conf_commit\fR
434 431 \fBpool_conf_export\fR \fBpool_conf_free\fR
435 432 \fBpool_conf_info\fR \fBpool_conf_location\fR
436 433 \fBpool_conf_open\fR \fBpool_conf_remove\fR
437 434 \fBpool_conf_rollback\fR \fBpool_conf_status\fR
438 435 \fBpool_conf_to_elem\fR \fBpool_conf_update\fR
439 436 \fBpool_conf_validate\fR \fBpool_create\fR
440 437 \fBpool_destroy\fR \fBpool_dissociate\fR
441 438 \fBpool_dynamic_location\fR \fBpool_error\fR
442 439 \fBpool_get_binding\fR \fBpool_get_owning_resource\fR
443 440 \fBpool_get_pool\fR \fBpool_get_property\fR
444 441 \fBpool_get_resource\fR \fBpool_get_resource_binding\fR
445 442 \fBpool_get_status\fR \fBpool_info\fR
446 443 \fBpool_put_property\fR \fBpool_query_components\fR
447 444 \fBpool_query_pool_resources\fR \fBpool_query_pools\fR
448 445 \fBpool_query_resource_components\fR \fBpool_query_resources\fR
449 446 \fBpool_resource_create\fR \fBpool_resource_destroy\fR
450 447 \fBpool_resource_info\fR \fBpool_resource_to_elem\fR
451 448 \fBpool_resource_transfer\fR \fBpool_resource_type_list\fR
452 449 \fBpool_resource_xtransfer\fR \fBpool_rm_property\fR
453 450 \fBpool_set_binding\fR \fBpool_set_status\fR
454 451 \fBpool_static_location\fR \fBpool_strerror\fR
455 452 \fBpool_to_elem\fR \fBpool_value_alloc\fR
456 453 \fBpool_value_free\fR \fBpool_value_get_bool\fR
457 454 \fBpool_value_get_double\fR \fBpool_value_get_int64\fR
458 455 \fBpool_value_get_name\fR \fBpool_value_get_string\fR
459 456 \fBpool_value_get_type\fR \fBpool_value_get_uint64\fR
460 457 \fBpool_value_set_bool\fR \fBpool_value_set_double\fR
|
↓ open down ↓ |
29 lines elided |
↑ open up ↑ |
461 458 \fBpool_value_set_int64\fR \fBpool_value_set_name\fR
462 459 \fBpool_value_set_string\fR \fBpool_value_set_uint64\fR
463 460 \fBpool_version\fR \fBpool_walk_components\fR
464 461 \fBpool_walk_pools\fR \fBpool_walk_properties\fR
465 462 \fBpool_walk_resources\fR
466 463 .TE
467 464
468 465 .SH FILES
469 466 .ne 2
470 467 .na
471 -\fB\fB/usr/lib/libpool.so.1\fR\fR
468 +\fB/usr/lib/libpool.so.1\fR
472 469 .ad
473 470 .RS 28n
474 471 shared object
475 472 .RE
476 473
477 474 .sp
478 475 .ne 2
479 476 .na
480 -\fB\fB/usr/lib/64/libpool.so.1\fR\fR
477 +\fB/usr/lib/64/libpool.so.1\fR
481 478 .ad
482 479 .RS 28n
483 480 64-bit shared object
484 481 .RE
485 482
486 483 .SH ATTRIBUTES
487 -.LP
488 484 See \fBattributes\fR(5) for descriptions of the following attributes:
489 485 .sp
490 486
491 487 .sp
492 488 .TS
493 489 box;
494 490 c | c
495 491 l | l .
496 492 ATTRIBUTE TYPE ATTRIBUTE VALUE
497 493 _
498 494 CSI Enabled
499 495 _
500 496 Interface Stability Unstable
501 497 _
502 498 MT-Level Safe
503 499 .TE
504 500
505 501 .SH SEE ALSO
506 -.LP
507 502 \fBIntro\fR(3), \fBpool_component_info\fR(3POOL), \fBpool_conf_open\fR(3POOL),
508 503 \fBpool_conf_to_elem\fR(3POOL), \fBpool_create\fR(3POOL),
509 504 \fBpool_error\fR(3POOL), \fBpool_get_binding\fR(3POOL),
510 505 \fBpool_get_property\fR(3POOL), \fBpool_get_resource\fR(3POOL),
511 506 \fBpool_resource_create\fR(3POOL), \fBpool_value_alloc\fR(3POOL),
512 507 \fBpool_walk_pools\fR(3POOL), \fBattributes\fR(5), \fBsmf\fR(5)
513 508 .SH NOTES
514 -.LP
515 509 Functions in \fBlibpool\fR can be used to manipulate static configurations even
516 510 when the pools facility is not enabled. See \fBpooladm\fR(1M) and
517 511 \fBpool_set_status\fR(3POOL) for more information about enabling the pools
518 512 facility. The pools facility must be enabled, however, to modify the dynamic
519 513 configuration.
520 514 .sp
521 515 .LP
522 516 Since the Resource Pools facility is an \fBsmf\fR(5) service, it can also be
523 517 enabled and disabled using the standard Service Management Facility (SMF)
524 518 interfaces.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX