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::ApacheDESCRIPTION
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.$$.outTry 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
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.