dgaudet 97/05/04 13:11:54
Modified: htdocs/manual dns-caveats.html vhosts-in-depth.html
htdocs/manual/mod core.html
Log:
Add documentation about :port in virtualhost. Note the necessity of
using _default_:* if the user wants to match all ips on all ports.
Revision Changes Path
1.3 +6 -3 apache/htdocs/manual/dns-caveats.html
Index: dns-caveats.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/dns-caveats.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -C3 -r1.2 -r1.3
*** dns-caveats.html 1997/05/01 05:26:33 1.2
--- dns-caveats.html 1997/05/04 20:11:51 1.3
***************
*** 139,146 ****
the IP address of any of the webservers will be served from the "main" or
"default" server configurations. The "main" server configuration consists
of all those definitions appearing outside of any VirtualHost section.
! You may want instead to define a <code><VirtualHost _default></code>
! which returns 403 or 404 for all hits.
<h3><a name="tips">Tips to Avoid these problems</a></h3>
--- 139,149 ----
the IP address of any of the webservers will be served from the "main" or
"default" server configurations. The "main" server configuration consists
of all those definitions appearing outside of any VirtualHost section.
! You may want instead to define a <code><VirtualHost
_default_:*></code>
! which returns 403 or 404 for all hits. (The trailing <code>:*</code>
! makes it apply to all ports, which is just a safety measure should you
! begin using multiple <code><a href="mod/core.html#listen">Listen</a></code>
! directives.)
<h3><a name="tips">Tips to Avoid these problems</a></h3>
***************
*** 149,155 ****
<li> use IP addresses in <code>Listen</code>
<li> use IP addresses in <code>BindAddress</code>
<li> ensure all virtual hosts have an explicit <code>ServerName</code>
! <li> create a <code><VirtualHost _default_></code> server that
has no pages to serve
</ul>
--- 152,158 ----
<li> use IP addresses in <code>Listen</code>
<li> use IP addresses in <code>BindAddress</code>
<li> ensure all virtual hosts have an explicit <code>ServerName</code>
! <li> create a <code><VirtualHost _default_:*></code> server that
has no pages to serve
</ul>
1.7 +6 -6 apache/htdocs/manual/vhosts-in-depth.html
Index: vhosts-in-depth.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/vhosts-in-depth.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -C3 -r1.6 -r1.7
*** vhosts-in-depth.html 1997/05/01 05:26:36 1.6
--- vhosts-in-depth.html 1997/05/04 20:11:52 1.7
***************
*** 302,321 ****
DNS for all the domains listed.
<a href="dns-caveats.html">
There's more information
! available on this and the next two topics</a>.
<li><code>ServerName</code> should always be set for each vhost. Otherwise
! A DNS lookup is required for each vhost.
<li>A DNS lookup is always required for the main_server's
<code>ServerName</code> (or to generate that if it isn't specified
! in the config).
<li>If a <code>ServerPath</code> directive exists which is a prefix of
another <code>ServerPath</code> directive that appears later in
the configuration file, then the former will always be matched
and the latter will never be matched. (That is assuming that no
! Host header was available to disambiguate the two.)
<li>If a vhost that would otherwise be a name-vhost includes a
<code>Port</code> statement that doesn't match the main_server
--- 302,321 ----
DNS for all the domains listed.
<a href="dns-caveats.html">
There's more information
! available on this and the next two topics</a>.</p>
<li><code>ServerName</code> should always be set for each vhost. Otherwise
! A DNS lookup is required for each vhost.</p>
<li>A DNS lookup is always required for the main_server's
<code>ServerName</code> (or to generate that if it isn't specified
! in the config).</p>
<li>If a <code>ServerPath</code> directive exists which is a prefix of
another <code>ServerPath</code> directive that appears later in
the configuration file, then the former will always be matched
and the latter will never be matched. (That is assuming that no
! Host header was available to disambiguate the two.)</p>
<li>If a vhost that would otherwise be a name-vhost includes a
<code>Port</code> statement that doesn't match the main_server
***************
*** 325,331 ****
to the port of the main_server) as the connection vhost. Then
<code>check_hostalias</code> will refuse to check any other name-based
vhost because of the port mismatch. The result is that the vhost
! will steal all hits going to the main_server address.
<li>If two IP-based vhosts have an address in common, the vhost appearing
later in the file is always matched. Such a thing might happen
--- 325,331 ----
to the port of the main_server) as the connection vhost. Then
<code>check_hostalias</code> will refuse to check any other name-based
vhost because of the port mismatch. The result is that the vhost
! will steal all hits going to the main_server address.</p>
<li>If two IP-based vhosts have an address in common, the vhost appearing
later in the file is always matched. Such a thing might happen
***************
*** 335,341 ****
Then the last of them will steal all the hits.</P>
<li>The last name-based vhost in the config is always matched for any hit
! which doesn't match one of the other name-based vhosts.
</ul>
--- 335,341 ----
Then the last of them will steal all the hits.</P>
<li>The last name-based vhost in the config is always matched for any hit
! which doesn't match one of the other name-based vhosts.</p>
</ul>
1.55 +7 -1 apache/htdocs/manual/mod/core.html
Index: core.html
===================================================================
RCS file: /export/home/cvs/apache/htdocs/manual/mod/core.html,v
retrieving revision 1.54
retrieving revision 1.55
diff -C3 -r1.54 -r1.55
*** core.html 1997/05/01 05:26:49 1.54
--- core.html 1997/05/04 20:11:53 1.55
***************
*** 1370,1376 ****
</menu> Example:
<blockquote>
<code>
! <VirtualHost host.foo.com> <br>
ServerAdmin [EMAIL PROTECTED] <br>
DocumentRoot /www/docs/host.foo.com <br>
ServerName host.foo.com <br>
--- 1370,1376 ----
</menu> Example:
<blockquote>
<code>
! <VirtualHost 10.1.2.3> <br>
ServerAdmin [EMAIL PROTECTED] <br>
DocumentRoot /www/docs/host.foo.com <br>
ServerName host.foo.com <br>
***************
*** 1392,1397 ****
--- 1392,1403 ----
in another virtual host. In the absence of any _default_ virtual host
the "main" server config, consisting of all those definitions outside
any VirtualHost section, is used when no match occurs.<p>
+
+ You can specify a <code>:port</code> to change the port that is matched.
+ If unspecified then it defaults to the same port as the most recent
+ <code><a href="#port">Port</a></code> statement of the main server. You
+ may also specify <code>:*</code> to match all ports on that address.
+ (This is recommended when used with <code>_default_</code>.)<p>
<strong>SECURITY</strong>: See the
<A HREF="../misc/security_tips.html">security tips</A>
