Sun Java System Web Proxy Server 4.0.11 NSAPI Developer's Guide

Privatization of Some Data Structures

The data structures in nsapi_pvt.h are now considered to be private data structures. Do not write code that accesses them directly. Instead, use accessor functions. This change should have very little impact on customer-defined plug-ins. Examine nsapi_pvt.h to see which data structures have been removed from the public domain. You can also see the accessor functions you can use now to access these dat structures.

plug-ins written for Enterprise Server 3.x that access contents of data structures defined in nsapi_pvt.h will not be source compatible with Sun Java System Web Proxy Server 4 you will have to #include "nsapi_pvt.h" to build such plug-ins from source. These programs might not be binary compatible with Sun Java System Web Proxy Server 4, because some of the data structures in nsapi_pvt.h have changed size. In particular, the directive structure is larger, which means that a plug-in that indexes through the directives in a dtable will not work without being rebuilt with nsapi_pvt.h included.

Because the majority of plug-ins do not reference the internals of data structures in nsapi_pvt.h, most existing NSAPI plug-ins will be both binary and source compatible with Sun Java System Web Proxy Server 4.

plug-ins written for iPlanet Web Proxy Server 3.6 will not be binary compatible with Proxy Server 4. These plug-ins will have to be recompiled and relinked using Web Proxy Server 4’s NSAPI header files and libraries.