summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian2023-09-26 23:02:17 +0000
committerBruce Momjian2023-09-26 23:02:17 +0000
commit14e60252c441d39f244497b60ea60e69d52e39f8 (patch)
treea3a0d24cace8d83aa1cfc01a0817260affc213f1
parent71c27e88e5a790a73895fb7c6bc649bda7db5c8c (diff)
doc: clarify the behavior of unopenable listen_addresses
Reported-by: Gurjeet Singh Discussion: https://postgr.es/m/CABwTF4WYPD9ov-kcSq1+J+ZJ5wYDQLXquY6Lu2cvb-Y7pTpSGA@mail.gmail.com Backpatch-through: 11
-rw-r--r--doc/src/sgml/config.sgml9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index fbd53113401..c6c33d272b3 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -635,10 +635,15 @@ include_dir 'conf.d'
<literal>::</literal> allows listening for all IPv6 addresses.
If the list is empty, the server does not listen on any IP interface
at all, in which case only Unix-domain sockets can be used to connect
- to it.
+ to it. If the list is not empty, the server will start if it
+ can listen on at least one TCP/IP address. A warning will be
+ emitted for any TCP/IP address which cannot be opened.
The default value is <systemitem class="systemname">localhost</systemitem>,
which allows only local TCP/IP <quote>loopback</quote> connections to be
- made. While client authentication (<xref
+ made.
+ </para>
+ <para>
+ While client authentication (<xref
linkend="client-authentication"/>) allows fine-grained control
over who can access the server, <varname>listen_addresses</varname>
controls which interfaces accept connection attempts, which