NAME

Apache::DB - Run the interactive Perl debugger under mod_perl

SYNOPSIS

<Location /perl>
 PerlFixupHandler +Apache::DB

 SetHandler perl-script
 PerlHandler +Apache::Registry
 Options +ExecCGI
</Location>

DESCRIPTION

Perl ships with a very useful interactive debugger, however, it does not run "out-of-the-box" in the Apache/mod_perl environment. Apache::DB makes a few adjustments so the two will cooperate.

CAVEATS

first compile

The first step through when a script or module is first compiled may produce unexpected results. It is almost always best to continue the first run and step through after the script is compiled.

-X

The server must be started with the -X to use Apache::DB.

preloading

Module and scripts that are compiled during server startup time will not have debugging hooks enabled.

filename/line info

The filename of Apache::Registry scripts is not displayed.

SEE ALSO

perldebug(1)

AUTHOR

Doug MacEachern