mpm_common.xml.ja revision e3c18d181f501fb13debc6ebdf0dd59084cf9e9f
842ae4bd224140319ae7feec1872b93dfd491143fielding<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- English Revision: 674934:918002 (outdated) -->
6c47a7d40935c5508868904cba1e87ca783ec386niq Licensed to the Apache Software Foundation (ASF) under one or more
6c47a7d40935c5508868904cba1e87ca783ec386niq contributor license agreements. See the NOTICE file distributed with
6c47a7d40935c5508868904cba1e87ca783ec386niq this work for additional information regarding copyright ownership.
6c47a7d40935c5508868904cba1e87ca783ec386niq The ASF licenses this file to You under the Apache License, Version 2.0
6c47a7d40935c5508868904cba1e87ca783ec386niq (the "License"); you may not use this file except in compliance with
6c47a7d40935c5508868904cba1e87ca783ec386niq the License. You may obtain a copy of the License at
6c47a7d40935c5508868904cba1e87ca783ec386niq Unless required by applicable law or agreed to in writing, software
6c47a7d40935c5508868904cba1e87ca783ec386niq distributed under the License is distributed on an "AS IS" BASIS,
6c47a7d40935c5508868904cba1e87ca783ec386niq WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
6c47a7d40935c5508868904cba1e87ca783ec386niq See the License for the specific language governing permissions and
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes limitations under the License.
6c47a7d40935c5508868904cba1e87ca783ec386niq<description>二つ以上のマルチプロセッシングモジュール (MPM)
6c47a7d40935c5508868904cba1e87ca783ec386niqで実装されているディレクティブのコレクション</description>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<description>複数の子プロセスがネットワークソケットでリクエストを
6c47a7d40935c5508868904cba1e87ca783ec386niqaccept しようとしているときに、Apache がそれらの子プロセスを直列化するために
6c47a7d40935c5508868904cba1e87ca783ec386niq使う方法</description>
e2b6e4d548316b37b2763c7ca7c2b54f5e210ac4wrowe<contextlist><context>server config</context></contextlist>
e2b6e4d548316b37b2763c7ca7c2b54f5e210ac4wrowe<modulelist><module>leader</module><module>perchild</module>
5bfaaf573bacb45c1cf290ce85ecc676587e8a64jim<module>prefork</module><module>threadpool</module><module>worker</module>
e2b6e4d548316b37b2763c7ca7c2b54f5e210ac4wrowe</modulelist>
6c47a7d40935c5508868904cba1e87ca783ec386niq ネットワークソケットのリクエストを accept しようとしている複数の子プロセスを
6c47a7d40935c5508868904cba1e87ca783ec386niq Apache が直列化するために使う方法(と必要ならロックファイルの場所)を設定します。
6c47a7d40935c5508868904cba1e87ca783ec386niq Apache 2.0 以前は、このメソッドはコンパイル時にのみ選択できました。
6c47a7d40935c5508868904cba1e87ca783ec386niq 最適な方法は、アーキテクチャやプラットホームに大きく依存します。
6c47a7d40935c5508868904cba1e87ca783ec386niq 詳細に関しては、<a
6c47a7d40935c5508868904cba1e87ca783ec386niq ドキュメントをご覧下さい。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq に設定されていれば、コンパイル時に選択されたデフォルト値が使われます。
6c47a7d40935c5508868904cba1e87ca783ec386niq 他の使用可能なメソッドの一覧は下にあります。
6c47a7d40935c5508868904cba1e87ca783ec386niq 全てのメソッドが全てのプラットホームで使用可能であるわけではない、
6c47a7d40935c5508868904cba1e87ca783ec386niq ということに注意してください。
6c47a7d40935c5508868904cba1e87ca783ec386niq 使用可能でないメソッドが指定された場合は、
6c47a7d40935c5508868904cba1e87ca783ec386niq 使用可能なメソッドの一覧を含んだメッセージが
6c47a7d40935c5508868904cba1e87ca783ec386niq エラーログに出力されます。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dt><code>flock<<var>:/path/to/lockfile</var>></code></dt>
6c47a7d40935c5508868904cba1e87ca783ec386niq パラメータで定義したファイルのロックに、
6c47a7d40935c5508868904cba1e87ca783ec386niq ロックファイルの指定には <directive module="mpm_common">LockFile</directive>
6c47a7d40935c5508868904cba1e87ca783ec386niq ディレクティブを使うことも出来ます(非推奨です)。</dd>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dt><code>fcntl<<var>:/path/to/lockfile</var>></code></dt>
6c47a7d40935c5508868904cba1e87ca783ec386niq パラメータで定義したファイルのロックに、
6c47a7d40935c5508868904cba1e87ca783ec386niq ロックファイルの指定には <directive module="mpm_common">LockFile</directive>
6c47a7d40935c5508868904cba1e87ca783ec386niq ディレクティブを使うことも出来ます(非推奨です)。</dd>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dt><code>file<<var>:/path/to/lockfile</var>></code></dt>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dd>使用できるファイルロックルーチンの中で最適なものを使います。
7c2df38555e33d4c30de9973722128cc9646a1b3sf 一つをサポートしている場合のみ使用可能です。</dd>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dd>使用できるセマフォルーチンの中で最適なものを使います。
6c47a7d40935c5508868904cba1e87ca783ec386niq 具体的には、Posix 互換セマフォが使用可能な場合はそれを使い、そうでない場合は
6c47a7d40935c5508868904cba1e87ca783ec386niq SystemV IPC 形式のセマフォを試します。
6c47a7d40935c5508868904cba1e87ca783ec386niq 一つをサポートしている場合のみ使用可能です。</dd>
6c47a7d40935c5508868904cba1e87ca783ec386niq <dd>POSIX Threads (PThreads) 規格で実装されている
6c47a7d40935c5508868904cba1e87ca783ec386niq POSIX 排他処理を使います。</dd>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>コンパイル時にシステムのデフォルトに選ばれたものが何かを見たい場合は、
6c47a7d40935c5508868904cba1e87ca783ec386niq <directive module="core">LogLevel</directive> を <code>debug</code>
6c47a7d40935c5508868904cba1e87ca783ec386niq が <directive module="core">ErrorLog</directive> に書き込まれます。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq 保持しているときに異常終了した場合、サーバはリクエストへの応答を
6c47a7d40935c5508868904cba1e87ca783ec386niq 停止してしまいます。これが発生した場合は、サーバを復旧させるためには
6c47a7d40935c5508868904cba1e87ca783ec386niq 手動で再起動させる必要があります。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>Solaris は例外で、Apache も使用している、子プロセスが mutex を
6c47a7d40935c5508868904cba1e87ca783ec386niq 保持して異常終了した後に mutex を復旧させるための機構を提供をしています。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>御使用のシステムが <code>pthread_mutexattr_setrobust_np()</code> 関数を
6c47a7d40935c5508868904cba1e87ca783ec386niq 可能性があります。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq</directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<directivesynopsis>
185aa71728867671e105178b4c66fbc22b65ae26sf<description>Apache がコアダンプする前に移動を試みるディレクトリ
6c47a7d40935c5508868904cba1e87ca783ec386niq</description>
6c47a7d40935c5508868904cba1e87ca783ec386niq<contextlist><context>server config</context></contextlist>
185aa71728867671e105178b4c66fbc22b65ae26sf<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
6c47a7d40935c5508868904cba1e87ca783ec386niq<module>threadpool</module><module>worker</module></modulelist>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>Apache がコアダンプする前に移動を試みるディレクトリを制御します。
6c47a7d40935c5508868904cba1e87ca783ec386niq ディレクトリですが、このディレクトリはサーバの実行されているユーザ権限で
6c47a7d40935c5508868904cba1e87ca783ec386niq 書き込み可能であるべきではないので、通常はコアダンプは書き込まれません。
6c47a7d40935c5508868904cba1e87ca783ec386niq デバッグのためにコアダンプが必要であれば、
185aa71728867671e105178b4c66fbc22b65ae26sf このディレクティブを使って他の位置にコアダンプを書き出すようにできます。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>Apache が root として起動されて、別のユーザの権限に以降した場合は
6c47a7d40935c5508868904cba1e87ca783ec386niq Linux のカーネルはディレクトリがプロセスの権限で書き込み可能な場合でさえも
6c47a7d40935c5508868904cba1e87ca783ec386niq Linux 2.4 以降ではコアダンプを行なうように再指定しますが、それは
6c47a7d40935c5508868904cba1e87ca783ec386niq</directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<contextlist><context>server config</context></contextlist>
6c47a7d40935c5508868904cba1e87ca783ec386niq<modulelist><module>leader</module><module>perchild</module>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>安全上の理由から、<code>--enable-exception-hook</code> configure
6c47a7d40935c5508868904cba1e87ca783ec386niq オプションを有効にした場合にのみ、このディレクティブを利用できます。
6c47a7d40935c5508868904cba1e87ca783ec386niq 外部モジュールをプラグインして、子がクラッシュした後に何か実行できるような
6c47a7d40935c5508868904cba1e87ca783ec386niq フックを有効にします。</p>
d56bacbfefa5aa883ce5162a115747372fc38d13chrisd <p>このような外部モジュールは、既に二つ存在していて、
6c47a7d40935c5508868904cba1e87ca783ec386niq <code>mod_whatkilledus</code> と <code>mod_backtrace</code>
185aa71728867671e105178b4c66fbc22b65ae26sf がこのフックを活用します。これらの詳細については Jeff Trawick
6c47a7d40935c5508868904cba1e87ca783ec386niq さんの <a href="http://www.apache.org/~trawick/exception_hook.html"
d56bacbfefa5aa883ce5162a115747372fc38d13chrisd</directivesynopsis>
d56bacbfefa5aa883ce5162a115747372fc38d13chrisd<directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<syntax>GracefulShutDownTimeout <var>seconds</var></syntax>
6c47a7d40935c5508868904cba1e87ca783ec386niq<contextlist><context>server config</context></contextlist>
185aa71728867671e105178b4c66fbc22b65ae26sf<modulelist><module>prefork</module><module>worker</module>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes サーバーが "graceful-stop" シグナルを受け取ってから現在の
6c47a7d40935c5508868904cba1e87ca783ec386niq リクエストの処理を最大で何秒間続けるかを指定します。</p>
d56bacbfefa5aa883ce5162a115747372fc38d13chrisd <p>この値をゼロに設定すると、処理中として残っているリクエストが
d56bacbfefa5aa883ce5162a115747372fc38d13chrisd 全て完了するまでサーバーは終了しません。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq</directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<contextlist><context>server config</context></contextlist>
6c47a7d40935c5508868904cba1e87ca783ec386niq<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
6c47a7d40935c5508868904cba1e87ca783ec386niq<module>threadpool</module><module>worker</module></modulelist>
6c47a7d40935c5508868904cba1e87ca783ec386niq<compatibility>Apache 2.0 以降で、グローバル設定でのみ有効です。</compatibility>
6c47a7d40935c5508868904cba1e87ca783ec386niq リクエストに応答する際に所属しておくグループを設定します。
6c47a7d40935c5508868904cba1e87ca783ec386niq このディレクティブを使用するためには、
6c47a7d40935c5508868904cba1e87ca783ec386niq 非 root ユーザでサーバを起動した場合は、指定したグループに変化できずに、
6c47a7d40935c5508868904cba1e87ca783ec386niq 結果的に起動したユーザの属するグループで実行されることになります。
6c47a7d40935c5508868904cba1e87ca783ec386niq Group www-group
6c47a7d40935c5508868904cba1e87ca783ec386niq </example>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>サーバを実行するために特定の新しいグループを設定することを
185aa71728867671e105178b4c66fbc22b65ae26sf 可能であったり望ましい訳では必ずしもありません。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>正確にどんなことをやっているのか、その危険性を知らないで、
185aa71728867671e105178b4c66fbc22b65ae26sf <p>特記事項: このディレクティブを
6c47a7d40935c5508868904cba1e87ca783ec386niq <directive module="core" type="section">VirtualHost</directive>
6c47a7d40935c5508868904cba1e87ca783ec386niq で使用することはサポートされなくなりました。Apache 2.0 で
6c47a7d40935c5508868904cba1e87ca783ec386niq <directive module="mod_suexec">SuexecUserGroup</directive>
6c47a7d40935c5508868904cba1e87ca783ec386niq を使用してください。</p>
97cc46935ec496b83fef9d6feb094d706c895b3bsf にも存在しますが、実質的に無効で、互換性のためだけに存在します。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq</directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<directivesynopsis>
6c47a7d40935c5508868904cba1e87ca783ec386niq<description>デーモンのプロセス ID
6c47a7d40935c5508868904cba1e87ca783ec386niqをサーバが記録するためのファイル</description>
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd<contextlist><context>server config</context></contextlist>
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd<modulelist><module>beos</module><module>leader</module>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<module>mpm_winnt</module><module>mpmt_os2</module>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<module>threadpool</module><module>worker</module></modulelist>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes デーモンのプロセス ID をサーバが記録するファイルを設定します。
6c47a7d40935c5508868904cba1e87ca783ec386niq ファイル名が絶対パスでない場合は、
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes からの相対的なものとして扱われます。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq や <directive module="mod_log_config">TransferLog</directive>
6c47a7d40935c5508868904cba1e87ca783ec386niq を閉じて開き直したり、設定ファイルを
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes 再読込したりさせるために、サーバにシグナルを送ることができると
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes これは SIGHUP (kill -1) シグナルを <directive>PidFile</directive>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes に書かれているプロセス ID に送ることでできます。</p>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes <a href="/misc/security_tips.html#serverroot">セキュリティ</a>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes と全く同じ注意点があります。</p>
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd <p>Apache 2 では、
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd スクリプトのみを使用してサーバの (再) 起動や停止を
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd 行なうことを推奨しています。</p>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes</directivesynopsis>
97cc46935ec496b83fef9d6feb094d706c895b3bsf<directivesynopsis>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<description>サーバが listen するIP アドレスとポート番号</description>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var> [<var>protocol</var>]</syntax>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<contextlist><context>server config</context></contextlist>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<modulelist><module>beos</module><module>leader</module>
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd<module>mpm_netware</module><module>mpm_winnt</module>
db027b0af55a7fa31f2e1659368d606a8b860bb0chrisd<module>prefork</module><module>threadpool</module><module>worker</module>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes</modulelist>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes<compatibility>Apache 2.0 から必須ディレクティブ。<var>protocol</var>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes引数は 2.1.5 で追加。</compatibility>
97cc46935ec496b83fef9d6feb094d706c895b3bsf が特定の IP アドレスやポート番号だけを listen するように指定します。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes デフォルトでは全ての IP インターフェースのリクエストに応答します。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes 現在は必須のディレクティブとなりました。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes もし設定ファイルになければ、サーバは起動に失敗します。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes これは以前のバージョンの Apache から変更のあった部分です。</p>
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes <p><directive>Listen</directive> ディレクティブでは、特定のポートあるいは
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes アドレスとポートの組み合わせから入ってくるリクエストに対して
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes 応答するように指定します。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes もしポート番号だけが指定された場合は、サーバは全インターフェースの
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes 指定されたポート番号に対して listen します。
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes IP アドレスがポートとともに指定された場合は、
97cc46935ec496b83fef9d6feb094d706c895b3bsf サーバは指定されたポートとインターフェースに対して listen
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>複数のアドレスとポートに対して listen するように、
2e242dca7111f99d54dd144b7b8418d88d560032chrisd サーバは列挙されたアドレスとポート全てからのリクエストに対して
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd <p>例えば、サーバが 80 番ポートと 8000 番ポートの両方の
2e242dca7111f99d54dd144b7b8418d88d560032chrisd コネクションを受け入れる場合は、次のようにします。</p>
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd Listen 80<br />
2e242dca7111f99d54dd144b7b8418d88d560032chrisd Listen 8000
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd <p>二つの特定のインターフェースとポート番号からのコネクションを
6c47a7d40935c5508868904cba1e87ca783ec386niq 受け入れるようにするには、次のようにします。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq Listen 192.170.2.1:80<br />
6c47a7d40935c5508868904cba1e87ca783ec386niq Listen 192.170.2.5:8000
6c47a7d40935c5508868904cba1e87ca783ec386niq </example>
6c47a7d40935c5508868904cba1e87ca783ec386niq <p>IPv6 アドレスは角括弧で囲まなければなりません。
6c47a7d40935c5508868904cba1e87ca783ec386niq 例えば次の例のようにです。</p>
6c47a7d40935c5508868904cba1e87ca783ec386niq Listen [2001:db8::a00:20ff:fea7:ccea]:80
6c47a7d40935c5508868904cba1e87ca783ec386niq </example>