Bug 87975 - comments in httpd.conf references incorrect virtual host query syntax
comments in httpd.conf references incorrect virtual host query syntax
Product: Red Hat Linux
Classification: Retired
Component: httpd (Show other bugs)
i386 Linux
medium Severity low
: ---
: ---
Assigned To: Joe Orton
Brian Brock
Depends On:
  Show dependency treegraph
Reported: 2003-04-04 00:08 EST by Karsten Wade
Modified: 2007-04-18 12:52 EDT (History)
0 users

See Also:
Fixed In Version: 2.0.45-1
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2003-05-13 09:13:33 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Karsten Wade 2003-04-04 00:08:21 EST
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 03:58:33 EST
Thanks for the report; yes, this comment should give "-t -D DUMP_VHOSTS" for
this version.
Comment 2 Joe Orton 2003-05-13 09:13:33 EDT
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.