From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Fri, 17 Nov 2006 23:25:17 +0000 (+0000)
Subject: Clarify description of CIDR-address column of pg_hba.conf, to discourage
X-Git-Tag: REL8_2_RC1~68
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fa3d622cb0ed7d101ea041733614661e7a4aa1ec;p=postgresql

Clarify description of CIDR-address column of pg_hba.conf, to discourage
people from trying notations like '10.6/16', which is accepted but does
not mean what you probably think.  Per example from Paul Forgey.
---

diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index a77d89db0e..f418332a39 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.94 2006/10/23 18:10:30 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.95 2006/11/17 23:25:17 tgl Exp $ -->
 
 <chapter id="client-authentication">
  <title>Client Authentication</title>
@@ -226,11 +226,12 @@ hostnossl  <replaceable>database</replaceable>  <replaceable>user</replaceable>
       </para>
 
       <para>
-       A typical <replaceable>CIDR-address</replaceable> is
+       Typical examples of a <replaceable>CIDR-address</replaceable> are
        <literal>172.20.143.89/32</literal> for a single host, or
-       <literal>172.20.143.0/24</literal> for a network.
+       <literal>172.20.143.0/24</literal> for a small network, or
+       <literal>10.6.0.0/16</literal> for a larger one.
        To specify a single host, use a CIDR mask of 32 for IPv4 or
-       128 for IPv6.
+       128 for IPv6.  In a network address, do not omit trailing zeroes.
       </para>
 
       <para>