From: pcs Date: Sun, 24 Aug 1997 13:17:56 +0000 (+0000) Subject: Attempt to clarify relationship between VirtualHost and X-Git-Tag: APACHE_1_3b1~25 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=779a53080ccc08a4273e07346a66dc33db158898;p=thirdparty%2Fapache%2Fhttpd.git Attempt to clarify relationship between VirtualHost and Listen/BindAddress/Port. PR: 1046 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@79049 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.html b/docs/manual/mod/core.html index a79be63a9be..daa64679171 100644 --- a/docs/manual/mod/core.html +++ b/docs/manual/mod/core.html @@ -245,9 +245,15 @@ If the value is *, then the server will listen for connections on every IP address, otherwise it will only listen on the IP address specified.

-This option can be used as an alternative method for supporting -virtual hosts instead of using -<VirtualHost> sections. +Only one BindAddress directive can be used. For more +control over which address and ports Apache listens to, use the +Listen directive instead of +BindAddress.

+ +BindAddress can be used as an alternative method for +supporting virtual hosts using +multiple independent servers, instead of using <VirtualHost> sections.

See Also: DNS Issues
@@ -783,8 +789,41 @@ Listen [IP address:]port number

The Listen directive instructs Apache to listen to more than one IP address or port; by default it responds to requests on all IP -interfaces, but only on the port given by the Port -directive.

+interfaces, but only on the port given by the Port directive.

+ +Listen can be used instead of BindAddress and Port. It tells +the server to accept incoming requests on the specified port or +address-and-port combination. If the first format is used, with a port +number only, the server listens to the given port on all interfaces, +instead of the port given by the Port directive. If an IP +address is given as well as a port, the server will listen on the +given port and interface.

+ +Note that you may still require a Port directive so +that URLs that Apache generates that point to your server still +work.

+ +Multiple Listen directives may be used +to specify a number of addresses and ports to listen to. The server +will respond to requests from any of the listed addresses and +ports. +

+ +For example, to make the server accept connections on both port +80 and port 8000, use: +

+   Listen 80
+   Listen 8000
+
+ +To make the server accept connections on two specified +interfaces and port numbers, use +
+   Listen 192.170.2.1:80
+   Listen 192.170.2.5:8000
+

See Also: DNS Issues
@@ -1626,6 +1665,12 @@ document for details on why your security could be compromised if the directory where logfiles are stored is writable by anyone other than the user that starts the server. +

NOTE: The use of <VirtualHost> does +not affect what addresses Apache listens on. You may +need to ensure that Apache is listening on the correct addresses using +either BindAddress or Listen. +

See also: Warnings about DNS and Apache
See also: @@ -1634,7 +1679,9 @@ than the user that starts the server. See also: Non-IP address-based Virtual Hosts
See also: -In-depth description of Virtual Host matching +In-depth description of Virtual Host matching
+See also: +Setting which addresses and ports Apache uses