User manual REDHAT NETSCAPE ENTERPRISE SERVER 6.0 NSAPI PROGRAMMER GUIDE

[. . . ] NSAPI Programmer's Guide Netscape Enterprise Server Version 6. 0 November 2001 Netscape Communications Corporation ("Netscape") and its licensors retain all ownership rights to the software programs offered by Netscape (referred to herein as "Software") and related documentation. Use of the Software and related documentation is governed by the license agreement for the Software and applicable copyright law. Your right to copy this documentation is limited by copyright law. Making unauthorized copies, adaptations or compilation works is prohibited and constitutes a punishable violation of the law. [. . . ] The pointer returned is a pointer into the pblock. If you want to modify it, do a STRDUP and modify the copy. Syntax char *pblock_findval(char *name, pblock *pb); Returns A string containing the value associated with the name or NULL if no match was found Parameters char *name is the name of a name-value pair. pblock *pb is the pblock to be searched. See also pblock_create, pblock_copy, pblock_find, pblock_free, pblock_nvinsert, pblock_remove, request_header pblock_free The pblock_free function frees a specified pblock and any entries inside it. If you want to save a variable in the pblock, remove the variable using the function pblock_remove and save the resulting pointer. Syntax void pblock_free(pblock *pb); Chapter 5 NSAPI Function Reference 157 NSAPI Functions (in Alphabetical Order) Returns void Parameters pblock *pb is the pblock to be freed. See also pblock_copy, pblock_create, pblock_dup, pblock_find, pblock_findval, pblock_nvinsert, pblock_remove pblock_nninsert The pblock_nninsert function creates a new entry with a given name and a numeric value in the specified pblock. The numeric value is first converted into a string. The name and value parameters are copied. Syntax pb_param *pblock_nninsert(char *name, int value, pblock *pb); Returns A pointer to the new pb_param structure. Parameters char *name is the name of the new entry. int value is the numeric value being inserted into the pblock. If the value you assign is not a number, then instead use the function pblock_nvinsert to create the parameter. pblock *pb is the pblock into which the insertion occurs. See also pblock_copy, pblock_create, pblock_find, pblock_free, pblock_nvinsert, pblock_remove, pblock_str2pblock pblock_nvinsert The pblock_nvinsert function creates a new entry with a given name and character value in the specified pblock. The name and value parameters are copied. Syntax pb_param *pblock_nvinsert(char *name, char *value, pblock *pb); 158 Netscape Enterprise Server NSAPI Programmer's Guide · November 2001 NSAPI Functions (in Alphabetical Order) Returns A pointer to the newly allocated pb_param structure Parameters char *name is the name of the new entry. char *value is the string value of the new entry. pblock *pb is the pblock into which the insertion occurs. Example pblock_nvinsert("content-type", "text/html", rq->srvhdrs); See also pblock_copy, pblock_create, pblock_find, pblock_free, pblock_nninsert, pblock_remove, pblock_str2pblock pblock_pb2env The pblock_pb2env function copies a specified pblock into a specified environment. The function creates one new environment entry for each name-value pair in the pblock. Use this function to send pblock entries to a program that you are going to execute. Syntax char **pblock_pb2env(pblock *pb, char **env); Returns A pointer to the environment. Parameters pblock *pb is the pblock to be copied. char **env is the environment into which the pblock is to be copied. See also pblock_copy, pblock_create, pblock_find, pblock_free, pblock_nvinsert, pblock_remove, pblock_str2pblock pblock_pblock2str The pblock_pblock2str function copies all parameters of a specified pblock into a specified string. The function allocates additional non-heap space for the string if needed. Use this function to stream the pblock for archival and other purposes. Chapter 5 NSAPI Function Reference 159 NSAPI Functions (in Alphabetical Order) Syntax char *pblock_pblock2str(pblock *pb, char *str); Returns The new version of the str parameter. [. . . ] PRUint32 flags is ORed directives for this function (see Flags). Request *rq is a pointer to the request. Session *sn is a pointer to the session. Flags DR_NONE specifies that no cache is used, so the function works as net_write does; DrHdl can be NULL. [. . . ]