Table of Contents
Advertisement
Overview of NSAPI C Functions
NSAPI provides a set of C functions that are used to implement SAFs. They serve
several purposes. They provide platform-independence across Netscape Server
operating system and hardware platforms. They provide improved performance.
They are thread-safe which is a requirement for SAFs. They prevent memory leaks.
And they provide functionality necessary for implementing SAFs. You should
always use these NSAPI routines when defining new SAFs.
This section provides an overview of the function categories available and some of
the more commonly used routines. All the public routines are detailed in Chapter
5, "NSAPI Function Reference."
The main categories of NSAPI functions are:
•
Parameter Block Manipulation Routines
•
Protocol Utilities for Service SAFs
•
Memory Management
•
File I/O
•
Network I/O
•
Threads
•
Enterprise ServerUtilities
•
Virtual Server
Parameter Block Manipulation Routines
The parameter block manipulation functions provide routines for locating, adding,
and removing entries in a
•
pblock_findval
•
pblock_nvinsert
•
pblock_remove
not disposed. Use
•
param_free
•
pblock_pblock2str
from a
function for debugging.
pblock
returns the value for a given name in a
adds a new name-value entry to a
removes a
pblock
param_free
frees the memory for the given
creates a new string containing all the name-value pairs
in the form "name
pblock
data structure include:
entry by name from a
to free the memory used by the entry.
pblock
value name
value." This can be a useful
=
=
Chapter 4
Overview of NSAPI C Functions
.
pblock
.
pblock
. The entry is
pblock
entry.
Creating Custom SAFs
127
Advertisement
Table of Contents
