From: Richard Bowen Date: Fri, 5 Jul 2002 03:28:06 +0000 (+0000) Subject: Submitted by: Owen Boyle, on users@ mailing list X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9198ff66e29255e8af98271a034dc4db19c1872a;p=apache Submitted by: Owen Boyle, on users@ mailing list Additional clarification on UseCanonicalName directive. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@95962 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index 3337e3b352..54de42770d 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -1684,20 +1684,27 @@ portIn many situations Apache has to construct a self-referential URL. That is, a URL which refers back to the same server. With UseCanonicalName on Apache will - use the hostname and port specified in the ServerName directive to construct a canonical + use the hostname and port specified in the ServerName directive to construct the canonical name for the server. This name is used in all self-referential URLs, and for the values of SERVER_NAME and SERVER_PORT in CGIs.

+

For example, if ServerName is set to + www.example.com and Port is set + to 9090, then the canonical name of the server + is www.example.com:9090. In the event that + Port has its default value of + 80, the :80 is ommitted from the + canonical name.

+

With UseCanonicalName off Apache will form self-referential URLs using the hostname and port supplied by the client if any are supplied (otherwise it will use the - canonical name). These values are the same that are used to - implement name based - virtual hosts, and are available with the same clients. The - CGI variables SERVER_NAME and - SERVER_PORT will be constructed from the client - supplied values as well.

+ canonical name, as defined above). These values are the same + that are used to implement name based virtual hosts, + and are available with the same clients. The CGI variables + SERVER_NAME and SERVER_PORT will be + constructed from the client supplied values as well.

An example where this may be useful is on an intranet server where you have users connecting to the machine using short @@ -1707,8 +1714,9 @@ port then Apache will redirect them to http://www.domain.com/splat/. If you have authentication enabled, this will cause the user to have to - reauthenticate twice (once for www and once again - for www.domain.com). But if + authenticate twice (once for www and once again + for www.domain.com -- see the + FAQ on this subject for more information). But if UseCanonicalName is set off, then Apache will redirect to http://www/splat/.

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml index 6e7ecdd070..7b090b29aa 100644 --- a/docs/manual/mod/core.xml +++ b/docs/manual/mod/core.xml @@ -2441,20 +2441,28 @@ port self-referential URL. That is, a URL which refers back to the same server. With UseCanonicalName on Apache will use the hostname and port specified in the ServerName directive to construct a canonical + module="core">ServerName directive to construct the canonical name for the server. This name is used in all self-referential URLs, and for the values of SERVER_NAME and SERVER_PORT in CGIs.

+

For example, if ServerName is set to + www.example.com and Port is set + to 9090, then the canonical name of the server + is www.example.com:9090. In the event that + Port has its default value of + 80, the :80 is ommitted from the + canonical name.

+

With UseCanonicalName off Apache will form self-referential URLs using the hostname and port supplied by the client if any are supplied (otherwise it will use the - canonical name). These values are the same that are used to - implement name based - virtual hosts, and are available with the same clients. The - CGI variables SERVER_NAME and - SERVER_PORT will be constructed from the client - supplied values as well.

+ canonical name, as defined above). These values are the same + that are used to implement name based virtual hosts, + and are available with the same clients. The CGI variables + SERVER_NAME and SERVER_PORT will be + constructed from the client supplied values as well.

An example where this may be useful is on an intranet server where you have users connecting to the machine using short @@ -2464,8 +2472,10 @@ port slash then Apache will redirect them to http://www.domain.com/splat/. If you have authentication enabled, this will cause the user to have to - reauthenticate twice (once for www and once again - for www.domain.com). But if + authenticate twice (once for www and once again + for www.domain.com -- see the + FAQ on this subject for more information). But if UseCanonicalName is set off, then Apache will redirect to http://www/splat/.