bottleneck testcase based on rubbos
[bottlenecks.git] / rubbos / app / apache2 / manual / faq / all_in_one.html.en
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5               This file is generated from xml source: DO NOT EDIT
6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7       -->
8 <title>Frequently Asked Questions - Apache HTTP Server</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
15 <p class="apache">Apache HTTP Server Version 2.0</p>
16 <img alt="" src="../images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
18 <div id="path">
19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.0</a> &gt; <a href="./">FAQ</a></div><div id="page-content"><div id="preamble"><h1>Frequently Asked Questions</h1>
20 <div class="toplang">
21 <p><span>Available Languages: </span><a href="../en/faq/all_in_one.html" title="English">&nbsp;en&nbsp;</a> |
22 <a href="../ko/faq/all_in_one.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
23 <a href="../tr/faq/all_in_one.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
24 </div>
25
26     <p>The latest version of this FAQ is always available from the main Apache
27     web site, at &lt;<a href="http://httpd.apache.org/docs/2.0/faq/">http://httpd.apache.org/docs/2.0/faq/</a>&gt;.</p>
28
29     <p>Since Apache 2.0 is quite new, we don't yet know what the <em>Frequently
30     Asked Questions</em> will be. While this section fills up, you should also
31     consult the <a href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
32     FAQ</a> to see if your question is answered there.</p>
33 </div>
34 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#topics">Topics</a></li>
35 <li><img alt="" src="../images/down.gif" /> <a href="#support">Support</a></li>
36 <li><img alt="" src="../images/down.gif" /> <a href="#error">Error Messages</a></li>
37 </ul></div>
38 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
39 <div class="section">
40 <h2><a id="topics" name="topics">Topics</a></h2>
41 <dl><dt><a href="#support">Support</a></dt><dd>What do I do when I have problems?</dd>
42 <dt><a href="#error">Error Messages</a></dt><dd>What does this error message mean?</dd>
43 </dl></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
44 <div class="section">
45 <h2><a name="support" id="support">Support</a></h2>
46     <ul>
47     <li><a href="#support.what2do">"Why can't I ...? Why won't ... work?" What
48     to do in case of problems</a></li>
49
50     <li><a href="#support.support">Whom do I contact for support?</a></li>
51     </ul>
52
53     <h3><a name="support.what2do" id="support.what2do">"Why can't I ...? Why won't ... work?" What to do in case of
54     problems</a></h3>
55     
56
57       <p>If you are having trouble with your Apache server software, you should
58       take the following steps:</p>
59
60       <dl>
61       <dt>Check the errorlog!</dt>
62       <dd>Apache tries to be helpful when it encounters a problem. In many
63       cases, it will provide some details by writing one or messages to the
64       server error log. Sometimes this is enough for you to diagnose &amp; fix
65       the problem yourself (such as file permissions or the like). The default
66       location of the error log is
67       <code>/usr/local/apache2/logs/error_log</code>, but see the <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> directive in your config files for the
68       location on your server.</dd>
69
70       <dt>Check the <a href="http://httpd.apache.org/docs/2.0/faq/">FAQ</a>!</dt>
71       <dd>The latest version of the Apache Frequently-Asked Questions list can
72       always be found at the main Apache web site.</dd>
73
74       <dt>Check the Apache bug database</dt>
75       <dd>Most problems that get reported to The Apache Group are recorded in
76       the <a href="http://httpd.apache.org/bug_report.html">bug database</a>.
77       <strong>Please</strong> check the existing reports, open
78       <strong>and</strong> closed, before adding one. If you find that your
79       issue has already been reported, please <em>don't</em> add a "me, too"
80       report. If the original report isn't closed yet, we suggest that you
81       check it periodically. You might also consider contacting the original
82       submitter, because there may be an email exchange going on about the
83       issue that isn't getting recorded in the database.</dd>
84
85       <dt><a id="support.what2do.user-support" name="support.what2do.user-support">Ask in a user support forum</a></dt>
86       <dd><p>Apache has an active community of users who are willing to share
87       their knowledge. Participating in this community is usually the best and
88       fastest way to get answers to your questions and problems.</p>
89
90       <p><a href="http://httpd.apache.org/userslist.html">Users
91       mailing list</a></p>
92
93       <p><a href="irc://irc.freenode.net/#httpd">#httpd</a> on 
94       <a href="http://freenode.net">Freenode IRC</a> is available for 
95       user support issues.</p>
96
97       <p>USENET newsgroups:</p>
98
99       <ul>
100       <li>comp.infosystems.www.servers.unix
101       [<a href="news:comp.infosystems.www.servers.unix">news</a>]
102       [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.unix">google</a>]
103       </li>
104
105       <li>comp.infosystems.www.servers.ms-windows
106       [<a href="news:comp.infosystems.www.servers.ms-windows">news</a>]
107       [<a href="http://groups.google.com/groups?group=comp.infosystems.www.servers.ms-windows">google</a>]
108       </li>
109
110       <li>comp.infosystems.www.authoring.cgi
111       [<a href="news:comp.infosystems.www.authoring.cgi">news</a>]
112       [<a href="http://groups.google.com/groups?group=comp.infosystems.www.authoring.cgi">google</a>]
113       </li>
114       </ul></dd>
115
116       <dt>If all else fails, report the problem in the bug database</dt>
117       <dd><p>If you've gone through those steps above that are appropriate and
118       have obtained no relief, then please <em>do</em> let the httpd developers
119       know about the problem by <a href="http://httpd.apache.org/bug_report.html">logging a bug
120       report</a>.</p>
121
122       <p>If your problem involves the server crashing and generating a core
123       dump, please include a backtrace (if possible). As an example,</p>
124
125       <div class="example"><p><code>
126         # cd <var>ServerRoot</var><br />
127         # dbx <var>httpd</var> <var>core</var><br />
128         (dbx) where
129       </code></p></div>
130
131       <p>(Substitute the appropriate locations for your <var>ServerRoot</var>
132       and your <var>httpd</var> and <var>core</var> files. You may have to use
133       <code>gdb</code> instead of <code>dbx</code>.)</p>
134       </dd>
135       </dl>
136     
137
138     <h3><a name="support.support" id="support.support">Whom do I contact for support?</a></h3>
139       <p>With several million users and fewer than forty volunteer developers,
140       we cannot provide personal support for Apache. For free support, we
141       suggest participating in a <a href="#support.what2do.user-support">user forum</a>.</p>
142
143       <p>Professional, commercial support for Apache is available from
144       <a href="http://www.apache.org/info/support.cgi">a number of
145       companies</a>.</p>
146     
147 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
148 <div class="section">
149 <h2><a name="error" id="error">Error Messages</a></h2>
150     <ul>
151     <li><a href="#error.sendfile">Invalid argument:
152     core_output_filter: writing data to the network</a></li>
153     <li><a href="#error.acceptex">AcceptEx failed</a></li>
154     <li><a href="#error.scriptheaders">Premature end of script 
155     headers</a></li>
156     </ul>
157
158     <h3><a name="error.sendfile" id="error.sendfile">Invalid argument:
159     core_output_filter: writing data to the network</a></h3>
160
161     <p>Apache uses the <code>sendfile</code> syscall on platforms
162     where it is available in order to speed sending of responses.
163     Unfortunately, on some systems, Apache will detect the presence of
164     <code>sendfile</code> at compile-time, even when it does not work
165     properly.  This happens most frequently when using network or
166     other non-standard file-system.</p>
167
168     <p>Symptoms of this problem include the above message in the error
169     log and zero-length responses to non-zero-sized files.  The
170     problem generally occurs only for static files, since dynamic
171     content usually does not make use of <code>sendfile</code>.</p>
172
173     <p>To fix this problem, simply use the <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> directive to disable
174     <code>sendfile</code> for all or part of your server.  Also see
175     the <code class="directive"><a href="../mod/core.html#enablemmap">EnableMMAP</a></code>, which can
176     help with similar problems.</p>
177
178     
179
180     <h3><a name="error.acceptex" id="error.acceptex">AcceptEx Failed</a></h3>
181
182     <p>If you get error messages related to the <code>AcceptEx</code> syscall
183     on win32, see the <code class="directive"><a href="../mod/mpm_winnt.html#win32disableacceptex">Win32DisableAcceptEx</a></code>
184     directive.</p>
185     
186
187
188     <h3><a name="error.scriptheaders" id="error.scriptheaders">Premature end of script 
189     headers</a></h3>
190
191     <p>Most problems with CGI scripts result in this message written in the
192     error log together with an <code>Internal Server Error</code> delivered
193     to the browser.  A guide to helping debug this type of problem is
194     available in the <a href="../howto/cgi.html#troubleshoot">CGI
195     tutorial</a>.</p>
196     
197
198 </div></div>
199 <div class="bottomlang">
200 <p><span>Available Languages: </span><a href="../en/faq/all_in_one.html" title="English">&nbsp;en&nbsp;</a> |
201 <a href="../ko/faq/all_in_one.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
202 <a href="../tr/faq/all_in_one.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
203 </div><div id="footer">
204 <p class="apache">Copyright 2009 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>
205 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
206 </body></html>