Sun Java System Web Server 6.1 SP7 NSAPI Programmer's Guide

pool-init

Applicable in Init-class directives.

The pool-init function changes the default values of pooled memory settings. The size of the free block list may be changed or pooled memory may be entirely disabled.

Memory allocation pools allow the server to run significantly faster. If you are programming with the NSAPI, note that MALLOC, REALLOC, CALLOC, STRDUP, and FREE work slightly differently if pooled memory is disabled. If pooling is enabled, the server automatically cleans up all memory allocated by these routines when each request completes. In most cases, this will improve performance and prevent memory leaks. If pooling is disabled, all memory is global and there is no clean-up.

If you want persistent memory allocation, add the prefix PERM_ to the name of each routine (PERM_MALLOC, PERM_REALLOC, PERM_CALLOC, PERM_STRDUP, and PERM_FREE).


Note –

Any memory you allocate from Init-class functions will be allocated as persistent memory, even if you use MALLOC. The server cleans up only the memory that is allocated while processing a request, and because Init-class functions are run before processing any requests, their memory is allocated globally.


Parameters

The following table describes parameters for the pool-init function.

Table 2–14 pool-init parameters

Parameter  

Description  

free-size

(Optional) Maximum size in bytes of free block list. May not be greater than 1048576. 

disable

(Optional) Flag to disable the use of pooled memory. Should have a value of true or false. Default value is false.

Example


Init fn=pool-init disable=true