Re: Document that server will start even if it's unable to open some TCP/IP ports

On Mon, Jun 12, 2023 at 10:59 PM Nathan Bossart
<nathandbossart(at)gmail(dot)com> wrote:
> On Sat, May 27, 2023 at 03:17:21PM -0700, Gurjeet Singh wrote:
> > If listen_addresses is empty, then server won't try to open any TCP/IP
> > ports. The patch does not change any language related to that.
>
> Your proposed change notes that the server only starts if it can listen on
> at least one TCP/IP address, which I worry might lead folks to think that
> the server won't start if listen_addresses is empty.

Perhaps we can prefix that statement with "If listen_addresses is not
empty", like so:

--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -661,3 +661,9 @@ include_dir 'conf.d'
which allows only local TCP/IP <quote>loopback</quote>
connections to be
- made. While client authentication (<xref
+ made. If <varname>listen_addresses</varname> is not empty, the server
+ will start only if it can open the <varname>port</varname>
+ on at least one TCP/IP address. If server is unable to open
+ <varname>port</varname> on a TCP/IP address, it emits a warning.
+ <para>
+ </para>
+ While client authentication (<xref
linkend="client-authentication"/>) allows fine-grained control

Best regards,
Gurjeet
http://Gurje.et