This section provides information on building dynamic modules on the AIX operating system, using the Makefile.exmpl file. This information includes locations of required files for building modules, instructions for building modules and using the APXS script. Links to related topics appear at the end of this section.
Building a module requires four files. Locate these files in the /usr/HTTPServer/example_module directory. This directory contains several files:
To build a module:
For an example, switch to the /usr/HTTPServer/example_module directory and run the make command. This commands acts on the mod_example.c sample file and creates a .so file for the mod_example file. To build your own module, use the sample file, mod_example.c, as a template.
The APXS script already has the compiler flags and link flags set for the AIX operating system. The syntax follows:
apxs -o mod_example.so -c *.c -be: mod_example.exp
The APXS script for the AIX operating system has an additional required option:
Failure to include this option on the APXS script results in the following message:
ld: 0711-244 ERROR: No csects or exported symbols have been saved.
Due to incompatibilities between mod_perl and the IBM HTTP Server AIX executable, running mod_perl as a Dynamic Shared Object (DSO) on AIX with the IBM HTTP Server is not recommended. For information on how to build mod_perl as a DSO on the IBM HTTP Server, you can refer to the Apache or mod_perl Web sites or forums.