Programmer's Guide to Enterprise Server 4.0

Programmer's Guide to Enterprise Server 4.0
Table of Contents | Previous | Next | Index | Bookshelf

Programmer's Guide to Enterprise Server 4.0

Chapter 4. NSAPI Changes

This chapter lists the changes to NSAPI in Enterprise Server 4.0. These changes are:

Privatization of Some Data Structures

In Enterprise Server 4.0, some data structures have been moved from nsapi.h to nsapi_pvt.h. The data structures in nsapi_pvt.h are now considered to be private data structures, and you should not write code that accesses them directly. Instead, use accessor functions. We expect that very few people have written plugins that access these data structures directly, so this change should have very little impact on existing customer-defined plugins. Look in nsapi_pvt.h to see which data structures have been removed from the public domain and to see the accessor functions you can use to access them from now on.

Plugins written for Enterprise Server 3.x that access contents of data structures defined in nsapi_pvt.h will not be source compatible with ES 4.0, that is, it will be necessary to #include "nsapi_pvt.h" in order to build such plugins from source. There is also a small chance that these programs will not be binary compatible with Enteprise Server 4.0, because some of the data structures in nsapi_pvt.h have changed size. In particular, the directive structure is larger, which means that a plugin that indexes through the directives in a dtable will not work without being rebuilt (with nsapi_pvt.h included).

We hope that the majority of plugins do not reference the internals of data structures in nsapi_pvt.h, and therefore that most plugins will be both binary and source compatible with Enterprise Server 4.0.

Logging Changes

The following API changes support the logging modifications in Enterprise Server 4.0:

New Init-class SAF, flex-rotate-init, lets you initialize log rotation for logs that use the flexible format.

For more information, see the discussion of flex-rotate-init in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

New relaxed parameter to the Init-class SAF flex-init allows you to specify whether logging uses relaxed mode or not. Also, the format parameter for flex-init now lets you log the values of named cookies.

When logging uses relaxed mode, it skips the logging of any variable that would normally block cache acceleration when processing requests for static files.

For more information, see the discussion of flex-init in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

Cookie Support

Two new NSAPI function for use with cookies.

The util_cookie_find function finds a specific cookie in a cookie string and return its value.

The util_cookie_next function enumerates all the cookie name-value pairs in a cookie string.

For more information, see the discussion of util_cookie_find and util_cookie_next in Chapter 5, "NSAPI Function Reference" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

New SAF for Security

New PathCheck-class function ssl-check helps enforce keysize restriction for cipher settings.

For more information, see the discussion of ssl-check in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

New SAFs for Adding Headers and Footers

New Service-class SAFs, add-header and add-footer, allow you to specify file names or URLs that provide a header or footer for a page being returned to the requesting client.

For more information, see the discussion of add-header and add-footer in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

Minor Changes to Init-class SAFs

Minor changes to the parameters for the Init-class SAF cache-init.

For more information, see the discussion of cache-init in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

Minor changes to the parameters for the Init-class SAF cindex-init.

For more information, see the discussion of cache-init in Chapter 3, "Directives and Their Predefined SAFs" in the "

NSAPI Programmer's Guide

http://developer.netscape.com/docs/manuals/enterprise/4.0/nsapi/index.htm

Table of Contents | Previous | Next | Index | Bookshelf

Last Updated: 08/12/99 12:35:19

Copyright Š1999 Netscape Communications Corp. All rights reserved.