mpm_common.xml.ja

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2002-2004 The Apache Software Foundation

 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.
-->

<modulesynopsis metafile="mpm_common.xml.meta">

<name>mpm_common</name>
<description>$BFs$D0J>e$N%^%k%A%W%m%;%C%7%s%0%b%8%e!<%k(B (MPM)
$B$G<BAu$5$l$F$$$k%G%#%l%/%F%#%V$N%3%l%/%7%g%s(B</description>
<status>MPM</status>

<directivesynopsis>
<name>AcceptMutex</name>
<description>$BJ#?t$N;R%W%m%;%9$,%M%C%H%o!<%/%=%1%C%H$G%j%/%(%9%H$r(B
accept $B$7$h$&$H$7$F$$$k$H$-$K!"(BApache $B$,$=$l$i$N;R%W%m%;%9$rD>Ns2=$9$k$?$a$K(B
$B;H$&J}K!(B</description>
<syntax>AcceptMutex default|<var>method</var></syntax>
<default>AcceptMutex default</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>leader</module><module>perchild</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p><directive>AcceptMutex</directive> $B%G%#%l%/%F%#%V$O!"(B
    $B%M%C%H%o!<%/%=%1%C%H$N%j%/%(%9%H$r(B accept $B$7$h$&$H$7$F$$$kJ#?t$N;R%W%m%;%9$r(B
    Apache $B$,D>Ns2=$9$k$?$a$K;H$&J}K!$r@_Dj$7$^$9!#(B
    Apache 2.0 $B0JA0$O!"$3$N%a%=%C%I$O%3%s%Q%$%k;~$K$N$_A*Br$G$-$^$7$?!#(B
    $B:GE,$JJ}K!$O!"%"!<%-%F%/%A%c$d%W%i%C%H%[!<%`$KBg$-$/0MB8$7$^$9!#(B
    $B>\:Y$K4X$7$F$O!"(B<a 
    href="../misc/perf-tuning.html">$B@-G=$N%A%e!<%K%s%0(B</a>
    $B%I%-%e%a%s%H$r$4Mw2<$5$$!#(B</p>

    <p>$B$3$N%G%#%l%/%F%#%V$,(B <code>Default</code>
    $B$K@_Dj$5$l$F$$$l$P!"%3%s%Q%$%k;~$KA*Br$5$l$?%G%U%)%k%HCM$,;H$o$l$^$9!#(B
    $BB>$N;HMQ2DG=$J%a%=%C%I$N0lMw$O2<$K$"$j$^$9!#(B
    $BA4$F$N%a%=%C%I$,A4$F$N%W%i%C%H%[!<%`$G;HMQ2DG=$G$"$k$o$1$G$O$J$$!"(B
    $B$H$$$&$3$H$KCm0U$7$F$/$@$5$$!#(B
    $B;HMQ2DG=$G$J$$%a%=%C%I$,;XDj$5$l$?>l9g$O!"(B
    $B;HMQ2DG=$J%a%=%C%I$N0lMw$r4^$s$@%a%C%;!<%8$,(B
    $B%(%i!<%m%0$K=PNO$5$l$^$9!#(B</p>

    <dl>
      <dt><code>flock</code></dt>
      <dd><directive module="mpm_common">LockFile</directive>
      $B%G%#%l%/%F%#%V$GDj5A$7$?%U%!%$%k$N%m%C%/$K!"(B
      <code>flock(2)</code> $B%7%9%F%`%3!<%k$r;H$$$^$9!#(B</dd>

      <dt><code>fcntl</code></dt>
      <dd><directive module="mpm_common">LockFile</directive>
      $B%G%#%l%/%F%#%V$GDj5A$7$?%U%!%$%k$N%m%C%/$K!"(B
      <code>fcntl(2)</code> $B%7%9%F%`%3!<%k$r;H$$$^$9!#(B</dd>

      <dt><code>posixsem</code></dt>
      <dd>$BGSB>=hM}$N<BAu$K(B POSIX $B8_49%;%^%U%)$r;HMQ$7$^$9(B</dd>

      <dt><code>pthread</code></dt>
      <dd>POSIX Threads (PThreads) $B5,3J$G<BAu$5$l$F$$$k(B
      POSIX $BGSB>=hM}$r;H$$$^$9!#(B</dd>

      <dt><code>sysvsem</code></dt>
      <dd>$BGSB>=hM}$N<BAu$K(B SySV $B7A<0$N%;%^%U%)$r;H$$$^$9!#(B</dd>
    </dl>

    <p>$B%3%s%Q%$%k;~$K%7%9%F%`$N%G%U%)%k%H$KA*$P$l$?$b$N$,2?$+$r8+$?$$>l9g$O!"(B
    <directive module="core">LogLevel</directive> $B$r(B <code>debug</code>
    $B$K@_Dj$9$k$H$h$$$G$7$g$&!#%G%U%)%k%H$N(B <directive>AcceptMutex</directive>
    $B$,(B <directive module="core">ErrorLog</directive> $B$K=q$-9~$^$l$^$9!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>BS2000Account</name>
<description>BS2000 $B$G$NHsFC8"%"%+%&%s%H$rDj5A$9$k(B</description>
<syntax>BS2000Account <var>account</var></syntax>
<contextlist><context>server config</context></contextlist>
<modulelist><module>perchild</module><module>prefork</module></modulelist>
<compatibility>BS2000 $B$G$N$_MxMQ2DG=(B</compatibility>

<usage>
    <p><directive>BS2000Account</directive> $B%G%#%l%/%F%#%V$O(B
    BS2000 $B%[%9%H$G$N$_;HMQ$G$-$^$9!#(B
    $BHsFC8"$N(B Apache $B%5!<%P%f!<%6(B (<directive
    module="mpm_common">User</directive>$B$G@_Dj(B)
    $B$N$?$a$N%"%+%&%s%HHV9f$rDj5A$9$k$N$K;HMQ$7$^$9!#(B
    BS2000 POSIX $B%5%V%7%9%F%`$KBP$7$F(B ($B2<0LAX$N(B sub-LOGON $B<B9T;~$K(B
    BS2000 $B%?%9%/4D6-$rJQ99$9$k$?$a$K(B) $BI,MW$G!"(B
    CGI $B%9%/%j%W%H$+$i!"FC8"%"%+%&%s%H$N%j%=!<%9!"(B
    $B0lHLE*$K$O(B <code>SYSROOT</code> $B$K%"%/%;%9$5$l$k$N$rKI$.$^$9!#(B</p>

    <note><title>Note</title>
      <p>$B;HMQ$G$-$k(B <directive>BS2000Account</directive> $B$O0l$D$@$1$G$9!#(B</p>
    </note>
</usage>
<seealso><a href="../platform/ebcdic.html">Apache EBCDIC port</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>CoreDumpDirectory</name>
<description>Apache $B$,%3%"%@%s%W$9$kA0$K0\F0$r;n$_$k%G%#%l%/%H%j(B
</description>
<syntax>CoreDumpDirectory <var>directory</var></syntax>
<default>$B%G%U%)%k%H$N@_Dj$O@bL@J8$rFI$s$G$/$@$5$$(B</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Apache $B$,%3%"%@%s%W$9$kA0$K0\F0$r;n$_$k%G%#%l%/%H%j$r@)8f$7$^$9!#(B
    $B%G%U%)%k%HCM$O(B <directive module="core">ServerRoot</directive>
    $B%G%#%l%/%H%j$G$9$,!"$3$N%G%#%l%/%H%j$O%5!<%P$N<B9T$5$l$F$$$k%f!<%68"8B$G(B
    $B=q$-9~$_2DG=$G$"$k$Y$-$G$O$J$$$N$G!"DL>o$O%3%"%@%s%W$O=q$-9~$^$l$^$;$s!#(B
    $B%G%P%C%0$N$?$a$K%3%"%@%s%W$,I,MW$G$"$l$P!"(B
    $B$3$N%G%#%l%/%F%#%V$r;H$C$FB>$N0LCV$K%3%"%@%s%W$r=q$-=P$9$h$&$K$G$-$^$9!#(B</p>

    <note><title>Linux $B$G$N%3%"%@%s%W(B</title>
      <p>Apache $B$,(B root $B$H$7$F5/F0$5$l$F!"JL$N%f!<%6$N8"8B$K0J9_$7$?>l9g$O(B
      Linux $B$N%+!<%M%k$O%G%#%l%/%H%j$,%W%m%;%9$N8"8B$G=q$-9~$_2DG=$J>l9g$G$5$($b(B
      $B%3%"%@%s%W$r(B<em>$BL58z(B</em>$B$K$7$^$9!#(BApache (2.0.46 $B0J9_(B) $B$O(B
      Linux 2.4 $B0J9_$G$O%3%"%@%s%W$r9T$J$&$h$&$K:F;XDj$7$^$9$,!"$=$l$O(B
      <directive>CoreDumpDirectory</directive> $B$rL@<(E*$K@_Dj$7$?$H$-$K(B
      $B8B$j$^$9!#(B</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>EnableExceptionHook</name>
<description>$B%/%i%C%7%e$N8e$KNc30%O%s%I%i$r<B9T$9$k%U%C%/$rM-8z$K$9$k(B</description>
<syntax>EnableExceptionHook On|Off</syntax>
<default>EnableExceptionHook Off</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>leader</module><module>perchild</module>
<module>prefork</module><module>threadpool</module>
<module>worker</module></modulelist>
<compatibility>2.0.49 $B0J9_(B</compatibility>

<usage>
    <p>$B0BA4>e$NM}M3$+$i!"(B<code>--enable-exception-hook</code> configure
    $B%*%W%7%g%s$rM-8z$K$7$?>l9g$K$N$_!"$3$N%G%#%l%/%F%#%V$rMxMQ$G$-$^$9!#(B
    $B30It%b%8%e!<%k$r%W%i%0%$%s$7$F!";R$,%/%i%C%7%e$7$?8e$K2?$+<B9T$G$-$k$h$&$J(B
    $B%U%C%/$rM-8z$K$7$^$9!#(B</p>
    
    <p>$B$3$N$h$&$J30It%b%8%e!<%k$O!"4{$KFs$DB8:_$7$F$$$F!"(B
    <code>mod_whatkilledus</code> $B$H(B <code>mod_backtrace</code>
    $B$,$3$N%U%C%/$r3hMQ$7$^$9!#$3$l$i$N>\:Y$K$D$$$F$O(B Jeff Trawick 
    $B$5$s$N(B <a href="http://www.apache.org/~trawick/exception_hook.html"
    >EnableExceptionHook site</a> $B$r;2>H$7$F$/$@$5$$!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Group</name>
<description>$B%j%/%(%9%H$K1~Ez$9$k:]$K=jB0$9$k%0%k!<%W(B</description>
<syntax>Group <var>unix-group</var></syntax>
<default>Group #-1</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<compatibility>Apache 2.0 $B0J9_$G!"%0%m!<%P%k@_Dj$G$N$_M-8z$G$9!#(B</compatibility>

<usage>
    <p><directive>Group</directive> $B%G%#%l%/%F%#%V$G!"(B
    $B%j%/%(%9%H$K1~Ez$9$k:]$K=jB0$7$F$*$/%0%k!<%W$r@_Dj$7$^$9!#(B
    $B$3$N%G%#%l%/%F%#%V$r;HMQ$9$k$?$a$K$O!"(B
    $B%5!<%P$O:G=i$K(B <code>root</code> $B8"8B$G5/F0$5$l$F$$$kI,MW$,$"$j$^$9!#(B
    $BHs(B root $B%f!<%6$G%5!<%P$r5/F0$7$?>l9g$O!";XDj$7$?%0%k!<%W$KJQ2=$G$-$:$K!"(B
    $B7k2LE*$K5/F0$7$?%f!<%6$NB0$9$k%0%k!<%W$G<B9T$5$l$k$3$H$K$J$j$^$9!#(B
    <var>unix-group</var> $B$O<!$N$&$A$N$$$:$l$+$G$9(B:</p>

    <dl>
      <dt>$B%0%k!<%WL>(B</dt>
      <dd>$B%0%k!<%W$rL>A0$G;2>H$7$^$9(B</dd>

      <dt><code>#</code> $B$KB3$$$F%0%k!<%WHV9f(B</dt>
      <dd>$B%0%k!<%W$r$rHV9f$G;2>H$7$^$9!#(B</dd>
    </dl>

    <example><title>$BNc(B</title>
      Group www-group
    </example>

    <p>$B%5!<%P$r<B9T$9$k$?$a$KFCDj$N?7$7$$%0%k!<%W$r@_Dj$9$k$3$H$r(B
    $B$*A&$a$7$^$9!#(B<code>nobody</code> $B$r;HMQ$9$k4IM}<T$b$$$^$9$,!"(B
    $B2DG=$G$"$C$?$jK>$^$7$$Lu$G$OI,$:$7$b$"$j$^$;$s!#(B</p>

    <note type="warning"><title>$B%;%-%e%j%F%#(B</title>
      <p>$B@53N$K$I$s$J$3$H$r$d$C$F$$$k$N$+!"$=$N4m81@-$rCN$i$J$$$G!"(B
      <directive>Group</directive> ($B$d(B <directive
      module="mpm_common">User</directive>) $B$r(B
      <code>root</code> $B$K(B $B@_Dj$7$J$$$G$/$@$5$$!#(B</p>
    </note>

    <p>$BFC5-;v9`(B: $B$3$N%G%#%l%/%F%#%V$r(B
    <directive module="core" type="section">VirtualHost</directive>
    $B$G;HMQ$9$k$3$H$O%5%]!<%H$5$l$J$/$J$j$^$7$?!#(BApache 2.0 $B$G(B
    <program>suexec</program> $B$r@_Dj$7$?$$>l9g$O!"(B
    <directive module="mod_suexec">SuexecUserGroup</directive>
    $B$r;HMQ$7$F$/$@$5$$!#(B</p>

    <note><title>$BCm0U(B</title>
      <p><directive>Group</directive> $B%G%#%l%/%F%#%V$O(B
      <module>beos</module> $B$H(B <module>mpmt_os2</module> MPM
      $B$K$bB8:_$7$^$9$,!"<B<AE*$KL58z$G!"8_49@-$N$?$a$@$1$KB8:_$7$^$9!#(B</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>PidFile</name>
<description>$B%G!<%b%s$N%W%m%;%9(B ID
$B$r%5!<%P$,5-O?$9$k$?$a$N%U%!%$%k(B</description>
<syntax>PidFile <var>filename</var></syntax>
<default>PidFile logs/httpd.pid</default>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
<module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p><directive>PidFile</directive> $B%G%#%l%/%F%#%V$G!"(B
    $B%G!<%b%s$N%W%m%;%9(B ID $B$r%5!<%P$,5-O?$9$k%U%!%$%k$r@_Dj$7$^$9!#(B
    $B%U%!%$%kL>$,@dBP%Q%9$G$J$$>l9g$O!"(B
    <directive module="core">ServerRoot</directive>
    $B$+$i$NAjBPE*$J$b$N$H$7$F07$o$l$^$9!#(B</p>

    <example><title>$BNc(B</title>
    PidFile /var/run/apache.pid
    </example>

    <p>$B%5!<%P$,(B <directive module="core">ErrorLog</directive>
    $B$d(B <directive module="mod_log_config">TransferLog</directive>
    $B$rJD$8$F3+$-D>$7$?$j!"@_Dj%U%!%$%k$r(B
    $B:FFI9~$7$?$j$5$;$k$?$a$K!"%5!<%P$K%7%0%J%k$rAw$k$3$H$,$G$-$k$H(B
    $BJXMx$J$3$H$,$"$j$^$9!#(B
    $B$3$l$O(B SIGHUP (kill -1) $B%7%0%J%k$r(B <directive>PidFile</directive>
    $B$K=q$+$l$F$$$k%W%m%;%9(B ID $B$KAw$k$3$H$G$G$-$^$9!#(B</p>

    <p><directive>PidFile</directive> $B$K$O!"%m%0%U%!%$%k$N@_CV0LCV$d(B
    <a href="../misc/security_tips.html#serverroot">$B%;%-%e%j%F%#(B</a>
    $B$HA4$/F1$8Cm0UE@$,$"$j$^$9!#(B</p>

    <note><title>$BCm0U(B</title>
      <p>Apache 2 $B$G$O!"(B
      <program>apachectl</program>
      $B%9%/%j%W%H$N$_$r;HMQ$7$F%5!<%P$N(B ($B:F(B) $B5/F0$dDd;_$r(B
      $B9T$J$&$3$H$r?d>)$7$F$$$^$9!#(B</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Listen</name>
<description>$B%5!<%P$,(B listen $B$9$k(BIP $B%"%I%l%9$H%]!<%HHV9f(B</description>
<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var></syntax>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_netware</module><module>mpm_winnt</module>
<module>mpmt_os2</module><module>perchild</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Apache 2.0 $B$+$iI,MW$J%G%#%l%/%F%#%V(B</compatibility>

<usage>
    <p><directive>Listen</directive> $B%G%#%l%/%F%#%V$O(B Apache
    $B$,FCDj$N(B IP $B%"%I%l%9$d%]!<%HHV9f$@$1$r(B listen $B$9$k$h$&$K;XDj$7$^$9!#(B
    $B%G%U%)%k%H$G$OA4$F$N(B IP $B%$%s%?!<%U%'!<%9$N%j%/%(%9%H$K1~Ez$7$^$9!#(B
    <directive>Listen</directive> $B%G%#%l%/%F%#%V$O(B
    $B8=:_$OI,?\$N%G%#%l%/%F%#%V$H$J$j$^$7$?!#(B
    $B$b$7@_Dj%U%!%$%k$K$J$1$l$P!"%5!<%P$O5/F0$K<:GT$7$^$9!#(B
    $B$3$l$O0JA0$N%P!<%8%g%s$N(B Apache $B$+$iJQ99$N$"$C$?ItJ,$G$9!#(B</p>

    <p><directive>Listen</directive> $B%G%#%l%/%F%#%V$G$O!"FCDj$N%]!<%H$"$k$$$O(B
    $B%"%I%l%9$H%]!<%H$NAH$_9g$o$;$+$iF~$C$F$/$k%j%/%(%9%H$KBP$7$F(B
    $B1~Ez$9$k$h$&$K;XDj$7$^$9!#(B
    $B$b$7%]!<%HHV9f$@$1$,;XDj$5$l$?>l9g$O!"%5!<%P$OA4%$%s%?!<%U%'!<%9$N(B
    $B;XDj$5$l$?%]!<%HHV9f$KBP$7$F(B listen $B$7$^$9!#(B
    IP $B%"%I%l%9$,%]!<%H$H$H$b$K;XDj$5$l$?>l9g$O!"(B
    $B%5!<%P$O;XDj$5$l$?%]!<%H$H%$%s%?!<%U%'!<%9$KBP$7$F(B listen 
    $B$7$^$9!#(B</p>

    <p>$BJ#?t$N%"%I%l%9$H%]!<%H$KBP$7$F(B listen $B$9$k$h$&$K!"(B
    $BJ#?t$N(B <directive>Listen</directive> $B%G%#%l%/%F%#%V$r;H$&$3$H$b$G$-$^$9!#(B
    $B%5!<%P$ONs5s$5$l$?%"%I%l%9$H%]!<%HA4$F$+$i$N%j%/%(%9%H$KBP$7$F(B
    $B1~Ez$7$^$9!#(B</p>

    <p>$BNc$($P!"%5!<%P$,(B 80 $BHV%]!<%H$H(B 8000 $BHV%]!<%H$NN>J}$N(B
    $B%3%M%/%7%g%s$r<u$1F~$l$k>l9g$O!"<!$N$h$&$K$7$^$9!#(B</p>

    <example>
       Listen 80<br />
       Listen 8000
    </example>

    <p>$BFs$D$NFCDj$N%$%s%?!<%U%'!<%9$H%]!<%HHV9f$+$i$N%3%M%/%7%g%s$r(B
    $B<u$1F~$l$k$h$&$K$9$k$K$O!"<!$N$h$&$K$7$^$9!#(B</p>