The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Apache-mod_perl_guide-1.31
++
/ src::help

Getting Help and Further Learning

READ ME FIRST

If, after reading this guide and the other documents listed in this section, you still don't have the answers/information needed, please ask for help on the Apache/mod_perl mailing list. But please, first try to browse the mailing list archive. Most of the time you will find the answer to your questions by searching the archive, since it is very likely that someone else has already encountered the same problem and found a solution for it. If you ignore this advice, you should not be surprised if your question is left unanswered - it bores people to answer the same question more than once. This does not mean that you should avoid asking questions, but you should not abuse the available help and you should RTFM before you call for HELP. (Remember the fable of the shepherd boy and the wolves).

For more information See Get helped with mod_perl.

Contacting me

Hi, I wrote this document to help people with mod_perl. It does not mean that if you have any question regarding mod_perl, perl or whatever you think I might know, you should send it directly to me. Please see the Get help with mod_perl section and follow the guidelines described there.

However, you are welcome to submit corrections and suggestions directly to me at stas@stason.org?subject=mod_perl%20guide%20corrections. If you are going to submit heavy corrections of the text (I love those!), please help me by downloading the source pages in POD from http://www.stason.org/guide-snapshots/, directly editing them and sending them to me. I will use Emacs Ediff to perform an easy merge of such changes. Thank you!

PLEASE DO NOT SEND QUESTIONS DIRECTLY TO ME, I didn't invite those by writing the guide. They will all be immediately deleted. Please ask questions on the mod_perl list and if we can answer your question, one (or more) of us will answer it on the list. Thank you!

Get help with mod_perl

  • mod_perl home

    http://perl.apache.org

  • News and Resources

    Take23: News and Resources for the mod_perl world http://take23.org

  • mod_perl Books

    • 'Apache Modules' Book

      http://www.modperl.com is the home site of The Apache Modules Book, a book about creating Web server modules using the Apache API, written by Lincoln Stein and Doug MacEachern.

      The book should be available from your local bookstore or from your favorite on-line bookseller. O'Reilly lists this book as:

        Writing Apache Modules with Perl and C
  By Lincoln Stein & Doug MacEachern
  1st Edition March 1999
  2nd Edition Feb 2000
  1-56592-567-X, Order Number: 567X
  746 pages, $34.95

    • 'Managing and Programming mod_perl' Book

      http://www.modperlbook.com is the home site of the new mod_perl book, that Eric Cholet and Stas Bekman are co-authoring. We expect the book to be published in 2001.

      Ideas, suggestions and comments are welcome. Please send them to info@modperlbook.com .

    • mod_perl Quick Reference Card

      mod_perl Pocket Reference by Andrew Ford was published by O'Reilly and Associates http://www.oreilly.com/catalog/modperlpr/

      You should probably get also the Apache Pocket Reference by the same author and the same publisher: http://www.oreilly.com/catalog/apachepr/

      See also Andrew's collection of reference card for Apache and other programs: http://www.refcards.com.

  • mod_perl Guide

    by Stas Bekman at http://perl.apache.org/guide

  • mod_perl FAQ

    by Frank Cringle at http://perl.apache.org/faq/ .

  • mod_perl performance tuning guide

    by Vivek Khera at http://perl.apache.org/tuning/ .

  • mod_perl plugin reference guide

    by Doug MacEachern at http://perl.apache.org/src/mod_perl.html .

  • Quick guide for moving from CGI to mod_perl

    at http://perl.apache.org/dist/cgi_to_mod_perl.html .

  • mod_perl_traps, common traps and solutions for mod_perl users

    at http://perl.apache.org/dist/mod_perl_traps.html .

  • Articles

    • PerlMonth

      http://perlmonth.com

    • ApacheToday

      http://apachetoday.com

    • Basic knowledge about Apache stages and mod_perl handlers article in German

      http://www.heise.de/ix/artikel/2000/01/156/

  • mod_perl mailing lists

    • The mod_perl mailing list

      The Apache/Perl mailing list is available for mod_perl users and developers to share ideas, solve problems and discuss things related to mod_perl and the Apache::* modules. To subscribe to this list, send email to modperl-subscribe@apache.org . To unsubscribe send email to modperl-unsubscribe@apache.org .

      To subscribe to the digest list send email to modperl-digest-subscribe@apache.org .

      Searchable mailing list archives are available:

      • http://mathforum.org/epigone/modperl

      • http://www.geocrawler.com/lists/3/web/182/0/

      • http://www.mail-archive.com/modperl%40apache.org/

      • http://www.davin.ottawa.on.ca/archive/modperl/

      • http://marc.theaimsgroup.com/?l=apache-modperl

      • http://www.egroups.com/group/modperl/

    • The mod_perl development mailing list

      This list is for discussions about the development of the core mod_perl.

      Subscription information.

      To subscribe to this list send an empty email to dev-subscribe@perl.apache.org. To unsubscribe from the list send an empty email to dev-unsubscribe@perl.apache.org. To get help with the list send an empty email to dev-help@perl.apache.org.

      List's searchable archives:

      • http://marc.theaimsgroup.com/?l=apache-modperl-dev&r=1&w=2#apache-modperl-dev

      • http://www.mail-archive.com/dev%40perl.apache.org/

    • The mod_perl documentation mailing list

      This mailing list is for discussing mod_perl documentation.

      Subscription information

        Subscribe to the list: docs-dev-subscribe@perl.apache.org.
  Unsubscribe from the list: docs-dev-unsubscribe@perl.apache.org.
  Get help with the list: docs-dev-help@perl.apache.org.

    • The Apache test framework development mailing list

      The test-dev list is the list where Apache HTTP Test project is discussed.

      Subscription information:

        Subscribe to the list: test-dev-subscribe@httpd.apache.org.
  Unsubscribe from the list: test-dev-unsubscribe@httpd.apache.org.
  Get help with the list: test-dev-help@httpd.apache.org.

      List's searchable archive:

      http://www.apachelabs.org/test-dev/

    • The advocacy mailing list

      The list for mod_perl advocacy issues, discussions about sites, etc.

      Subscribe by sending a mail to advocacy-subscribe@perl.apache.org. Unsubscribe by sending a mail to advocacy-unsubscribe@perl.apache.org. Use advocacy@perl.apache.org to post to the list.

      The archive: http://www.mail-archive.com/advocacy@perl.apache.org/.

    • The modperl-cvs mailing list

      The modperl developers list is the list where you can watch mod_perl getting patched. No real discussions happen on this list, but if you want to know about the latest changes in the mod_perl core before everyone else, this is a list to be on.

      To subscribe to this list, send email to modperl-cvs-subscribe@apache.org . To unsubscribe send email to modperl-cvs-unsubscribe@apache.org . Send email to modperl-cvs@apache.org to post to the list.

      No archives available.

Get help with Perl

  • The Perl FAQ

    http://www.perl.com/CPAN/doc/FAQs/FAQ/PerlFAQ.html

  • The Perl Home Page

    http://www.perl.com/

  • The Perl Journal

    http://www.tpj.com/

  • Perl Module Mechanics

    http://world.std.com/~swmcd/steven/perl/module_mechanics.html - This page describes the mechanics of creating, compiling, releasing and maintaining Perl modules.

  • Creating (and Maintaining) Perl Modules

    http://www.mathforum.com/~ken/perl_modules.html

  • XS tutorials

    Perl manpages: perlguts, perlxs, and perlxstut manpages.

    Dean Roehrich's XS CookBookA and CookBookB http://search.cpan.org/search?dist=CookBookA http://search.cpan.org/search?dist=CookBookB

    a series of articles at PerlMonth.com by Steven McDougall: http://www.perlmonth.com/columns/modules/modules.html?issue=6 http://www.perlmonth.com/columns/modules/modules.html?issue=7 http://www.perlmonth.com/columns/modules/modules.html?issue=8 http://www.perlmonth.com/columns/modules/modules.html?issue=9 http://www.perlmonth.com/columns/modules/modules.html?issue=10

    Advanced Perl Programming By Sriram Srinivasan. Published by O'Reilly & Associates. ISBN: 1-56592-220-4. Chapters 18-20.

    perl-xs mailing list on perl.org (mail perl-xs-subscribe@perl.org)

    Take a look also at Inline.pm (CPAN) and SWIG (http://www.swig.org/)

  • Perl mailing lists

    A huge number of diverse Perl mailing lists is listed at http://lists.perl.org/.

  • perl5-porters mailing list

    Send an email:

    • to perl5-porters-subscribe@perl.org to subscribe to this list.

    • to perl5-porters-unsubscribe@perl.org to unsubscribe to this list.

    • to perl5-porters-digest-subscribe@perl.org if you prefer a digest version.

    • to perl5-porters-digest-unsubscribe@perl.org to unsubscribe from the digest.

    • to perl5-porters-help@perl.org for more information about the subscription options.

    See also http://tile.net/listserv/perl5portersdigest.html and http://tile.net/lists/perl5porters.html .

    List's archive is available at http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/.

Get help with Perl/CGI

  • Perl/CGI FAQ

    at http://www.perl.com/CPAN/doc/FAQs/cgi/perl-cgi-faq.html

  • Answers to some troublesome Perl and Perl/CGI questions

    http://stason.org/TULARC/webmaster/myfaq.html

  • Idiot's Guide to CGI programming

    http://www.perl.com/CPAN/doc/FAQs/cgi/idiots-guide.html

  • WWW Security FAQ

    http://www.w3.org/Security/Faq/www-security-faq.html

  • CGI/Perl Taint Mode FAQ

    http://www.gunther.web66.com/FAQS/taintmode.html (by Gunther Birznieks)

  • cgi-list mailing list

    Send email to majordomo@jann.com with body:

      subscribe cgi-list

Get help with Apache

  • Apache Project's Home

    http://www.apache.org

  • Apache Mailing Lists

    You will find a comprehensive list of all Apache projects' mailing lists at: http://www.apache.org/foundation/mailinglists.html

  • Apache Quick Reference Card

    http://www.refcards.com (other reference cards are also available from this link)

  • The Apache FAQ

    http://www.apache.org/docs/misc/FAQ.html

  • Apache Server Documentation

    http://www.apache.org/docs/

  • Apache Handlers

    http://www.apache.org/docs/handler.html

  • mod_rewrite Guide

    http://www.engelschall.com/pw/apache/rewriteguide/

  • articles

    Security and Apache: An Essential Primer http://linuxplanet.com/linuxplanet/print/1527/

    Using Apache with Suexec on Linux http://linuxplanet.com/linuxplanet/print/1445/

    Installing and Securing the Apache Webserver with SSL http://www.securityfocus.com/focus/sun/articles/apache-inst.html?&_ref=1653102939

  • mod_throttle_access

    mod_throttle_access is available at http://www.fremen.org/apache/

Get help with DBI and SQL

  • Introduction to Structured Query Language: http://w3.one.net/~jhoffman/sqltut.htm

  • SQL for Web Nerds by Philip Greenspun http://www.arsdigita.com/books/sql/

  • Jeffrey Baker's DBI Examples and Performance Tuning

    http://www.saturn5.com/~jwb/dbi-examples.html (by Jeffrey William Baker).

  • DBI Homepage

    http://www.symbolstone.org/technology/perl/DBI/

  • DBI mailing list information

    http://www.fugue.com/dbi/

  • DBI mailing list archives

    http://outside.organic.com/mail-archives/dbi-users/ http://www.xray.mpe.mpg.de/mailing-lists/dbi/

Get help with Squid - Internet Object Cache

  • Home page - http://squid.nlanr.net/

  • FAQ - http://squid.nlanr.net/Squid/FAQ/FAQ.html

  • Users Guide - http://squid.nlanr.net/Squid/Users-Guide/

  • Mailing lists - http://squid.nlanr.net/Squid/mailing-lists.html

Get help with CVS -- Concurrent Version Control

  • mod_perl repository specific doc: mod_perl_cvs.pod, located in the root of the mod_perl source distribution and online at http://perl.apache.org/mod_perl_cvs.html

  • Open Source Development with CVS http://cvsbook.red-bean.com/

  • Online Documents http://www.sourcegear.com/CVS/Docs/online

  • CVS Quick Reference http://www.sourcegear.com/CVS/Docs/ref

  • CVS Books http://www.sourcegear.com/CVS/Docs/books

  • User-Written FAQ http://www.sourcegear.com/CVS/Docs/docfaq

  • Introduction to CVS http://www.sourcegear.com/CVS/Docs/blandy

Get help with Performance and Scalability

  • Techniques and Technologies for Scaling Internet Services mailing list.

    The list's address: scalable@arctic.org. Subscribe by sending a message to scalable-subscribe@arctic.org. Archive: http://archive.develooper.com/scalable@arctic.org/

  • Solaris 2.x - Tuning Your TCP/IP Stack and More http://www.sean.de/Solaris/tune.html

    This page talks about TCP/IP stack and various tricks of tuning your system to get the most out of it as a web server. While the information is for Solaris 2.x OS, most of it will be relevant of other Unix flavors. At the end an extensive list of related literature is presented.

  • High-Availability Linux Project http://www.linux-ha.org/

Get help with Unix OS flavors -- Unix OS related resources

  • Memory system management and architecture:

    The Solaris memory system, sizing, tools and architecture: http://www.sun.com/solutions/third-party/global/SAS/pdf/vmsizing.pdf