summaryrefslogtreecommitdiff
path: root/docs/manual/invoking.html
diff options
context:
space:
mode:
authorMartin Kraemer <martin@apache.org>1998-07-19 21:34:58 +0000
committerMartin Kraemer <martin@apache.org>1998-07-19 21:34:58 +0000
commiteb30786813533d0b93d7c9b27a5dc0f4e4d94c63 (patch)
tree1b47a1783e89a49676a1ab7eeceba76e03aba9e8 /docs/manual/invoking.html
parent03c9ede3adf54a556edaa71e49aa086dc1733ffd (diff)
downloadhttpd-eb30786813533d0b93d7c9b27a5dc0f4e4d94c63.tar.gz
Add new httpd switches; remove reference to httpd sub-version
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@81779 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/invoking.html')
-rw-r--r--docs/manual/invoking.html24
1 files changed, 23 insertions, 1 deletions
diff --git a/docs/manual/invoking.html b/docs/manual/invoking.html
index df0a4d0445..3888fc3b57 100644
--- a/docs/manual/invoking.html
+++ b/docs/manual/invoking.html
@@ -32,12 +32,28 @@ The following options are recognized on the httpd command line:
<EM>serverroot</EM>. This can be overridden by the ServerRoot command in the
configuration file. The default is <CODE>/usr/local/apache</CODE>.
+<DT><CODE>-D</CODE> <EM>name</EM>
+<DD>Define a name for use in in
+<A HREF="mod/core.html#ifdefine">IfDefine</A> directives.
+This option can be used to optionally enable certain functionality in the
+configuration file, or to use a common configuration for
+several independent hosts, where host specific information is enclosed in
+&lt;IfDefine&gt; sections.
+
<DT><CODE>-f</CODE> <EM>config</EM>
<DD>Execute the commands in the file <EM>config</EM> on startup. If
<EM>config</EM> does not begin with a <CODE>/</CODE>, then it is taken to be a
path relative to the <A HREF="mod/core.html#serverroot">ServerRoot</A>. The
default is <CODE>conf/httpd.conf</CODE>.
+<DT><CODE>-C</CODE> <EM>"directive"</EM>
+<DD>Process the given apache "directive" (just as if it had been part of a
+configuration file) <STRONG>before</STRONG> actually reading the regular configuration files.
+
+<DT><CODE>-c</CODE> <EM>"directive"</EM>
+<DD>Process the given apache "directive" <STRONG>after</STRONG> reading
+all the regular configuration files.
+
<DT><CODE>-X</CODE>
<DD>Run in single-process mode, for internal debugging purposes only; the
daemon does not detach from the terminal or fork any children. Do <EM>NOT</EM>
@@ -47,7 +63,7 @@ use this mode to provide ordinary web service.
<DD>Print the version of httpd and its build date, and then exit.
<DT><A NAME="version"><CODE>-V</CODE></A>
-<DD>Print the base version of httpd, its sub-version if defined, its
+<DD>Print the base version of httpd, its
build date, and a list of compile time settings which influence the
behavior and performance of the apache server (<EM>e.g.</EM>,
<SAMP>-DUSE_MMAP_FILES</SAMP>),
@@ -64,6 +80,12 @@ places where the directive is valid. (New in Apache 1.2)
<DD>Show the settings as parsed from the config file (currently only
shows a breakdown of the vhost settings).
+<DT><CODE>-t</CODE>
+<DD>Test the configuration file syntax (i.e., read all configuration files
+and interpret them) but do not start the server. If the configuration contains
+errors, display an error message and exit with a non-zero exit status,
+otherwise display "Syntax OK" and terminate with a zero exit status.
+
<DT><CODE>-?</CODE>
<DD>Print a list of the httpd options, and then exit.
</DL>