mod_dav.html revision 2eaf662cbc81e823e8d9aeb8d54e69e63032493e
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Apache module mod_dav</title>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#000080" alink="#FF0000">
<!--#include virtual="header.html" -->
<h1 align="CENTER">Module mod_dav</h1>
<p>This module provides Distributed Authoring and Versioning
functionality.</p>
<a href="module-dict.html#Status"
rel="Help"><strong>Status:</strong></a> Extension <br />
<a href="module-dict.html#SourceFile"
<a href="module-dict.html#ModuleIdentifier"
rel="Help"><strong>Module Identifier:</strong></a> dav_module
<h2>Summary</h2>
<p>This module provides class 1 and class 2 <a
href="http://www.webdav.org">WebDAV</a> ('Web-based Distributed
Authoring and Versioning') functionality for Apache. This
extension to the HTTP protocol allows creating, moving,
copying, and deleting resources and collections on a remote web
server.</p>
<p>To enable mod_dav, add the following to a container in your
<blockquote>
<code>Dav On</code>
</blockquote>
<p>Also, specify a valid filename for the DAV lock database by
adding the following to the global section in your
<blockquote>
<em>(Any web-server writable filename, without an
extension)</em>
</blockquote>
<h2>Directives</h2>
<ul>
<li><a href="#DAV">Dav</a></li>
<li><a href="#DAVLockDB">DavLockDB</a></li>
<li><a href="#DAVMinTimeout">DavMinTimeout</a></li>
<li><a href="#DAVDepthInfinity">DavDepthInfinity</a></li>
</ul>
<hr />
<h2><a id="DAV" name="DAV">Dav</a></h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> Dav on|off<br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <code>Dav
off</code><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> directory<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_dav<br />
<a href="directive-dict.html#Compatibility"
rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.4 and
above
<p>Use the <code>Dav</code> directive to enable the WebDAV HTTP
methods for the given container. You may wish to add a <a
href="core.html#location">location</a> directive to limit
access to DAV-enabled locations.</p>
<table width="70%" border="0" bgcolor="#E0E0F0" cellspacing="0"
cellpadding="10">
<tr>
<td><strong>Example</strong>:<br />
<br />
<br />
<Location /foo><br />
Dav On<br />
<br />
AuthType Basic<br />
AuthName DAV<br />
AuthUserFile user.passwd<br />
<br />
<LimitExcept GET HEAD OPTIONS><br />
require user admin<br />
</LimitExcept><br />
</Location><br />
</code> </td>
</tr>
</table>
<br />
<hr />
<h2><a id="DavLockDB" name="DavLockDB">DavLockDB</a></h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> DavLockDB
<em>filename</em><br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <em>None</em><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> server config, virtual
host<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_dav
<p>Use the <code>DavLockDB</code> directive to specify the full
path to the lock database, excluding an extension. The default
(file system) implementation of mod_dav uses a SDBM database to
track user locks. The utility
server to display all locks in a lock database.</p>
<table width="70%" border="0" bgcolor="#E0E0F0" cellspacing="0"
cellpadding="10">
<tr>
<td><strong>Example</strong>:<br />
<br />
<br />
</code> </td>
</tr>
</table>
<br />
<hr />
<h2><a id="DavMinTimeout"
name="DavMinTimeout">DavMinTimeout</a></h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> DavMinTimeout
<em>seconds</em><br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <code>DavMinTimeout
0</code><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> directory<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_dav
<p>When a client requests a DAV resource lock, it can also
specify a time when the lock will be automatically removed by
the server. This value is only a request, and the server can
ignore it or inform the client of an arbitrary value.</p>
<p>Use the <code>DavMinTimeout</code> directive to specify, in
seconds, the minimum lock timeout to return to a client.
Microsoft Web Folders defaults to a timeout of 120 seconds; the
<code>DavMinTimeout</code> can override this to a higher value
(like 600 seconds) to reduce the chance of the client losing
the lock due to network latency.</p>
<table width="70%" border="0" bgcolor="#E0E0F0" cellspacing="0"
cellpadding="10">
<tr>
<td><strong>Example</strong>:<br />
<br />
<code><Location /MSWord><br />
DavMinTimeout 600<br />
</Location><br />
<br />
</code> </td>
</tr>
</table>
<br />
<hr />
<h2><a id="DavDepthInfinity"
name="DavDepthInfinity">DavDepthInfinity</a></h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> DavDepthInfinity
on|off<br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <code>DavDepthInfinity
off</code><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> directory<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_dav
<p>Use the <code>DavDepthInfinity</code> directive to allow the
processing of PROPFIND requests containing the header 'Depth:
Infinity'. Because this type of request could constitute a
denial-of-service attack, by default it is not allowed.</p>
<!--#include virtual="footer.html" -->
</body>
</html>