Communicator e3000 MPE/iX Release 6.5 Express 2 (Software Release C.65.02) (30216-90322)

26 Chapter3

Technical Articles

Apache 1.3.9 for MPE/iX

with Procedure Exits enabled.

• PX1LXC8 - This patch changes the way getenv() operates. Currently getenv()

returns the address of the value of an environment variable. This patch causes the

value itself to be returned instead of the address. This change is needed for many

customer applications.(Release 6.0 and 6.5).

Support

Apache 1.3.9 for MPE/iX is supported through the HP Response Center as part of MPE

FOS support.

Product Description

Apache 1.3.9 for MPE/iX is an upgrade to base version Apache 1.3.9 and also includes

major new features and functionality. These new features include:

• Dynamic Shared Object (DSO) capability

• Extended API (EAPI)

• Additional compiled-in modules

• General bug ﬁxes and upgrades provided by the Apache Software Foundation as part of

the Apache 1.3.9 base.

• File Creation Mask

Dynamic Shared Objects (DSOs)

DSOs are add-on modules that extend the functionality of Apache. These module are

loaded at Apache startup (and at restart, i.e. kill -HUP) into Apache process space. These

modules exist separately from the Apache binary and allow a user to add new functionality

as they desire. This DSO feature keeps Apache memory usage low while still making new

features available. It also gives ﬂexibility in Apache installations. No recompilation of

Apache is necessary to use DSOs. However, DSOs require a DSO-enabled Apache, such as

Apache1.3.9.

HP currently provides a DSO for Java Servlets. This DSO can be installed to run with

Apache 1.3.9 or HP Webwise Secure Web Server.

Users can also create their own DSOs. A DSO is an Apache module, similar to the modules

that are compiled into the Apache binary. DSOs can be written in C or perl. To write a

DSO in C, /APACHE/PUB/libexec/mod_example.c ﬁle is a useful template. Mod_example.c

compiles into a working DSO by compiling it as a shared library, mod_example.so.

DSOs can also be created by using the bin/apxs utility ("Apache eXtenSion" tool). If

creating a DSO using bin/apxs, the -g and -n options will create a module skeleton and

corresponding Makeﬁle. This is useful as the Makeﬁle will contain all the necessary MPE

compile options. Details on using bin/apxs are found on the apxs manual page on your

server in /APACHE/PUB/manual/dso.html. Please note that apxs is a perl script and perl

is not distributed with FOS. It is available as downloadable software from

http://jazz.external.hp.com but is not supported by HP.

DSOs are conﬁgured in conf/httpd.conf by specifying the AddModule and LoadModule