From: André Malo Date: Wed, 18 Sep 2002 23:37:28 +0000 (+0000) Subject: - fix examples: turn example.isp.com to domain.example.com X-Git-Tag: WROWE_2_0_43_PRE1~96 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9ac1d8c955d9925065f0b1f121e320f3f937352b;p=thirdparty%2Fapache%2Fhttpd.git - fix examples: turn example.isp.com to domain.example.com (isp.com is really a bad choice, YMMV) - add "none" to syntax descriptions and fix defaults - fix several s - add infos the descriptions of *IP directives (redundant, but to reach more clearness) - add section ids - fix some typos git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96892 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_vhost_alias.html.en b/docs/manual/mod/mod_vhost_alias.html.en index 71333ea1b9d..30a432ee660 100644 --- a/docs/manual/mod/mod_vhost_alias.html.en +++ b/docs/manual/mod/mod_vhost_alias.html.en @@ -18,13 +18,13 @@ hostingStatus: huge number of virtual hosts with similar configurations.

-
top

Directory Name Interpolation

+
top

Directory Name Interpolation

All the directives in this module interpolate a string into a pathname. The interpolated string (henceforth called the - "name") may be either the server name (see the UseCanonicalName + "name") may be either the server name (see the UseCanonicalName directive for details on how this is determined) or the IP address of the virtual host on the server in dotted-quad format. The interpolation is controlled by specifiers inspired @@ -80,16 +80,16 @@ virtual hosting

If N or M is greater than the number of parts available a single underscore is interpolated.

-
top

Examples

+
top

Examples

For simple name-based virtual hosts you might use the following directives in your server configuration file:

-

- UseCanonicalName Off
- VirtualDocumentRoot /usr/local/apache/vhosts/%0 -

+

+ UseCanonicalName Off
+ VirtualDocumentRoot /usr/local/apache/vhosts/%0 +

A request for http://www.example.com/directory/file.html will be @@ -102,15 +102,15 @@ virtual hosting

vhosts directory. To do this you might use the following in your configuration file:

-

- UseCanonicalName Off
- VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2 -

+

+ UseCanonicalName Off
+ VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2 +

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html will be satisfied by the file - /usr/local/apache/vhosts/isp.com/e/x/a/example/directory/file.html.

+ /usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html.

A more even spread of files can be achieved by hashing from the end of the name, for example:

@@ -120,7 +120,7 @@ virtual hosting

The example request would come from - /usr/local/apache/vhosts/isp.com/e/l/p/example/directory/file.html.

+ /usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html.

Alternatively you might use:

@@ -129,24 +129,24 @@ virtual hosting

The example request would come from - /usr/local/apache/vhosts/isp.com/e/x/a/mple/directory/file.html.

+ /usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html.

For IP-based virtual hosting you might use the following in your configuration file:

-

- UseCanonicalName DNS
- VirtualDocumentRootIP /usr/local/apache/vhosts/%1/%2/%3/%4/docs
- VirtualScriptAliasIP /usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin -

+

+ UseCanonicalName DNS
+ VirtualDocumentRootIP /usr/local/apache/vhosts/%1/%2/%3/%4/docs
+ VirtualScriptAliasIP /usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin +

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html would be satisfied by the file /usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html - if the IP address of www.example.com were + if the IP address of www.domain.example.com were 10.20.30.40. A request for - http://www.example.isp.com/cgi-bin/script.pl would + http://www.domain.example.com/cgi-bin/script.pl would be satisfied by executing the program /usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl.

@@ -160,9 +160,9 @@ virtual hosting

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html will be satisfied by the file - /usr/local/apache/vhosts/example.isp/directory/file.html.

+ /usr/local/apache/vhosts/domain.example/directory/file.html.

The LogFormat directives %V and %A are useful @@ -170,63 +170,63 @@ virtual hosting

top

VirtualDocumentRoot Directive

Description: Dynamically configure the location of the document root for a given virtual host
Syntax: - VirtualDocumentRoot interpolated-directory
Default: - none
Context: + VirtualDocumentRoot interpolated-directory|none
Default: + VirtualDocumentRoot none
Context: server config, virtual host
Status: Extension
Module: mod_vhost_alias
-

The VirtualDocumentRoot directive allows you to +

The VirtualDocumentRoot directive allows you to determine where Apache will find your documents based on the value of the server name. The result of expanding interpolated-directory is used as the root of the document tree in a similar manner to the DocumentRoot directive's argument. If interpolated-directory is none then - VirtaulDocumentRoot is turned off. This directive - cannot be used in the same context as - VirtualDocumentRootIP.

+ VirtualDocumentRoot is turned off. This directive + cannot be used in the same context as VirtualDocumentRootIP.

top

VirtualDocumentRootIP Directive

Description: Dynamically configure the location of the document root for a given virtual host
Syntax: - VirtualDocumentRootIP interpolated-directory
Default: - none
Context: + VirtualDocumentRootIP interpolated-directory|none
Default: + VirtualDocumentRootIP none
Context: server config, virtual host
Status: Extension
Module: mod_vhost_alias
-

The VirtualDocumentRootIP directive is like the - VirtualDocumentRoot +

The VirtualDocumentRootIP directive is like the + VirtualDocumentRoot directive, except that it uses the IP address of the server end - of the connection instead of the server name.

+ of the connection for directory interpolation instead of the server + name.

top

VirtualScriptAlias Directive

Description: Dynamically configure the location of the CGI directory for a given virtual host
Syntax: - VirtualScriptAlias interpolated-directory
Default: - none
Context: + VirtualScriptAlias interpolated-directory|none
Default: + VirtualScriptAlias none
Context: server config, virtual host
Status: Extension
Module: mod_vhost_alias
-

The VirtualScriptAlias directive allows you to +

The VirtualScriptAlias directive allows you to determine where Apache will find CGI scripts in a similar - manner to VirtualDocumentRoot - does for other documents. It matches requests for URIs starting - /cgi-bin/, much like ScriptAlias + manner to VirtualDocumentRoot does for other documents. It matches + requests for URIs starting /cgi-bin/, much like ScriptAlias /cgi-bin/ would.

top

VirtualScriptAliasIP Directive

Description: Dynamically configure the location of the cgi directory for a given virtual host
Syntax: - VirtualScriptAliasIP interpolated-directory
Default: - none
Context: + VirtualScriptAliasIP interpolated-directory|none
Default: + VirtualScriptAliasIP none
Context: server config, virtual host
Status: Extension
Module: mod_vhost_alias
-

The VirtualScriptAliasIP directive is like the - VirtualScriptAlias +

The VirtualScriptAliasIP directive is like the + VirtualScriptAlias directive, except that it uses the IP address of the server end - of the connection instead of the server name.

+ of the connection for directory interpolation instead of the server + name.

\ No newline at end of file diff --git a/docs/manual/mod/mod_vhost_alias.xml b/docs/manual/mod/mod_vhost_alias.xml index 2b623f791bb..c2b91159be3 100644 --- a/docs/manual/mod/mod_vhost_alias.xml +++ b/docs/manual/mod/mod_vhost_alias.xml @@ -21,17 +21,17 @@ hosting UseCanonicalName. + module="core">UseCanonicalName Dynamically configured mass virtual hosting -
+
Directory Name Interpolation

All the directives in this module interpolate a string into a pathname. The interpolated string (henceforth called the - "name") may be either the server name (see the UseCanonicalName + "name") may be either the server name (see the UseCanonicalName directive for details on how this is determined) or the IP address of the virtual host on the server in dotted-quad format. The interpolation is controlled by specifiers inspired @@ -89,16 +89,16 @@ virtual hosting

-
+
Examples

For simple name-based virtual hosts you might use the following directives in your server configuration file:

- - UseCanonicalName Off
- VirtualDocumentRoot /usr/local/apache/vhosts/%0 - + + UseCanonicalName Off
+ VirtualDocumentRoot /usr/local/apache/vhosts/%0 +

A request for http://www.example.com/directory/file.html will be @@ -111,15 +111,15 @@ virtual hosting vhosts directory. To do this you might use the following in your configuration file:

- - UseCanonicalName Off
- VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2 - + + UseCanonicalName Off
+ VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2 +

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html will be satisfied by the file - /usr/local/apache/vhosts/isp.com/e/x/a/example/directory/file.html.

+ /usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html.

A more even spread of files can be achieved by hashing from the end of the name, for example:

@@ -129,7 +129,7 @@ virtual hosting

The example request would come from - /usr/local/apache/vhosts/isp.com/e/l/p/example/directory/file.html.

+ /usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html.

Alternatively you might use:

@@ -138,24 +138,24 @@ virtual hosting

The example request would come from - /usr/local/apache/vhosts/isp.com/e/x/a/mple/directory/file.html.

+ /usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html.

For IP-based virtual hosting you might use the following in your configuration file:

- - UseCanonicalName DNS
- VirtualDocumentRootIP /usr/local/apache/vhosts/%1/%2/%3/%4/docs
- VirtualScriptAliasIP /usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin - + + UseCanonicalName DNS
+ VirtualDocumentRootIP /usr/local/apache/vhosts/%1/%2/%3/%4/docs
+ VirtualScriptAliasIP /usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin +

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html would be satisfied by the file /usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html - if the IP address of www.example.com were + if the IP address of www.domain.example.com were 10.20.30.40. A request for - http://www.example.isp.com/cgi-bin/script.pl would + http://www.domain.example.com/cgi-bin/script.pl would be satisfied by executing the program /usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl.

@@ -169,9 +169,9 @@ virtual hosting

A request for - http://www.example.isp.com/directory/file.html + http://www.domain.example.com/directory/file.html will be satisfied by the file - /usr/local/apache/vhosts/example.isp/directory/file.html.

+ /usr/local/apache/vhosts/domain.example/directory/file.html.

The LogFormat directives %V and %A are useful @@ -182,8 +182,8 @@ virtual hosting VirtualDocumentRoot Dynamically configure the location of the document root for a given virtual host -VirtualDocumentRoot interpolated-directory -none +VirtualDocumentRoot interpolated-directory|none +VirtualDocumentRoot none server config virtual host @@ -191,16 +191,16 @@ for a given virtual host -

The VirtualDocumentRoot directive allows you to +

The VirtualDocumentRoot directive allows you to determine where Apache will find your documents based on the value of the server name. The result of expanding interpolated-directory is used as the root of the document tree in a similar manner to the DocumentRoot directive's argument. If interpolated-directory is none then - VirtaulDocumentRoot is turned off. This directive - cannot be used in the same context as - VirtualDocumentRootIP.

+ VirtualDocumentRoot is turned off. This directive + cannot be used in the same context as VirtualDocumentRootIP.

@@ -209,8 +209,8 @@ for a given virtual host VirtualDocumentRootIP Dynamically configure the location of the document root for a given virtual host -VirtualDocumentRootIP interpolated-directory -none +VirtualDocumentRootIP interpolated-directory|none +VirtualDocumentRootIP none server config virtual host @@ -218,10 +218,11 @@ for a given virtual host -

The VirtualDocumentRootIP directive is like the - VirtualDocumentRoot +

The VirtualDocumentRootIP directive is like the + VirtualDocumentRoot directive, except that it uses the IP address of the server end - of the connection instead of the server name.

+ of the connection for directory interpolation instead of the server + name.

 @@ -229,8 +230,8 @@ for a given virtual host VirtualScriptAlias Dynamically configure the location of the CGI directory for a given virtual host -VirtualScriptAlias interpolated-directory -none +VirtualScriptAlias interpolated-directory|none +VirtualScriptAlias none server config virtual host @@ -238,11 +239,11 @@ a given virtual host -

The VirtualScriptAlias directive allows you to +

The VirtualScriptAlias directive allows you to determine where Apache will find CGI scripts in a similar - manner to VirtualDocumentRoot - does for other documents. It matches requests for URIs starting - /cgi-bin/, much like VirtualDocumentRoot does for other documents. It matches + requests for URIs starting /cgi-bin/, much like ScriptAlias /cgi-bin/ would.

@@ -253,8 +254,8 @@ a given virtual host VirtualScriptAliasIP Dynamically configure the location of the cgi directory for a given virtual host -VirtualScriptAliasIP interpolated-directory -none +VirtualScriptAliasIP interpolated-directory|none +VirtualScriptAliasIP none server config virtual host @@ -262,11 +263,11 @@ a given virtual host -

The VirtualScriptAliasIP directive is like the - VirtualScriptAlias +

The VirtualScriptAliasIP directive is like the + VirtualScriptAlias directive, except that it uses the IP address of the server end - of the connection instead of the server name.

+ of the connection for directory interpolation instead of the server + name.