From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 24 Mar 2007 21:46:23 +0000 (+0000)
Subject: Document that LDAP URLs should be double-quoted in pg_hba.conf because
X-Git-Tag: REL8_3_BETA1~972
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=36d35a14df85e0e9a6a599d27232a43e543e4f5b;p=postgresql

Document that LDAP URLs should be double-quoted in pg_hba.conf because
commas are often present in the URL.

Backpatch to 8.2.X.
---

diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index 8ea76a0bd0..8b3954df74 100644
--- a/doc/src/sgml/client-auth.sgml
+++ b/doc/src/sgml/client-auth.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.97 2007/01/31 20:56:16 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.98 2007/03/24 21:46:23 momjian Exp $ -->
 
 <chapter id="client-authentication">
  <title>Client Authentication</title>
@@ -929,9 +929,13 @@ omicron       bryanh            guest1
     <synopsis>
 ldap[<replaceable>s</>]://<replaceable>servername</>[:<replaceable>port</>]/<replaceable>base dn</replaceable>[;<replaceable>prefix</>[;<replaceable>suffix</>]]
     </synopsis>
-    for example:
+    Commas are used to specify multiple items in an <literal>ldap</>
+    component.  However, because unquoted commas are treated as item
+    separators in <filename>pg_hba.conf</filename>, it is wise to
+    double-quote the <literal>ldap</> URL to preserve any commas present,
+    e.g.:
     <synopsis>
-ldap://ldap.example.net/dc=example,dc=net;EXAMPLE\
+"ldap://ldap.example.net/dc=example,dc=net;EXAMPLE\"
     </synopsis>
 
    </para>