httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dean Gaudet <dgau...@hyperreal.com>
Subject cvs commit: apache/htdocs/manual/mod core.html
Date Sun, 04 May 1997 20:11:55 GMT
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>&lt;VirtualHost _default&gt;</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>&lt;VirtualHost _default_:*&gt;</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>&lt;VirtualHost _default_&gt;</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>&lt;VirtualHost _default_:*&gt;</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>
  ! &lt;VirtualHost host.foo.com&gt; <br>
    ServerAdmin webmaster@host.foo.com <br>
    DocumentRoot /www/docs/host.foo.com <br>
    ServerName host.foo.com <br>
  --- 1370,1376 ----
    </menu> Example:
    <blockquote>
    <code>
  ! &lt;VirtualHost 10.1.2.3&gt; <br>
    ServerAdmin webmaster@host.foo.com <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> 
  
  
  

Mime
View raw message