.el .ne 3
.IP "\\$1" \\$2
..
-.TH "APACHECTL" 8 "2003-11-25" "Apache HTTP Server" "apachectl"
+.TH "APACHECTL" 8 "2005-05-03" "Apache HTTP Server" "apachectl"
.SH NAME
apachectl \- Apache HTTP Server Control Interface
Run a configuration file syntax test\&. It parses the configuration files and either reports Syntax Ok or detailed information about the particular syntax error\&. This is equivalent to apachectl -t\&.
.PP
-The following additional option is available, but deprecated\&.
+The following option was available in earlier versions but has been removed\&.
.TP
startssl
-This is equivalent to apachectl -k start -DSSL\&. We recommend that you use that command explicitly, or you adjust your httpd\&.conf to remove the <IfDefine> section so that SSL will always be available\&.
+To start httpd with SSL support, you should edit your configuration file to include the relevant directives and then use the normal apachectl start\&.
(<code>%t</code>)</dt>
<dd>
- The time that the server finished processing the request.
+ The time that the request was received.
The format is:
<p class="indent">
<?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
-<!-- English Revision: 151408 -->
+<!-- English Revision: 151408:165671 (outdated) -->
<!--
Copyright 2002-2005 The Apache Software Foundation or its licensors,
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ko.xsl"?>
-<!-- English Revision: 105989:151408 (outdated) -->
+<!-- English Revision: 105989:165671 (outdated) -->
<!--
Copyright 2003-2005 The Apache Software Foundation or its licensors,
<variants>
<variant>en</variant>
- <variant>ja</variant>
+ <variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>
</variants>
</metafile>
or a message. Apache will sometimes offer additional information
regarding the problem/error.</p>
- <p>URLs can begin with a slash (/) for local URLs, or be a full
- URL which the client can resolve. Alternatively, a message can
- be provided to be displayed by the browser. Examples:</p>
+ <p>URLs can begin with a slash (/) for local web-paths (relative
+ to the <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), or be a
+ full URL which the client can resolve. Alternatively, a message
+ can be provided to be displayed by the browser. Examples:</p>
<div class="example"><p><code>
ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
error rather than masking it. More information is available in
Microsoft Knowledge Base article <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
+ <p>Although most error messages can be overriden, there are certain
+ circumstances where the internal messages are used regardless of the
+ setting of <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. In
+ particular, if a malformed request is detected, normal request processing
+ will be immediately halted and the internal error message returned.
+ This is necessary to guard against security problems caused by
+ bad requests.</p>
+
<p>Prior to version 2.0, messages were indicated by prefixing
them with a single unmatched double quote character.</p>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
-<!-- English Revision: 161140 -->
+<!-- English Revision: 161140:167959 (outdated) -->
<!--
Copyright 2003-2005 The Apache Software Foundation or its licensors,
<?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 161140 -->
+<!-- English Revision: 161140:167959 (outdated) -->
<!--
Copyright 2003-2005 The Apache Software Foundation or its licensors,
<relpath>..</relpath>
<variants>
- <variant>de</variant>
+ <variant outdated="yes">de</variant>
<variant>en</variant>
- <variant>ja</variant>
+ <variant outdated="yes">ja</variant>
</variants>
</metafile>
</dl>
-<p>The following additional option is available, but deprecated.</p>
+<p>The following option was available in earlier versions but has been removed.</p>
<dl>
<dt><code>startssl</code></dt>
-<dd>This is equivalent to <code>apachectl -k start -DSSL</code>. We
-recommend that you use that command explicitly, or you adjust your
-<code>httpd.conf</code> to remove the <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> section so that SSL will always be
-available.</dd>
+<dd>To start <code class="program"><a href="../programs/httpd.html">httpd</a></code> with SSL support, you should edit
+your configuration file to include the relevant directives and then
+use the normal <code>apachectl start</code>.</dd>
</dl>
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
-<!-- English Revision: 105989:151408 (outdated) -->
+<!-- English Revision: 105989:167936 (outdated) -->
<!--
Copyright 2004-2005 The Apache Software Foundation or its licensors,
the <code>conf/extra/</code> directive of the installed
server.</li>
+ <li>The <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> option
+ <code>startssl</code> is no longer available. To enable ssl
+ support, you should edit <code>httpd.conf</code> to include the
+ relevant <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> directives and then use
+ <code>apachectl start</code> to start the server. An example
+ configuration to activate <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> has been included
+ in <code>conf/extra/httpd-ssl.conf</code>.</li>
+
<li>The default setting of <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> is now
<code>Off</code>. If you did not have this directive in your
config file, you can add <code>UseCanonicalName On</code> to
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.de.xsl"?>
-<!-- English Revision: 151408:160702 (outdated) -->
+<!-- English Revision: 151408:167912 (outdated) -->
<!--
Copyright 2002-2005 The Apache Software Foundation or its licensors,
<?xml version='1.0' encoding='iso-2022-jp' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
-<!-- English Revision: 151408:160702 (outdated) -->
+<!-- English Revision: 151408:167912 (outdated) -->
<!--
Copyright 2002-2005 The Apache Software Foundation or its licensors,
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ko.xsl"?>
-<!-- English Revision: 151408:160702 (outdated) -->
+<!-- English Revision: 151408:167912 (outdated) -->
<!--
Copyright 2003-2005 The Apache Software Foundation or its licensors,
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.pt-br.xsl"?>
-<!-- English Revision: 151408:160702 (outdated) -->
+<!-- English Revision: 151408:167912 (outdated) -->
<!--
Copyright 2005 The Apache Software Foundation or its licensors,
<?xml version='1.0' encoding='KOI8-R' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?>
-<!-- English Revision: 96997:160702 (outdated) -->
+<!-- English Revision: 96997:167912 (outdated) -->
<!--
Copyright 2002-2005 The Apache Software Foundation or its licensors,