You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ta...@apache.org on 2008/05/08 17:08:33 UTC
svn commit: r654544 - /httpd/httpd/branches/2.2.x/docs/manual/bind.xml
Author: takashi
Date: Thu May 8 08:08:33 2008
New Revision: 654544
URL: http://svn.apache.org/viewvc?rev=654544&view=rev
Log:
Merge r561458 from trunk:
Minor language fixes
Modified:
httpd/httpd/branches/2.2.x/docs/manual/bind.xml
Modified: httpd/httpd/branches/2.2.x/docs/manual/bind.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/bind.xml?rev=654544&r1=654543&r2=654544&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/bind.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/bind.xml Thu May 8 08:08:33 2008
@@ -48,15 +48,15 @@
<p>When Apache starts, it binds to some port and address on
the local machine and waits for incoming requests. By default,
- it listens to all addresses on the machine. However, it needs to
- be told to listen on specific ports, or to listen on only selected
- addresses, or a combination. This is often combined with the
- Virtual Host feature which determines how Apache responds to
+ it listens to all addresses on the machine. However, it may need to
+ be told to listen on specific ports, or only on selected
+ addresses, or a combination of both. This is often combined with the
+ Virtual Host feature, which determines how Apache responds to
different IP addresses, hostnames and ports.</p>
<p>The <directive module="mpm_common">Listen</directive>
directive tells the server to accept
- incoming requests only on the specified port or
+ incoming requests only on the specified ports or
address-and-port combinations. If only a port number is
specified in the <directive module="mpm_common">Listen</directive>
directive, the server
@@ -69,22 +69,22 @@
addresses and ports.</p>
<p>For example, to make the server accept connections on both
- port 80 and port 8000, use:</p>
+ port 80 and port 8000, on all interfaces, use:</p>
<example>
Listen 80<br />
Listen 8000
</example>
- <p>To make the server accept connections on two specified
- interfaces and port numbers, use</p>
+ <p>To make the server accept connections on port 80 for one interface,
+ and port 8080 on another, use</p>
<example>
Listen 192.170.2.1:80<br />
Listen 192.170.2.5:8000
</example>
- <p>IPv6 addresses must be surrounded in square brackets, as in the
+ <p>IPv6 addresses must be enclosed in square brackets, as in the
following example:</p>
<example>
@@ -97,27 +97,27 @@
<p>A growing number of platforms implement IPv6, and
<glossary>APR</glossary> supports IPv6 on most of these platforms,
- allowing Apache to allocate IPv6 sockets and handle requests which
- were sent over IPv6.</p>
+ allowing Apache to allocate IPv6 sockets, and to handle requests sent
+ over IPv6.</p>
<p>One complicating factor for Apache administrators is whether or
not an IPv6 socket can handle both IPv4 connections and IPv6
connections. Handling IPv4 connections with an IPv6 socket uses
IPv4-mapped IPv6 addresses, which are allowed by default on most
- platforms but are disallowed by default on FreeBSD, NetBSD, and
- OpenBSD in order to match the system-wide policy on those
- platforms. But even on systems where it is disallowed by default, a
+ platforms, but are disallowed by default on FreeBSD, NetBSD, and
+ OpenBSD, in order to match the system-wide policy on those
+ platforms. On systems where it is disallowed by default, a
special <program>configure</program> parameter can change this behavior
for Apache.</p>
- <p>On the other hand, on some platforms such as Linux and Tru64 the
+ <p>On the other hand, on some platforms, such as Linux and Tru64, the
<strong>only</strong> way to handle both IPv6 and IPv4 is to use
mapped addresses. If you want Apache to handle IPv4 and IPv6 connections
with a minimum of sockets, which requires using IPv4-mapped IPv6
addresses, specify the <code>--enable-v4-mapped</code> <program>
configure</program> option.</p>
- <p><code>--enable-v4-mapped</code> is the default on all platforms but
+ <p><code>--enable-v4-mapped</code> is the default on all platforms except
FreeBSD, NetBSD, and OpenBSD, so this is probably how your Apache was
built.</p>
@@ -132,7 +132,7 @@
</example>
<p>If your platform supports it and you want Apache to handle IPv4 and
- IPv6 connections on separate sockets (i.e., to disable IPv4-mapped
+ IPv6 connections on separate sockets (i.e., to disable IPv4-mapped
addresses), specify the <code>--disable-v4-mapped</code> <program>
configure</program> option. <code>--disable-v4-mapped</code> is the
default on FreeBSD, NetBSD, and OpenBSD.</p>
@@ -141,20 +141,20 @@
<section id="virtualhost">
<title>How This Works With Virtual Hosts</title>
- <p> <directive
- module="mpm_common">Listen</directive> does not implement
- Virtual Hosts. It only tells the
- main server what addresses and ports to listen to. If no
+ <p> The <directive
+ module="mpm_common">Listen</directive> directive does not implement
+ Virtual Hosts - it only tells the
+ main server what addresses and ports to listen on. If no
<directive module="core" type="section">VirtualHost</directive>
directives are used, the server will behave
- the same for all accepted requests. However,
+ in the same way for all accepted requests. However,
<directive module="core" type="section">VirtualHost</directive>
can be used to specify a different behavior
- for one or more of the addresses and ports. To implement a
+ for one or more of the addresses or ports. To implement a
VirtualHost, the server must first be told to listen to the
address and port to be used. Then a
<directive module="core" type="section">VirtualHost</directive> section
- should be created for a specified address and port to set the
+ should be created for the specified address and port to set the
behavior of this virtual host. Note that if the
<directive module="core" type="section">VirtualHost</directive>
is set for an address and port that the