Bug 87975 - comments in httpd.conf references incorrect virtual host query syntax
Summary: comments in httpd.conf references incorrect virtual host query syntax
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: httpd
Version: 8.0
Hardware: i386
OS: Linux
Target Milestone: ---
Assignee: Joe Orton
QA Contact: Brian Brock
Depends On:
TreeView+ depends on / blocked
Reported: 2003-04-04 05:08 UTC by Karsten Wade
Modified: 2007-04-18 16:52 UTC (History)
0 users

Fixed In Version: 2.0.45-1
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed: 2003-05-13 13:13:33 UTC

Attachments (Terms of Use)

Description Karsten Wade 2003-04-04 05:08:21 UTC
Description of problem:
The file /etc/httpd/conf/httpd.conf has a reference to the command 'httpd -S' to
query the format/syntax of the virtual host section.  This syntax has changed to
 the following:

  -t -D DUMP_VHOSTS : show parsed settings (currently only vhost settings)
  -t                : run syntax check for config files

The section in question appears at the end of the file; the line number is 1013
in the default install file:

# You may use the command line option '-S' to verify your virtual host
# configuration.

The lines above that point the user at the following URL for Apache documentation:


That URL repeats the documentation error, and in fact offers a command which
does not work:

  [root@hostname root]# /usr/local/apache2/bin/httpd -S
  -bash: /usr/local/apache2/bin/httpd: No such file or directory

The application 'httpd' is now in /usr/sbin/.

Version-Release number of selected component (if applicable):

Red Hat Linux 8.0 on i386
  All errata installed
  No customizations to installed paths/procedures

How reproducible:

So far, always in all installs I have seen of 8.0.  The -S option works in at
least Red Hat Enterprise Linux AS (2.1), so I presume this was changed and not
correctly documented by the Apache project.

Steps to Reproduce:
1. Install Apache package for Red Hat Linux 8.0
2. Check file /etc/httpd/conf/httpd.conf, line 1013
3. Try that command, note return of --help results for httpd
Actual results:

The documented step 'httpd -S' no longer tests the syntax of httpd.conf, 'httpd
-t' does

Expected results:

That the option change is documented correctly.

Additional info:

Comment 1 Joe Orton 2003-04-04 08:58:33 UTC
Thanks for the report; yes, this comment should give "-t -D DUMP_VHOSTS" for
this version.

Comment 2 Joe Orton 2003-05-13 13:13:33 UTC
I won't change the default config in an erratum, so this won't get fixed for 8.0
or 9 - the comment is now correct for 2.0.45 in Raw Hide.

Note You need to log in before you can comment on or make changes to this bug.