You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ka...@apache.org on 2007/05/04 12:42:12 UTC
svn commit: r535159 -
/httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja
Author: kawai
Date: Fri May 4 03:42:11 2007
New Revision: 535159
URL: http://svn.apache.org/viewvc?view=rev&rev=535159
Log:
English Revision: 421100
Submitted by: Takashi Sato
Reviewed by: Hiroaki Kawai
Modified:
httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja
Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja?view=diff&rev=535159&r1=535158&r2=535159
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja [iso-2022-jp] (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mpm_common.xml.ja [iso-2022-jp] Fri May 4 03:42:11 2007
@@ -1,7 +1,7 @@
<?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: 190982:421100 (outdated) -->
+<!-- English Revision: 421100 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -35,8 +35,8 @@
<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>
+<module>prefork</module><module>worker</module>
</modulelist>
<usage>
@@ -108,9 +108,9 @@
<syntax>CoreDumpDirectory <var>directory</var></syntax>
<default>デフォルトの設定は説明文を読んでください</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>
+<modulelist><module>beos</module>
+<module>mpm_winnt</module><module>prefork</module>
+<module>worker</module></modulelist>
<usage>
<p>Apache がコアダンプする前に移動を試みるディレクトリを制御します。
@@ -137,8 +137,8 @@
<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>
+<modulelist>
+<module>prefork</module>
<module>worker</module></modulelist>
<compatibility>2.0.49 以降</compatibility>
@@ -157,14 +157,34 @@
</directivesynopsis>
<directivesynopsis>
+<name>GracefulShutdownTimeout</name>
+<description>穏やかな停止をかけた後、終了するまで待つ時間</description>
+<syntax>GracefulShutDownTimeout <var>seconds</var></syntax>
+<default>GracefulShutDownTimeout 0</default>
+<contextlist><context>server config</context></contextlist>
+<modulelist><module>prefork</module><module>worker</module>
+<module>event</module></modulelist>
+<compatibility>2.2 以降</compatibility>
+
+<usage>
+ <p><directive>GracefulShutdownTimeout</directive> には
+ サーバーが "graceful-stop" シグナルを受け取ってから現在の
+ リクエストの処理を最大で何秒間続けるかを指定します。</p>
+
+ <p>この値をゼロに設定すると、処理中として残っているリクエストが
+ 全て完了するまでサーバーは終了しません。</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
<name>Group</name>
<description>リクエストに応答する際に所属するグループ</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>
+<modulelist><module>beos</module>
+<module>mpmt_os2</module><module>prefork</module>
+<module>worker</module></modulelist>
<compatibility>Apache 2.0 以降で、グローバル設定でのみ有効です。</compatibility>
<usage>
@@ -181,7 +201,7 @@
<dd>グループを名前で参照します</dd>
<dt><code>#</code> に続いてグループ番号</dt>
- <dd>グループをを番号で参照します。</dd>
+ <dd>グループを番号で参照します。</dd>
</dl>
<example><title>例</title>
@@ -221,10 +241,10 @@
<syntax>PidFile <var>filename</var></syntax>
<default>PidFile logs/httpd.pid</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
-<module>perchild</module><module>prefork</module>
-<module>threadpool</module><module>worker</module></modulelist>
+<module>prefork</module>
+<module>worker</module></modulelist>
<usage>
<p><directive>PidFile</directive> ディレクティブで、
@@ -263,10 +283,10 @@
<description>サーバが listen するIP アドレスとポート番号</description>
<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var> [<var>protocol</var>]</syntax>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</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>
+<module>mpmt_os2</module>
+<module>prefork</module><module>worker</module>
<module>event</module>
</modulelist>
<compatibility>Apache 2.0 から必須ディレクティブ。<var>protocol</var>
@@ -315,7 +335,7 @@
例えば次の例のようにです。</p>
<example>
- Listen [2001:db8::a00:20ff:fea7:ccea]:80
+ Listen [2001:db8::a00:20ff:fea7:ccea]:80
</example>
<p><var>protocol</var> オプション引数は通常の設定では必要ありません。
@@ -351,10 +371,10 @@
<syntax>ListenBacklog <var>backlog</var></syntax>
<default>ListenBacklog 511</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</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>
+<module>mpmt_os2</module><module>prefork</module>
+<module>worker</module></modulelist>
<usage>
<p>保留状態のコネクションのキューの最大長です。
@@ -378,8 +398,8 @@
<syntax>LockFile <var>filename</var></syntax>
<default>LockFile logs/accept.lock</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
-<module>prefork</module><module>threadpool</module><module>worker</module>
+<modulelist>
+<module>prefork</module><module>worker</module>
</modulelist>
<usage>
@@ -412,8 +432,8 @@
<syntax>MaxClients <var>number</var></syntax>
<default>詳細は使用法をご覧下さい。</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
-<module>prefork</module><module>threadpool</module><module>worker</module>
+<modulelist><module>beos</module>
+<module>prefork</module><module>worker</module>
</modulelist>
<usage>
@@ -456,9 +476,9 @@
<syntax>MaxMemFree <var>KBytes</var></syntax>
<default>MaxMemFree 0</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>prefork</module>
-<module>threadpool</module><module>worker</module><module>mpm_winnt</module></modulelist>
+<module>worker</module><module>mpm_winnt</module></modulelist>
<usage>
<p><directive>MaxMemFree</directive> ディレクティブは
@@ -474,10 +494,10 @@
<syntax>MaxRequestsPerChild <var>number</var></syntax>
<default>MaxRequestsPerChild 10000</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_netware</module>
+<modulelist><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>
+<module>prefork</module>
+<module>worker</module></modulelist>
<usage>
<p><directive>MaxRequestsPerChild</directive> ディレクティブは、
@@ -518,23 +538,16 @@
<syntax>MaxSpareThreads <var>number</var></syntax>
<default>詳細は使用法をご覧下さい。</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<module>worker</module>
</modulelist>
<usage>
<p>アイドルなスレッドの最大数です。異なる MPM ではそれぞれ、
このディレクティブは異なる取り扱われ方をされます。</p>
- <p><module>perchild</module> では、
- デフォルトは <code>MaxSpareThreads 10</code> です。
- この MPM はアイドルスレッド数を、それぞれの子プロセスごとに監視します。
- 子プロセスにアイドルスレッドが多すぎる場合は、
- サーバはその子プロセスに含まれるスレッドを終了し始めます。</p>
-
- <p><module>worker</module>, <module>leader</module>,
- <module>threadpool</module> では、
+ <p><module>worker</module> では、
デフォルトは <code>MaxSpareThreads 250</code> です。
この MPM はアイドルスレッド数をサーバ全体で監視します。
サーバでアイドルスレッド数が多すぎる場合は、
@@ -555,16 +568,12 @@
<p><directive>MaxSpareThreads</directive> の取る値には制限があります。
Apache は次の規則に従って自動的に補正します。</p>
<ul>
- <li><module>perchild</module> では、
- <directive>MaxSpareThreads</directive> が
- <directive module="mpm_common">ThreadLimit</directive>
- と等しいかそれ以下である必要があります。</li>
<li><module>mpm_netware</module> は
<directive module="mpm_common">MinSpareThreads</directive>
よりも大きい必要があります。</li>
- <li><module>leader</module>, <module>threadpool</module>,
+ <li>
<module>worker</module> では、
<directive module="mpm_common">MinSpareThreads</directive> と
<directive module="mpm_common">ThreadsPerChild</directive>
@@ -583,9 +592,9 @@
<syntax>MinSpareThreads <var>number</var></syntax>
<default>詳細は使用方法をご覧下さい。</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<module>worker</module>
</modulelist>
<usage>
@@ -593,18 +602,7 @@
異なる MPM ではそれぞれ、
このディレクティブは異なる取り扱われ方をします。</p>
- <p><module>perchild</module> では、
- デフォルトは <code>MinSpareThreads 5</code> で、
- アイドルスレッド数を子プロセス毎に監視します。
- もし子プロセスに十分な数のスレッドがなければ、
- サーバはその子プロセスに新しいスレッドを作り始めます。
- ですから、<directive module="perchild">NumServers</directive>
- を <code>10</code> に、<directive>MinSpareThreads</directive> を
- <code>5</code> にした場合は、最小でも 50 のアイドルスレッドが
- システム上にあることになります。</p>
-
- <p><module>worker</module>, <module>leader</module>,
- <module>threadpool</module> では、
+ <p><module>worker</module> では、
デフォルトは <code>MinSpareThreads 75</code> で、
アイドルスレッド数をサーバ全体で監視します。
もしサーバに十分な数のアイドルスレッドがなければ、
@@ -632,9 +630,9 @@
<syntax>ScoreBoardFile <var>file-path</var></syntax>
<default>ScoreBoardFile logs/apache_status</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>
+<modulelist><module>beos</module>
+<module>mpm_winnt</module><module>prefork</module>
+<module>worker</module></modulelist>
<usage>
<p>Apache は親プロセスと子プロセス間の通信にスコアボードを用います。
@@ -662,18 +660,36 @@
</directivesynopsis>
<directivesynopsis>
+<name>ReceiveBufferSize</name>
+<description>TCP 受信バッファサイズ</description>
+<syntax>ReceiveBufferSize <var>bytes</var></syntax>
+<default>ReceiveBufferSize 0</default>
+<contextlist><context>server config</context></contextlist>
+<modulelist><module>beos</module>
+<module>mpm_netware</module><module>mpm_winnt</module>
+<module>mpmt_os2</module><module>prefork</module>
+<module>worker</module></modulelist>
+
+<usage>
+ <p>サーバは TCP 受信バッファサイズを指定されたバイト数に設定します。</p>
+
+ <p><code>0</code>にした場合、OS のデフォルト値が使用されます。</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
<name>SendBufferSize</name>
<description>TCP バッファサイズ</description>
<syntax>SendBufferSize <var>bytes</var></syntax>
<default>SendBufferSize 0</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</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>
+<module>mpmt_os2</module><module>prefork</module>
+<module>worker</module></modulelist>
<usage>
- <p>サーバは TCP バッファサイズを指定されたバイト数に設定します。
+ <p>サーバは TCP 送信バッファサイズを指定されたバイト数に設定します。
高速で高レイテンシな環境で
(<em>例</em> 100ms 程度、大陸横断高速通信路など)
古い一般的な OS のデフォルト値を増やすのに非常に便利です。</p>
@@ -688,8 +704,8 @@
<syntax>ServerLimit <var>number</var></syntax>
<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>
+<module>prefork</module><module>worker</module>
</modulelist>
<usage>
@@ -722,8 +738,7 @@
希望の <directive module="mpm_common">MaxClients</directive>
数とくらべて、必要以上に大きな値を指定することは避けてください。</p>
- <p><module>worker</module>, <module>leader</module>,
- <module>threadpool</module> MPM では、
+ <p><module>worker</module> MPM では、
<directive module="mpm_common">MaxClients</directive> と
<directive module="mpm_common">ThreadsPerChild</directive>
の設定で 16 サーバプロセス (デフォルト)
@@ -733,10 +748,6 @@
とくらべて、必要となるサーバプロセス数以上に大きな値を
設定することは避けてください。</p>
- <p><module>perchild</module> MPM では、
- <directive module="perchild">NumServers</directive> を 8 (デフォルト)
- よろいも大きな値に設定する必要があるときにのみ使用してください。</p>
-
<note><title>注意</title>
<p><code>ServerLimit 20000</code> という制限付きでコンパイルされています
(<module>prefork</module> MPM では <code>200000</code>) 。
@@ -753,8 +764,8 @@
<syntax>StartServers <var>number</var></syntax>
<default>詳細は使用方法を参照</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpmt_os2</module>
-<module>prefork</module><module>threadpool</module><module>worker</module>
+<modulelist><module>mpmt_os2</module>
+<module>prefork</module><module>worker</module>
</modulelist>
<usage>
@@ -764,7 +775,6 @@
通常はこの値を調整する理由はあまりないでしょう。</p>
<p>デフォルト値は MPM ごとに異なります。
- <module>leader</module>, <module>threadpool</module>,
<module>worker</module> は <code>StartServers 3</code> です。
<module>prefork</module> は <code>5</code> で、
<module>mpmt_os2</module> は <code>2</code> です。</p>
@@ -778,17 +788,13 @@
<default>詳細は使用方法を参照</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>mpm_netware</module>
-<module>perchild</module></modulelist>
+</modulelist>
<usage>
<p>起動時に生成されるスレッドの数です。
スレッド数は負荷に応じて動的に制御されますので、
通常はこの値を調整する理由はあまりないでしょう。</p>
- <p><module>perchild</module> でのデフォルトは
- <code>StartThreads 5</code> で、このディレクティブは起動時に
- プロセス毎のスレッド数を追跡します。</p>
-
<p><module>mpm_netware</module> でのデフォルトは
<code>StartThreads 50</code> で、
この場合プロセスは一つしかないので、
@@ -807,8 +813,8 @@
<syntax>ThreadLimit <var>number</var></syntax>
<default>詳細は使用方法を参照</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_winnt</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<modulelist><module>mpm_winnt</module>
+<module>worker</module>
</modulelist>
<compatibility>Apache 2.0.41 とそれ以降の <module>mpm_winnt</module>
で利用可能</compatibility>
@@ -857,8 +863,8 @@
<syntax>ThreadsPerChild <var>number</var></syntax>
<default>詳細は使用方法を参照</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_winnt</module>
-<module>threadpool</module><module>worker</module></modulelist>
+<modulelist><module>mpm_winnt</module>
+<module>worker</module></modulelist>
<usage>
<p>このディレクティブは、それぞれの子プロセスで生成される
@@ -885,9 +891,9 @@
<syntax>ThreadStackSize <var>size</var></syntax>
<default>NetWare では 65536。他の OS では違った値</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_netware</module>
-<module>mpm_winnt</module><module>perchild</module>
-<module>threadpool</module><module>worker</module>
+<modulelist><module>mpm_netware</module>
+<module>mpm_winnt</module>
+<module>worker</module>
</modulelist>
<compatibility>2.1 以降</compatibility>
@@ -930,8 +936,8 @@
<syntax>User <var>unix-userid</var></syntax>
<default>User #-1</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
-<module>prefork</module><module>threadpool</module><module>worker</module>
+<modulelist>
+<module>prefork</module><module>worker</module>
</modulelist>
<compatibility>Apache 2.0 以降で、グローバル設定でのみ有効です。
</compatibility>
@@ -973,14 +979,6 @@
module="mpm_common">Group</directive>) を <code>root</code> に
設定しないでください。</p>
</note>
-
- <p><module>perchild</module> MPM では、異なるユーザ ID
- で複数のバーチャルホストを動かすことを目的としていますが、
- <directive>User</directive> は、主サーバのユーザ ID
- と、<directive module="perchild">AssignUserID</directive>
- ディレクティブを持たない <directive type="section"
- module="core">VirtualHost</directive> セクションへの
- フォールバックとを定義することになります。</p>
<p>特記事項: このディレクティブを
<directive module="core" type="section">VirtualHost</directive>