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

This section provides information on building dynamic modules on the Solaris operating system, using the Makefile.exmpl file. This information includes locations of required files for building modules, and 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 Solaris platform
• Finding related information

Locating required files for building modules

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

• Makefile for example dynamic shared object modules (DSOs): 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.tmpl file to Makefile.
6. Edit the file, Makefile and replace the name SRCFILE, with the name of the source file, without the extension.
7. Issue the make command.
8. Copy the mod_foo.so file into the opt/IBMHTTPD/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 /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.

Using the APXS script on the Solaris platform

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

apxs -o mod_example.so -c *.c 

     (Back to the top)