mirror of
https://github.com/apache/httpd.git
synced 2025-11-08 04:22:21 +03:00
5bd178154b
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@151414 13f79535-47bb-0310-9956-ffa450edef68
273 lines
10 KiB
XML
273 lines
10 KiB
XML
<?xml version="1.0" encoding="iso-2022-jp"?>
|
||
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
|
||
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
|
||
<!-- English Revision: 151408 -->
|
||
|
||
<!--
|
||
Copyright 2004-2005 The Apache Software Foundation or its licensors,
|
||
as applicable.
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an "AS IS" BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
-->
|
||
|
||
<manualpage metafile="modules.xml.meta">
|
||
<parentdocument href="./">Developer Documentation</parentdocument>
|
||
|
||
<title>$B%b%8%e!<%k$N(B Apache 1.3 $B$+$i(B Apache 2.0 $B$X$N0\?"(B</title>
|
||
|
||
<summary>
|
||
<p>$B$3$NJ8=q$O(B <code>mod_mmap_static</code> $B%b%8%e!<%k$r(B Apache 2.0 $BMQ$K0\?"$7$?;~$K(B
|
||
$B3X$s$@7P83$r$b$H$K=q$$$?!":G=i$N<j0z$-=q$G$9!#$^$@$^$@40A4$8$c$J$$$7!"(B
|
||
$B$R$g$C$H$9$k$H4V0c$C$F$$$kItJ,$b$"$k$+$b$7$l$^$;$s$,!"(B
|
||
$B<h$C3]$j$K$O$J$k$G$7$g$&!#(B</p>
|
||
</summary>
|
||
|
||
<section id="easy"><title>$B4JC1$JJQ99E@(B</title>
|
||
|
||
<section id="cleanup"><title>$B%/%j!<%s%J%C%W(B $B%k!<%A%s(B</title>
|
||
<p>$B%/%j!<%s%J%C%W%k!<%A%s$O(B <code>apr_status_t</code> $B7?$G$"$kI,MW$,$"$j$^$9!#(B
|
||
$B$=$7$F!"(Bapr_status_t $B7?$NCM$rJV$5$J$/$F$O$J$j$^$;$s!#(B
|
||
$B%/%j!<%s%J%C%WCf$N%(%i!<$rDLCN$9$kI,MW$,$J$1$l$P!"JV$jCM$OIaDL!"(B
|
||
<code>ARP_SUCCESS</code> $B$G$9!#$?$H$(%(%i!<$rDLCN$7$?$H$7$F$b!"(B
|
||
$B$9$Y$F$N%3!<%I$,$=$NDLCN$r%A%'%C%/$7$?$j!"(B
|
||
$B%(%i!<$K1~$8$?F0:n$r$9$k$o$1$G$O$J$$$3$H$K5$$r$D$1$F$/$@$5$$!#(B</p>
|
||
</section>
|
||
|
||
|
||
<section id="init"><title>$B=i4|2=%k!<%A%s(B</title>
|
||
|
||
<p>$B=i4|2=%k!<%A%s$O=hM}A4BN$+$i8+$F$7$C$/$j$/$k$h$&$J0UL#$rI=$9$h$&$K!"(B
|
||
$BL>A0$,JQ99$5$l$^$7$?!#$G$9$+$i!"(B<code>mmap_init</code> $B$+$i(B <code>mmap_post_config</code>
|
||
$B$N$h$&$K$A$g$C$HJQ99$5$l$^$7$?!#(B
|
||
$BEO$5$l$k0z?t$OBgI}$KJQ99$5$l!"<!$N$h$&$K$J$j$^$7$?!#(B</p>
|
||
|
||
<ul>
|
||
<li><code>apr_pool_t *p</code></li>
|
||
<li><code>apr_pool_t *plog</code></li>
|
||
<li><code>apr_pool_t *ptemp</code></li>
|
||
<li><code>server_rec *s</code></li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section id="datatypes"><title>$B%G!<%?7?(B</title>
|
||
<p>$B%G!<%?7?$N$[$H$s$I$O(B <a
|
||
href="http://apr.apache.org/">APR</a> $B$K0\$5$l$^$7$?!#$D$^$j!"(B
|
||
$B$$$/$D$+$NL>A0$,A0=R$N$h$&$KJQ99$5$l$F$$$^$9!#(B
|
||
$B;\$9$Y$-JQ99E@$N4JC1$J0lMw$r0J2<$K<($7$^$9!#(B</p>
|
||
|
||
<ul>
|
||
<li><code>pool</code> becomes <code>apr_pool_t</code></li>
|
||
<li><code>table</code> becomes <code>apr_table_t</code></li>
|
||
</ul>
|
||
</section>
|
||
</section>
|
||
|
||
<section id="messy"><title>$B$b$C$HLq2p$JJQ99E@!D(B</title>
|
||
|
||
<section id="register-hooks"><title>$B%U%C%/$NEPO?(B</title>
|
||
<p>$B?7$7$$%"!<%-%F%/%A%c$G$O:n@.$7$?4X?t$r8F$S=P$9$N$K(B
|
||
$B0lO"$N%U%C%/$r;HMQ$7$^$9!#$3$N%U%C%/$O!"?7$7$$4X?t(B
|
||
<code>static void register_hooks(void)</code> $B$r;H$C$FEPO?$9$k$h$&!"(B
|
||
$B%b%8%e!<%k$K=q$-B-$5$J$/$F$O$J$j$^$;$s!#(B
|
||
$B$3$N4X?t$O!"$J$K$r$9$Y$-$+0lC6M}2r$7$F$7$^$($P!"(B
|
||
$B==J,$K$o$+$j$d$9$$$b$N$G$9!#(B
|
||
$B%j%/%(%9%H$N=hM}$N$"$k%9%F!<%8$G8F$S=P$5$J$/$F$O$J$i$J$$(B
|
||
$B4X?t$OEPO?$9$kI,MW$,$"$j$^$9!#%O%s%I%i$OEPO?$9$kI,MW$O$"$j$^$;$s!#(B
|
||
$B4X?t$rEPO?$G$-$k%U%'!<%:$O$?$/$5$s$"$j$^$9!#(B
|
||
$B$=$l$>$l$N%U%'!<%:$G!"4X?t$r8F$S=P$9AjBPE*$J=gHV$O!"(B
|
||
$B$+$J$j$NDxEY@)8f$G$-$^$9!#(B</p>
|
||
|
||
<p>$B0J2<$O!"(B<code>mod_mmap_static</code> $B$KDI2C$7$?%3!<%I$G$9(B:</p>
|
||
|
||
<example><pre>
|
||
static void register_hooks(void)
|
||
{
|
||
static const char * const aszPre[]={ "http_core.c",NULL };
|
||
ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);
|
||
ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);
|
||
};</pre>
|
||
</example>
|
||
|
||
<p>$B$3$3$G$O8F$S$@$9$Y$-Fs$D$N4X?t$rEPO?$7$F$$$^$9!#0l$D$O(B
|
||
<code>post_config</code> $B%9%F!<%8MQ(B ($B$[$H$s$I$9$Y$F$N%b%8%e!<%k(B
|
||
$B$O$3$l$,I,MW$G$9(B) $B$G!"$b$&0l$D$O(B <code>translate_name</code> $B%U%'!<%:MQ$G$9!#(B
|
||
$B$=$l$>$l$N4X?t$OL>A0$O0c$&$1$l$I$b7A<0$OF1$8$G$"$k$3$H$KCm0U$7$F$/$@$5$$!#(B
|
||
$B$=$l$G$O!"7A<0$O$I$N$h$&$K$J$C$F$$$k$G$7$g$&$+(B?</p>
|
||
|
||
<example>
|
||
ap_hook_<var>phase_name</var>(<var>function_name</var>,
|
||
<var>predecessors</var>, <var>successors</var>, <var>position</var>);
|
||
</example>
|
||
|
||
<p>$B;0$D$N0LCV$,Dj5A$5$l$F$$$^$9!D(B</p>
|
||
|
||
<ul>
|
||
<li><code>HOOK_FIRST</code></li>
|
||
<li><code>HOOK_MIDDLE</code></li>
|
||
<li><code>HOOK_LAST</code></li>
|
||
</ul>
|
||
|
||
<p>$B0LCV$rDj5A$9$k$K$O!">e5-$N!V0LCV!W$r;XDj$7!"(B
|
||
$B=$>~;R$G$"$k!V@h9T!W$H!V8e9T!W$G<j$r2C$($^$9!#(B
|
||
$B!V@h9T!W!V8e9T!W$O!"8F$P$l$k$Y$-4X?t$N%j%9%H$G$9!#(B
|
||
$B!V@h9T!W$O4X?t$N<B9TA0$K8F$P$l$k$b$N$G!"(B
|
||
$B!V8e9T!W$O<B9T8e$K8F$P$l$k$b$N$G$9!#(B</p>
|
||
|
||
<p><code>mod_mmap_static</code> $B$N>l9g!"(B<code>post_config</code>
|
||
$B%9%F!<%8$G$OI,MW$"$j$^$;$s$,!"(B
|
||
<code>mmap_static_xlat</code> $B$,(B core $B%b%8%e!<%k$,L>A0$NJQ49$r<B9T$7$?8e$K(B
|
||
<strong>$B8F$P$l$J$1$l$P$J$j$^$;$s(B</strong>$B!#(B
|
||
$B$=$3$G(B aszPre $B$r;H$C$F(B <code>HOOK_LAST</code> $B$N=$>~;R$rDj5A$7$F$$$^$9!#(B</p>
|
||
</section>
|
||
|
||
<section id="moddef"><title>$B%b%8%e!<%k$NDj5A(B</title>
|
||
<p>$B%b%8%e!<%k$NDj5A$r:n@.$9$k:]$KCm0U$7$J$1$l$P$J$i$J$$(B
|
||
$B%9%F!<%8$N?t$O7c8:$7$F$$$^$9!#8E$$Dj5A$O<!$N$h$&$K$J$C$F$$$^$7$?!#(B</p>
|
||
|
||
<example><pre>
|
||
module MODULE_VAR_EXPORT <var>module_name</var>_module =
|
||
{
|
||
STANDARD_MODULE_STUFF,
|
||
/* initializer */
|
||
/* dir config creater */
|
||
/* dir merger --- default is to override */
|
||
/* server config */
|
||
/* merge server config */
|
||
/* command handlers */
|
||
/* handlers */
|
||
/* filename translation */
|
||
/* check_user_id */
|
||
/* check auth */
|
||
/* check access */
|
||
/* type_checker */
|
||
/* fixups */
|
||
/* logger */
|
||
/* header parser */
|
||
/* child_init */
|
||
/* child_exit */
|
||
/* post read-request */
|
||
};</pre>
|
||
</example>
|
||
|
||
<p>$B?7$7$$9=B$BN$O$H$C$F$b%7%s%W%k$G$9!D(B</p>
|
||
<example><pre>
|
||
module MODULE_VAR_EXPORT <var>module_name</var>_module =
|
||
{
|
||
STANDARD20_MODULE_STUFF,
|
||
/* create per-directory config structures */
|
||
/* merge per-directory config structures */
|
||
/* create per-server config structures */
|
||
/* merge per-server config structures */
|
||
/* command handlers */
|
||
/* handlers */
|
||
/* register hooks */
|
||
};</pre>
|
||
</example>
|
||
|
||
<p>$B$3$N$&$A$N$$$/$D$+$O8E$$$b$N$+$i?7$7$$$b$N$KD>@\FI$_BX$($i$l$k$b$N$G!"(B
|
||
$B$$$/$D$+$O$=$&$G$O$"$j$^$;$s!#$I$&$9$l$P$$$$$N$+$rMWLs$7$F$_$^$9!#(B</p>
|
||
|
||
<p>$BD>@\FI$_BX$($i$l$k%9%F!<%8(B:</p>
|
||
|
||
<dl>
|
||
<dt><code>/* $B%G%#%l%/%H%j@_Dj:n@.4X?t(B */</code></dt>
|
||
<dd><code>/* $B%G%#%l%/%H%jKh@_Dj9=B$BN:n@.(B */</code></dd>
|
||
|
||
<dt><code>/* $B%5!<%P@_Dj:n@.4X?t(B */</code></dt>
|
||
<dd><code>/* $B%5!<%PKh@_Dj9=B$BN:n@.(B */</code></dd>
|
||
|
||
<dt><code>/* $B%G%#%l%/%H%j@_Dj%^!<%84X?t(B */</code></dt>
|
||
<dd><code>/* $B%G%#%l%/%H%jKh@_Dj9=B$BN%^!<%8(B */</code></dd>
|
||
|
||
<dt><code>/* $B%5!<%P@_Dj%^!<%84X?t(B */</code></dt>
|
||
<dd><code>/* $B%5!<%PKh@_Dj9=B$BN:n@.%^!<%8(B */</code></dd>
|
||
|
||
<dt><code>/* $B%3%^%s%I!&%F!<%V%k(B */</code></dt>
|
||
<dd><code>/* $B%3%^%s%I(B apr_table_t */</code></dd>
|
||
|
||
<dt><code>/* $B%O%s%I%i(B */</code></dt>
|
||
<dd><code>/* $B%O%s%I%i(B */</code></dd>
|
||
</dl>
|
||
|
||
<p>$B8E$$4X?t$N;D$j$N$b$N$O%U%C%/$H$7$FEPO?$5$l$k$Y$-$G$9!#(B
|
||
$B8=;~E@$G<!$N$h$&$J%U%C%/!&%9%F!<%8$,Dj5A$5$l$F$$$^$9!D(B</p>
|
||
|
||
<dl>
|
||
<dt><code>ap_hook_post_config</code></dt>
|
||
<dd>($B0JA0$N(B <code>_init</code> $B%k!<%A%s$,EPO?$5$l$k$Y$->l=j$G$9(B)</dd>
|
||
|
||
<dt><code>ap_hook_http_method</code></dt>
|
||
<dd>($B%j%/%(%9%H$+$i(B HTTP $B%a%=%C%I$r<hF@$7$^$9(B ($B8_49MQ(B))</dd>
|
||
|
||
<dt><code>ap_hook_open_logs</code></dt>
|
||
<dd>($BFCDj$N%m%0$N%*!<%W%s(B)</dd>
|
||
|
||
<dt><code>ap_hook_auth_checker</code></dt>
|
||
<dd>($B%j%=!<%9$,8"8B$rI,MW$H$9$k$+$I$&$+$N3NG'(B)</dd>
|
||
|
||
<dt><code>ap_hook_access_checker</code></dt>
|
||
<dd>($B%b%8%e!<%k8GM-$N@)Ls$N3NG'(B)</dd>
|
||
|
||
<dt><code>ap_hook_check_user_id</code></dt>
|
||
<dd>($B%f!<%6(B ID $B$H%Q%9%o!<%I$N3NG'(B)</dd>
|
||
|
||
<dt><code>ap_hook_default_port</code></dt>
|
||
<dd>($B%5!<%P$N%G%U%)%k%H!&%]!<%H$N<hF@(B)</dd>
|
||
|
||
<dt><code>ap_hook_pre_connection</code></dt>
|
||
<dd>($B=hM}$ND>A0$KI,MW$J$3$H$r<B9T!#$?$@$7(B accept $BD>8e$K8F$P$l$k(B)</dd>
|
||
|
||
<dt><code>ap_hook_process_connection</code></dt>
|
||
<dd>($B%W%m%H%3%k$N=hM}(B)</dd>
|
||
|
||
<dt><code>ap_hook_child_init</code></dt>
|
||
<dd>($B;R%W%m%;%k5/F0D>8e(B)</dd>
|
||
|
||
<dt><code>ap_hook_create_request</code></dt>
|
||
<dd>(??)</dd>
|
||
|
||
<dt><code>ap_hook_fixups</code></dt>
|
||
<dd>($B1~EzFbMF$N@8@.$rJQ99$9$k%i%9%H!&%A%c%s%9(B)</dd>
|
||
|
||
<dt><code>ap_hook_handler</code></dt>
|
||
<dd>($B1~EzFbMF$N@8@.(B)</dd>
|
||
|
||
<dt><code>ap_hook_header_parser</code></dt>
|
||
<dd>($B%b%8%e!<%k$K%X%C%@$N>H2q$r$5$;$k!#$[$H$s$I$N%b%8%e!<%k$G$O;H$o$l$^$;$s!#(Bpost_read_request $B$r;H$$$^$9(B)</dd>
|
||
|
||
<dt><code>ap_hook_insert_filter</code></dt>
|
||
<dd>($B%U%#%k%?!&%A%'%$%s$K%U%#%k%?$rA^F~(B)</dd>
|
||
|
||
<dt><code>ap_hook_log_transaction</code></dt>
|
||
<dd>($B%j%/%(%9%H$K$D$$$F$N>pJs$r5-O?$9$k(B)</dd>
|
||
|
||
<dt><code>ap_hook_optional_fn_retrieve</code></dt>
|
||
<dd>($B%*%W%7%g%s$H$7$FEPO?$5$l$?4X?t$N<hF@(B)</dd>
|
||
|
||
<dt><code>ap_hook_post_read_request</code></dt>
|
||
<dd>($B%j%/%(%9%H$rFI$_$3$s$@8e!"B>$N%U%'!<%:$NA0$K8F$P$l$k(B)</dd>
|
||
|
||
<dt><code>ap_hook_quick_handler</code></dt>
|
||
<dd>$B%j%/%(%9%H$N=hM}$,;O$^$kA0$K8F$P$l$k!#%-%c%C%7%e%b%8%e!<%k$,(B
|
||
$B;HMQ$7$F$$$k(B</dd>
|
||
|
||
<dt><code>ap_hook_translate_name</code></dt>
|
||
<dd>(URI $B$r%U%!%$%kL>$KJQ49$9$k(B)</dd>
|
||
|
||
<dt><code>ap_hook_type_checker</code></dt>
|
||
<dd>($BJ8=q7?$N7hDj$H@_Dj!#$"$k$$$O$=$NJRJ}(B)</dd>
|
||
</dl>
|
||
</section>
|
||
</section>
|
||
</manualpage>
|