SUPPORT

MAIL LIST

For comments, questions, bug-reports, announcements, etc., send mail to modperl@apache.org To subscribe to this list (which you must do to send mail to the list), send a mail message to majordomo@apache.org with the body:

 subscribe modperl

(Thanks to Brian Behlendorf) (Thanks also to Mark A. Imbriaco who maintained the original list for 2 years)

MAIL LIST ARCHIVE

Thanks to James Cooper, there is a hypermail archive for this list at:

 http://outside.organic.com/mail-archives/modperl/
 

REPORTING PROBLEMS

HOMEWORK

Make sure you've done your homework before reporting a problem. Check the mail archive, read cgi_to_mod_perl.pod, the FAQ and other pod documents in the distribution.

HOW

When debugging, always start httpd with the -X switch so only one process is started.

Always check the error_log.

WHERE

Please send mail to modperl@listproc.itribe.net

WHAT

Always include this information:

Output of perl -v; perl -V

Version of mod_perl

Version of apache

Server configuration details

relevant sections of /tmp/mod_perl_error_log or logs/error_log

If 'make test' fails, the output of 'make test TEST_VERBOSE=1'

Depending on the nature of your problem, you may also be asked:

-Does 'make test' pass 100%?

-Does your script still work under CGI?

-Do you have a *small* test script that illustrates the problem?

-Can you get a backtrace (if httpd is dumping core)?

CORE DUMPS

If you get a core dump, please send a backtrace if possible. Before you try, build mod_perl with perl Makefile.PL PERL_DEBUG=1 which will: -add `-g' to EXTRA_CFLAGS -turn on PERL_TRACE -set PERL_DESTRUCT_LEVEL=2 (additional checks during Perl cleanup) -link against libperld if it exists

Here's how to get a backtrace:

 % cd mod_perl-x.xx
 % touch /tmp/mod_perl_srm.conf
 % gdb ../apache_x.xx/src/httpd
 (gdb) run -X -d `pwd/t'
 [now make request that causes core dump]
 (gdb) bt

If the dump is happening in libperl a -DDEBUGGING enabled libperl would help show us what's really happening.

Go to your Perl source tree:

 % rm *.[oa]
 % make LIBPERL=libperld.a
 % cp libperld.a $Config{archlibexp}/CORE

$Config{archlibexp} is:

 % perl -V:archlibexp

Rebuild httpd/mod_perl with PERL_DEBUG=1, let's see a new backtrace.