NAME

Devel::DLMProf::Apache - Find dynamic loaded modules in mod_perl applications with Devel::DLMProf

SYNOPSIS

    # in your Apache config file with mod_perl installed
    PerlPassEnv DLMPROF
    PerlModule Devel::DLMProf::Apache

    # the case you use startup.pl

    PerlPostConfigRequire /path/to/startup.pl
    PerlPassEnv DLMPROF
    PerlModule Devel::DLMProf::Apache

DESCRIPTION

This module allows mod_perl applications to be profiled using Devel::DLMProf.

If the DLMPROF environment variable isn't set at the time Devel::DLMProf::Apache is loaded then Devel::DLMProf::Apache will issue a warning and default it to:

        /tmp/dlmprof.$$.out

Try using PerlPassEnv so you can set the DLMPROF environment variable externally.

Each profiled mod_perl process will need to have terminated before you can successfully read the profile data file. The simplest approach is to start the httpd, make some requests (e.g., 100 of the same request), then stop it and process the profile data.

Alternatively you could send a TERM signal to the httpd worker process to terminate that one process. The parent httpd process will start up another one for you ready for more profiling.

Example httpd.conf

It's often a good idea to use just one child process when profiling, which you can do by setting the MaxClients to 1 in httpd.conf.

Using an IfDefine blocks lets you leave the profile configuration in place and enable it whenever it's needed by adding -D DLMPROF to the httpd startup command line.

    <IfDefine DLMPROF>
        MaxClients 1
        PerlModule Devel::DLMProf::Apache
    </IfDefine>

SEE ALSO

Devel::DLMProf

AUTHOR

Takatoshi Kitano, <kitano.tk at gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by Takatoshi Kitano

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.