Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 296 / 612

Functions for Managing Memory
296 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Syntax
#include “slapi-plugin.h”
void slapi_ch_free_string( char **s );
Parameters
This function takes the following parameter:
Description
This function is similar to
slapi_ch_free()
, but the argument is the address of a
string. This helps with compile time error checking.
See Also
slapi_ch_free()
slapi_ch_malloc()
Allocates space in memory.
Syntax
#include “slapi-plugin.h”
char * slapi_ch_malloc( unsigned long size );
Parameters
This function takes the following parameters:
Returns
This function returns a pointer to the newly allocated space of memory. If space
cannot be allocated, for example, if no more virtual memory exists, the
slapd
program terminates.
Memory Concerns
This function terminates the
slapd
server with an “out of memory” error message
if memory cannot be allocated.
s
Address of the string that you want to free. If
NULL
, no action occurs.
size
Size of the space that you want to allocate memory for.