Document that TCP keepalive settings read as 0 on Unix-socket connections.

Per bug #7631 from Rob Johnson.  The code is operating as designed, but the
docs didn't explain it.
This commit is contained in:
Tom Lane 2012-10-31 14:26:20 -04:00
parent 9b8dd7e8aa
commit e774b7649c
1 changed files with 9 additions and 6 deletions

View File

@ -675,8 +675,9 @@ include 'filename'
an otherwise idle connection. A value of 0 uses the system default. an otherwise idle connection. A value of 0 uses the system default.
This parameter is supported only on systems that support the This parameter is supported only on systems that support the
<symbol>TCP_KEEPIDLE</> or <symbol>TCP_KEEPALIVE</> symbols, and on <symbol>TCP_KEEPIDLE</> or <symbol>TCP_KEEPALIVE</> symbols, and on
Windows; on other systems, it must be zero. This parameter is ignored Windows; on other systems, it must be zero.
for connections made via a Unix-domain socket. In sessions connected via a Unix-domain socket, this parameter is
ignored and always reads as zero.
</para> </para>
<note> <note>
<para> <para>
@ -698,8 +699,9 @@ include 'filename'
otherwise idle connection. A value of 0 uses the system default. otherwise idle connection. A value of 0 uses the system default.
This parameter is supported only on systems that support the This parameter is supported only on systems that support the
<symbol>TCP_KEEPINTVL</> symbol, and on Windows; on other systems, it <symbol>TCP_KEEPINTVL</> symbol, and on Windows; on other systems, it
must be zero. This parameter is ignored for connections made via a must be zero.
Unix-domain socket. In sessions connected via a Unix-domain socket, this parameter is
ignored and always reads as zero.
</para> </para>
<note> <note>
<para> <para>
@ -720,8 +722,9 @@ include 'filename'
Specifies the number of keepalive packets to send on an otherwise idle Specifies the number of keepalive packets to send on an otherwise idle
connection. A value of 0 uses the system default. This parameter is connection. A value of 0 uses the system default. This parameter is
supported only on systems that support the <symbol>TCP_KEEPCNT</> supported only on systems that support the <symbol>TCP_KEEPCNT</>
symbol; on other systems, it must be zero. This parameter is ignored symbol; on other systems, it must be zero.
for connections made via a Unix-domain socket. In sessions connected via a Unix-domain socket, this parameter is
ignored and always reads as zero.
</para> </para>
<note> <note>
<para> <para>