Doc: fix description about using PCP password file when connect to Unix domain socket
authorMasaya Kawamoto <kawamoto@sraoss.co.jp>
Thu, 30 Jun 2022 03:58:37 +0000 (03:58 +0000)
committerMasaya Kawamoto <kawamoto@sraoss.co.jp>
Thu, 30 Jun 2022 03:59:47 +0000 (03:59 +0000)
The localhost entry in pcppass matches only for the default PCP socket
directory path, not all Unix socket connections. This behavior is the
same as pgpass.

doc.ja/src/sgml/reference.sgml
doc/src/sgml/reference.sgml

index c89cbe18f695e61617d0b73758e09cc09e423ea7..14b0b64ab2d531f5c9f1059269384dca97866686 100644 (file)
      field from the first line that matches the current connection
      parameters will be used. (Therefore, put more-specific entries
      first when you are using wildcards.) If an entry needs to contain
-     : or \, escape this character with \. A host name of localhost
-     matches both TCP (host name localhost) and Unix domain socket
-     connections coming from the local machine.
+     : or \, escape this character with \. The hostname field is matched
+     to the host connection parameter if that is specified, if the host
+     parameter is not given then the host name <literal>localhost</literal>
+     is searched for. The host name <literal>localhost</literal> is also
+     searched for when the connection is a Unix domain socket connection
+     and the host parameter matches the default pcp socket directory path.
      -->
      (この文字列の行頭に # を付けてからファイルにコピーしておけば備忘録のコメントになります。)
      最初の3つのフィールドはそれぞれリテラル値か、任意のものにマッチする * を指定します。
      現在の接続パラメータにマッチした最初の行の password フィールドが使用されます。
      (したがって、ワイルドーカードを使用する場合には、具体的なエントリーの方を先に書きます。)
      エントリーの中に 「:」 か 「\」 を含む必要がある場合には、その文字を 「\」 をつかってエスケープしてください。
-     ホスト名 localhost はローカルマシンからの TCP と Unix ドメインソケットの両方の接続にマッチします。
+     hostname フィールドは、host 接続パラメータとマッチします。host パラメータが指定されていなければ、ホスト名<literal>localhost</literal>がマッチします。
+     接続が Unix ドメインソケット接続で、host パラメータがデフォルトの PCP ソケットディレクトリパスに一致した場合も、ホスト名<literal>localhost</literal>がマッチします。
     </para>
 
     <para>
index 1abf64833d55741002135fbfdc3fb93a73d5557c..ba259ba9703814dc3bb51ae2ec1a591d9b4b9155 100644 (file)
      field from the first line that matches the current connection
      parameters will be used. (Therefore, put more-specific entries
      first when you are using wildcards.) If an entry needs to contain
-     : or \, escape this character with \. A host name of localhost
-     matches both TCP (host name localhost) and Unix domain socket
-     connections coming from the local machine.
+     : or \, escape this character with \. The hostname field is matched
+     to the host connection parameter if that is specified, if the host
+     parameter is not given then the host name <literal>localhost</literal>
+     is searched for. The host name <literal>localhost</literal> is also
+     searched for when the connection is a Unix domain socket connection
+     and the host parameter matches the default pcp socket directory path.
     </para>
 
     <para>