Bug 63717 - Meaning of _default_ seems to have changed in 2.4, yet not reflected in documentation
Summary: Meaning of _default_ seems to have changed in 2.4, yet not reflected in docum...
Status: NEW
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.4.41
Hardware: PC All
: P2 normal (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-09-02 15:29 UTC by Stefan Seidel
Modified: 2019-09-02 16:41 UTC (History)
0 users



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Stefan Seidel 2019-09-02 15:29:22 UTC
In the docs for <VirtualHost>: https://httpd.apache.org/docs/2.4/mod/core.html#virtualhost it is said that _default_ is an alias for *. This has changed from 2.2, where _default_ indicated a "catch-all" for unmatched hosts.

I seems that the pages
https://httpd.apache.org/docs/2.4/vhosts/examples.html
and
https://httpd.apache.org/docs/2.4/vhosts/details.html
have not been brought up to date with this information.

Some testing seems to confirm that _default_ is nothing special anymore and if in doubt, Apache HTTPD 2.4 will use the first <VirtualHost> declaration if the request hostname does not match any declared ServerName or ServerAlias.

Is this correct, and if so, can the documentation be adjusted accordingly?
Comment 1 Eric Covener 2019-09-02 16:02:22 UTC
As far as I can tell _default_ was not treated differently from * in 2.2 either. Do you have any results that imply the references to _default_ shouldn't just be removed from those topics?
Comment 2 Stefan Seidel 2019-09-02 16:41:50 UTC
Well, in 2.2 the <VirtualHost> docs say:
> "The string _default_, which is used only with IP virtual hosting to catch unmatched IP addresses."

So this seems a difference to me, but I have never actively used it so I cannot vouch for it.

But yes, I think the references to _default_ can be removed from the documentation. I tried all kinds of combinations and it doesn't seem to have any special meaning, and a look through the source code also only reveals that it is an alias of "*" (line 190 of vhost.c)