Communicator e3000 MPE/iX Release 7.0 Express 1 (Software Release C.70.01) (30216-90328)

Chapter 3 53
New Networking
Apache 1.3.14 for MPE/iX
Feature Set
Dynamic Shared Objects (DSOs)
DSOs are add-on modules that extend the functionality of Apache. These modules are
self-contained code that can provide a wide-range of additional Apache capabilities such as
custom authentication and authorization, custom logging, or new configuration directives.
Users can create their own Apache modules or use those written by others. For instance,
the Apache Module Registry (http://modules.apache.org/) is a web site with downloadable
Apache modules. Some of these modules are freely available while others have various
license restrictions. DSOs on MPE/iX can utilize Apache's full Application Programming
Interface (API) as well as Apache's full Extended Application Programming Interface
(EAPI).
A DSO is an Apache module with the same structure as the modules compiled into the
Apache binary. But instead of being statically linked into the Apache program, the DSO
module is created as a shared library (NMXL). DSOs are loaded at Apache startup into
Apache's process space.
No recompilation of Apache is necessary to use DSOs. However, DSOs require a
DSO-enabled Apache such as Apache 1.3.9 or Apache 1.3.14 for MPE/iX or HP WebWise
MPE/iX Secure Web Server.
Using DSO modules keeps Apache memory usage low by running an Apache binary with
core features only and adding additional features with DSOs. DSOs also provide
flexibility. An installation can pick and choose which features to include in their web
server.
Apache DSOs can be written in either the C programming language or in the Perl scripting
language. DSOs written in Perl require the mod_perl module to be linked either statically
or dynamically (DSO) into Apache. Since mod_perl is not currently part of Apache for
MPE/iX, DSO modules for Apache 1.3.9 for MPE/iX,and Apache 1.3.14 for MPE/iX, must
be written in C. Mod_perl is part of the HP WebWise MPE/iX Secure Web Server product
version 2so DSOs for Secure WebServer can be written in either C orPerl.
Information on creating and installing DSOs for Apache on MPE/iX is provided in the
"Configuring and Managing Internet Services" manual for Release 7.0 Express 1.
EAPI
Apache 1.3.14 for MPE/iX is built with an extended set of Apache APIs. That means that
this version also expects these EAPIs to be built into any module it calls, including DSOs.
This EAPI feature is included in Apache 1.3.14 or MPE/iX so that a commom DSO can be
used by both Apache and WebWise without the need to recompile the module.
When creating DSOs, you must compile with the -DEAPI option. This will include the
necessary EAPI header files. These header files are part of the Apache 1.3.14 for MPE/iX
distribution and reside in the/APACHE/PUB/include directory. The include directory also
contains the README.EAPI file. The README.EAPI file describes the additional
functionality that is available with EAPI such as more features in the mod_rewrite,
mod_status, and mod_proxy modules. DSOs created with the apxs utility will
automatically include the -DEAPI option.