These functions provide mechanisms for constructing and modifying pools entries within a target pools configuration. The conf argument for each function refers to the target configuration to which the operation applies.
The pool_associate() function associates the specified resource with pool. A resource can be associated with multiple pools at the same time. Any resource of this type that was formerly associated with this pool is no longer associated with the pool. The
new association replaces the earlier one.
The pool_create() function creates a new pool with the supplied name with its default properties initialized, and associated with the default resource of each type.
The pool_destroy function() destroys the given pool association. Associated resources are not modified.
The pool_dissociate() function removes the association between the given resource and pool. On successful completion, the pool is associated with the default resource of the same type.
The pool_info() function returns a string describing the given pool. The string is allocated with malloc(3C). The caller is reponsible
for freeing the returned string. If the flags option is non-zero, the string returned also describes the associated resources of the pool.
The pool_query_pool_resources() function returns a null-terminated array of resources currently associated with the pool. The return value must be freed by the caller. The nelem argument is set to be the length of the array returned.
|