Sorry for the delay. Here's the revised mod_perl Apache module doc, as
discussed last week. Or whenever that was. Stas said to just go ahead
and send the doc to the list rather than a diff, as it is a complete
change.
Thanks
--
Rich Bowen
http://www.apacheadmin.com/
Apache Support and Training
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
<html xmlns="http://www.w3.org/1999/xhtml";>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>mod_perl- Apache HTTP Server</title>
<link href="../style/manual.css" type="text/css" rel="stylesheet" />
</head>
<body>
<blockquote>
<div align="center">
<img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
</div>
<h1 align="center">Apache Module mod_perl</h1>
<table cellspacing="1" cellpadding="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap" valign="top"><span
class="help">Description:</span></td>
<td>Integration of the Perl programming language and the Apache
API</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="module-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="module-dict.html#ModuleIdentifier"
class="help">Module Identifier:</a></td>
<td>perl_module</td>
</tr>
</table>
</td>
</tr>
</table>
<h2>Summary</h2>
<p>The Apache/Perl integration project brings together the full power of
the Perl programming language and the Apache HTTP server.</p>
<blockquote>
<table>
<tr>
<td bgcolor="#e0e5f5">
<p align="center"><strong>Why this doc is so sparse</strong></p>
This document is intended <em>only</em> as a reference to
available Apache configuration file directives provided by
mod_perl. Full details are intentionally ommitted, because the
mod_perl documentation itself is so complete. This document
exists primarily in order to give the information in a format
familiar to those used to the other Apache module docs.
</td>
</tr>
</table>
</blockquote>
<p>Additional information about mod_perl is available at <a
href="http://perl.apache.org/";>http://perl.apache.org/</a>.</p>
<h2>Directives</h2>
<ul>
<li><a href="#__cut__">__CUT__</a></li>
<li><a href="#<perl>"><Perl></a></li>
<li><a href="#=back">=back</a></li>
<li><a href="#=cut">=cut</a></li>
<li><a href="#=pod">=pod</a></li>
<li><a href="#perlaccesshandler">PerlAccessHandler</a></li>
<li><a href="#perladdvar">PerlAddVar</a></li>
<li><a href="#perlauthenhandler">PerlAuthenHandler</a></li>
<li><a href="#perlauthzhandler">PerlAuthzHandler</a></li>
<li><a href="#perlchildexithandler">PerlChildExitHandler</a></li>
<li><a href="#perlchildinithandler">PerlChildInitHandler</a></li>
<li><a href="#perlcleanuphandler">PerlCleanupHandler</a></li>
<li><a href="#perldispatchhandler">PerlDispatchHandler</a></li>
<li><a href="#perlfixuphandler">PerlFixupHandler</a></li>
<li><a href="#perlfreshrestart">PerlFreshRestart</a></li>
<li><a href="#perlhandler">PerlHandler</a></li>
<li><a href="#perlheaderparserhandler">PerlHeaderParserHandler</a></li>
<li><a href="#perlinithandler">PerlInitHandler</a></li>
<li><a href="#perlloghandler">PerlLogHandler</a></li>
<li><a href="#perlmodule">PerlModule</a></li>
<li><a href="#perlpassenv">PerlPassEnv</a></li>
<li><a
href="#perlpostreadrequesthandler">PerlPostReadRequestHandler</a></li>
<li><a href="#perlrequire">PerlRequire</a></li>
<li><a href="#perlrestarthandler">PerlRestartHandler</a></li>
<li><a href="#perlscript">PerlScript</a></li>
<li><a href="#perlsendheader">PerlSendHeader</a></li>
<li><a href="#perlsetenv">PerlSetEnv</a></li>
<li><a href="#perlsetupenv">PerlSetupEnv</a></li>
<li><a href="#perlsetvar">PerlSetVar</a></li>
<li><a href="#perltaintcheck">PerlTaintCheck</a></li>
<li><a href="#perltranshandler">PerlTransHandler</a></li>
<li><a href="#perltypehandler">PerlTypeHandler</a></li>
<li><a href="#perlwarn">PerlWarn</a></li>
</ul>
<h2>POD</h2>
<p>POD is the Perl documentation format. POD stands for Plain Old
Documentation. Please see <a
href="http://www.perldoc.com/perl5.6.1/pod/perlpod.html";>http://www.perldoc.com/perl5.6.1/pod/perlpod.html</a>
for additional details, or type <code>perldoc perlpod</code> at your
command line.</p>
<hr />
<h2><a id="__CUT__" name="__CUT__">__CUT__</a> <a id="__cut__"
name="__cut__">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Stop reading config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>__CUT__</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Stop reading the configuration file. Everything following a <code
class="directive">__CUT__</code> is ignored.</p>
<hr />
<h2><a id="<Perl>" name="<Perl>"><Perl></a> <a
id="<perl>" name="<perl>">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Include Perl code in your configuration file</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td><Perl> # code here </Perl></td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>The <Perl> directive allows you to include Perl code in your
configuration file. It will be executed at server start. This can be used
to load modules, or to provide dynamic configuration files.</p>
<hr />
<h2><a id="=back" name="=back">=back</a> <a id="=back"
name="=back">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>End of an =over section in POD</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>=back</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Used to end an <code>=over</code> listing in POD. See discussion of
POD above.</p>
<hr />
<h2><a id="=cut" name="=cut">=cut</a> <a id="=cut"
name="=cut">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>End of POD</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>=cut</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Used to end a section of POD. See discussion of POD above.</p>
<hr />
<h2><a id="=pod" name="=pod">=pod</a> <a id="=pod"
name="=pod">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Start of POD</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>=pod</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Used to start a section of POD. See discussion of POD, above.</p>
<hr />
<h2><a id="PerlAccessHandler"
name="PerlAccessHandler">PerlAccessHandler</a> <a id="perlaccesshandler"
name="perlaccesshandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Access handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlAccessHandler Apache::AccessHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Specifies module to be used as an access handler.</p>
<hr />
<h2><a id="PerlAddVar" name="PerlAddVar">PerlAddVar</a> <a
id="perladdvar" name="perladdvar">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Adds a value to a list variable</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlAddVar ListName "value"</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Adds a value to a list variable, which can later be retrieved via the
<code>$r->dir_config('ListName')</code> method.</p>
<hr />
<h2><a id="PerlAuthenHandler"
name="PerlAuthenHandler">PerlAuthenHandler</a> <a id="perlauthenhandler"
name="perlauthenhandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Authentication handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlAuthenHandler Apache::AuthenHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Specifies the module to be used for authentication purposes.</p>
<hr />
<h2><a id="PerlAuthzHandler" name="PerlAuthzHandler">PerlAuthzHandler</a>
<a id="perlauthzhandler" name="perlauthzhandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Authorization handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlAuthzHandler Apache::AuthzHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Specifies the module to be used for authorization purposes.</p>
<hr />
<h2><a id="PerlChildExitHandler"
name="PerlChildExitHandler">PerlChildExitHandler</a> <a
id="perlchildexithandler" name="perlchildexithandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Child exit handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlChildExitHandler Apache::ChildExit</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Handler to be run on the exit of an Apache child process.</p>
<hr />
<h2><a id="PerlChildInitHandler"
name="PerlChildInitHandler">PerlChildInitHandler</a> <a
id="perlchildinithandler" name="perlchildinithandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Child init handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlChildInitHandler Apache::ChildInit</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Handler to be run on the initialization of an Apache child
process.</p>
<hr />
<h2><a id="PerlCleanupHandler"
name="PerlCleanupHandler">PerlCleanupHandler</a> <a
id="perlcleanuphandler" name="perlcleanuphandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Cleanup handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlCleanupHandler Apache::Cleanup</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Provide a module for the cleanup phase of a transation.</p>
<hr />
<h2><a id="PerlDispatchHandler"
name="PerlDispatchHandler">PerlDispatchHandler</a> <a
id="perldispatchhandler" name="perldispatchhandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Dispatch handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlDispatchHandler Apache::Dispatch</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Handler to take over the entire process of loading and executing
handler code.</p>
<hr />
<h2><a id="PerlFixupHandler" name="PerlFixupHandler">PerlFixupHandler</a>
<a id="perlfixuphandler" name="perlfixuphandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Fixup handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlFixupHandler Apache::Fixup</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Corresponds to the Apache API fixup stage.</p>
<hr />
<h2><a id="PerlFreshRestart" name="PerlFreshRestart">PerlFreshRestart</a>
<a id="perlfreshrestart" name="perlfreshrestart">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Reload modules on restart</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlFreshRestart</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Tell mod_perl to reload modules and flush
<code>Apache::Registry</code> cache on restart.</p>
<blockquote>
<table>
<tr>
<td bgcolor="#e0e5f5">
<p align="center"><strong>Note</strong></p>
This will cause a lot of <code>Subroutine foo redefined</code>
warnings on restart. This is expected.
</td>
</tr>
</table>
</blockquote>
<hr />
<h2><a id="PerlHandler" name="PerlHandler">PerlHandler</a> <a
id="perlhandler" name="perlhandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlHandler Apache::Perldoc</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Specify the handler to be run.</p>
<blockquote>
<table cellpadding="10">
<tr>
<td bgcolor="#eeeeee"><code><Location /perldoc><br />
SetHandler perl-script<br />
PerlHandler Apache::Perldoc<br />
</Location></code> </td>
</tr>
</table>
</blockquote>
<hr />
<h2><a id="PerlHeaderParserHandler"
name="PerlHeaderParserHandler">PerlHeaderParserHandler</a> <a
id="perlheaderparserhandler"
name="perlheaderparserhandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Header Parser handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlHeaderParserHandler Apache::HeadParser</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Perl module which is to handle the header parsing phase.</p>
<hr />
<h2><a id="PerlInitHandler" name="PerlInitHandler">PerlInitHandler</a> <a
id="perlinithandler" name="perlinithandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Init handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlInitHandler Apache::InitHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Specifies Init handler module or routine name.</p>
<hr />
<h2><a id="PerlLogHandler" name="PerlLogHandler">PerlLogHandler</a> <a
id="perlloghandler" name="perlloghandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Log handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlLogHandler Apache::LogHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Provide a module for logging</p>
<hr />
<h2><a id="PerlModule" name="PerlModule">PerlModule</a> <a
id="perlmodule" name="perlmodule">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Load a Perl module</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlModule Apache::Perldoc</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Load a Perl module, to be used later in a handler.</p>
<hr />
<h2><a id="PerlPassEnv" name="PerlPassEnv">PerlPassEnv</a> <a
id="perlpassenv" name="perlpassenv">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Pass environment variables to %ENV</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlPassEnv EnvVar</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Passes an environment variable to your Perl code.</p>
<hr />
<h2><a id="PerlPostReadRequestHandler"
name="PerlPostReadRequestHandler">PerlPostReadRequestHandler</a> <a
id="perlpostreadrequesthandler"
name="perlpostreadrequesthandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Post Read Request handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlPostReadRequestHandler Apache::PostRequest</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Handler to be run during the phase when the request is read.</p>
<hr />
<h2><a id="PerlRequire" name="PerlRequire">PerlRequire</a> <a
id="perlrequire" name="perlrequire">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>A perl script, loaded via require</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlRequire <em>/path/to/script.pl</em></td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Runs a Perl program, via require. Primarily used to set up
environmental variables, load modules, and estabilish database
connections at startup.</p>
<hr />
<h2><a id="PerlRestartHandler"
name="PerlRestartHandler">PerlRestartHandler</a> <a
id="perlrestarthandler" name="perlrestarthandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Restart handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlRestartHandler Apache::Restart</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Code to be executed on server restart.</p>
<hr />
<h2><a id="PerlScript" name="PerlScript">PerlScript</a> <a
id="perlscript" name="perlscript">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Loads a Perl script. Deprecated</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlScript <em>/path/to/file.pl</em></td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<blockquote>
<table>
<tr>
<td bgcolor="#ffe5f5">
<p align="center"><strong>Deprecated</strong></p>
This directive is deprecated. Please use <a href="#perlrequire"
class="directive"><code class="directive">PerlRequire</code></a>
instead.
</td>
</tr>
</table>
</blockquote>
<p>Runs a Perl program. Primarily to load modules and set up
environmental things.</p>
<hr />
<h2><a id="PerlSendHeader" name="PerlSendHeader">PerlSendHeader</a> <a
id="perlsendheader" name="perlsendheader">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Tell mod_perl to parse and send HTTP headers</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td />
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Tell mod_perl to parse and send HTTP headers</p>
<hr />
<h2><a id="PerlSetEnv" name="PerlSetEnv">PerlSetEnv</a> <a
id="perlsetenv" name="perlsetenv">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Perl %ENV key and value</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlSetEnv EnvVar "value"</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Set a Perl environment variable. Later accessible via
<code>$ENV{EnvVar}</code>.</p>
<hr />
<h2><a id="PerlSetupEnv" name="PerlSetupEnv">PerlSetupEnv</a> <a
id="perlsetupenv" name="perlsetupenv">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Tell mod_perl to setup %ENV by default</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlSetupEnv off</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Tells mod_perl whether to set up the <code>%ENV</code> hash by
default.</p>
<hr />
<h2><a id="PerlSetVar" name="PerlSetVar">PerlSetVar</a> <a
id="perlsetvar" name="perlsetvar">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Set a configuration variable</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlSetVar VariableName "value"</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Used to set a configuration variable, which can later be retrieved via
the <code>$r->dir_config('VariableName')</code> method.</p>
<hr />
<h2><a id="PerlTaintCheck" name="PerlTaintCheck">PerlTaintCheck</a> <a
id="perltaintcheck" name="perltaintcheck">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Turn on -T switch</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlTaintCheck</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Turn on <code>-T</code> switch for all Perl code. Turns on Taint
checking.</p>
<hr />
<h2><a id="PerlTransHandler" name="PerlTransHandler">PerlTransHandler</a>
<a id="perltranshandler" name="perltranshandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>
</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlTranshandler Apache::TransExample</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>The Perl Translation handler to use.</p>
<hr />
<h2><a id="PerlTypeHandler" name="PerlTypeHandler">PerlTypeHandler</a> <a
id="perltypehandler" name="perltypehandler">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>The Perl Type check handler routine name</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlTypeHandler Apache::TypeHandler</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Modifies the Apache API phase of determining MIME types.</p>
<hr />
<h2><a id="PerlWarn" name="PerlWarn">PerlWarn</a> <a id="perlwarn"
name="perlwarn">Directive</a></h2>
<table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc">
<tr>
<td>
<table bgcolor="#ffffff">
<tr>
<td nowrap="nowrap"><strong>Description:</strong> </td>
<td>Turn on -w switch</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Syntax"
class="help">Syntax:</a></td>
<td>PerlWarn</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Context"
class="help">Context:</a></td>
<td>server config</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Status"
class="help">Status:</a></td>
<td>Extension</td>
</tr>
<tr>
<td nowrap="nowrap"><a href="directive-dict.html#Module"
class="help">Module:</a></td>
<td>mod_perl</td>
</tr>
</table>
</td>
</tr>
</table>
<p>Turns on warnings for all Perl code.</p>
<hr />
</blockquote>
<a href="./"><img src="../images/index.gif" alt="Index" /></a><a
href="../"><img src="../images/home.gif" alt="Home" /></a>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
