Commit 32098e3e authored by Joe Orton's avatar Joe Orton
Browse files

Merge r1816110 from trunk: 

Document special cases where changing Listen across a restart will
fail. 

PR: 61666



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1827552 13f79535-47bb-0310-9956-ffa450edef68
parent c530f7f1

docs/manual/bind.xml

+35 −1
Original line number Diff line number Diff line
@@ -111,6 +111,40 @@ Listen 192.0.2.5:8000 


</note>



  </section>



  <section id="reload">

    <title>Changing Listen configuration on restart</title>



    <p>When httpd is restarted, special consideration must be made for

    changes to <directive module="mpm_common">Listen</directive> directives.  During a restart, httpd keeps ports

    bound (as in the original configuration) to avoid generating

    "Connection refused" errors for any new attempts to connect to the

    server. If changes are made to the set of <directive module="mpm_common">Listen</directive> directives used

    which conflict with the old configuration, configuration will fail

    and the server will terminate.</p>



    <p>For example, changing from configuration:</p>

    

    <example>

    <highlight language="config">

      Listen 127.0.0.1:80

    </highlight>

    </example>



    <p>to the following may fail, because binding to port 80 across

    all addresses conflicts with binding to port 80 on just

    127.0.0.1.</p>

    

    <example>

    <highlight language="config">

      Listen 80

    </highlight>

    </example>



    <p>To have such configuration changes take effect, it is necessary

    to stop and then start the server.</p>

    

  </section>



    <section id="ipv6">