Commit 4253176b authored by Martin Kraemer's avatar Martin Kraemer
Browse files

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
parent f951e3cd

docs/manual/invoking.html

+23 −1
Changes for docs/manual/invoking.html: 23 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -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>

docs/manual/invoking.html.en

+23 −1
Changes for docs/manual/invoking.html.en: 23 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -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>