www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2026-10-23 22:49:01 +03:00
Code Activity

Regenerate docs.

Browse Source 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1938253 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Joe Orton
2026-09-15 15:10:10 +00:00
parent 2fc5be40ba
commit 313986a96e
28 changed files with 454 additions and 434 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/manual/caching.html.en.utf8
View File

@@ -433,7 +433,7 @@ Vary: negotiate,accept-language,accept-charset
<p>Typically the module will be configured as so;</p>
<pre class="prettyprint lang-config">CacheRoot "/var/cache/apache/"
<pre class="prettyprint lang-config">CacheRoot "/var/cache/apache"
CacheEnable disk /
CacheDirLevels 2
CacheDirLength 1</pre>

2
docs/manual/howto/cgi.html.en.utf8
View File

@@ -486,7 +486,7 @@ import os
print("Content-type: text/html\n")
for key, value in os.environ.items():
print(f"{key} --&gt; {value}&lt;br&gt;")</pre>
print(f"{key} --&gt; {value}&lt;br&gt;")</pre>
</div>

2
docs/manual/mod/allmodules.xml
View File

@@ -80,8 +80,8 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>
<modulefile>mod_policy.xml</modulefile>

1
docs/manual/mod/allmodules.xml.de
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

1
docs/manual/mod/allmodules.xml.es
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

1
docs/manual/mod/allmodules.xml.fr
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml.fr</modulefile>
<modulefile>mod_md.xml.fr</modulefile>
<modulefile>mod_mime.xml.fr</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml.fr</modulefile>
<modulefile>mod_negotiation.xml.fr</modulefile>
<modulefile>mod_nw_ssl.xml.fr</modulefile>

1
docs/manual/mod/allmodules.xml.ja
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml.ja</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml.ja</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

1
docs/manual/mod/allmodules.xml.ko
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

1
docs/manual/mod/allmodules.xml.tr
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

1
docs/manual/mod/allmodules.xml.zh-cn
View File

@@ -80,6 +80,7 @@
<modulefile>mod_macro.xml</modulefile>
<modulefile>mod_md.xml</modulefile>
<modulefile>mod_mime.xml</modulefile>
<modulefile>mod_mime_libmagic.xml</modulefile>
<modulefile>mod_mime_magic.xml</modulefile>
<modulefile>mod_negotiation.xml</modulefile>
<modulefile>mod_nw_ssl.xml</modulefile>

4
docs/manual/mod/directives.html.en.utf8
View File

@@ -531,6 +531,10 @@
<li><a href="mod_cern_meta.html#metadir">MetaDir</a></li>
<li><a href="mod_cern_meta.html#metafiles">MetaFiles</a></li>
<li><a href="mod_cern_meta.html#metasuffix">MetaSuffix</a></li>
<li><a href="mod_mime_libmagic.html#mimelibmagic">MimeLibmagic</a></li>
<li><a href="mod_mime_libmagic.html#mimelibmagicbytes">MimeLibmagicBytes</a></li>
<li><a href="mod_mime_libmagic.html#mimelibmagiccharset">MimeLibmagicCharset</a></li>
<li><a href="mod_mime_libmagic.html#mimelibmagicfile">MimeLibmagicFile</a></li>
<li><a href="mod_mime_magic.html#mimemagicdecompression">MimeMagicDecompression</a></li>
<li><a href="mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></li>
<li><a href="mod_mime.html#mimeoptions">MimeOptions</a></li>

2
docs/manual/mod/index.html.en.utf8
View File

@@ -180,6 +180,8 @@ request processing</dd>
with the file's behavior (handlers and filters)
and content (mime-type, language, character set and
encoding)</dd>
<dt><a href="mod_mime_libmagic.html">mod_mime_libmagic</a></dt><dd>Determines the MIME type of a file from its contents
using libmagic</dd>
<dt><a href="mod_mime_magic.html">mod_mime_magic</a></dt><dd>Determines the MIME type of a file
by looking at a few bytes of its contents</dd>
<dt><a href="mod_negotiation.html" id="N" name="N">mod_negotiation</a></dt><dd>Provides for <a href="../content-negotiation.html">content negotiation</a></dd>

127
docs/manual/mod/mod_auth_digest.html.en.utf8
View File

@@ -38,15 +38,19 @@
<h3>Summary</h3>
<p>This module implements HTTP Digest Authentication
(<a href="https://www.rfc-editor.org/rfc/rfc2617">RFC 2617</a>), and
provides an alternative to <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> where the
password is not transmitted as cleartext. However, this does
<strong>not</strong> lead to a significant security advantage over
basic authentication. On the other hand, the password storage on the
server is much less secure with digest authentication than with
basic authentication. Therefore, using basic auth and encrypting the
whole connection using <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> is a much better
alternative.</p>
(<a href="https://www.rfc-editor.org/rfc/rfc2617">RFC 2617</a>), an alternative to the Basic authentication provided
by <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> in which the password is not sent
over the network in cleartext.</p>
<p>Basic and Digest are both authentication schemes only: they
establish who the client is, and do nothing for the confidentiality or
integrity of the request and response themselves. Over an unencrypted
connection the contents of every request and response are exposed with
either scheme; Digest's one advantage is that the password is not among
them. Digest is therefore not a substitute for a connection secured
with <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, which protects the credentials and the
data alike, and that one advantage has limits of its own (see the note
below).</p>
</div>
<div id="quickview"><h3>Topics</h3>
<ul id="topics">
@@ -95,26 +99,26 @@
<div class="note"><h3>Note</h3>
<p>Digest authentication was intended to be more secure than basic
authentication, but no longer fulfills that design goal. A
man-in-the-middle attacker can trivially force the browser to downgrade
to basic authentication. And even a passive eavesdropper can brute-force
the password using today's graphics hardware, because the hashing
algorithm used by digest authentication is too fast. Another problem is
that the storage of the passwords on the server is insecure. The contents
of a stolen htdigest file can be used directly for digest authentication.
Therefore using <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> to encrypt the whole connection is
strongly recommended.</p>
<p><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> only works properly on platforms
where APR supports shared memory.</p>
<p>Digest authentication's one advantage over Basic, keeping the
password off the wire, is conditional. If the client will silently fall
back to Basic when challenged, an active attacker can
strip the Digest challenge and offer Basic instead, and the browser
then sends the password in cleartext; a passive eavesdropper can mount
an offline brute-force attack on a captured response, which the fast
MD5 hash does little to slow; and if the <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>
file is stolen its stored hashes can be replayed to authenticate to
that realm directly, without the password itself being recovered.
Encrypt the whole connection with <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> instead.</p>
<p><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> requires an APR built with shared
memory support, and is not built without it.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="authdigestalgorithm"><span id="AuthDigestAlgorithm">AuthDigestAlgorithm</span> Directive <a title="Permanent link" href="#authdigestalgorithm" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Selects the algorithm used to calculate the challenge and
response hashes in digest authentication</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestAlgorithm MD5|MD5-sess</code></td></tr>
response hashes in Digest authentication</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestAlgorithm MD5</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AuthDigestAlgorithm MD5</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
@@ -123,18 +127,13 @@ response hashes in digest authentication</td></tr>
</table>
<p>The <code class="directive">AuthDigestAlgorithm</code> directive
selects the algorithm used to calculate the challenge and response
hashes.</p>
<div class="note">
<code>MD5-sess</code> is not correctly implemented yet.
</div>
hashes. Only <code>MD5</code> is supported.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="authdigestdomain"><span id="AuthDigestDomain">AuthDigestDomain</span> Directive <a title="Permanent link" href="#authdigestdomain" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URIs that are in the same protection space for digest
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URIs that are in the same protection space for Digest
authentication</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
@@ -204,14 +203,31 @@ client</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
<p>The <code class="directive">AuthDigestNonceLifetime</code> directive
controls how long the server nonce is valid. When the client
contacts the server using an expired nonce the server will send
back a 401 with <code>stale=true</code>. If <var>seconds</var> is
greater than 0 then it specifies the amount of time for which the
nonce is valid; this should probably never be set to less than 10
seconds. If <var>seconds</var> is less than 0 then the nonce never
expires.
</p>
controls how long the server nonce is valid. When the client contacts
the server using an expired nonce the server sends back a 401 with
<code>stale=true</code>, and an RFC-compliant client retries with a
fresh nonce without prompting the user.</p>
<ul>
<li>If <var>seconds</var> is greater than 0 then it specifies the
amount of time for which the nonce is valid; this should probably
never be set to less than 10 seconds.</li>
<li>If <var>seconds</var> is 0 then the nonce may be used exactly
once. The server supplies the next nonce in the
<code>Authentication-Info</code> header of each response so the
client can continue; a client which reuses a nonce is answered with
<code>stale=true</code> and retries. One-time nonces give stronger
protection against replaying a captured request, but the client
cannot pipeline requests, and one that does receives a 401 for all
but the first and has to resend them. The protection is worth this
cost mainly for requests that change server state or return content
which varies over time; replaying a request for unchanging content
that the eavesdropper already captured in full gains nothing.</li>
<li>If <var>seconds</var> is less than 0 then the nonce never
expires.</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
@@ -240,29 +256,25 @@ client</td></tr>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="authdigestqop"><span id="AuthDigestQop">AuthDigestQop</span> Directive <a title="Permanent link" href="#authdigestqop" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the quality-of-protection to use in digest
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Determines the quality-of-protection to use in Digest
authentication</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestQop none|auth|auth-int [auth|auth-int]</code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestQop auth</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AuthDigestQop auth</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
</table>
<p>The <code class="directive">AuthDigestQop</code> directive determines
the <dfn>quality-of-protection</dfn> to use. <code>auth</code> will
only do authentication (username/password); <code>auth-int</code> is
authentication plus integrity checking (an MD5 hash of the entity
is also computed and checked); <code>none</code> will cause the module
to use the old RFC-2069 digest algorithm (which does not include
integrity checking). Both <code>auth</code> and <code>auth-int</code> may
be specified, in which the case the browser will choose which of
these to use. <code>none</code> should only be used if the browser for
some reason does not like the challenge it receives otherwise.</p>
<p>The <code class="directive">AuthDigestQop</code> directive determines the
<dfn>quality-of-protection</dfn> to use. Only <code>auth</code>
(authentication) is supported, and it is the default, so this
directive no longer has any effect and is retained only for
compatibility.</p>
<div class="note">
<code>auth-int</code> is not implemented yet.
</div>
<div class="note">Earlier releases also accepted <code>none</code> (the RFC 2069
Digest scheme, without a quality-of-protection). It has been removed:
a request whose <code>qop</code> is missing or not <code>auth</code>
is now rejected.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
@@ -271,7 +283,7 @@ authentication</td></tr>
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The amount of shared memory to allocate for keeping track
of clients</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthDigestShmemSize <var>size</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AuthDigestShmemSize 1000</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AuthDigestShmemSize 8192</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr>
@@ -286,6 +298,13 @@ of clients</td></tr>
<code>0</code> and read the error message after trying to start the
server.</p>
<p>The default holds roughly 140 clients. A client which is discarded
to make room for another is not denied access: it is issued a new
nonce with <code>stale=true</code>, which costs it one extra request.
Note that a request which does not authenticate also takes an entry,
since the challenge sent back to it carries the identifier the client
is tracked by.</p>
<p>The <var>size</var> is normally expressed in Bytes, but you
may follow the number with a <code>K</code> or an <code>M</code> to
express your value as KBytes or MBytes. For example, the following

13
docs/manual/mod/mod_dav_lock.html
View File

@@ -1,13 +0,0 @@
# GENERATED FROM XML -- DO NOT EDIT
URI: mod_dav_lock.html.en.utf8
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: mod_dav_lock.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: mod_dav_lock.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8

110
docs/manual/mod/mod_dav_lock.html.en.utf8
View File

@@ -1,110 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_dav_lock - Apache HTTP Server Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.png" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p>
<p class="apache">Apache HTTP Server Version 2.5</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<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.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache Module mod_dav_lock</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/mod/mod_dav_lock.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Generic locking module for <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr>
<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>dav_lock_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_dav_lock.c</td></tr></table>
<h3>Summary</h3>
<p>This module implements a generic locking API which can be used by any
backend provider of <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. It <em>requires</em> at least
the service of <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. But without a backend provider
which makes use of it, it's useless and should not be loaded into the
server. A sample backend module which actually utilizes
<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> is <a href="http://subversion.apache.org/">mod_dav_svn</a>, the subversion provider module.</p>
<p>Note that <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> does <em>not</em> need this
generic locking module, because it uses its own more specialized
version.</p>
<p>In order to make <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> functional, you just have
to specify the location of the lock database using the <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> directive described
below.</p>
<div class="note"><h3>Developer's Note</h3>
<p>In order to retrieve the pointer to the locking provider function, you
have to use the <code>ap_lookup_provider</code> API with the arguments
<code>dav-lock</code>, <code>generic</code>, and <code>0</code>.</p>
</div>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#davgenericlockdb">DavGenericLockDB</a></li>
</ul>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_dav_lock">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_dav_lock">Report a bug</a></li></ul><h3>See also</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li>
<li><a href="#comments_section">Comments</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a> <a name="davgenericlockdb" id="davgenericlockdb">Directive</a> <a title="Permanent link" href="#davgenericlockdb" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Location of the DAV lock database</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DavGenericLockDB <var>file-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_lock</td></tr>
</table>
<p>Use the <code class="directive">DavGenericLockDB</code> directive to specify
the full path to the lock database, excluding an extension. If
the path is not absolute, it will be interpreted relative to <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. The implementation of
<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> uses a SDBM database to track user
locks.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre>
</div>
<p>The directory containing the lock database file must be
writable by the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>
and <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> under which
Apache is running. For security reasons, you should create a
directory for this purpose rather than changing the permissions on
an existing directory. In the above example, Apache will create
files in the <code>var/</code> directory under the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> with the base filename
<code>DavLock</code> and an extension added by the server.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_dav_lock.html" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 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>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>

119
docs/manual/mod/mod_dav_lock.html.fr.utf8
View File

@@ -1,119 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_dav_lock - Serveur HTTP Apache Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.png" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.5</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_dav_lock</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de verrouillage générique pour
<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_lock_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_lock.c</td></tr></table>
<h3>Sommaire</h3>
<p>ce module implémente une API de verrouillage générique que tout
fournisseur support de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut utiliser. Son
activation nécessite l'utilisation de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Mais
sans fournisseur support pour l'utiliser, il n'est d'aucun service
et ne doit pas être chargé dans le serveur. <a href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui
implémente le fournisseur subversion, est un exemple
de module de support qui utilise effectivement
<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code>.</p>
<p>Notez que <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> n'a <em>pas</em> besoin de
ce module de verrouillage générique, car il utilise sa propre
version plus spécifique.</p>
<p>Pour que <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> puisse fonctionner, il
vous suffit de spécifier le chemin de la base de données des verrous
à l'aide de la directive <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> décrite
ci-dessous.</p>
<div class="note"><h3>Note du développeur</h3>
<p>Pour déterminer le pointeur de la fonction du fournisseur de
verrouillage, vous devez utiliser l'API
<code>ap_lookup_provider</code> avec les arguments
<code>dav-lock</code>, <code>generic</code> et <code>0</code>.</p>
</div>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#davgenericlockdb">DavGenericLockDB</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_dav_lock">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_dav_lock">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li>
<li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="davgenericlockdb" id="davgenericlockdb">Directive</a> <a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a> <a title="Lien permanent" href="#davgenericlockdb" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavGenericLockDB <var>chemin fichier</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_lock</td></tr>
</table>
<p>La directive <code class="directive">DavLockDB</code> spécifie
le chemin complet de la base de données des verrous, sans extension.
Si le chemin n'est pas absolu, il sera considéré comme relatif au
répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. L'implémentation de
<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> utilise une base de données SDBM pour
surveiller les verrous utilisateurs.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre>
</div>
<p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui
sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> doivent pouvoir écrire dans le
répertoire qui contient le fichier de la base de données des
verrous. Pour des raisons de sécurité, il est recommandé de créer un
répertoire dédié à la base de données des verrous, plutôt que de
modifier les permissions d'un répertoire existant. Dans l'exemple
ci-dessus, Apache va créer des fichiers dans le répertoire
<code>var/</code>, lui-même sous-répertoire du répertoire défini par
la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base
<code>DavLock</code> suivi d'une extension choisie par le
serveur.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>

114
docs/manual/mod/mod_dav_lock.html.ja.utf8
View File

@@ -1,114 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_dav_lock - Apache HTTP サーバ バージョン 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.png" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.5</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.5</a> &gt; <a href="./">モジュール</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache モジュール mod_dav_lock</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> 用の汎用ロックモジュール</td></tr>
<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>dav_lock_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_dav_lock.c</td></tr></table>
<h3>概要</h3>
<p>このモジュールは <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> のどのバックエンド
からでも使える汎用ロック API を提供します。
使用には最低限 <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>
を必要としますが、これを利用するバックエンドが存在しないと役に立たないので、
そのような場合はサーバに読み込むべきではありません。
<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code>
を実際に利用するバックエンドモジュールの例としては subversion
プロバイダモジュールの <a href="http://subversion.apache.org/">mod_dav_svn</a> があります。</p>
<p><code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> は特化された専用のバージョンを
使うため、この汎用モジュールは<em>必要ない</em>ことに注意して
ください。</p>
<p><code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> を機能させるには、
以下で説明されている <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> を使って
ロックデータベースの場所を指定するだけです。</p>
<div class="note"><h3>開発者向けのメモ</h3>
<p>ロックを提供している関数へのポインタを取得するためには、
<code>ap_lookup_provider</code> API を、引数 <code>dav-lock</code>,
<code>generic</code>, <code>0</code> を指定して使う必要が
あります。</p>
</div>
</div>
<div id="quickview"><h3 class="directives">ディレクティブ</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#davgenericlockdb">DavGenericLockDB</a></li>
</ul>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_dav_lock">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_dav_lock">Report a bug</a></li></ul><h3>参照</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li>
<li><a href="#comments_section">コメント</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a> <a name="davgenericlockdb" id="davgenericlockdb">ディレクティブ</a> <a title="Permanent link" href="#davgenericlockdb" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>DAV ロックデータベースの場所</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DavGenericLockDB <var>file-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_dav_lock</td></tr>
</table>
<p><code class="directive">DavGenericLockDB</code> ディレクティブを
使って、拡張子を除いたロックデータベースへのフルパスを
指定します。絶対パスでないときは <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> からの相対パスとして
扱われます。<code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> の実装ではユーザの
ロックを追跡するのに SDBM データベースを使います。</p>
<div class="example"><h3>例</h3><pre class="prettyprint lang-config">DavGenericLockDB var/DavLock</pre>
</div>
<p>ロックデータベースファイルのあるディレクトリは
Apache が実行されている <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>
と <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> によって
書き込み可能でなければなりません。セキュリティ上の理由から、
既存のディレクトリのパーミッションを変更するのではなく、
専用のディレクトリを作るのが良いでしょう。上の例では、
Apache は <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> の下の <code>var/</code>
ディレクトリに、ファイル名の本体が <code>DavLock</code> で
サーバが追加する拡張子を持つファイルを作成します。</p>
</div>
</div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_dav_lock.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_dav_lock.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>

5
docs/manual/mod/mod_mime_libmagic.html Normal file
View File

@@ -0,0 +1,5 @@
# GENERATED FROM XML -- DO NOT EDIT
URI: mod_mime_libmagic.html.en.utf8
Content-Language: en
Content-type: text/html; charset=UTF-8

225
docs/manual/mod/mod_mime_libmagic.html.en.utf8 Normal file
View File

@@ -0,0 +1,225 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_mime_libmagic - Apache HTTP Server Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p>
<p class="apache">Apache HTTP Server Version 2.5</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">HTTP Server</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache Module mod_mime_libmagic</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/mod/mod_mime_libmagic.html" title="English">&nbsp;en&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Determines the MIME type of a file from its contents
using libmagic</td></tr>
<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Module&nbsp;Identifier:</a></th><td>mime_libmagic_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Source&nbsp;File:</a></th><td>mod_mime_libmagic.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.5.1 and later</td></tr></table>
<h3>Summary</h3>
<p>This module determines the <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME
type</a> of a file by examining its contents, in the same
way the <code>file(1)</code> command does. It is intended as a
"second line of defense" for files which
<code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> cannot type from their extension: it
runs after <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> and does nothing if a type
has already been set.</p>
<p>Unlike <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>, which has its own
copy of the <code>file(1)</code> engine and its own magic
database, this module uses the system's <code>libmagic(3)</code>
library and magic database from the <code>file</code> package,
so the types it reports are those which <code>file --mime-type</code>
would report. The module is built only if libmagic is found at
configure time, and is only active in a server or virtual host
where <code class="directive"><a href="#mimelibmagic">MimeLibmagic</a></code>
is <code>On</code>.</p>
<p>Where libmagic reports <code>application/octet-stream</code>
the module sets no type, leaving the response without a
<code>Content-Type</code> header, as <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>
does for unrecognised content. Directories are typed as
<code>httpd/unix-directory</code> and empty files as
<code>text/plain</code>.</p>
<p>The module does not look inside compressed files and never
sets a <code>Content-Encoding</code>: a gzip file is reported as
<code>application/gzip</code>. This differs from
<code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>, which reports the compressed
file's encoding.</p>
</div>
<div id="quickview"><h3>Topics</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif"> <a href="#threads">Performance and memory overhead</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif"> <a href="#mimelibmagic">MimeLibmagic</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#mimelibmagicbytes">MimeLibmagicBytes</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#mimelibmagiccharset">MimeLibmagicCharset</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#mimelibmagicfile">MimeLibmagicFile</a></li>
</ul>
<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_mime_libmagic">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_mime_libmagic">Report a bug</a></li></ul><h3>See also</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li>
<li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="threads">Performance and memory overhead <a title="Permanent link" href="#threads" class="permalink">&para;</a></h2>
<p>A libmagic handle is created, loaded with the magic database
and destroyed for every request examined. Loading a compiled database
(<code>magic.mgc</code>) maps the file into memory rather than
parsing it, and the mapped pages are shared between all server
processes, so this is inexpensive. If the configured database
is a text file rather than a compiled one, it is parsed on every
request.</p>
<p>Only the first <code class="directive"><a href="#mimelibmagicbytes">MimeLibmagicBytes</a></code> bytes of a file are read and
examined, whatever its size.</p>
<p>Examining text content in particular can allocate a few
megabytes of memory temporarily. With a threaded MPM and a C
library which keeps a separate heap per thread, each server
thread retains its peak allocation, so the resident size of a
busy child process can grow by that much per thread before
levelling off. This is not a leak.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="mimelibmagic"><span id="MimeLibmagic">MimeLibmagic</span> Directive <a title="Permanent link" href="#mimelibmagic" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable MIME type determination from file contents</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeLibmagic On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MimeLibmagic Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime_libmagic</td></tr>
</table>
<p>The <code class="directive">MimeLibmagic</code> directive enables the
module for a server or virtual host. Files which
<code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> leaves untyped, typically those without
a recognised extension, then have their contents examined by
libmagic.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">MimeLibmagic On</pre>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="mimelibmagicbytes"><span id="MimeLibmagicBytes">MimeLibmagicBytes</span> Directive <a title="Permanent link" href="#mimelibmagicbytes" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Number of bytes of a file examined</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeLibmagicBytes <var>bytes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MimeLibmagicBytes 16384</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime_libmagic</td></tr>
</table>
<p>The <code class="directive">MimeLibmagicBytes</code> directive sets
how many bytes from the start of a file are read and examined.
Larger values allow magic rules which look deeper into a file to
match, at the cost of reading more of every examined file. The
maximum is 1048576.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="mimelibmagiccharset"><span id="MimeLibmagicCharset">MimeLibmagicCharset</span> Directive <a title="Permanent link" href="#mimelibmagiccharset" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Add a charset parameter to text types</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeLibmagicCharset On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MimeLibmagicCharset Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime_libmagic</td></tr>
</table>
<p>When <code class="directive">MimeLibmagicCharset</code> is
<code>On</code>, the character encoding libmagic detects (such
as <code>us-ascii</code>, <code>utf-8</code> or
<code>iso-8859-1</code>) is added as a <code>charset</code>
parameter to <code>text/*</code> types, giving for example
<code>text/plain; charset=utf-8</code>. Other types are not
affected. As with <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, the detected charset should be
trusted only where the content is known to be encoded
consistently.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="mimelibmagicfile"><span id="MimeLibmagicFile">MimeLibmagicFile</span> Directive <a title="Permanent link" href="#mimelibmagicfile" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The magic database to use</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MimeLibmagicFile <var>file-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>The default database of the installed libmagic</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime_libmagic</td></tr>
</table>
<p>The <code class="directive">MimeLibmagicFile</code> directive names
the magic database, in place of the default compiled into
libmagic (typically <code>/usr/share/misc/magic</code>, for which
the compiled <code>magic.mgc</code> alongside it is loaded).
The database must be in the format described in
<code>magic(5)</code>; the file distributed with
<code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code> is not suitable. A relative path
is taken relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. If the database cannot be loaded, an
error is logged for each request examined and the file is left
untyped.</p>
<p>Note that the <code>MAGIC</code> environment variable, if set
when the server is started, overrides the library default, but
not a database given with this directive.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">MimeLibmagicFile /usr/share/misc/magic.mgc</pre>
</div>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_mime_libmagic.html" title="English">&nbsp;en&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '&#9776;';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>

12
docs/manual/mod/mod_mime_libmagic.xml.meta Normal file
View File

@@ -0,0 +1,12 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!-- GENERATED FROM XML: DO NOT EDIT -->
<metafile reference="mod_mime_libmagic.xml">
<basename>mod_mime_libmagic</basename>
<path>/mod/</path>
<relpath>..</relpath>
<variants>
<variant>en</variant>
</variants>
</metafile>

21
docs/manual/mod/mod_proxy.html.en.utf8
View File

@@ -742,8 +742,9 @@ NoProxy .example.com 192.168.112.0/21</pre>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
</table>
<p>Directives placed in <code class="directive">&lt;Proxy&gt;</code>
sections apply only to matching proxied content using a simple string prefix match against the URL. Shell-style wildcards are also
allowed.</p>
sections apply only to matching proxied content using a simple string
prefix match against the URL. Shell-style wildcards are also allowed.
</p>
<p>For example, the following will allow only hosts in
<code>yournetwork.example.com</code> to access content via your proxy
@@ -774,6 +775,14 @@ NoProxy .example.com 192.168.112.0/21</pre>
&lt;/Proxy&gt;</pre>
<div class="warning"><h3>Warning</h3>
This configuration section does not canonicalize any part of the string
being matched such as schemes, hostnames, IP addresses, etc. Care should be
taken if using it for access control, including but not limited to
denying access by default and allowing expected hostnames rather than the
inverse where a denial could be bypassed by using alternate forms.
</div>
<div class="note"><h3>Differences from the Location configuration section</h3>
<p>A backend URL matches the configuration section if it begins with the
the <var>wildcard-url</var> string, even if the last path segment in the
@@ -1098,6 +1107,14 @@ proxied resources</td></tr>
identical to the <code class="directive"><a href="#proxy">&lt;Proxy&gt;</a></code> directive, except that it matches URLs
using <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expressions</a>.</p>
<div class="warning"><h3>Warning</h3>
This configuration section does not canonicalize any part of the string
being matched such as schemes, hostnames, IP addresses, etc. Care should be
taken if using it for access control, including but not limited to
denying access by default and allowing expected hostnames rather than the
inverse where a denial could be bypassed by using alternate forms.
</div>
<p>From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of URLs to be referenced

12
docs/manual/mod/mod_proxy_connect.html.en.utf8
View File

@@ -116,8 +116,16 @@ Port ranges available since Apache 2.3.7.</td></tr>
<code class="directive">AllowCONNECT</code> directive to override this default and
allow connections to the listed ports only.</p>
<p>Set the value to <code>None</code> to disallow
<code>CONNECT</code> requests to all ports, including the defaults.</p>
<p>Set the value to <code>None</code> to disallow <code>CONNECT</code>
requests to all ports, including the defaults. <code>None</code> cannot
be combined with port numbers in the same context.</p>
<p>Where <code class="directive">AllowCONNECT</code> is set in both the main
server and a virtual host, the lists of ports are merged, so a virtual
host may permit additional ports. A value of <code>None</code> takes
precedence and disallows all ports where it is set; but an inherited
<code>None</code> is in turn overridden by an explicit list of ports in a
virtual host.</p>
</div>
</div>

71
docs/manual/mod/mod_systemd.html.en.utf8
View File

@@ -38,7 +38,7 @@
<p>This module provides support for systemd integration. It allows
httpd to be used in a service with the systemd
<code>Type=notify</code> (see <a href="https://www.freedesktop.org/software/systemd/man/systemd.service.html">systemd.service(5)</a>
<code>Type=notify</code> or <code>Type=notify-reload</code> (see <a href="https://www.freedesktop.org/software/systemd/man/systemd.service.html">systemd.service(5)</a>
for more information). The module is activated if loaded.</p>
<div class="example"><h3>Example of systemd service unit (more settings are probably needed for production systems)</h3><pre>[Unit]
@@ -68,12 +68,79 @@ WantedBy=multi-user.target</pre></div>
any processes are still running. See <a href="https://www.freedesktop.org/software/systemd/man/systemd.kill.html">systemd.kill(5)</a>
for more information.</p>
<p>This module does not provide support for Systemd socket activation.</p>
<p>A service manager from systemd 253 onwards offers
<code>Type=notify-reload</code>, which is worth using in preference.
Under <code>Type=notify</code> a <code>systemctl reload</code>
returns as soon as the <code>ExecReload</code> command has sent its
signal, which is before the new configuration has been read, and it
reports success whatever becomes of the restart afterwards.
<code>Type=notify-reload</code> instead holds the reload open until
the server reports it finished, so the command waits for the new
configuration to be in use and fails if it never is. mod_systemd
sends the <code>RELOADING=1</code> notification the protocol expects
while the configuration is being read, stamped with the
<code>MONOTONIC_USEC</code> the service manager requires, and
<code>READY=1</code> once it has been loaded.</p>
<div class="example"><h3>Example of a service unit which reloads synchronously</h3><pre>[Service]
Type=notify-reload
ReloadSignal=SIGCONT
ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start
ExecReload=/usr/local/apache2/bin/httpd -k graceful
KillMode=mixed</pre></div>
<p>The service manager runs <code>ExecReload</code> first, and sends
the signal named by <code>ReloadSignal</code> only once that command
has exited successfully. Keeping <code>ExecReload</code> is what
makes the reload safe: <code>httpd -k graceful</code> parses the new
configuration in a process of its own and exits without signalling
anything if it does not parse, so the reload fails and the running
server carries on with the configuration it already has. Leaving
<code>ExecReload</code> out, and letting the service manager signal
the server directly, gives up that check: the running parent reads
the new configuration itself, and a configuration which does not
parse makes it exit, taking the server down.</p>
<p>The signal sent after <code>ExecReload</code> has run is then
redundant, so <code>ReloadSignal</code> should name one httpd does
not act on, such as <code>SIGCONT</code>. It matters that it is set:
the default is <code>SIGHUP</code>, which httpd takes as an
<em>ungraceful</em> restart, dropping the connections a reload is
meant to preserve. A unit which does leave out
<code>ExecReload</code> must set <code>ReloadSignal=SIGUSR1</code>,
the signal httpd restarts gracefully on.</p>
<p>Systemd socket activation is supported if httpd was built with
it. Each <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> port
must then be one passed in by systemd; a port which was not is a
fatal configuration error rather than one httpd opens for itself.
Socket activation is used only if this module is loaded, so it can
be built in and left unused.</p>
<p><code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> is
enabled by default if the module is loaded. If <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> is not disabled in
the configuration, run-time load and request statistics are made
available in the <code>systemctl status</code> output.</p>
<p>The systemd watchdog is supported. If the service unit sets
<code>WatchdogSec=</code>, the parent process sends the keep-alive
notification which tells systemd the server is still alive; a server
which stops sending it is terminated and, with a suitable
<code>Restart=</code> setting, restarted. The notification is sent
while the configuration is being read and again once it is loaded, so
that a reload is covered, and periodically from the parent process
while the server runs.</p>
<p>That periodic notification is sent about every ten seconds, which
is how often the parent process runs the hook it is sent from. A
<code>WatchdogSec=</code> of less than twice that cannot be met, and
would have systemd terminating a server which is working normally;
such a setting is reported as a warning at startup. Use a
<code>WatchdogSec=</code> of at least 20 seconds.</p>
<div class="example"><h3>Adding watchdog supervision to either unit above</h3><pre>[Service]
WatchdogSec=30
Restart=on-failure</pre></div>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<p>This module provides no

6
docs/manual/mod/overrides.html.en.utf8
View File

@@ -278,9 +278,9 @@ store passwords</td></tr>
passwords for authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestalgorithm">AuthDigestAlgorithm</a></td><td class="module"><a href="mod_auth_digest.html">mod_auth_digest</a></td></tr>
<tr class="odd"><td colspan="2" class="descr">Selects the algorithm used to calculate the challenge and
response hashes in digest authentication</td></tr>
response hashes in Digest authentication</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestdomain">AuthDigestDomain</a></td><td class="module"><a href="mod_auth_digest.html">mod_auth_digest</a></td></tr>
<tr><td colspan="2" class="descr">URIs that are in the same protection space for digest
<tr><td colspan="2" class="descr">URIs that are in the same protection space for Digest
authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestnccheck">AuthDigestNcCheck</a></td><td class="module"><a href="mod_auth_digest.html">mod_auth_digest</a></td></tr>
<tr class="odd"><td colspan="2" class="descr">Enables or disables checking of the nonce-count sent by the
@@ -290,7 +290,7 @@ client</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></td><td class="module"><a href="mod_auth_digest.html">mod_auth_digest</a></td></tr>
<tr class="odd"><td colspan="2" class="descr">Sets the authentication provider(s) for this location</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestqop">AuthDigestQop</a></td><td class="module"><a href="mod_auth_digest.html">mod_auth_digest</a></td></tr>
<tr><td colspan="2" class="descr">Determines the quality-of-protection to use in digest
<tr><td colspan="2" class="descr">Determines the quality-of-protection to use in Digest
authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_form.html#authformauthoritative">AuthFormAuthoritative</a></td><td class="module"><a href="mod_auth_form.html">mod_auth_form</a></td></tr>
<tr class="odd"><td colspan="2" class="descr">Sets whether authorization and authentication are passed to

14
docs/manual/mod/quickreference.html.en.utf8
View File

@@ -174,18 +174,18 @@ of user groups for authorization</td></tr>
store passwords</td></tr>
<tr><td><a href="mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile <var>file-path</var></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Sets the name of a database file containing the list of users and
passwords for authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestalgorithm">AuthDigestAlgorithm MD5|MD5-sess</a></td><td> MD5 </td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Selects the algorithm used to calculate the challenge and
response hashes in digest authentication</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestdomain">AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">URIs that are in the same protection space for digest
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestalgorithm">AuthDigestAlgorithm MD5</a></td><td> MD5 </td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Selects the algorithm used to calculate the challenge and
response hashes in Digest authentication</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestdomain">AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">URIs that are in the same protection space for Digest
authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestnccheck">AuthDigestNcCheck On|Off</a></td><td> Off </td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enables or disables checking of the nonce-count sent by the
client</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestnoncelifetime">AuthDigestNonceLifetime <var>seconds</var></a></td><td> 300 </td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">How long the server nonce is valid</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestprovider">AuthDigestProvider <var>provider-name</var>
[<var>provider-name</var>] ...</a></td><td> file </td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Sets the authentication provider(s) for this location</td></tr>
<tr><td><a href="mod_auth_digest.html#authdigestqop">AuthDigestQop none|auth|auth-int [auth|auth-int]</a></td><td> auth </td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Determines the quality-of-protection to use in digest
<tr><td><a href="mod_auth_digest.html#authdigestqop">AuthDigestQop auth</a></td><td> auth </td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Determines the quality-of-protection to use in Digest
authentication</td></tr>
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestshmemsize">AuthDigestShmemSize <var>size</var></a></td><td> 1000 </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">The amount of shared memory to allocate for keeping track
<tr class="odd"><td><a href="mod_auth_digest.html#authdigestshmemsize">AuthDigestShmemSize <var>size</var></a></td><td> 8192 </td><td>s</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">The amount of shared memory to allocate for keeping track
of clients</td></tr>
<tr><td><a href="mod_auth_form.html#authformauthoritative">AuthFormAuthoritative On|Off</a></td><td> On </td><td>dh</td><td>B</td></tr><tr><td class="descr" colspan="4">Sets whether authorization and authentication are passed to
lower level modules</td></tr>
@@ -827,6 +827,10 @@ files</td></tr>
<tr><td><a href="mod_cern_meta.html#metafiles">MetaFiles on|off</a></td><td> off </td><td>svdh</td><td>D</td></tr><tr><td class="descr" colspan="4">Activates CERN meta-file processing</td></tr>
<tr class="odd"><td><a href="mod_cern_meta.html#metasuffix">MetaSuffix <var>suffix</var></a></td><td> .meta </td><td>svdh</td><td>D</td></tr><tr class="odd"><td class="descr" colspan="4">File name suffix for the file containing CERN-style
meta information</td></tr>
<tr><td><a href="mod_mime_libmagic.html#mimelibmagic">MimeLibmagic On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Enable MIME type determination from file contents</td></tr>
<tr class="odd"><td><a href="mod_mime_libmagic.html#mimelibmagicbytes">MimeLibmagicBytes <var>bytes</var></a></td><td> 16384 </td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Number of bytes of a file examined</td></tr>
<tr><td><a href="mod_mime_libmagic.html#mimelibmagiccharset">MimeLibmagicCharset On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Add a charset parameter to text types</td></tr>
<tr class="odd"><td><a href="mod_mime_libmagic.html#mimelibmagicfile">MimeLibmagicFile <var>file-path</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">The magic database to use</td></tr>
<tr><td><a href="mod_mime_magic.html#mimemagicdecompression">MimeMagicDecompression On|Off</a></td><td> Off </td><td>sv</td><td>E</td></tr><tr><td class="descr" colspan="4">Enable decompression of compressed files for MIME type detection</td></tr>
<tr class="odd"><td><a href="mod_mime_magic.html#mimemagicfile">MimeMagicFile <var>file-path</var></a></td><td></td><td>sv</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Enable MIME-type determination based on file contents
using the specified magic file</td></tr>

11
docs/manual/programs/htcacheclean.html.en.utf8
View File

@@ -198,10 +198,13 @@
<dt>status</dt><dd>Status of the cached response.</dd>
<dt>entity version</dt><dd>The number of times this entry has been
revalidated without being deleted.</dd>
<dt>date</dt><dd>Date of the response.</dd>
<dt>expiry</dt><dd>Expiry date of the response.</dd>
<dt>request time</dt><dd>Time of the start of the request.</dd>
<dt>response time</dt><dd>Time of the end of the request.</dd>
<dt>date</dt><dd>Timestamp of the response in microseconds.</dd>
<dt>expiry</dt><dd>Expiry timestamp of the response in
microseconds.</dd>
<dt>request time</dt><dd>Timestamp of the start of the request in
microseconds.</dd>
<dt>response time</dt><dd>Timestamp of the end of the request in
microseconds.</dd>
<dt>body present</dt><dd>If 0, no body is stored with this request,
1 otherwise.</dd>
<dt>head request</dt><dd>If 1, the entry contains a cached HEAD

8
docs/manual/rewrite/avoid.html.en.utf8
View File

@@ -423,9 +423,11 @@ RewriteRule "^/secret/files/" "-" [F]</pre>
<code class="directive"><a href="../mod/mod_authz_host.html#require">Require</a></code> directly:</p>
<pre class="prettyprint lang-config">&lt;Location "/"&gt;
Require all granted
Require not ip 193.102.180.41
Require not ip 192.76.162.40
&lt;RequireAll&gt;
Require all granted
Require not ip 193.102.180.41
Require not ip 192.76.162.40
&lt;/RequireAll&gt;
&lt;/Location&gt;</pre>
</dd>

1
docs/manual/sitemap.html.en.utf8
View File

@@ -271,6 +271,7 @@ log_server_status</a></li>
<li><a href="mod/mod_macro.html">Apache Module mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache Module mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache Module mod_mime</a></li>
<li><a href="mod/mod_mime_libmagic.html">Apache Module mod_mime_libmagic</a></li>
<li><a href="mod/mod_mime_magic.html">Apache Module mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache Module mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache Module mod_nw_ssl</a></li>