Print this page
11583 Some man3lib pages are missing parts of the SYNOPSIS
   1 '\" te
   2 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.
   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 .\" 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 .\" 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"
   7 .SH NAME
   8 libpool \- pool configuration manipulation library
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... [ \fIlibrary\fR... ]
  13 #include <\fBpool.h\fR>
  14 .fi
  15 
  16 .SH DESCRIPTION
  17 .LP
  18 The functions in this library define the interface for reading and writing
  19 resource pools configuration files, as well as that for committing an existing
  20 configuration to becoming the running OS configuration (with respect to
  21 partitioning subsystems). The <\fBpool.h\fR> header provides type and function
  22 declarations for all library services.
  23 .sp
  24 .LP
  25 The resource pools facility brings together process-bindable resources into a
  26 common abstraction called a pool. Processor sets and other entities can be
  27 configured, grouped, and labelled in a persistent fashion such that workload
  28 components can be associated with a subset of a system's total resources. The
  29 \fBlibpool\fR library provides a C language API for accessing this
  30 functionality, while \fBpooladm\fR(1M), \fBpoolbind\fR(1M), and
  31 \fBpoolcfg\fR(1M) make this facility available through command invocations from
  32 a shell. Each of those manual pages describes aspects of the pools facility;
  33 this page describes the properties available to the various entities managed
  34 within the pools facility. These entities include the system, pools, and the
  35 \fBpset\fR resources for processor sets.
  36 .sp
  37 .LP


 111 If "importance based" allocation is defined, then during a commit the library
 112 will allocate resources to pools using an algorithm that observes minimum and
 113 maximum constraints for resources but favors those resources with greater
 114 importance.
 115 .sp
 116 .LP
 117 If "surplus to default" is defined, then during a commit the library will
 118 allocate minimum resources to all resource sets apart from default which will
 119 receive any surplus.
 120 .sp
 121 .LP
 122 The \fBsystem.bind-default\fR property defaults to true. This property
 123 interacts with the \fBproject.pool\fR resource control to specify the binding
 124 behavior for processes associated with a project. If \fBproject.pool\fR is not
 125 specified, then this property has no effect. If \fBproject.pool\fR is specified
 126 and the specified pool exists, this property has no effect. If the specified
 127 pool does not exist, perhaps because of a reconfiguration, then this property
 128 controls the binding behavior for the project member. If
 129 \fBsystem.bind-default\fR is true, then the project member is bound to the
 130 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
 132 taken with the pools configuration if this property is set to false, so as to
 133 avoid denying users access to the system.
 134 .sp
 135 .LP
 136 The various \fBpoold\fR properties are used to configure the operation of
 137 \fBpoold\fR(1M).
 138 .sp
 139 .LP
 140 The \fBsystem.poold.log-level\fR property is used to specify the level of
 141 detail provided in log messages. Valid values are: \fBALERT\fR, \fBCRIT\fR,
 142 \fBERR\fR, \fBWARNING\fR, \fBNOTICE\fR, \fBINFO\fR, and \fBDEBUG\fR.
 143 .sp
 144 .LP
 145 \fBALERT\fR provides the least level of detail, \fBDEBUG\fR the greatest. See
 146 \fBsyslog\fR(3C) for more information about the meaning of these debug levels.
 147 If this property is not specified, the default value \fBNOTICE\fR is used.
 148 .sp
 149 .LP
 150 The \fBsystem.poold.log-location\fR property is used to specify the location of
 151 the logfiles generated by \fBpoold\fR. The special value of "syslog" indicates


 263 \fBpset.poold.objectives\fR properties are writable; the \fBpset.default\fR,
 264 \fBpset.load\fR, \fBpset.size\fR, \fBpset.sys_id\fR, \fBpset.temporary\fR,
 265 \fBpset.type\fR, and \fBpset.units\fR properties are not.
 266 .sp
 267 .LP
 268 The \fBpset.load\fR property represents the load on a processor set. The lowest
 269 value for this property is 0. The value of \fBpset.load\fR increases in a
 270 linear fashion with the load on the set, as measured by the number of jobs in
 271 the system run queue.
 272 .sp
 273 .LP
 274 The \fBpset.poold.objectives\fR property specifies an objective which is
 275 specific to a particular \fBpset\fR. See the \fBsystem.poold.objectives\fR
 276 entry for the specification of this property's syntax.
 277 .sp
 278 .LP
 279 There are two types of objectives that can be set on a \fBpset\fR:
 280 .sp
 281 .ne 2
 282 .na
 283 \fB\fBlocality\fR\fR
 284 .ad
 285 .RS 15n
 286 This objective influences the impact that locality, as measured by lgroup data,
 287 has upon the chosen configuration. This objective can take one of three values:
 288 .sp
 289 .ne 2
 290 .na
 291 \fB\fBtight\fR\fR
 292 .ad
 293 .RS 9n
 294 If set, configurations that maximize resource locality are favored.
 295 .RE
 296 
 297 .sp
 298 .ne 2
 299 .na
 300 \fB\fBloose\fR\fR
 301 .ad
 302 .RS 9n
 303 If set, configurations that minimize resource locality are favored.
 304 .RE
 305 
 306 .sp
 307 .ne 2
 308 .na
 309 \fB\fBnone\fR\fR
 310 .ad
 311 .RS 9n
 312 This is the default value for this objective. If set, configuration
 313 favorability is uninfluenced by resource locality.
 314 .RE
 315 
 316 .RE
 317 
 318 .sp
 319 .ne 2
 320 .na
 321 \fB\fButilization\fR\fR
 322 .ad
 323 .RS 15n
 324 This objective favors configurations that allocate resources to partitions that
 325 are failing to preserve the specified utilization objective.
 326 .RE
 327 
 328 .sp
 329 .LP
 330 These objectives are specified in terms of an operator and a value. The
 331 operators are
 332 .sp
 333 .ne 2
 334 .na
 335 \fB\fB<\fR\fR
 336 .ad
 337 .RS 5n
 338 The ``less than'' operator is used to indicate that the specified value should
 339 be treated as a maximum target value.
 340 .RE
 341 
 342 .sp
 343 .ne 2
 344 .na
 345 \fB\fB>\fR\fR
 346 .ad
 347 .RS 5n
 348 The ``greater than'' operator is used to indicate that the specified value
 349 should be treated as a minimum target value.
 350 .RE
 351 
 352 .sp
 353 .ne 2
 354 .na
 355 \fB\fB~\fR\fR
 356 .ad
 357 .RS 5n
 358 The ``about'' operator is used to indicate that the specified value should be
 359 treated as a target value about which some fluctuation is acceptable.
 360 .RE
 361 
 362 .sp
 363 .LP
 364 Only one objective of each type of operator can be set. For example, if the
 365 \fB~\fR operator is set, the \fB<\fR and \fB>\fR operators cannot be set. It is
 366 possible to set a \fB<\fR and a \fB>\fR operator together; the values will be
 367 validated to ensure that they do not overlap.
 368 .SS "Processors"
 369 .TS
 370 c c c
 371 l l l .
 372 Property name   Type    Description
 373 _
 374 \fBcpu.comment\fR       \fBstring\fR    User description of CPU.
 375 \fBcpu.pinned\fR        \fBbool\fR      CPU pinned to this processor set.
 376 \fBcpu.status\fR        \fBint64\fR     T{
 377 Processor status, on-line, offline or interrupts disabled.
 378 T}
 379 \fBcpu.sys_id\fR        \fBint64\fR     System-assigned processor ID.
 380 .TE
 381 
 382 .sp
 383 .LP
 384 The \fBcpu.comment\fR, \fBcpu.pinned\fR, and \fBcpu.status\fR properties are
 385 writable.
 386 .sp
 387 .LP
 388 The \fBcpu.status\fR property can be set only to the following values:
 389 .sp
 390 .ne 2
 391 .na
 392 \fB\fBoff-line\fR\fR
 393 .ad
 394 .RS 12n
 395 Set the CPU offline.
 396 .RE
 397 
 398 .sp
 399 .ne 2
 400 .na
 401 \fB\fBon-line\fR\fR
 402 .ad
 403 .RS 12n
 404 Set the CPU online.
 405 .RE
 406 
 407 .sp
 408 .ne 2
 409 .na
 410 \fB\fBno-intr\fR\fR
 411 .ad
 412 .RS 12n
 413 Disable interrupt processing on the CPU.
 414 .RE
 415 
 416 .sp
 417 .LP
 418 These values are defined in <\fBsys/processor.h\fR> as the \fBPS_OFFLINE\fR,
 419 \fBPS_ONLINE\fR, and \fBPS_NOINTR\fR macros.
 420 .SH INTERFACES
 421 .LP
 422 The shared object \fBlibpool.so.1\fR provides the public interfaces defined
 423 below. See \fBIntro\fR(3) for additional information on shared object
 424 interfaces.
 425 .sp
 426 
 427 .sp
 428 .TS
 429 l l
 430 l l .
 431 \fBpool_associate\fR    \fBpool_component_info\fR
 432 \fBpool_component_to_elem\fR    \fBpool_conf_alloc\fR
 433 \fBpool_conf_close\fR   \fBpool_conf_commit\fR
 434 \fBpool_conf_export\fR  \fBpool_conf_free\fR
 435 \fBpool_conf_info\fR    \fBpool_conf_location\fR
 436 \fBpool_conf_open\fR    \fBpool_conf_remove\fR
 437 \fBpool_conf_rollback\fR        \fBpool_conf_status\fR
 438 \fBpool_conf_to_elem\fR \fBpool_conf_update\fR
 439 \fBpool_conf_validate\fR        \fBpool_create\fR
 440 \fBpool_destroy\fR      \fBpool_dissociate\fR
 441 \fBpool_dynamic_location\fR     \fBpool_error\fR


 451 \fBpool_resource_transfer\fR    \fBpool_resource_type_list\fR
 452 \fBpool_resource_xtransfer\fR   \fBpool_rm_property\fR
 453 \fBpool_set_binding\fR  \fBpool_set_status\fR
 454 \fBpool_static_location\fR      \fBpool_strerror\fR
 455 \fBpool_to_elem\fR      \fBpool_value_alloc\fR
 456 \fBpool_value_free\fR   \fBpool_value_get_bool\fR
 457 \fBpool_value_get_double\fR     \fBpool_value_get_int64\fR
 458 \fBpool_value_get_name\fR       \fBpool_value_get_string\fR
 459 \fBpool_value_get_type\fR       \fBpool_value_get_uint64\fR
 460 \fBpool_value_set_bool\fR       \fBpool_value_set_double\fR
 461 \fBpool_value_set_int64\fR      \fBpool_value_set_name\fR
 462 \fBpool_value_set_string\fR     \fBpool_value_set_uint64\fR
 463 \fBpool_version\fR      \fBpool_walk_components\fR
 464 \fBpool_walk_pools\fR   \fBpool_walk_properties\fR
 465 \fBpool_walk_resources\fR       
 466 .TE
 467 
 468 .SH FILES
 469 .ne 2
 470 .na
 471 \fB\fB/usr/lib/libpool.so.1\fR\fR
 472 .ad
 473 .RS 28n
 474 shared object
 475 .RE
 476 
 477 .sp
 478 .ne 2
 479 .na
 480 \fB\fB/usr/lib/64/libpool.so.1\fR\fR
 481 .ad
 482 .RS 28n
 483 64-bit shared object
 484 .RE
 485 
 486 .SH ATTRIBUTES
 487 .LP
 488 See \fBattributes\fR(5) for descriptions of the following attributes:
 489 .sp
 490 
 491 .sp
 492 .TS
 493 box;
 494 c | c
 495 l | l .
 496 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 497 _
 498 CSI     Enabled
 499 _
 500 Interface Stability     Unstable
 501 _
 502 MT-Level        Safe
 503 .TE
 504 
 505 .SH SEE ALSO
 506 .LP
 507 \fBIntro\fR(3), \fBpool_component_info\fR(3POOL), \fBpool_conf_open\fR(3POOL),
 508 \fBpool_conf_to_elem\fR(3POOL), \fBpool_create\fR(3POOL),
 509 \fBpool_error\fR(3POOL), \fBpool_get_binding\fR(3POOL),
 510 \fBpool_get_property\fR(3POOL), \fBpool_get_resource\fR(3POOL),
 511 \fBpool_resource_create\fR(3POOL), \fBpool_value_alloc\fR(3POOL),
 512 \fBpool_walk_pools\fR(3POOL), \fBattributes\fR(5), \fBsmf\fR(5)
 513 .SH NOTES
 514 .LP
 515 Functions in \fBlibpool\fR can be used to manipulate static configurations even
 516 when the pools facility is not enabled. See \fBpooladm\fR(1M) and
 517 \fBpool_set_status\fR(3POOL) for more information about enabling the pools
 518 facility. The pools facility must be enabled, however, to modify the dynamic
 519 configuration.
 520 .sp
 521 .LP
 522 Since the Resource Pools facility is an \fBsmf\fR(5) service, it can also be
 523 enabled and disabled using the standard Service Management Facility (SMF)
 524 interfaces.
   1 '\" te
   2 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.
   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 .\" 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 .\" 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 "Aug 19, 2019"
   7 .SH NAME
   8 libpool \- pool configuration manipulation library
   9 .SH SYNOPSIS

  10 .nf
  11 \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpool\fR [ \fIlibrary\fR... ]
  12 #include <\fBpool.h\fR>
  13 .fi
  14 
  15 .SH DESCRIPTION

  16 The functions in this library define the interface for reading and writing
  17 resource pools configuration files, as well as that for committing an existing
  18 configuration to becoming the running OS configuration (with respect to
  19 partitioning subsystems). The <\fBpool.h\fR> header provides type and function
  20 declarations for all library services.
  21 .sp
  22 .LP
  23 The resource pools facility brings together process-bindable resources into a
  24 common abstraction called a pool. Processor sets and other entities can be
  25 configured, grouped, and labelled in a persistent fashion such that workload
  26 components can be associated with a subset of a system's total resources. The
  27 \fBlibpool\fR library provides a C language API for accessing this
  28 functionality, while \fBpooladm\fR(1M), \fBpoolbind\fR(1M), and
  29 \fBpoolcfg\fR(1M) make this facility available through command invocations from
  30 a shell. Each of those manual pages describes aspects of the pools facility;
  31 this page describes the properties available to the various entities managed
  32 within the pools facility. These entities include the system, pools, and the
  33 \fBpset\fR resources for processor sets.
  34 .sp
  35 .LP


 109 If "importance based" allocation is defined, then during a commit the library
 110 will allocate resources to pools using an algorithm that observes minimum and
 111 maximum constraints for resources but favors those resources with greater
 112 importance.
 113 .sp
 114 .LP
 115 If "surplus to default" is defined, then during a commit the library will
 116 allocate minimum resources to all resource sets apart from default which will
 117 receive any surplus.
 118 .sp
 119 .LP
 120 The \fBsystem.bind-default\fR property defaults to true. This property
 121 interacts with the \fBproject.pool\fR resource control to specify the binding
 122 behavior for processes associated with a project. If \fBproject.pool\fR is not
 123 specified, then this property has no effect. If \fBproject.pool\fR is specified
 124 and the specified pool exists, this property has no effect. If the specified
 125 pool does not exist, perhaps because of a reconfiguration, then this property
 126 controls the binding behavior for the project member. If
 127 \fBsystem.bind-default\fR is true, then the project member is bound to the
 128 default pool (identified as the pool for which \fBpool.default\fR is true);
 129 otherwise the project member is refused access to the system. Care should be
 130 taken with the pools configuration if this property is set to false, so as to
 131 avoid denying users access to the system.
 132 .sp
 133 .LP
 134 The various \fBpoold\fR properties are used to configure the operation of
 135 \fBpoold\fR(1M).
 136 .sp
 137 .LP
 138 The \fBsystem.poold.log-level\fR property is used to specify the level of
 139 detail provided in log messages. Valid values are: \fBALERT\fR, \fBCRIT\fR,
 140 \fBERR\fR, \fBWARNING\fR, \fBNOTICE\fR, \fBINFO\fR, and \fBDEBUG\fR.
 141 .sp
 142 .LP
 143 \fBALERT\fR provides the least level of detail, \fBDEBUG\fR the greatest. See
 144 \fBsyslog\fR(3C) for more information about the meaning of these debug levels.
 145 If this property is not specified, the default value \fBNOTICE\fR is used.
 146 .sp
 147 .LP
 148 The \fBsystem.poold.log-location\fR property is used to specify the location of
 149 the logfiles generated by \fBpoold\fR. The special value of "syslog" indicates


 261 \fBpset.poold.objectives\fR properties are writable; the \fBpset.default\fR,
 262 \fBpset.load\fR, \fBpset.size\fR, \fBpset.sys_id\fR, \fBpset.temporary\fR,
 263 \fBpset.type\fR, and \fBpset.units\fR properties are not.
 264 .sp
 265 .LP
 266 The \fBpset.load\fR property represents the load on a processor set. The lowest
 267 value for this property is 0. The value of \fBpset.load\fR increases in a
 268 linear fashion with the load on the set, as measured by the number of jobs in
 269 the system run queue.
 270 .sp
 271 .LP
 272 The \fBpset.poold.objectives\fR property specifies an objective which is
 273 specific to a particular \fBpset\fR. See the \fBsystem.poold.objectives\fR
 274 entry for the specification of this property's syntax.
 275 .sp
 276 .LP
 277 There are two types of objectives that can be set on a \fBpset\fR:
 278 .sp
 279 .ne 2
 280 .na
 281 \fBlocality\fR
 282 .ad
 283 .RS 15n
 284 This objective influences the impact that locality, as measured by lgroup data,
 285 has upon the chosen configuration. This objective can take one of three values:
 286 .sp
 287 .ne 2
 288 .na
 289 \fBtight\fR
 290 .ad
 291 .RS 9n
 292 If set, configurations that maximize resource locality are favored.
 293 .RE
 294 
 295 .sp
 296 .ne 2
 297 .na
 298 \fBloose\fR
 299 .ad
 300 .RS 9n
 301 If set, configurations that minimize resource locality are favored.
 302 .RE
 303 
 304 .sp
 305 .ne 2
 306 .na
 307 \fBnone\fR
 308 .ad
 309 .RS 9n
 310 This is the default value for this objective. If set, configuration
 311 favorability is uninfluenced by resource locality.
 312 .RE
 313 
 314 .RE
 315 
 316 .sp
 317 .ne 2
 318 .na
 319 \fButilization\fR
 320 .ad
 321 .RS 15n
 322 This objective favors configurations that allocate resources to partitions that
 323 are failing to preserve the specified utilization objective.
 324 .RE
 325 
 326 .sp
 327 .LP
 328 These objectives are specified in terms of an operator and a value. The
 329 operators are
 330 .sp
 331 .ne 2
 332 .na
 333 \fB<\fR
 334 .ad
 335 .RS 5n
 336 The ``less than'' operator is used to indicate that the specified value should
 337 be treated as a maximum target value.
 338 .RE
 339 
 340 .sp
 341 .ne 2
 342 .na
 343 \fB>\fR
 344 .ad
 345 .RS 5n
 346 The ``greater than'' operator is used to indicate that the specified value
 347 should be treated as a minimum target value.
 348 .RE
 349 
 350 .sp
 351 .ne 2
 352 .na
 353 \fB~\fR
 354 .ad
 355 .RS 5n
 356 The ``about'' operator is used to indicate that the specified value should be
 357 treated as a target value about which some fluctuation is acceptable.
 358 .RE
 359 
 360 .sp
 361 .LP
 362 Only one objective of each type of operator can be set. For example, if the
 363 \fB~\fR operator is set, the \fB<\fR and \fB>\fR operators cannot be set. It is
 364 possible to set a \fB<\fR and a \fB>\fR operator together; the values will be
 365 validated to ensure that they do not overlap.
 366 .SS "Processors"
 367 .TS
 368 c c c
 369 l l l .
 370 Property name   Type    Description
 371 _
 372 \fBcpu.comment\fR       \fBstring\fR    User description of CPU.
 373 \fBcpu.pinned\fR        \fBbool\fR      CPU pinned to this processor set.
 374 \fBcpu.status\fR        \fBint64\fR     T{
 375 Processor status, on-line, offline or interrupts disabled.
 376 T}
 377 \fBcpu.sys_id\fR        \fBint64\fR     System-assigned processor ID.
 378 .TE
 379 
 380 .sp
 381 .LP
 382 The \fBcpu.comment\fR, \fBcpu.pinned\fR, and \fBcpu.status\fR properties are
 383 writable.
 384 .sp
 385 .LP
 386 The \fBcpu.status\fR property can be set only to the following values:
 387 .sp
 388 .ne 2
 389 .na
 390 \fBoff-line\fR
 391 .ad
 392 .RS 12n
 393 Set the CPU offline.
 394 .RE
 395 
 396 .sp
 397 .ne 2
 398 .na
 399 \fBon-line\fR
 400 .ad
 401 .RS 12n
 402 Set the CPU online.
 403 .RE
 404 
 405 .sp
 406 .ne 2
 407 .na
 408 \fBno-intr\fR
 409 .ad
 410 .RS 12n
 411 Disable interrupt processing on the CPU.
 412 .RE
 413 
 414 .sp
 415 .LP
 416 These values are defined in <\fBsys/processor.h\fR> as the \fBPS_OFFLINE\fR,
 417 \fBPS_ONLINE\fR, and \fBPS_NOINTR\fR macros.
 418 .SH INTERFACES

 419 The shared object \fBlibpool.so.1\fR provides the public interfaces defined
 420 below. See \fBIntro\fR(3) for additional information on shared object
 421 interfaces.
 422 .sp
 423 
 424 .sp
 425 .TS
 426 l l
 427 l l .
 428 \fBpool_associate\fR    \fBpool_component_info\fR
 429 \fBpool_component_to_elem\fR    \fBpool_conf_alloc\fR
 430 \fBpool_conf_close\fR   \fBpool_conf_commit\fR
 431 \fBpool_conf_export\fR  \fBpool_conf_free\fR
 432 \fBpool_conf_info\fR    \fBpool_conf_location\fR
 433 \fBpool_conf_open\fR    \fBpool_conf_remove\fR
 434 \fBpool_conf_rollback\fR        \fBpool_conf_status\fR
 435 \fBpool_conf_to_elem\fR \fBpool_conf_update\fR
 436 \fBpool_conf_validate\fR        \fBpool_create\fR
 437 \fBpool_destroy\fR      \fBpool_dissociate\fR
 438 \fBpool_dynamic_location\fR     \fBpool_error\fR


 448 \fBpool_resource_transfer\fR    \fBpool_resource_type_list\fR
 449 \fBpool_resource_xtransfer\fR   \fBpool_rm_property\fR
 450 \fBpool_set_binding\fR  \fBpool_set_status\fR
 451 \fBpool_static_location\fR      \fBpool_strerror\fR
 452 \fBpool_to_elem\fR      \fBpool_value_alloc\fR
 453 \fBpool_value_free\fR   \fBpool_value_get_bool\fR
 454 \fBpool_value_get_double\fR     \fBpool_value_get_int64\fR
 455 \fBpool_value_get_name\fR       \fBpool_value_get_string\fR
 456 \fBpool_value_get_type\fR       \fBpool_value_get_uint64\fR
 457 \fBpool_value_set_bool\fR       \fBpool_value_set_double\fR
 458 \fBpool_value_set_int64\fR      \fBpool_value_set_name\fR
 459 \fBpool_value_set_string\fR     \fBpool_value_set_uint64\fR
 460 \fBpool_version\fR      \fBpool_walk_components\fR
 461 \fBpool_walk_pools\fR   \fBpool_walk_properties\fR
 462 \fBpool_walk_resources\fR       
 463 .TE
 464 
 465 .SH FILES
 466 .ne 2
 467 .na
 468 \fB/usr/lib/libpool.so.1\fR
 469 .ad
 470 .RS 28n
 471 shared object
 472 .RE
 473 
 474 .sp
 475 .ne 2
 476 .na
 477 \fB/usr/lib/64/libpool.so.1\fR
 478 .ad
 479 .RS 28n
 480 64-bit shared object
 481 .RE
 482 
 483 .SH ATTRIBUTES

 484 See \fBattributes\fR(5) for descriptions of the following attributes:
 485 .sp
 486 
 487 .sp
 488 .TS
 489 box;
 490 c | c
 491 l | l .
 492 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 493 _
 494 CSI     Enabled
 495 _
 496 Interface Stability     Unstable
 497 _
 498 MT-Level        Safe
 499 .TE
 500 
 501 .SH SEE ALSO

 502 \fBIntro\fR(3), \fBpool_component_info\fR(3POOL), \fBpool_conf_open\fR(3POOL),
 503 \fBpool_conf_to_elem\fR(3POOL), \fBpool_create\fR(3POOL),
 504 \fBpool_error\fR(3POOL), \fBpool_get_binding\fR(3POOL),
 505 \fBpool_get_property\fR(3POOL), \fBpool_get_resource\fR(3POOL),
 506 \fBpool_resource_create\fR(3POOL), \fBpool_value_alloc\fR(3POOL),
 507 \fBpool_walk_pools\fR(3POOL), \fBattributes\fR(5), \fBsmf\fR(5)
 508 .SH NOTES

 509 Functions in \fBlibpool\fR can be used to manipulate static configurations even
 510 when the pools facility is not enabled. See \fBpooladm\fR(1M) and
 511 \fBpool_set_status\fR(3POOL) for more information about enabling the pools
 512 facility. The pools facility must be enabled, however, to modify the dynamic
 513 configuration.
 514 .sp
 515 .LP
 516 Since the Resource Pools facility is an \fBsmf\fR(5) service, it can also be
 517 enabled and disabled using the standard Service Management Facility (SMF)
 518 interfaces.