sorry if I'm wrong but pool cache has gone so man pages needs to be updated
Index: pool.9 =================================================================== RCS file: /cvs/src/share/man/man9/pool.9,v retrieving revision 1.36 diff -u -p -u -r1.36 pool.9 --- pool.9 26 Jun 2008 05:42:08 -0000 1.36 +++ pool.9 16 Jul 2008 12:17:07 -0000 @@ -40,12 +40,6 @@ .Nm pool_sethiwat , .Nm pool_setlowat , .Nm pool_sethardlimit , -.Nm pool_cache_init , -.Nm pool_cache_destroy , -.Nm pool_cache_get , -.Nm pool_cache_put , -.Nm pool_cache_destruct_object , -.Nm pool_cache_invalidate .Nd resource-pool manager .Sh SYNOPSIS .Fd #include <sys/types.h> @@ -81,24 +75,6 @@ .Fa "const char *warnmess" .Fa "int ratecap" .Fc -.Ft void -.Fo pool_cache_init -.Fa "struct pool_cache *pc" -.Fa "struct pool *pp" -.Fa "int (*ctor)(void *, void *, int)" -.Fa "void (*dtor)(void *, void *)" -.Fa "void *arg" -.Fc -.Ft void -.Fn pool_cache_destroy "struct pool_cache *pc" -.Ft void * -.Fn pool_cache_get "struct pool_cache *pc" "int flags" -.Ft void -.Fn pool_cache_put "struct pool_cache *pc" "void *object" -.Ft void -.Fn pool_cache_destruct_object "struct pool_cache *pc" "void *object" -.Ft void -.Fn pool_cache_invalidate "struct pool_cache *pc" .Sh DESCRIPTION These utility routines provide management of pools of fixed-sized areas of memory. @@ -314,42 +290,6 @@ The pool resource code uses a per-pool l If any pool functions are called in an interrupt context, the caller must block all interrupts that might cause the code to be reentered. -.Ss POOL CACHES -Another set of functions are available as extensions to the pool manager. -The pool cache functions automatically call constructors and destructors -when objects are allocated from the pool or returned to it. -They have similar semantics as the other pool functions. -The -.Fa pp -argument to -.Fn pool_cache_init -must already be initialized. -.Pp -Objects are not immediately deconstructed when put into the pool cache. -Instead, they are maintained for future allocations. -When the system determines that memory needs to be reclaimed, then the -deconstructor is called on each free object and it is placed back into the -pool. -The -.Fa ctor -and -.Fa dtor -functions are passed -.Fa arg -and a pointer to the object, in that order. -The -.Fa ctor -is also passed the same -.Fa flags -that are passed to -.Fn pool_cache_get . -The -.Fn pool_cache_destruct_object -function deconstructs and puts an object back into the pool immediately. -.Fn pool_cache_invalidate -deconstructs all cached objects and releases their memory. -.Pp -Pool caches are also commonly referred to as a slab allocator. .Ss DIAGNOSTICS Pool usage logs can be enabled by defining the compile-time option .Dv POOL_DIAGNOSTIC .
