www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2026-01-06 09:01:14 +03:00
Code Activity

Added documentation for the new EnableMMAP directive

Browse Source 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@95100 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Brian Pane
2002-05-15 00:24:15 +00:00
parent 6f15a6a898
commit 913591354a
1 changed files with 39 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/manual/mod/core.xml
View File

@@ -544,6 +544,45 @@ from the web</description>
Location</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>EnableMMAP</name>
<description>Controls whether the httpd uses memory-mapping to read files
during delivery</description>
<syntax>EnableMMAP on|off</syntax>
<default>EnableMMAP on</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<usage>
<p>This directive controls whether the httpd may use memory-mapping
if it needs to read the contents of a file during delivery. By default,
when the handling of a request requires access to the data within a file--
for example, when delivering a server-parsed file using <module>mod_include</module>--
Apache memory-maps the file if the OS supports it.
</p>
<p>
This memory-mapping sometimes yields a performance improvement.
But in some environments, it is better to disable the memory-mapping
to prevent operational problems:
</p>
<ul>
<li>On some multiprocessor systems, memory-mapping can reduce the
performance of the httpd.</li>
<li>With an NFS-mounted <directive module="core">DocumentRoot</directive>,
the httpd may crash due tof a segmentation fault if a file is deleted
or truncated while the httpd has it memory-mapped.</li>
</ul>
<p>
For server configurations that are vulnerable to these problems,
you should disable memory-mapping of delivered files by specifying:
</p>
<example>
EnableMMAP off
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ErrorDocument</name>
<description>Specifies what the server will return to the client