diff options
| author | Bruce Momjian <bruce@momjian.us> | 2023-09-26 19:02:18 -0400 |
|---|---|---|
| committer | Bruce Momjian <bruce@momjian.us> | 2023-09-26 19:02:18 -0400 |
| commit | 3fea8546914e3ebfcd4c3a3e25fbee6c54545087 (patch) | |
| tree | 395c235d0a8012bcac2c959fdacd832cd8d106a3 | |
| parent | b0d049e8fa0c7ad61f7aa0c95e2987b8bace7090 (diff) | |
| download | postgresql-3fea8546914e3ebfcd4c3a3e25fbee6c54545087.tar.gz postgresql-3fea8546914e3ebfcd4c3a3e25fbee6c54545087.zip | |
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.sgml | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index d42b7d63ee6..90ba406e442 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -656,10 +656,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 |