NAME
    Apache::Module - Interface to Apache C module structures

SYNOPSIS
      use Apache::Module ();

DESCRIPTION
    This module provides an interface to the list of apache modules
    configured with your httpd and their `module *' structures.

METHODS
    top_module
        This method returns a pointer the first module in Apache's internal
        list of modules.

           Example:

           my $top_module = Apache::Module->top_module;

           print "Configured modules: \n";

           for (my $modp = $top_module; $modp; $modp = $modp->next) {
                print $modp->name, "\n";
           }

    find($module_name)
        This method returns a pointer to the module structure if found,
        under otherwise.

          Example:

         for (qw(proxy perl include cgi)) {
             if(my $modp = Apache::Module->find($_)) {
                 print "$_ module is configured\n";
                 print "with enabled commands: \n";

                 for (my $cmd = $modp->cmds; $cmd; $cmd = $cmd->next) {
                     print "   ", $cmd->name, "\n";
                 }
             }
             else {
                 print "$_ module is not configured\n";
             }
         }

    handlers
        Returns a pointer to the module response handler table.

        Example:

            print "module ", $modp->name, " handles:\n";

            for (my $hand = $modp->handlers; $hand; $hand = $hand->next) {
                print $hand->content_type, "\n";
            }

    Other Stuff
        There's more you can do with this module, I will document it later.
        For now, see Apache::ModuleDoc and Apache::ShowRequest for examples.

AUTHOR
    Doug MacEachern

SEE ALSO
    Apache::ModuleDoc(3), Apache::ShowRequest(3), Apache(3), mod_perl(3).

