libutils/isoc/bget.doc

11 overhead  required  for  buffer  pool  management.    It   automatically
25         entire buffer pool.
27     *   Retrieval of allocation and pool size statistics.
32     *   Automatic  pool compaction, growth, and shrinkage by
94 the buffer pool area in RAM,  then  allocate  buffers  with  bget()  and
105 Initially  define  a  buffer  pool   of   an   appropriate   size   with
112 the  underlying  operating  system, add it to the buffer pool by another
119 implement  automatic storage pool expansion, contraction, and optionally
122 storage compaction, acquisition, and release, as well as a standard pool
127 release  storage  as before.  You can supply an initial buffer pool with
128 bpool() or rely on automatic allocation  to  acquire  the  entire  pool.
143 additional space are required.  This will be the standard pool expansion
146 standard pool block can be managed "off the books" by BGET in this mode.
148 a pointer to the new block and BGET  expands  the  buffer  pool;  if  it
151 totally  empty  are  released  to  the global free pool by passing their
170 Create  a  buffer  pool  of  <len>  bytes, using the storage starting at
172 storage to the overall buffer pool.
196 space pool.
218 release any space or add storage to the  buffer  pool),  the  allocation
219 request  fails,  which  can  trigger  automatic  pool  expansion  if the
224 the buffer pool in any manner which would be valid were the  application
237 allocation  will  proceed  using the expanded buffer pool.  If <acquire>
244 function.  Automatic release of empty pool blocks will occur only if all
245 pool blocks in the system are the size given by <pool_incr>.
252 in  the  pool)  is stored into the variable pointed to by <totfree>, and
253 the size of the largest single block in the free space  pool  is  stored
266 pool blocks will be stored into the variable pointed to by <npool>.  The
278         void bpoold(void *pool, int dumpalloc, int dumpfree);
280 All  buffers in the buffer pool <pool>, previously initialised by a call
285         int bpoolv(void *pool);
287 The named buffer pool, previously initialised by a  call  on  bpool(),  is
290 is returned if the pool is valid, 0 if an error is found.
307                               buffers in a buffer pool. */
311                               a buffer pool. */
321                               pool, the largest available
338                               pool space control.  */