Document that TCP keepalive settings read as 0 on Unix-socket connections.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 31 Oct 2012 18:26:20 +0000 (14:26 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 31 Oct 2012 18:26:47 +0000 (14:26 -0400)
Per bug #7631 from Rob Johnson.  The code is operating as designed, but the
docs didn't explain it.

doc/src/sgml/config.sgml

index 8ec8a6f663594baf9159c42101f93226f214ed1e..c1a90d1fba90467fdc5883be12b9c8e60ada997d 100644 (file)
@@ -551,8 +551,9 @@ SET ENABLE_SEQSCAN TO OFF;
         an otherwise idle connection.  A value of 0 uses the system default.
         This parameter is supported only on systems that support the
         <symbol>TCP_KEEPIDLE</> or <symbol>TCP_KEEPALIVE</> symbols, and on
-        Windows; on other systems, it must be zero. This parameter is ignored
-        for connections made via a Unix-domain socket.
+        Windows; on other systems, it must be zero.
+        In sessions connected via a Unix-domain socket, this parameter is
+        ignored and always reads as zero.
        </para>
        <note>
         <para>
@@ -574,8 +575,9 @@ SET ENABLE_SEQSCAN TO OFF;
         otherwise idle connection.  A value of 0 uses the system default.
         This parameter is supported only on systems that support the
         <symbol>TCP_KEEPINTVL</> symbol, and on Windows; on other systems, it
-        must be zero. This parameter is ignored for connections made via a
-        Unix-domain socket.
+        must be zero.
+        In sessions connected via a Unix-domain socket, this parameter is
+        ignored and always reads as zero.
        </para>
        <note>
         <para>
@@ -596,8 +598,9 @@ SET ENABLE_SEQSCAN TO OFF;
         Specifies the number of keepalive packets to send on an otherwise idle
         connection.  A value of 0 uses the system default.  This parameter is
         supported only on systems that support the <symbol>TCP_KEEPCNT</>
-        symbol; on other systems, it must be zero. This parameter is ignored
-        for connections made via a Unix-domain socket.
+        symbol; on other systems, it must be zero.
+        In sessions connected via a Unix-domain socket, this parameter is
+        ignored and always reads as zero.
        </para>
        <note>
         <para>