summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian2007-03-24 21:46:23 +0000
committerBruce Momjian2007-03-24 21:46:23 +0000
commit36d35a14df85e0e9a6a599d27232a43e543e4f5b (patch)
tree1d0fa51a084d5bef407dedf2c966a042f6f87a0f /doc/src
parent5e37b4cb1abc506e3d44f920a6a5605e34ec8992 (diff)
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.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/client-auth.sgml10
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index 8ea76a0bd08..8b3954df74c 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>