Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 20728 invoked from network); 2 Apr 2008 16:51:14 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 2 Apr 2008 16:51:14 -0000 Received: (qmail 24110 invoked by uid 500); 2 Apr 2008 16:51:06 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 23967 invoked by uid 500); 2 Apr 2008 16:51:05 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 23746 invoked by uid 99); 2 Apr 2008 16:51:05 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 02 Apr 2008 09:51:04 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 02 Apr 2008 16:50:25 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 161611A987D; Wed, 2 Apr 2008 09:49:49 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r643967 [25/42] - in /httpd/httpd/branches/2.0.x/docs/manual: ./ developer/ howto/ mod/ ssl/ style/ style/xsl/util/ vhosts/ Date: Wed, 02 Apr 2008 16:47:12 -0000 To: cvs@httpd.apache.org From: nd@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080402164949.161611A987D@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html?rev=643967&r1=643966&r2=643967&view=diff ============================================================================== --- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html (original) +++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html Wed Apr 2 09:46:34 2008 @@ -2,9 +2,9 @@ Content-Language: en Content-type: text/html; charset=ISO-8859-1 -URI: mod_info.html.ja.euc-jp +URI: mod_info.html.ja.utf8 Content-Language: ja -Content-type: text/html; charset=EUC-JP +Content-type: text/html; charset=UTF-8 URI: mod_info.html.ko.euc-kr Content-Language: ko Copied: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.utf8 (from r643946, httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.euc-jp) URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.utf8?p2=httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.utf8&p1=httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.euc-jp&r1=643946&r2=643967&rev=643967&view=diff ============================================================================== --- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.euc-jp [euc-jp] (original) +++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_info.html.ja.utf8 [iso-8859-1] Wed Apr 2 09:46:34 2008 @@ -1,25 +1,25 @@ - + -mod_info - Apache HTTP サーバ +mod_info - Apache HTTP サーバ
-

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

-

Apache HTTP サーバ バージョン 2.0

+

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

+

Apache HTTP サーバ バージョン 2.0

<-
+Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.0 > モジュール
-

Apache モジュール mod_info

+

Apache モジュール mod_info

Available Languages:  en  |  ja  | @@ -27,15 +27,15 @@

This translation may be out of date. Check the English version for recent changes.
- - - -
説明:サーバの設定の包括的な概観を提供する
ステータス:Extension
モジュール識別子:info_module
ソースファイル:mod_info.c
-

概要

+ + + +
説明:サーバの設定の包括的な概観を提供する
ステータス:Extension
モジュール識別子:info_module
ソースファイル:mod_info.c
+

概要

-

mod_info を設定するには、以下を httpd.conf - ファイルに加えます。

+

mod_info を設定するには、以下を httpd.conf + ファイルに加えます。

<Location /server-info>
@@ -43,60 +43,60 @@ </Location>

-

サーバ設定の情報へのアクセスを制限するために、 +

サーバ設定の情報へのアクセスを制限するために、 <Location> - ディレクティブの中に <Limit> - 節を入れるとよいかもしれません。

+ ディレクティブの中に <Limit> + 節を入れるとよいかもしれません。

-

一旦設定すると、http://your.host.dom/server-info - をアクセスすることでサーバの情報を得られるようになります。

+

一旦設定すると、http://your.host.dom/server-info + をアクセスすることでサーバの情報を得られるようになります。

-

このモジュールは実行時に設定ファイルを読み込みます。 - サーバの設定ファイルが最後にサーバに読み込まれた後に変更されている - 場合には、表示されている内容は実行されているサーバの設定を反映して - いないかもしれないことに注意してください。 - また、設定ファイルはサーバが実行されているユーザの権限で - 読み込み許可が与えられている必要があります +

このモジュールは実行時に設定ファイルを読み込みます。 + サーバの設定ファイルが最後にサーバに読み込まれた後に変更されている + 場合には、表示されている内容は実行されているサーバの設定を反映して + いないかもしれないことに注意してください。 + また、設定ファイルはサーバが実行されているユーザの権限で + 読み込み許可が与えられている必要があります (User - ディレクティブを参照してください)。 - でなければ、ディレクティブの設定は表示されません。

+ ディレクティブを参照してください)。 + でなければ、ディレクティブの設定は表示されません。

mod_info - がサーバに組み込まれている場合は、ディレクトリ毎のファイル - (例えば、.htaccess) を含むすべての設定ファイルで - ハンドラを使用可能であるということにも注意してください。 - これは、あなたのサイトではセキュリティに関連した問題があるかもしれません。 + がサーバに組み込まれている場合は、ディレクトリ毎のファイル + (例えば、.htaccess) を含むすべての設定ファイルで + ハンドラを使用可能であるということにも注意してください。 + これは、あなたのサイトではセキュリティに関連した問題があるかもしれません。

-

特に、このモジュールはシステムパス、ユーザ名/パスワード、 - データベース名など、他の Apache モジュールの設定ディレクティブから - セキュリティ上微妙な情報を漏らす可能性があります。 - このモジュールの動作方法のせいで、情報の流出を防ぐ方法はありません。 - ですから、このモジュールはちゃんとアクセスが制御された環境で、 - 注意して使ってください。

+

特に、このモジュールはシステムパス、ユーザ名/パスワード、 + データベース名など、他の Apache モジュールの設定ディレクティブから + セキュリティ上微妙な情報を漏らす可能性があります。 + このモジュールの動作方法のせいで、情報の流出を防ぐ方法はありません。 + ですから、このモジュールはちゃんとアクセスが制御された環境で、 + 注意して使ってください。

-

ディレクティブ

+

ディレクティブ

top
-

AddModuleInfo ディレクティブ

+

AddModuleInfo ディレクティブ

- - - - - - + + + + + +
説明:server-info ハンドラにより表示されるモジュールの情報に -追加の情報を付け加える
構文:AddModuleInfo module-name string
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Extension
モジュール:mod_info
互換性:Apache 1.3 以降
説明:server-info ハンドラにより表示されるモジュールの情報に +追加の情報を付け加える
構文:AddModuleInfo module-name string
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Extension
モジュール:mod_info
互換性:Apache 1.3 以降
-

これは、string の内容がモジュール module-name - の追加情報 として HTML - として解釈され、表示されるようにします。例:

+

これは、string の内容がモジュール module-name + の追加情報 として HTML + として解釈され、表示されるようにします。例:

AddModuleInfo mod_authn_file.c 'See <a \
@@ -114,5 +114,5 @@  ko 

+

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html?rev=643967&r1=643966&r2=643967&view=diff ============================================================================== --- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html (original) +++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html Wed Apr 2 09:46:34 2008 @@ -2,9 +2,9 @@ Content-Language: en Content-type: text/html; charset=ISO-8859-1 -URI: mod_log_config.html.ja.euc-jp +URI: mod_log_config.html.ja.utf8 Content-Language: ja -Content-type: text/html; charset=EUC-JP +Content-type: text/html; charset=UTF-8 URI: mod_log_config.html.ko.euc-kr Content-Language: ko Copied: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.utf8 (from r643946, httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.euc-jp) URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.utf8?p2=httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.utf8&p1=httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.euc-jp&r1=643946&r2=643967&rev=643967&view=diff ============================================================================== --- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.euc-jp [euc-jp] (original) +++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_log_config.html.ja.utf8 [iso-8859-1] Wed Apr 2 09:46:34 2008 @@ -1,25 +1,25 @@ - + -mod_log_config - Apache HTTP サーバ +mod_log_config - Apache HTTP サーバ
-

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

-

Apache HTTP サーバ バージョン 2.0

+

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

+

Apache HTTP サーバ バージョン 2.0

<-
+Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.0 > モジュール
-

Apache モジュール mod_log_config

+

Apache モジュール mod_log_config

Available Languages:  en  |  ja  | @@ -27,304 +27,304 @@

This translation may be out of date. Check the English version for recent changes.
- - - -
説明:サーバへのリクエストのロギング
ステータス:Base
モジュール識別子:log_config_module
ソースファイル:mod_log_config.c
-

概要

+ + + +
説明:サーバへのリクエストのロギング
ステータス:Base
モジュール識別子:log_config_module
ソースファイル:mod_log_config.c
+

概要

- このモジュールはクライアントのリクエストを柔軟にログ収集する機能を - 提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接 - 書いたり、外部プログラムに渡したりすることができます。個々のリクエストを - 特徴に応じてログに書いたり書かなかったりできるように、条件による - ログ収集も提供されています。

- -

このモジュールは三つのディレクティブ提供します: - ログファイルを作成するための TransferLog, - 新しい書式を 定義する LogFormat, - ログファイルと 書式を一度に定義する CustomLog です。 - 各リクエストが複数回ログ収集されるようにするために - TransferLog ディレクティブと + このモジュールはクライアントのリクエストを柔軟にログ収集する機能を + 提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接 + 書いたり、外部プログラムに渡したりすることができます。個々のリクエストを + 特徴に応じてログに書いたり書かなかったりできるように、条件による + ログ収集も提供されています。

+ +

このモジュールは三つのディレクティブ提供します: + ログファイルを作成するための TransferLog, + 新しい書式を 定義する LogFormat, + ログファイルと 書式を一度に定義する CustomLog です。 + 各リクエストが複数回ログ収集されるようにするために + TransferLog ディレクティブと CustomLog - ディレクティブは複数回使用することができます。

+ ディレクティブは複数回使用することができます。

-

ディレクティブ

+
top
-

カスタムログ書式

+

カスタムログ書式

-

LogFormat ディレクティブと +

LogFormat ディレクティブと CustomLog - ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの - リクエストがログファイルにログ収集されます。その文字列には - ログファイルにそのまま - 書かれる文字列や、それぞれ改行とタブを現す C 言語 - 形式の制御文字 "\n" と "\t" - とを含めることができます。そのまま出力させたい引用符とバックスラッシュは - バックスラッシュでエスケープする必要があります。

- -

リクエストの特徴そのものは "%" - ディレクティブを書式の文字列に書くことで - ログ収集されます。"%" - ディレクティブはログファイル中では以下のような - 値で置換されます:

+ ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの + リクエストがログファイルにログ収集されます。その文字列には + ログファイルにそのまま + 書かれる文字列や、それぞれ改行とタブを現す C 言語 + 形式の制御文字 "\n" と "\t" + とを含めることができます。そのまま出力させたい引用符とバックスラッシュは + バックスラッシュでエスケープする必要があります。

+ +

リクエストの特徴そのものは "%" + ディレクティブを書式の文字列に書くことで + ログ収集されます。"%" + ディレクティブはログファイル中では以下のような + 値で置換されます:

- - +
フォーマット文字列説明
+ - + - + - + - + - + - + - + - + - + - + - + - + - + ディレクティブが On に設定されていない限り、 + - になります。 - + - + - + - + - + - - + - + - - + - + - + - - + - + - + - + 構文と衝突していました。)

- + - +
フォーマット文字列説明
%%パーセント記号 (Apache 2.0.44 以降)
パーセント記号 (Apache 2.0.44 以降)
%...aリモート IP アドレス
リモート IP アドレス
%...Aローカル IP アドレス
ローカル IP アドレス
%...BHTTP ヘッダ以外の送られたバイト数
HTTP ヘッダ以外の送られたバイト数
%...bHTTP ヘッダ以外の送られたバイト数。CLF 書式。 - すなわち、1 バイトも送られなかったときは 0 ではなく、 - '-' になる
HTTP ヘッダ以外の送られたバイト数。CLF 書式。 + すなわち、1 バイトも送られなかったときは 0 ではなく、 + '-' になる
%...{Foobar}Cサーバに送られたリクエスト中のクッキー Foobar の値
サーバに送られたリクエスト中のクッキー Foobar の値
%...Dリクエストを処理するのにかかった時間、ミリ秒単位
リクエストを処理するのにかかった時間、ミリ秒単位
%...{FOOBAR}e環境変数 FOOBAR の内容
環境変数 FOOBAR の内容
%...fファイル名
ファイル名
%...hリモートホスト
リモートホスト
%...Hリクエストプロトコル
リクエストプロトコル
%...{Foobar}iサーバに送られたリクエストの Foobar: - ヘッダの内容
サーバに送られたリクエストの Foobar: + ヘッダの内容
%...l(identd からもし提供されていれば) リモートログ名。 - これは + (identd からもし提供されていれば) リモートログ名。 + これは IdentityCheck - ディレクティブが On に設定されていない限り、 - - になります。
%...mリクエストメソッド
リクエストメソッド
%...{Foobar}n他のモジュールからのメモ Foobar の内容
他のモジュールからのメモ Foobar の内容
%...{Foobar}o応答の Foobar: ヘッダの内容
応答の Foobar: ヘッダの内容
%...pリクエストを扱っているサーバの正式なポート
リクエストを扱っているサーバの正式なポート
%...Pリクエストを扱った子プロセスのプロセス ID
リクエストを扱った子プロセスのプロセス ID
%...{format}Pリクエストを扱ったワーカーのプロセス ID かスレッド ID。 - format として有効な値は pid と tid - (Apache 2.0.46 以降) + リクエストを扱ったワーカーのプロセス ID かスレッド ID。 + format として有効な値は pid と tid + (Apache 2.0.46 以降)
%...q問い合せ文字列 (存在する場合は前に ? が追加される。 - そうでない場合は空文字列)
問い合せ文字列 (存在する場合は前に ? が追加される。 + そうでない場合は空文字列)
%...rリクエストの最初の行
リクエストの最初の行
%...sステータス。内部でリダイレクトされたリクエストは、元々の - リクエストのステータス --- 最後のステータスは %...>s + ステータス。内部でリダイレクトされたリクエストは、元々の + リクエストのステータス --- 最後のステータスは %...>s
%...t時刻。CLF の時刻の書式 (標準の英語の書式)
時刻。CLF の時刻の書式 (標準の英語の書式)
%...{format}tformat で与えられた書式による時刻。format は - strftime (3) の - 書式である必要がある。(地域化されている可能性がある)
format で与えられた書式による時刻。format は + strftime (3) の + 書式である必要がある。(地域化されている可能性がある)
%...Tリクエストを扱うのにかかった時間、秒単位
リクエストを扱うのにかかった時間、秒単位
%...uリモートユーザ (認証によるもの。ステータス (%s) が - 401 のときは意味がないものである可能性がある) + リモートユーザ (認証によるもの。ステータス (%s) が + 401 のときは意味がないものである可能性がある)
%...Uリクエストされた URL パス。クエリ文字列は含まない
リクエストされた URL パス。クエリ文字列は含まない
%...vリクエストを扱っているサーバの正式な ServerName
リクエストを扱っているサーバの正式な ServerName
%...VUseCanonicalName の設定によるサーバ名
UseCanonicalName の設定によるサーバ名
%...X応答が完了したときの接続ステータス: + 応答が完了したときの接続ステータス: - + - + - +
X =応答が完了する前に接続が異常終了
応答が完了する前に接続が異常終了
+ =応答が送られた後に接続を持続することが可能
応答が送られた後に接続を持続することが可能
- = 応答が送られた後に接続が切られる
応答が送られた後に接続が切られる
-

(このディレクティブは Apache - 1.3 の後期のバージョンでは %...c に割り当てられて - いましたが、これは歴史的に ssl が使用している +

(このディレクティブは Apache + 1.3 の後期のバージョンでは %...c に割り当てられて + いましたが、これは歴史的に ssl が使用している %...{var}c - 構文と衝突していました。)

%...Iリクエストとヘッダを含む、受け取ったバイト数。 - 0 にはならない。 - これを使用するためには mod_logio が必要
リクエストとヘッダを含む、受け取ったバイト数。 + 0 にはならない。 + これを使用するためには mod_logio が必要
%...Oヘッダを含む、送信したバイト数。0 にはならない。 - これを使用するためには mod_logio が必要
ヘッダを含む、送信したバイト数。0 にはならない。 + これを使用するためには mod_logio が必要
-

"..." は何もないか (例えば、 - "%h %u %r %s %b" のように)、 - その項目を含めるかどうかの条件 (もし条件に合わなかったときは - その項目は "-" になります) にすることができます。条件の形式は - HTTP ステータスコードのリストで、前に "!" を付けることもできます。 - ですから、"%400,501{User-agent}i" は 400 エラーと 501 エラー - (Bad Request と Not Implemented) のときのみ User-agent: - をログ収集します。 - "%!200,304,302{Referer}i" は普通のステータスを返さなかった - すべてのリクエストで Referer: をログ収集します。

- -

修飾子 "<" と ">" は内部リダイレクトされたリクエストのログに - 元のリクエストか最終的なリクエストのどちらを使用するかを - 指定するために使います。デフォルトでは、% ディレクティブの - %s, %U, %T, %D, %r は元のリクエストを、他は最終的なリクエストを - 使用します。例えば、リクエストの最終ステータスを記録するには - %>s を、内部的に認証されていないリソースへリダイレクトされた - リクエストで元のリクエストで認証されたユーザを記録するためには - %<u を使うことができます。

+

"..." は何もないか (例えば、 + "%h %u %r %s %b" のように)、 + その項目を含めるかどうかの条件 (もし条件に合わなかったときは + その項目は "-" になります) にすることができます。条件の形式は + HTTP ステータスコードのリストで、前に "!" を付けることもできます。 + ですから、"%400,501{User-agent}i" は 400 エラーと 501 エラー + (Bad Request と Not Implemented) のときのみ User-agent: + をログ収集します。 + "%!200,304,302{Referer}i" は普通のステータスを返さなかった + すべてのリクエストで Referer: をログ収集します。

+ +

修飾子 "<" と ">" は内部リダイレクトされたリクエストのログに + 元のリクエストか最終的なリクエストのどちらを使用するかを + 指定するために使います。デフォルトでは、% ディレクティブの + %s, %U, %T, %D, %r は元のリクエストを、他は最終的なリクエストを + 使用します。例えば、リクエストの最終ステータスを記録するには + %>s を、内部的に認証されていないリソースへリダイレクトされた + リクエストで元のリクエストで認証されたユーザを記録するためには + %<u を使うことができます。

-

httpd 2.0 の 1.3.25 より前のバージョンでは、 +

httpd 2.0 の 1.3.25 より前のバージョンでは、 %...r, %...i, - %...o の文字列は - エスケープされていなかったことに - 注意してください。これは主に Common Log Format からの要求によるものです。 - これは、クライアントがログに制御文字を挿入することができるということで、 - 生のログファイルを扱うときには非常に注意が必要でした。

- -

セキュリティ上の理由により 2.0.46 より印字不可能な文字と - 他の特別な文字は、ほとんど \xhh という - 文字列でエスケープされるようになりました。ここで、hh は - そのままのバイトの値の 16 進での値です。この規則の例外には、 - バックスラッシュを使ってエスケープされる " と \ と、 - C 形式の表記法が使われる空白文字 (\n, \t など) が - あります。

+ %...o の文字列は + エスケープされていなかったことに + 注意してください。これは主に Common Log Format からの要求によるものです。 + これは、クライアントがログに制御文字を挿入することができるということで、 + 生のログファイルを扱うときには非常に注意が必要でした。

+ +

セキュリティ上の理由により 2.0.46 より印字不可能な文字と + 他の特別な文字は、ほとんど \xhh という + 文字列でエスケープされるようになりました。ここで、hh は + そのままのバイトの値の 16 進での値です。この規則の例外には、 + バックスラッシュを使ってエスケープされる " と \ と、 + C 形式の表記法が使われる空白文字 (\n, \t など) が + あります。

-

よく使われるフォーマット文字列は:

+

よく使われるフォーマット文字列は:

Common Log Format (CLF)
"%h %l %u %t \"%r\" %>s %b"
-
バーチャルホスト付き Common Log Format
+
バーチャルホスト付き Common Log Format
"%v %h %l %u %t \"%r\" %>s %b"
-
NCSA extended/combined ログ書式
+
NCSA extended/combined ログ書式
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
-
Referer ログ書式
+
Referer ログ書式
"%{Referer}i -> %U"
-
Agent (ブラウザ) ログ書式
+
Agent (ブラウザ) ログ書式
"%{User-agent}i"
-

%v と %p にはそれぞれ、 - リクエストを扱っているサーバの正規化された - ServerName と Listen が使われるということに注意してください。 - これは UseCanonicalName の - 設定に関わらず、常にそうなります。そうしないとどの - ホストが実際にリクエストを扱ったのかを知るために、 - ログ解析プログラムがバーチャルホストのマッチングをとるアルゴリズム全体を - 再実装しなければならなくなるからです。

+

%v と %p にはそれぞれ、 + リクエストを扱っているサーバの正規化された + ServerName と Listen が使われるということに注意してください。 + これは UseCanonicalName の + 設定に関わらず、常にそうなります。そうしないとどの + ホストが実際にリクエストを扱ったのかを知るために、 + ログ解析プログラムがバーチャルホストのマッチングをとるアルゴリズム全体を + 再実装しなければならなくなるからです。

top
-

セキュリティに関して

-

ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで - 書き込み可能なときにセキュリティの問題が発生する理由の詳細はセキュリティのこつ - を参照してください。

+

セキュリティに関して

+

ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで + 書き込み可能なときにセキュリティの問題が発生する理由の詳細はセキュリティのこつ + を参照してください。

top
-

CookieLog ディレクティブ

+

CookieLog ディレクティブ

- - - - - - + + + + + +
説明:クッキングのロギングのためのファイル名を設定する
構文:CookieLog filename
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
互換性:このディレクティブは非推奨
説明:クッキングのロギングのためのファイル名を設定する
構文:CookieLog filename
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
互換性:このディレクティブは非推奨

CookieLog - ディレクティブはクッキーのロギングのためのファイル名を - 設定します。filename は ServerRoot - からの相対パスです。このディレクティブは mod_cookies との互換性のためだけに - 存在し、使用は推奨されていません。

+ ディレクティブはクッキーのロギングのためのファイル名を + 設定します。filename は ServerRoot + からの相対パスです。このディレクティブは mod_cookies との互換性のためだけに + 存在し、使用は推奨されていません。

top
-

CustomLog ディレクティブ

+

CustomLog ディレクティブ

- - + - - - + + +
説明:ログファイルの名前と書式を設定する
構文:CustomLog file|pipe +
説明:ログファイルの名前と書式を設定する
構文:CustomLog file|pipe format|nickname [env=[!]environment-variable]
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
-

CustomLog ディレクティブはサーバへのリクエストを - ログ収集するために使われます。ログの書式が指定され、 - 環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。

+

CustomLog ディレクティブはサーバへのリクエストを + ログ収集するために使われます。ログの書式が指定され、 + 環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。

-

ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を - とることができます:

+

ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を + とることができます:

file
ServerRoot - からの相対パスで表されるファイル名。
+ からの相対パスで表されるファイル名。
pipe
-
パイプ文字 "|" と、その後に標準入力からログの - 情報を受けとるプログラムへのパスが続いたもの。 +
パイプ文字 "|" と、その後に標準入力からログの + 情報を受けとるプログラムへのパスが続いたもの。 -

セキュリティ

-

もしプログラムが使用された場合、 - httpd が起動されたユーザとして実行されます。これはサーバが - root によって起動された場合は root になります。プログラムが - 安全であるように留意してください。

+

セキュリティ

+

もしプログラムが使用された場合、 + httpd が起動されたユーザとして実行されます。これはサーバが + root によって起動された場合は root になります。プログラムが + 安全であるように留意してください。

-

注

-

Unix でないプラットフォームでファイルのパスを入力しているときは、 - 使用しているプラットフォームがバックスラッシュの使用を許可していた - として、通常のスラッシュだけを使うように気をつけてください。 - 一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする - 方が良いです。

+

注

+

Unix でないプラットフォームでファイルのパスを入力しているときは、 + 使用しているプラットフォームがバックスラッシュの使用を許可していた + として、通常のスラッシュだけを使うように気をつけてください。 + 一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする + 方が良いです。

-

二つめの引数はログファイルに何が書かれるかを指定します。 - 前にある LogFormat ディレクティブにより - 定義された nickname か、ログの書式 - のところで説明されている、明示的な format 文字列の - どちらかを指定することができます。

+

二つめの引数はログファイルに何が書かれるかを指定します。 + 前にある LogFormat ディレクティブにより + 定義された nickname か、ログの書式 + のところで説明されている、明示的な format 文字列の + どちらかを指定することができます。

-

例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:

+

例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:

# CustomLog with format nickname
@@ -335,18 +335,18 @@ CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"

-

三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに - 応じてリクエストをログ収集するかどうかを制御するために使うことができます。 - 指定された環境変数がリクエストに対して - 設定されていた場合 ('env=!name' 文が使われたときは - 設定されていない場合)、リクエストがログ収集されます。

- -

環境変数は mod_setenvif モジュールと - mod_rewrite モジュールの両方もしくは - 片方を用いてリクエストごとに設定することができます。 - 例えば、サーバにあるすべての GIF 画像へのリクエストを別のログファイル - には記録したいけれど、メインログには記録したくない、というときは - 以下のものを使うことができます:

+

三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに + 応じてリクエストをログ収集するかどうかを制御するために使うことができます。 + 指定された環境変数がリクエストに対して + 設定されていた場合 ('env=!name' 文が使われたときは + 設定されていない場合)、リクエストがログ収集されます。

+ +

環境変数は mod_setenvif モジュールと + mod_rewrite モジュールの両方もしくは + 片方を用いてリクエストごとに設定することができます。 + 例えば、サーバにあるすべての GIF 画像へのリクエストを別のログファイル + には記録したいけれど、メインログには記録したくない、というときは + 以下のものを使うことができます:

SetEnvIf Request_URI \.gif$ gif-image
@@ -356,67 +356,67 @@

top
-

LogFormat ディレクティブ

+

LogFormat ディレクティブ

- - + - - - - + + + +
説明:ログファイルで使用する書式を設定する
構文:LogFormat format|nickname +
説明:ログファイルで使用する書式を設定する
構文:LogFormat format|nickname [nickname]
デフォルト:LogFormat "%h %l %u %t \"%r\" %>s %b"
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
デフォルト:LogFormat "%h %l %u %t \"%r\" %>s %b"
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
-

このディレクティブはアクセスログファイルの書式を指定します。

+

このディレクティブはアクセスログファイルの書式を指定します。

-

LogFormat ディレクティブは二つの形式のどちらかを - とることができます。最初の形式では一つの引数のみが指定され、 - 続く TransferLog - で指定されたログで使われるログの書式を設定します。この単独の引数では - 上のカスタムログ書式で説明されているように - format を明示的に指定することができます。 - もしくは、下で説明されているように前に LogFormat - ディレクティブで定義されたログの書式を nicknameを使って - 参照することもできます。

- -

LogFormat ディレクティブの二つめの形式は - format に nickname を与えます。 - フォーマット文字列全体を再び書くかわりに、 - この nickname を続きの LogFormat ディレクティブや - CustomLog ディレクティブで使うことができます。 - Nickname を定義する LogFormat ディレクティブは - 他には何もしません -- すなわち、ニックネームを定義 - するだけで、実際に書式を適用してデフォルトにするということは行ないません。 - ですから、これは続く TransferLog - ディレクティブには影響を与えません。 - さらに、LogFormat ディレクティブは既存の nickname を - 使って別の nickname を定義することはできません。Nickname には - パーセント記号 (%) が含まれていてはいけないことにも注意 - してください。

+

LogFormat ディレクティブは二つの形式のどちらかを + とることができます。最初の形式では一つの引数のみが指定され、 + 続く TransferLog + で指定されたログで使われるログの書式を設定します。この単独の引数では + 上のカスタムログ書式で説明されているように + format を明示的に指定することができます。 + もしくは、下で説明されているように前に LogFormat + ディレクティブで定義されたログの書式を nicknameを使って + 参照することもできます。

+ +

LogFormat ディレクティブの二つめの形式は + format に nickname を与えます。 + フォーマット文字列全体を再び書くかわりに、 + この nickname を続きの LogFormat ディレクティブや + CustomLog ディレクティブで使うことができます。 + Nickname を定義する LogFormat ディレクティブは + 他には何もしません -- すなわち、ニックネームを定義 + するだけで、実際に書式を適用してデフォルトにするということは行ないません。 + ですから、これは続く TransferLog + ディレクティブには影響を与えません。 + さらに、LogFormat ディレクティブは既存の nickname を + 使って別の nickname を定義することはできません。Nickname には + パーセント記号 (%) が含まれていてはいけないことにも注意 + してください。

-

例

+

例

LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common

top
-

TransferLog ディレクティブ

+

TransferLog ディレクティブ

- - - - - + + + + +
説明:ログファイルの位置を指定
構文:TransferLog file|pipe
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
説明:ログファイルの位置を指定
構文:TransferLog file|pipe
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Base
モジュール:mod_log_config
-

このディレクティブは、ログ書式を直接指定できないことと、 - 条件付きロギングが無いことを除くと、CustomLog と全く同じ引数と効果があります。 - 直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された - ニックネームを定義しない - LogFormat ディレクティブ - で定義されたものを使います。 - もし他の書式が全く指定されていないときは Common Log Format - が使われます。

+

このディレクティブは、ログ書式を直接指定できないことと、 + 条件付きロギングが無いことを除くと、CustomLog と全く同じ引数と効果があります。 + 直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された + ニックネームを定義しない + LogFormat ディレクティブ + で定義されたものを使います。 + もし他の書式が全く指定されていないときは Common Log Format + が使われます。

-

例

+

例

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log

@@ -429,5 +429,5 @@  ko 

+

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_logio.html URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_logio.html?rev=643967&r1=643966&r2=643967&view=diff ============================================================================== --- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_logio.html (original) +++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_logio.html Wed Apr 2 09:46:34 2008 @@ -2,9 +2,9 @@ Content-Language: en Content-type: text/html; charset=ISO-8859-1 -URI: mod_logio.html.ja.euc-jp +URI: mod_logio.html.ja.utf8 Content-Language: ja -Content-type: text/html; charset=EUC-JP +Content-type: text/html; charset=UTF-8 URI: mod_logio.html.ko.euc-kr Content-Language: ko