<p><span>Available Languages: </span><a href="../en/programs/httpd.html" title="English"> en </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<p><code>httpd</code> is the Apache HyperText Transfer Protocol
(HTTP) server program. It is designed to be run as a standalone
daemon process. When used like this it will create a pool of
child processes or threads to handle requests.</p>
<p>In general, <code>httpd</code> should not be invoked directly,
but rather should be invoked via <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> on Unix-based systems or <a href="../platform/windows.html#winsvc">as a service on Windows NT,
2000 and XP</a> and <a href="../platform/windows.html#wincons">as
a console application on Windows 9x and ME</a>.</p>
in the configuration files to conditionally skip or process commands
at server startup and restart. Also can be used to set certain
less-common startup parameters including <code>-DNO_DETACH</code>
(prevent the parent from forking) and <code>-DFOREGROUND</code>
(prevent the parent from calling <code>setsid()</code> et al).</dd>
<dt><code>-e <var>level</var></code></dt>
<dd>Sets the <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> to
<var>level</var> during server startup. This is useful for
temporarily increasing the verbosity of the error messages to find
problems during startup.</dd>
<dt><code>-E <var>file</var></code></dt>
<dd>Send error messages during server startup to <var>file</var>.</dd>
<dt><code>-R <var>directory</var></code></dt>
<dd>When the server is compiled using the <code>SHARED_CORE</code>
rule, this specifies the <var>directory</var> for the shared
object files.</dd>
<dt><code>-h</code></dt>
<dd>Output a short summary of available command line options.</dd>
<dt><code>-l</code></dt>
<dd>Output a list of modules compiled into the server. This will
<strong>not</strong> list dynamically loaded modules included using
the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</dd>
<dt><code>-L</code></dt>
<dd>Output a list of directives together with expected arguments and
places where the directive is valid.</dd>
<dt><code>-M</code></dt>
<dd>Dump a list of loaded Static and Shared Modules.</dd>
<dt><code>-S</code></dt>
<dd>Show the settings as parsed from the config file (currently only
shows the virtualhost settings).</dd>
<dt><code>-t</code></dt>
<dd>Run syntax tests for configuration files only. The program
immediately exits after these syntax parsing tests with either a return code
of 0 (Syntax OK) or return code not equal to 0 (Syntax Error). If -D
<var>DUMP</var>_<var>VHOSTS </var>is also set, details of the virtual host
configuration will be printed. If -D <var>DUMP</var>_<var>MODULES </var> is
set, all loaded modules will be printed.</dd>
<dt><code>-v</code></dt>
<dd>Print the version of <code>httpd</code>, and then exit.</dd>
<dt><code>-V</code></dt>
<dd>Print the version and build parameters of <code>httpd</code>, and
then exit.</dd>
<dt><code>-X</code></dt>
<dd>Run httpd in debug mode. Only one worker will be started and the
server will not detach from the console.</dd>
</dl>
<p>The following arguments are available only on the <a href="../platform/windows.html">Windows platform</a>:</p>
<dl>
<dt><code>-k install|config|uninstall</code></dt>
<dd>Install Apache as a Windows NT service; change startup options for
the Apache service; and uninstall the Apache service.</dd>
<dt><code>-n <var>name</var></code></dt>
<dd>The <var>name</var> of the Apache service to signal.</dd>
<dt><code>-w</code></dt>
<dd>Keep the console window open on error so that the error message can
be read.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/httpd.html" title="English"> en </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2007 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
