From f488bea2a93656c25d1bab5254afe0db3ee0eb1a Mon Sep 17 00:00:00 2001
From: Hiroaki Kawai <kawai@apache.org>
Date: Sat, 3 Jul 2004 07:37:50 +0000
Subject: [PATCH] update translation.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@104144 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/howto/cgi.xml.ja | 138 +++++++++++++++++++++++------------
 1 file changed, 92 insertions(+), 46 deletions(-)

diff --git a/docs/manual/howto/cgi.xml.ja b/docs/manual/howto/cgi.xml.ja
index cb39315e9a..f6b15f1926 100644
--- a/docs/manual/howto/cgi.xml.ja
+++ b/docs/manual/howto/cgi.xml.ja
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='iso-2022-jp' ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 1.9 (outdated: 1.12) -->
+<!-- English Revision: 1.12 -->
 
 <!--
  Copyright 2002-2004 The Apache Software Foundation
@@ -71,7 +71,7 @@
       ディレクティブは以下のように使用します:</p>
 
       <example>
-        ScriptAlias /cgi-bin/ /usr/local/apache/cgi-bin/
+        ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
       </example>
 
       <p>デフォルト位置に Apache をインストールしたならば、
@@ -89,12 +89,12 @@
       URL は CGI プログラムとみなされるという追加の意味を含んでいることです。
       従って、上記の例では、<code>/cgi-bin/</code>
       で始まるリソースへのあらゆるリクエストに対して、ディレクトリ
-      <code>/usr/local/apache/cgi-bin/</code> から提供し、それらを
+      <code>/usr/local/apache2/cgi-bin/</code> から提供し、それらを
       CGI プログラムとして扱うよう Apache に示します。</p>
 
       <p>例えば、URL <code>http://dev.rcbowen.com/cgi-bin/test.pl</code>
       が要求された場合、Apache は ファイル
-      <code>/usr/local/apache/cgi-bin/test.pl</code>
+      <code>/usr/local/apache2/cgi-bin/test.pl</code>
       を実行し、その出力を返すことを試みます。
       もちろん、ファイルが存在し、実行可能であり、決められた方法で出力を返します。
       そうでなければ、Apache はエラーメッセージを返します。</p>
@@ -114,6 +114,14 @@
       もし、彼らが CGI プログラムを持つことを望んでいても、メインの
       <code>cgi-bin</code> ディレクトリへのアクセスができない場合、
       CGI プログラムを実行することができる他の場所が必要になります。</p>
+
+      <p>任意のディレクトリで CGI の実行を許可するには二段階の設定が必要です。
+      まず、<directive
+      module="mod_mime">AddHandler</directive> や <directive
+      module="core">SetHandler</directive> ディレクティブによって
+      <code>cgi-script</code> ハンドラが可能になっている必要があります。
+      次に、<directive module="core">Options</directive> ディレクティブで
+      <code>ExecCGI</code> が指定されていなければなりません。</p>
     </section>
 
     <section id="options">
@@ -124,7 +132,7 @@
       CGI の実行を許可するように指定することができます:</p>
 
       <example>
-        &lt;Directory /usr/local/apache/htdocs/somedir&gt;<br />
+        &lt;Directory /usr/local/apache2/htdocs/somedir&gt;<br />
         <indent>
           Options +ExecCGI<br />
         </indent>
@@ -140,43 +148,46 @@
       プログラムとしてみなすことをサーバに伝えます:</p>
 
       <example>
-        AddHandler cgi-script cgi pl
+        AddHandler cgi-script .cgi .pl
       </example>
     </section>
 
     <section id="htaccess">
       <title>.htaccess files</title>
 
-      <p><a href="htaccess.html"><code>.htaccess</code>
-      ファイル</a>は、ディレクトリ毎にディレクティブを指定する方法です。
-      Apache は、リソースを提供するときに、
-      提供するファイルが置かれているディレクトリ中の <code>.htaccess</code>
-      というファイルを参照します。そのファイルを発見したら、
-      その中で発見されたディレクティブが適用されます。
-      
-      <code>.htaccess</code> ファイルは、
-      <directive module="core">AllowOverride</directive>
-      ディレクティブの指定により使えるようになります。
-      <directive module="core">AllowOverride</directive> 
-      ディレクティブは、<code>.htaccess</code>
-      ファイルで、どのタイプのディレクティブが設定できるか、
-      あるいは全く指定できないかを指定します。
-      この目的に必要になるディレクティブを使用できるようにするには、
-      サーバのメインの設定で、以下の設定が必要になります:</p>
+      <p><a href="htaccess.html"><code>.htaccess</code> チュートリアル</a>
+      は <code>httpd.conf</code> を変更できない場合にどうやって CGI プログラムを
+      使えるようにするかを説明しています。</p>
+    </section>
+
+    <section id="userdir">
+      <title>User ディレクトリ</title>
+
+      <p><code>.cgi</code> で終わるすべてのファイルに対して CGI プログラムの
+      実行を許可するには、以下の設定を使用できます。</p>
 
       <example>
-        AllowOverride Options
+      &lt;Directory /home/*/public_html&gt;<br/>
+      <indent>
+        Options +ExecCGI<br/>
+        AddHandler cgi-script .cgi<br/>
+      </indent>
+      &lt;/Directory&gt;
       </example>
 
-      <p><code>.htaccess</code>
-      ファイルでは、次のディレクティブが必要となります:</p>
+      <p>ユーザディレクトリの <code>cgi-bin</code> サブディレクトリの
+      すべてのファイルを CGI プログラムとして指定したい場合には
+      以下のようなものを使います。</p>
 
       <example>
-        Options +ExecCGI
+      &lt;Directory /home/*/public_html/cgi-bin&gt;<br/>
+      <indent>
+        Options ExecCGI<br/>
+        SetHandler cgi-script<br/>
+      </indent>
+      &lt;/Directory&gt;
       </example>
 
-      <p>この設定では、このディレクトリにおける CGI
-      プログラムの実行を許可するよう Apache に伝えます。</p>
     </section>
   </section>
 
@@ -251,7 +262,10 @@
 
     <dl>
       <dt>CGI プログラムの出力</dt>
-      <dd>素晴らしい ! それはすべてがうまく動いたことを意味します。</dd>
+      <dd>素晴らしい ! それはすべてがうまく動いたことを意味します。
+      出力が正常だけれども、ブラウザが正常に処理してくれない場合は、
+      正しい <code>Content-Type</code> を CGI プログラム内で
+      セットしたかを確認してください。</dd>
 
       <dt>CGI プログラムのソースコード、または "POST Method Not Allowed"
       というメッセージ</dt> 
@@ -297,28 +311,20 @@
       それらのファイルは、これが可能となる正しいパーミッション
       を持っている必要があります。</p>
 
-      <p>これに対する例外は、サーバが <a href="../suexec.html">suexec</a>
-      を使用するよう設定されている場合です。suexec は、CGI
-      プログラムが置かれているバーチャルホストまたはユーザの
-      ホームディレクトリによって、異なるユーザ権限で実行されるようにします。
-      suexec はとても厳しいパーミッションのチェックがあり、
-      そのチェックを通過できないと "Internal Server Error" となり、その
-      CGI プログラムの実行は失敗します。
-      この場合、どのセキュリティチェックが失敗しているのかを知るために
-      suexec ログファイルをチェックする必要があります。</p>
     </section>
 
     <section id="pathinformation">
-      <title>パス情報</title>
+      <title>パス情報と環境</title>
 
       <p>コマンドラインからプログラムを実行するとき、
       意識しなくてもシェルに渡される情報があります。
       例えば、参照するファイルのためにどこを検索したらよいかを
-      シェルに伝えるパスがあります。</p>
+      シェルに伝える <code>PATH</code> があります。</p>
 
       <p>プログラムが CGI プログラムとしてウェブサーバによって実行されるとき、
-      それはパスを持ちません。CGI プログラム内で呼び出すあらゆるプログラム
-      (例えば、'sendmail' のようなもの) は、
+      それは同じ <code>PATH</code> ではないかもしれません。
+      CGI プログラム内で呼び出すあらゆるプログラム
+      (例えば、<code>sendmail</code> のようなもの) は、
       フルパスで指定する必要があるでしょう。それにより、CGI
       プログラムを実行しようとしたとき、
       シェルはそのようなプログラムを見つけることができます。</p>
@@ -334,14 +340,30 @@
     </section>
 
     <section id="syntaxerrors">
-      <title>構文エラー</title>
+      <title>プログラムエラー</title>
 
       <p>CGI
       プログラムが失敗するのは大抵、プログラム自身に問題がある場合です。
       一度 CGI の使い方を理解し、前述の二つの誤りを犯していないならば、
-      まず間違いなくそうでしょう。ブラウザを通してテストを行う前に必ず、
-      コマンドラインからプログラムの実行を試しなさい。
-      これにより、大抵の問題が起こらなくなります。</p>
+      まず間違いなくそうでしょう。ブラウザを使ってテストする前に
+      まず確認することは、コマンドラインからプログラムが実行できることです。
+      例えば、以下を実行してみてください:</p>
+
+      <example>
+      cd /usr/local/apache2/cgi-bin<br/>
+      ./first.pl
+      </example>
+
+      <p>(<code>perl</code> インタプリタは呼ばないでください。
+      シェルと Apache がスクリプトの最初の行の <a
+      href="#pathinformation">パス情報</a> を使って見つけます。)</p>
+
+      <p>最初にプログラムから出力されるのは <code>Content-Type</code> を含み、
+      後に空行の続く HTTP ヘッダでなければなりません。他のものが出力されている
+      場合は、Apache はこのプログラムをサーバ経由で実行しようとしたときには
+      <code>Premature end of script headers</code> エラーを出力します。詳細は
+      上記の <a
+      href="#writing">CGI プログラムを書く</a> を読んでください。</p>
     </section>
 
     <section id="errorlogs">
@@ -355,6 +377,30 @@
       エラーログの読み方を学ぶことで、ほとんど全ての問題が迅速に確認され、
       迅速に解決されるということが分かるでしょう。</p>
     </section>
+
+    <section id="suexec">
+      <title>Suexec</title>
+
+      <p><a href="../suexec.html">suexec</a> サポートプログラムは
+      バーチャルホストやユーザのホームディレクトリの場所に依って
+      CGI プログラムを違うユーザ権限の下で走らせることを可能にします。
+      Suexec の権限のチェックは非常に厳しく、それを満たさない場合は
+      CGI プログラムが <code>Premature end of script headers</code> エラーで
+      実行されません。</p>
+
+      <p>suexec を使っているかどうかを調べためには <code>apachectl
+      -V</code> を実行して、<code>SUEXEC_BIN</code> の場所を調べてください。
+      Apache がそこに suexec のバイナリを発見した場合は、suexec が
+      使用されます。</p>
+
+      <p>suexec を完全に理解していない限り、使うべきではありません。
+      suexec を無効にするには、<code>SUEXEC_BIN</code> から指されている
+      <code>suexec</code> バイナリを削除 (か名前を変更) するだけです。
+      <a href="../suexec.html">suexec</a> を読んだ後で、まだそれを
+      使いたいのであれば、<code>suexec -V</code> を実行して suexec の
+      ログファイルの位置を調べ、そのログファイルを使ってポリシー違反を
+      見つけてください。</p>
+    </section>
   </section>
 
   <section id="behindscenes">
-- 
2.50.1