Netscape ENTERPRISE SERVER 6.1, Manual

Page: 128 / 373

Overview of NSAPI C Functions
128 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
Protocol Utilities for Service SAFs
Protocol utilities provide functionality necessary to implement Service SAFs:
•
request_header
returns the value for a given request header name, reading
the headers if necessary. This function must be used when requesting entries
from the browser header
pblock
(
rq->headers
).
•
protocol_status
sets the HTTP response status code and reason phrase
•
protocol_start_response
sends the HTTP response and all HTTP headers to
the browser.
Memory Management
Memory management routines provide fast, platform-independent versions of the
standard memory management routines. They also prevent memory leaks by
allocating from a temporary memory (called “pooled” memory) for each request
and then disposing the entire pool after each request. There are wrappers for
standard memory routines for using permanent memory. To disable pooled
memory for debugging, see the built-in SAF
pool-init
in Chapter 7, “Syntax and
Use of magnus.conf.”
•
MALLOC
•
FREE
•
STRDUP
•
REALLOC
•
CALLOC
•
PERM_MALLOC
•
PERM_FREE
•
PERM_STRDUP
•
PERM_REALLOC
•
PERM_CALLOC