mpm_common.xml.ja revision ca0a943242b488c162aa89874498e0316f7b2f2e
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<!-- English Revision: 674934:883878 (outdated) -->
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Licensed to the Apache Software Foundation (ASF) under one or more
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi contributor license agreements. See the NOTICE file distributed with
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi this work for additional information regarding copyright ownership.
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi The ASF licenses this file to You under the Apache License, Version 2.0
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi (the "License"); you may not use this file except in compliance with
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi the License. You may obtain a copy of the License at
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Unless required by applicable law or agreed to in writing, software
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi distributed under the License is distributed on an "AS IS" BASIS,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi See the License for the specific language governing permissions and
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi limitations under the License.
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulesynopsis metafile="mpm_common.xml.meta">
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>二つ以上のマルチプロセッシングモジュール (MPM)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiで実装されているディレクティブのコレクション</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>複数の子プロセスがネットワークソケットでリクエストを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiaccept しようとしているときに、Apache がそれらの子プロセスを直列化するために
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi使う方法</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>AcceptMutex Default|<var>method</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>AcceptMutex</directive> ディレクティブは、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ネットワークソケットのリクエストを accept しようとしている複数の子プロセスを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache が直列化するために使う方法(と必要ならロックファイルの場所)を設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache 2.0 以前は、このメソッドはコンパイル時にのみ選択できました。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 最適な方法は、アーキテクチャやプラットホームに大きく依存します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi href="/misc/perf-tuning.html">性能のチューニング</a>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ドキュメントをご覧下さい。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定されていれば、コンパイル時に選択されたデフォルト値が使われます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 他の使用可能なメソッドの一覧は下にあります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 全てのメソッドが全てのプラットホームで使用可能であるわけではない、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ということに注意してください。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 使用可能でないメソッドが指定された場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 使用可能なメソッドの一覧を含んだメッセージが
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi エラーログに出力されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dt><code>flock<<var>:/path/to/lockfile</var>></code></dt>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi パラメータで定義したファイルのロックに、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ロックファイルの指定には <directive module="mpm_common">LockFile</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブを使うことも出来ます(非推奨です)。</dd>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dt><code>fcntl<<var>:/path/to/lockfile</var>></code></dt>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi パラメータで定義したファイルのロックに、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ロックファイルの指定には <directive module="mpm_common">LockFile</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブを使うことも出来ます(非推奨です)。</dd>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dt><code>file<<var>:/path/to/lockfile</var>></code></dt>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dd>使用できるファイルロックルーチンの中で最適なものを使います。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 具体的には、<code>fcntl</code> が使用可能な場合はそれを使い、そうでない場合は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この設定はプラットホームと <glossary>APR</glossary> が二つのうち少なくとも
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 一つをサポートしている場合のみ使用可能です。</dd>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dd>使用できるセマフォルーチンの中で最適なものを使います。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 具体的には、Posix 互換セマフォが使用可能な場合はそれを使い、そうでない場合は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi SystemV IPC 形式のセマフォを試します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この設定はプラットホームと <glossary>APR</glossary> が二つのうち少なくとも
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 一つをサポートしている場合のみ使用可能です。</dd>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <dd>POSIX Threads (PThreads) 規格で実装されている
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi POSIX 排他処理を使います。</dd>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>コンパイル時にシステムのデフォルトに選ばれたものが何かを見たい場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="core">LogLevel</directive> を <code>debug</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定するとよいでしょう。デフォルトの <directive>AcceptMutex</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi が <directive module="core">ErrorLog</directive> に書き込まれます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>ほとんどのシステムにおいては、<code>pthread</code> オプションが
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 選ばれていると、子プロセスが <code>AcceptCntl</code> mutex を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 保持しているときに異常終了した場合、サーバはリクエストへの応答を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 停止してしまいます。これが発生した場合は、サーバを復旧させるためには
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 手動で再起動させる必要があります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>Solaris は例外で、Apache も使用している、子プロセスが mutex を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 保持して異常終了した後に mutex を復旧させるための機構を提供をしています。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>御使用のシステムが <code>pthread_mutexattr_setrobust_np()</code> 関数を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 実装している場合は、<code>pthread</code> オプションを安全に使用できる
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 可能性があります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>Apache がコアダンプする前に移動を試みるディレクトリ
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>CoreDumpDirectory <var>directory</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>Apache がコアダンプする前に移動を試みるディレクトリを制御します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デフォルト値は <directive module="core">ServerRoot</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクトリですが、このディレクトリはサーバの実行されているユーザ権限で
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 書き込み可能であるべきではないので、通常はコアダンプは書き込まれません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デバッグのためにコアダンプが必要であれば、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブを使って他の位置にコアダンプを書き出すようにできます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>Apache が root として起動されて、別のユーザの権限に以降した場合は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Linux のカーネルはディレクトリがプロセスの権限で書き込み可能な場合でさえも
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Linux 2.4 以降ではコアダンプを行なうように再指定しますが、それは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>CoreDumpDirectory</directive> を明示的に設定したときに
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>クラッシュの後に例外ハンドラを実行するフックを有効にする</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>安全上の理由から、<code>--enable-exception-hook</code> configure
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi オプションを有効にした場合にのみ、このディレクティブを利用できます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 外部モジュールをプラグインして、子がクラッシュした後に何か実行できるような
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi フックを有効にします。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このような外部モジュールは、既に二つ存在していて、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <code>mod_whatkilledus</code> と <code>mod_backtrace</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi がこのフックを活用します。これらの詳細については Jeff Trawick
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi さんの <a href="http://www.apache.org/~trawick/exception_hook.html"
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi >EnableExceptionHook site</a> を参照してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>穏やかな停止をかけた後、終了するまで待つ時間</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>GracefulShutDownTimeout <var>seconds</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<default>GracefulShutDownTimeout 0</default>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>prefork</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>GracefulShutdownTimeout</directive> には
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバーが "graceful-stop" シグナルを受け取ってから現在の
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi リクエストの処理を最大で何秒間続けるかを指定します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>この値をゼロに設定すると、処理中として残っているリクエストが
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 全て完了するまでサーバーは終了しません。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>リクエストに応答する際に所属するグループ</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>Group <var>unix-group</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<compatibility>Apache 2.0 以降で、グローバル設定でのみ有効です。</compatibility>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi リクエストに応答する際に所属しておくグループを設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブを使用するためには、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバは最初に <code>root</code> 権限で起動されている必要があります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 非 root ユーザでサーバを起動した場合は、指定したグループに変化できずに、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 結果的に起動したユーザの属するグループで実行されることになります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Group www-group
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>サーバを実行するために特定の新しいグループを設定することを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 可能であったり望ましい訳では必ずしもありません。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>正確にどんなことをやっているのか、その危険性を知らないで、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>特記事項: このディレクティブを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="core" type="section">VirtualHost</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi で使用することはサポートされなくなりました。Apache 2.0 で
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mod_suexec">SuexecUserGroup</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を使用してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> と <module>mpmt_os2</module> MPM
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi にも存在しますが、実質的に無効で、互換性のためだけに存在します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>デーモンのプロセス ID
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiをサーバが記録するためのファイル</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>PidFile <var>filename</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_winnt</module><module>mpmt_os2</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>PidFile</directive> ディレクティブで、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デーモンのプロセス ID をサーバが記録するファイルを設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ファイル名が絶対パスでない場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="core">ServerRoot</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi からの相対的なものとして扱われます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>サーバが <directive module="core">ErrorLog</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi や <directive module="mod_log_config">TransferLog</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を閉じて開き直したり、設定ファイルを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 再読込したりさせるために、サーバにシグナルを送ることができると
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi これは SIGHUP (kill -1) シグナルを <directive>PidFile</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に書かれているプロセス ID に送ることでできます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>PidFile</directive> には、ログファイルの設置位置や
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <a href="/misc/security_tips.html#serverroot">セキュリティ</a>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi と全く同じ注意点があります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>Apache 2 では、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スクリプトのみを使用してサーバの (再) 起動や停止を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 行なうことを推奨しています。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>サーバが listen するIP アドレスとポート番号</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var> [<var>protocol</var>]</syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpmt_os2</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<compatibility>Apache 2.0 から必須ディレクティブ。<var>protocol</var>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi引数は 2.1.5 で追加。</compatibility>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>Listen</directive> ディレクティブは Apache
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi が特定の IP アドレスやポート番号だけを listen するように指定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デフォルトでは全ての IP インターフェースのリクエストに応答します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 現在は必須のディレクティブとなりました。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi もし設定ファイルになければ、サーバは起動に失敗します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi これは以前のバージョンの Apache から変更のあった部分です。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>Listen</directive> ディレクティブでは、特定のポートあるいは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi アドレスとポートの組み合わせから入ってくるリクエストに対して
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 応答するように指定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi もしポート番号だけが指定された場合は、サーバは全インターフェースの
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 指定されたポート番号に対して listen します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi IP アドレスがポートとともに指定された場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバは指定されたポートとインターフェースに対して listen
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>複数のアドレスとポートに対して listen するように、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 複数の <directive>Listen</directive> ディレクティブを使うこともできます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバは列挙されたアドレスとポート全てからのリクエストに対して
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>例えば、サーバが 80 番ポートと 8000 番ポートの両方の
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi コネクションを受け入れる場合は、次のようにします。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Listen 80<br />
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>二つの特定のインターフェースとポート番号からのコネクションを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 受け入れるようにするには、次のようにします。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Listen 192.170.2.1:80<br />
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Listen 192.170.2.5:8000
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>IPv6 アドレスは角括弧で囲まなければなりません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 例えば次の例のようにです。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Listen [2001:db8::a00:20ff:fea7:ccea]:80
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><var>protocol</var> オプション引数は通常の設定では必要ありません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 無指定の場合、443 番ポートには <code>https</code> が、他のポートには
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi protocol 指定は、どのモジュールがリクエストを処理するかを決定し、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="core">AcceptFilter</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi によるプロトコル特有の最適化を行うようにします。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>非標準なポートで運用している際にのみ protocol 指定が必要になります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi たとえば <code>https</code> なサイトを 8443 番ポートで運用している場合 :</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Listen 192.170.2.1:8443 https
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 同一 IP アドレスとポートの組に、複数の <directive>Listen</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブを指定してしまうと、<code>Address already in use</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi というエラーメッセージを受けることになります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><a href="/dns-caveats.html">DNS の問題</a></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>保留状態のコネクションのキューの最大長</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ListenBacklog <var>backlog</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>保留状態のコネクションのキューの最大長です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 一般的には調整する必要はありませんし、調整は望ましくありません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi しかし、TCP SYN フラッドアタックの状況下におかれる場合に、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 増やした方が望ましいシステムもあります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>この値は OS により、小さな数に抑えられます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 値は OS 毎に異なっています。また多くの OS では、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi バックログとして指定されている値ちょうどまで使っているわけではなく、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定されている値に基づいて (通常は設定値よりも大きな値を)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 使っていることに注意してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>受付を直列化するためのロックファイルの位置<em>(非推奨)</em></description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>LockFile <var>filename</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<default>LockFile logs/accept.lock</default>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive module="mpm_common">AcceptMutex</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定されて使用されている場合に、使用されるロックファイルへのパスを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>LockFile</directive> ディレクティブで設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブは通常はそのままにしておきます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi でマウントされている場合などに値を変えます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi なぜなら<strong>ロックファイルはローカルディスクに
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 保存されなければならない</strong>からです。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi メインサーバプロセスの PID がファイル名に自動的に付加されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi といった、誰でも書き込めるディレクトリにファイルを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ロックファイルの作成自体を妨害することによって、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 誰でもサービス拒否アタックを引き起こすことができるからです。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi module="mpm_common">AcceptMutex</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブで排他処理の方法の指定とともにロックファイルの場所も指定してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><directive module="mpm_common">AcceptMutex</directive></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>リクエストに応答するために作成される
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi子プロセスの最大個数</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>MaxClients <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>MaxClients</directive> ディレクティブは、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 応答することのできる同時リクエスト数を設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>MaxClients</directive> 制限数を越えるコネクションは通常、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ListenBacklog</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブで設定した数までキューに入ります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 他のリクエストの最後まで達して子プロセスが空くと、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 次のコネクションに応答します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>スレッドを用いないサーバ (<em>すなわち</em> <module>prefork</module>)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi は、リクエストに応答するために起動される
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 子プロセスの最大数となります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ServerLimit</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi の値も増加させる必要があります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> <module>worker</module>)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi は、クライアントに応答できるスレッドの総数を制限します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> でのデフォルト値は <code>50</code> です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ServerLimit</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi module="mpm_common">ThreadsPerChild</directive>) です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を 16 プロセス以上必要な値まで増加させたい場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ServerLimit</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi も増加させる必要があります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi主メモリアロケータが保持し続けられるメモリの最大量</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>MaxMemFree <var>KBytes</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module><module>mpm_winnt</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>MaxMemFree</directive> ディレクティブは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 主アロケータが保持できる空のメモリの最大値をキロバイト単位で設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定されていないか、零に設定されているときは、無制限になります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>個々の子サーバが稼働中に扱うリクエスト数の上限</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>MaxRequestsPerChild <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<default>MaxRequestsPerChild 10000</default>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>mpm_netware</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_winnt</module><module>mpmt_os2</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>MaxRequestsPerChild</directive> ディレクティブは、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 個々の子サーバプロセスが扱うことのできるリクエストの制限数を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定します。<directive>MaxRequestsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 個のリクエストの後に、子プロセスは終了します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>MaxRequestsPerChild</directive> が <code>0</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定されている場合は、プロセスは期限切れにより終了することはありません。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>mpm_netware</module> と <module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>MaxRequestsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を非ゼロにすることにより、(偶発的な) メモリーリークが起こった場合に
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi プロセスが消費するメモリの総量を制限できます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive module="core">KeepAlive</directive> リクエストの場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 一つ目のリクエストだけがこの制限に該当します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 制限するように挙動が変化します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>MaxSpareThreads <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpmt_os2</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>perchild</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>アイドルなスレッドの最大数です。異なる MPM ではそれぞれ、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブは異なる取り扱われ方をされます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この MPM はアイドルスレッド数を、それぞれの子プロセスごとに監視します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 子プロセスにアイドルスレッドが多すぎる場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバはその子プロセスに含まれるスレッドを終了し始めます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>worker</module>, <module>leader</module>,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デフォルトは <code>MaxSpareThreads 250</code> です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この MPM はアイドルスレッド数をサーバ全体で監視します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバでアイドルスレッド数が多すぎる場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この数字よりも少ない数になるまで子プロセスを終了します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi デフォルトは <code>MaxSpareThreads 100</code> です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この MPM はシングルプロセスで実行されますので、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スペアスレッド数もサーバ全体で勘定します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>beos</module> と <module>mpmt_os2</module> は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> でのデフォルト値は <code>MaxSpareThreads 50</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi です。<module>mpmt_os2</module> でのデフォルト値は <code>10</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>MaxSpareThreads</directive> の取る値には制限があります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache は次の規則に従って自動的に補正します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadLimit</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi と等しいかそれ以下である必要があります。</li>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MinSpareThreads</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi よりも大きい必要があります。</li>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <li><module>leader</module>, <module>threadpool</module>,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MinSpareThreads</directive> と
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi で決まる総和と等しいか大きい必要があります。</li>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><directive module="mpm_common">MinSpareThreads</directive></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><directive module="mpm_common">StartServers</directive></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>リクエストに応答することのできる
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiアイドルスレッド数の最小数</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>MinSpareThreads <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpmt_os2</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>perchild</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>リクエストに応答するスレッド数の最小値です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 異なる MPM ではそれぞれ、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブは異なる取り扱われ方をします。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi アイドルスレッド数を子プロセス毎に監視します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi もし子プロセスに十分な数のスレッドがなければ、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバはその子プロセスに新しいスレッドを作り始めます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ですから、<directive module="perchild">NumServers</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を <code>10</code> に、<directive>MinSpareThreads</directive> を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi システム上にあることになります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>worker</module>, <module>leader</module>,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi アイドルスレッド数をサーバ全体で監視します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi もしサーバに十分な数のアイドルスレッドがなければ、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 新しい子プロセスが生成されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi シングルプロセス MPM ですので、サーバ全体で管理されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>beos</module> と <module>mpmt_os2</module> は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> でのデフォルトは <code>MinSpareThreads 1</code>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><directive module="mpm_common">MaxSpareThreads</directive></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><directive module="mpm_common">StartServers</directive></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>子プロセスと連携するためのデータを保存する
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiファイルの位置</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ScoreBoardFile <var>file-path</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<default>ScoreBoardFile logs/apache_status</default>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>Apache は親プロセスと子プロセス間の通信にスコアボードを用います。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この通信機能にファイルを必要とするアーキテクチャもあります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ファイルが指定されていなければ、Apache はまずメモリ上
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi (匿名共有メモリ) にスコアボードを作ろうとし、それが失敗すると
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディスク上にファイル (ファイルベースの共有メモリ) を作ろうとします。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブを指定すると、Apache
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi は必ずディスクにファイルを生成します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>ファイルベースの共有メモリは、サードパーティー製のアプリケーションで
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スコアボードに直接アクセスする必要がある場合に役に立ちます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>ScoreBoardFile</directive> を使う場合、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi RAM ディスク上に置くとスピードが向上するでしょう。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi しかし、ログファイルの設置位置や
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <a href="/misc/security_tips.html">セキュリティ</a>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi と同様の注意点があるので、注意してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><a href="/stopping.html">Apache の停止と再起動</a></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ReceiveBufferSize <var>bytes</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpmt_os2</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><code>0</code>にした場合、OS のデフォルト値が使用されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>SendBufferSize <var>bytes</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>leader</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_netware</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>サーバは TCP 送信バッファサイズを指定されたバイト数に設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 高速で高レイテンシな環境で
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 古い一般的な OS のデフォルト値を増やすのに非常に便利です。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><code>0</code>にした場合、OS のデフォルト値が使用されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ServerLimit <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>prefork</module> MPM の場合は、このディレクティブは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache プロセス稼働中における
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定可能な上限値を設定することになります
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <transnote>prefork の場合は同時クライアント数 = サーバプロセス数なので</transnote>。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>worker</module> MPM の場合には、このディレクティブは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadLimit</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi ディレクティブと組み合わせて、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache プロセス稼働中における
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定可能な上限値を設定することになります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブを変更して再起動<transnote>apachectl
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi restart</transnote>しても無視されますが、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi は再起動で変更することができます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このディレクティブを使用する際は特に注意してください。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>ServerLimit</directive> が必要以上に大きな値に
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定された場合は、余計な未使用共有メモリが割り当てられます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi がシステムの扱える範囲を越えた設定値になっていると、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache は起動しないか、起動しても不安定になるでしょう。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を 256 (デフォルト) よりも大きな値に設定する必要がある時にだけ使用してください。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 希望の <directive module="mpm_common">MaxClients</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 数とくらべて、必要以上に大きな値を指定することは避けてください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>worker</module>, <module>leader</module>,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients</directive> と
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi の設定で 16 サーバプロセス (デフォルト)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 以上必要になる場合にのみ使用してください。希望の
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">MaxClients </directive> と
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi とくらべて、必要となるサーバプロセス数以上に大きな値を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定することは避けてください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="perchild">NumServers</directive> を 8 (デフォルト)
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi よろいも大きな値に設定する必要があるときにのみ使用してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><code>ServerLimit 20000</code> という制限付きでコンパイルされています
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi (<module>prefork</module> MPM では <code>200000</code>) 。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi これはスペルミスによって誤って酷い状況になるのを、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 回避するための処置です。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<seealso><a href="/stopping.html">Apache の停止と再起動</a></seealso>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>起動時に生成される子サーバプロセスの数</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>StartServers <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>mpmt_os2</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>StartServers</directive> ディレクティブは、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 起動時に生成される子サーバプロセスの数を設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi プロセス数は負荷に応じて動的に制御されますので、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 通常はこの値を調整する理由はあまりないでしょう。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>デフォルト値は MPM ごとに異なります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>leader</module>, <module>threadpool</module>,
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>worker</module> は <code>StartServers 3</code> です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>prefork</module> は <code>5</code> で、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>mpmt_os2</module> は <code>2</code> です。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>StartThreads <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>beos</module><module>mpm_netware</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>起動時に生成されるスレッドの数です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スレッド数は負荷に応じて動的に制御されますので、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 通常はこの値を調整する理由はあまりないでしょう。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <code>StartThreads 5</code> で、このディレクティブは起動時に
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi プロセス毎のスレッド数を追跡します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この場合プロセスは一つしかないので、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 起動時にリクエストに応答するスレッドの総数となります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>beos</module> でのデフォルトは <code>StartThreads
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 10</code> です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi また、起動時に生成されるスレッドの総数にも反映されます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>設定可能な子プロセス毎のスレッド数の上限を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi設定します</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ThreadLimit <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>perchild</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<compatibility>Apache 2.0.41 とそれ以降の <module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiで利用可能</compatibility>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このディレクティブは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache プロセス稼働中における
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi に設定可能な上限値を設定します。再起動時にこのディレクティブの値を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 変更しても無視されますが、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi は再起動中に、このディレクティブで指定された上限値まで
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 変更することができます。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このディレクティブを使用する際は特に注意してください。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi よりもずっと大きな値に設定された場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 余計な未使用共有メモリが割り当てられてしまいます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mpm_common">ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi の両方がシステムの扱える範囲を超えている場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Apache は起動しないか、起動したとしても不安定になるでしょう。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブの値は今使用している Apache の <directive
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi module="mpm_common">ThreadsPerChild</directive> の予想上限値を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 超えた値には設定しないでください。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><directive>ThreadLimit</directive> のデフォルト値は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>mpm_winnt</module> のときは <code>1920</code> で、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><code>ThreadLimit 20000</code> (<module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi という制限付きでコンパイルされています。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi これはスペルミスによって誤って酷い状況になるのを、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 回避するための処置です。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>子プロセスそれぞれに生成されるスレッド数</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ThreadsPerChild <var>number</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>mpm_winnt</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このディレクティブは、それぞれの子プロセスで生成される
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 子プロセスは開始時にこれらのスレッドを生成して、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi その後は生成しません。<module>mpm_winnt</module> のような、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 子プロセスが一つしかないような MPM を利用しているのであれば、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi この値はサーバの負荷全体を十分取り扱える程度に、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 子プロセスが複数あるような MPM を利用しているのであれば、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバの通常負荷を十分扱える程度に、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>mpm_winnt</module>での <directive>ThreadsPerChild</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>クライアントのコネクションを受け持つスレッドが使用する
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchiスタックのバイト数</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ThreadStackSize <var>size</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<default>NetWare では 65536。他の OS では違った値</default>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>mpm_netware</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>mpm_winnt</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>クライアントコネクションを受け持ち、コネクション処理に必要なモジュールの
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 呼び出しを行なっているスレッドの、(自動変数用の) スタックサイズは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive>ThreadStackSize</directive> ディレクティブで指定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 大抵の場合 OS の指定しているスタックサイズのデフォルト値は
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 適切なものですが、調整が必要になる場合もあります:</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <li>スレッドスタックサイズのデフォルト値が比較的小さく設定されている
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi プラットホーム (例えば HP-UX) では、自動変数用の領域で大きな容量を
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 使用するサードパーティ製モジュールのために Apache がクラッシュする
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 場合もあります。そのモジュールは他のプラットホームでは
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スタックサイズが大きいために、快調に動作するかもしれません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このタイプのクラッシュは、<directive>ThreadStackSize</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi で OS のデフォルト値より大きな値を指定することで解決します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サードパーティ製モジュールでこの処置が必要であると記載されている
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 場合か、Apache の出力するメッセージでスレッドスタックサイズが
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 小さすぎると指摘されている場合にのみ、この調整をしてください。</li>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <li>デフォルトスレッドスタックサイズが、Web サーバ用途に必要な量よりも
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 明らかに大きすぎる場合、<directive>ThreadStackSize</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を OS のデフォルト値よりも小さな値にすることで、子プロセスあたりの
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi スレッド数をより多く持たせられるようになります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このタイプの調整は、テスト環境でウェブサーバを完全に
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi テストできる場合に限って行なうべきです。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi まれに多数のスタックが要求されるリクエストを受けることがあるかも
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi Web サーバの設定を変更すると、現在の <directive>ThreadStackSize</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi の設定が取り消される場合があります。</li>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>リクエストに応答する際に用いるユーザ ID</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>User <var>unix-userid</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<modulelist><module>leader</module><module>perchild</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>threadpool</module><module>worker</module>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<compatibility>Apache 2.0 以降で、グローバル設定でのみ有効です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</compatibility>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバがリクエストに応答する際に用いるユーザ ID を設定します。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi このディレクティブを使用するためには、スタンドアロン型の
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバは最初に <code>root</code> 権限で起動されている必要があります。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 非 root ユーザでサーバを起動した場合は、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 権限の低いユーザへと変わることができず、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 結局元のユーザのプロセスとして実行され続けます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi として実行されているのは正常な動作です。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このユーザは、外部に見せるように意図していないファイルに、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi アクセス可能になってしまうような権限を持つべきではないですし、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 同様に HTTP リクエストに対して応答するように意図していない
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 実行コードを、実行できるような権限を持つべきではないです。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバを実行するために特定の新しいユーザとグループを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定することをお薦めいたします。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi これが常に望ましいわけではありません。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 他の役割を担っているかも知れないからです。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>正確にどんなことをやっているのか、その危険性を知らないで、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi module="mpm_common">Group</directive>) を <code>root</code> に
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 設定しないでください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p><module>perchild</module> MPM では、異なるユーザ ID
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi で複数のバーチャルホストを動かすことを目的としていますが、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi と、<directive module="perchild">AssignUserID</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi module="core">VirtualHost</directive> セクションへの
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi フォールバックとを定義することになります。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>特記事項: このディレクティブを
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="core" type="section">VirtualHost</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi で使用することはサポートされなくなりました。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <program>suexec</program> 向けにサーバを設定するのであれば、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <directive module="mod_suexec">SuexecUserGroup</directive>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi を使用してください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <module>beos</module> と <module>mpmt_os2</module> MPM
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi にも存在しますが、実質的に無効で、互換性のためだけに存在します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<description>apache が起動後に chroot(8) するディレクトリ
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</description>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<syntax>ChrootDir <var>/path/to/directory</var></syntax>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<contextlist><context>server config</context></contextlist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi<module>prefork</module><module>worker</module></modulelist>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>このディレクティブは2.2.9(?)以降で利用できます。
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバ起動後、ネットからリクエストを受け付けるより前に、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi サーバは指定したディレクトリに <var>chroot(8)</var> します。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi <p>chroot 環境下でサーバを動かすのは単純ではなく、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi 特に CGI や PHP を動かしているなら、さらなるセットアップ
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi が必要であることに注意してください。 この機能を使おうとする前に、
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi chroot の動作を正しく理解しておくようにしてください。</p>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</directivesynopsis>
d14abf155341d55053c76eeec58b787a456b753bRobert Mustacchi</modulesynopsis>