Netscape ENTERPRISE SERVER 6.1, Manual

Page: 166 / 373

NSAPI Functions (in Alphabetical Order)
166 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
pblock *pb
is the
pblock
into which the name-value pairs are stored.
See also
pblock_copy, pblock_create, pblock_find, pblock_free,
pblock_nvinsert, pblock_remove, pblock_pblock2str
PERM_CALLOC
The
PERM_CALLOC
macro is a platform-independent substitute for the C library
routine
calloc
. It allocates
num*size
bytes of memory that persists after the
request that is being processed has been completed. If pooled memory has been
disabled in the configuration file (with the
pool-init
built-in SAF),
PERM_CALLOC
and
CALLOC
both obtain their memory from the system heap.
Syntax
void *PERM_CALLOC(int num, int size)
Returns
A void pointer to a block of memory
Parameters
int num
is the number of elements to allocate.
int size
is the size in bytes of each element.
Example
/* Allocate 256 bytes for a name */
char **name;
name = (char **) PERM_CALLOC(100, sizeof(char *));
See also
PERM_FREE, PERM_STRDUP, PERM_MALLOC, PERM_REALLOC, MALLOC, FREE,
CALLOC, STRDUP, REALLOC
PERM_FREE
The
PERM_FREE
macro is a platform-independent substitute for the C library
routine
free
. It deallocates the persistent space previously allocated by
PERM_MALLOC
,
PERM_CALLOC
, or
PERM_STRDUP
. If pooled memory has been disabled
in the configuration file (with the
pool-init
built-in SAF),
PERM_FREE
and FREE
both deallocate memory in the system heap.
Syntax
PERM_FREE(void *ptr);