Building dynamic modules on the Linux operating system using the Makefile.exmpl file

This section provides information on building dynamic modules on the Linux 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.

• Locating required files for building modules
• Building a module
• Using the APXS script on the Linux platform
• Finding related information

Locating required files for building modules

Building a module requires two files. Locate these files in the /opt/IBMHTTPServer/example_module directory. This directory contains several files:

• Makefile for example dynamic shared object modules: Makefile.exmpl
• Sample module: mod_example.c

Building a module

To build a module:

1. Install the server.
2. Copy the entire example_module directory to your build directory.
3. Switch to the build directory.
4. Copy your module.c file to the build directory
.
5. Rename the Makefile.exmpl file to Makefile.
6. Edit the file, Makefile, and make the following changes:
   • Replace SRCFILE with the name of the source file, without the extension.
7. Issue the make command.
8. Copy the resulting .so file to the /opt/IBMHTTPServer/libexec directory.
9. Add the LoadModule and AddModule directives to the httpd.conf file, along with any module-specific directives.
10. Restart the server.

For an example, switch to the /opt/IBMHTTPServer/example_module directory and run the make -f Makefile.exmpl command. This command 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.

Using the APXS script on the Linux platform

The APXS script already has the compiler flags and link flags set for the Linux operating system. The syntax follows:

apxs -o mod_example.so -c *.c

     (Back to the top)