You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-cvs@perl.apache.org by st...@apache.org on 2002/08/13 13:41:45 UTC
cvs commit: modperl-docs/src/docs/2.0/user/config config.pod
stas 2002/08/13 04:41:45
Modified: src/docs/2.0/user/config config.pod
Log:
remove irrelevant data from the config tables
other minor reorgs
Revision Changes Path
1.21 +91 -58 modperl-docs/src/docs/2.0/user/config/config.pod
Index: config.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/config.pod,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- config.pod 12 Jul 2002 09:55:54 -0000 1.20
+++ config.pod 13 Aug 2002 11:41:45 -0000 1.21
@@ -645,72 +645,71 @@
=head1 mod_perl Directives Argument Types and Allowed Location
The following table shows where in the configuration files mod_perl
-configuration directives are allowed to appear, what kind of and how
-many arguments they expect:
+configuration directives are allowed to appear, what kind and how many
+arguments they expect:
General directives:
- Directive Arguments SRV DIR
- ---------------------------------------------------
- PerlSwitches ITERATE V
- PerlRequire ITERATE V
- PerlModule ITERATE V
- PerlOptions ITERATE V V
- PerlSetVar TAKE2 V V
- PerlAddVar ITERATE2 V V
- PerlSetEnv TAKE2 V V
- PerlPassEnv TAKE1 V
- <Perl> Sections RAW_ARGS V
- PerlTrace TAKE1 V
+ Directive Arguments Scope
+ --------------------------------------------
+ PerlSwitches ITERATE SRV
+ PerlRequire ITERATE SRV
+ PerlModule ITERATE SRV
+ PerlOptions ITERATE DIR
+ PerlSetVar TAKE2 DIR
+ PerlAddVar ITERATE2 DIR
+ PerlSetEnv TAKE2 DIR
+ PerlPassEnv TAKE1 SRV
+ <Perl> Sections RAW_ARGS SRV
+ PerlTrace TAKE1 SRV
Handler assignment directives:
- Directive Arguments TYPE SRV DIR
- ---------------------------------------------------------
- PerlOpenLogsHandler ITERATE RUN_ALL V
- PerlPostConfigHandler ITERATE RUN_ALL V
- PerlChildInitHandler ITERATE VOID V
-
- PerlPreConnectionHandler ITERATE RUN_ALL V
- PerlProcessConnectionHandler ITERATE RUN_FIRST V
-
- PerlPostReadRequestHandler ITERATE RUN_ALL V
- PerlTransHandler ITERATE RUN_FIRST V
- PerlInitHandler ITERATE RUN_ALL V V
- PerlHeaderParserHandler ITERATE RUN_ALL V V
- PerlAccessHandler ITERATE RUN_ALL V V
- PerlAuthenHandler ITERATE RUN_FIRST V V
- PerlAuthzHandler ITERATE RUN_FIRST V V
- PerlTypeHandler ITERATE RUN_FIRST V V
- PerlFixupHandler ITERATE RUN_ALL V V
- PerlResponseHandler ITERATE RUN_FIRST V V
- PerlLogHandler ITERATE RUN_ALL V V
- PerlCleanupHandler ITERATE XXX V V
-
- PerlInputFilterHandler ITERATE VOID V V
- PerlOutputFilterHandler ITERATE VOID V V
+ Directive Arguments Scope
+ --------------------------------------------
+ PerlOpenLogsHandler ITERATE SRV
+ PerlPostConfigHandler ITERATE SRV
+ PerlChildInitHandler ITERATE SRV
+
+ PerlPreConnectionHandler ITERATE SRV
+ PerlProcessConnectionHandler ITERATE SRV
+
+ PerlPostReadRequestHandler ITERATE SRV
+ PerlTransHandler ITERATE SRV
+ PerlInitHandler ITERATE DIR
+ PerlHeaderParserHandler ITERATE DIR
+ PerlAccessHandler ITERATE DIR
+ PerlAuthenHandler ITERATE DIR
+ PerlAuthzHandler ITERATE DIR
+ PerlTypeHandler ITERATE DIR
+ PerlFixupHandler ITERATE DIR
+ PerlResponseHandler ITERATE DIR
+ PerlLogHandler ITERATE DIR
+ PerlCleanupHandler ITERATE DIR
+ PerlInputFilterHandler ITERATE DIR
+ PerlOutputFilterHandler ITERATE DIR
Perl Interpreter management directives:
- Directive Arguments SRV DIR
- ---------------------------------------------------
- PerlInterpStart TAKE1 V
- PerlInterpMax TAKE1 V
- PerlInterpMinSpare TAKE1 V
- PerlInterpMaxSpare TAKE1 V
- PerlInterpMaxRequests TAKE1 V
- PerlInterpScope TAKE1 V V
-
-mod_perl 1.0 back compatibility directives:
-
- Directive Arguments SRV DIR
- ---------------------------------------------------
- PerlHandler ITERATE V V
- PerlSendHeader FLAG V V
- PerlSetupEnv FLAG V V
- PerlTaintCheck FLAG V
- PerlWarn FLAG V
+ Directive Arguments Scope
+ --------------------------------------------
+ PerlInterpStart TAKE1 SRV
+ PerlInterpMax TAKE1 SRV
+ PerlInterpMinSpare TAKE1 SRV
+ PerlInterpMaxSpare TAKE1 SRV
+ PerlInterpMaxRequests TAKE1 SRV
+ PerlInterpScope TAKE1 DIR
+
+mod_perl 1.0 back-compatibility directives:
+
+ Directive Arguments Scope
+ --------------------------------------------
+ PerlHandler ITERATE DIR
+ PerlSendHeader FLAG DIR
+ PerlSetupEnv FLAG DIR
+ PerlTaintCheck FLAG SRV
+ PerlWarn FLAG SRV
The I<Arguments> column represents the type of arguments directives
accepts, where:
@@ -743,8 +742,8 @@
=back
-The second and the third column show the locations the directives are
-allowed to appear in:
+The I<Scope> column shows the location the directives are allowed to
+appear in:
=over
@@ -761,6 +760,9 @@
can also appear in I<.htaccess> files. These directives are defined
as C<OR_ALL> in the source code.
+These directives can also appear in the global server configuration
+and C<E<lt>VirtualHostE<gt>>.
+
=back
Apache specifies other allowed location types which are currently not
@@ -768,8 +770,39 @@
in I<include/httpd_config.h> (hint: search for C<RSRC_CONF>).
+The I<Type> column specifies a phase's behavior when there is more
+then one handler registered to run for this phase. (For C API
+declarations see I<include/ap_config.h>, which includes other types
+which aren't exposed by mod_perl.)
+
+
+=over
+=item * VOID
+
+Handlers of the type C<VOID> will be I<all> executed in the order they
+have been registered disregarding their return values. Though in
+mod_perl they are expected to return C<Apache::OK>.
+
+=item * RUN_FIRST
+
+Handlers of the type C<RUN_FIRST> will be executed in the order they
+have been registered until the first handler that returns something
+other than C<Apache::DECLINED>. If the return value is
+C<Apache::DECLINED>, the next handler in the chain will be run. If the
+return value is C<Apache::OK> the next phase will start. In all other
+cases the execution will be aborted.
+
+=item * RUN_ALL
+
+Handlers of the type C<RUN_ALL> will be executed in the order they
+have been registered until the first handler that returns something
+other than C<Apache::OK> or C<Apache::DECLINED>.
+
+=back
+Also see L<mod_perl Directives Argument Types and Allowed
+Location|user::config::config/mod_perl_Directives_Argument_Types_and_Allowed_Location>
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org