mod_dav.html revision 2de56243b49d1c39dbc467e3f9daab152c8691b8
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder This file is generated from xml source: DO NOT EDIT
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder --><title>mod_dav- Apache HTTP Server</title><link href="/style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="/images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_dav</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td>Distributed Authoring and Versioning
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder(<a href="http://www.webdav.org/">WebDAV</a>) functionality</td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>dav_module</td></tr></table></td></tr></table><h2>Summary</h2>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>This module provides class 1 and class 2 <a href="http://www.webdav.org">WebDAV</a> ('Web-based Distributed
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Authoring and Versioning') functionality for Apache. This
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder extension to the HTTP protocol allows creating, moving,
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder copying, and deleting resources and collections on a remote web
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>To enable mod_dav, add the following to a container in your
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>Dav On</code></td></tr></table></blockquote>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>Also, specify a valid filename for the DAV lock database by
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder adding the following to the global section in your
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>DavLockDB /tmp/DavLock
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <em>(Any web-server writable filename, without an
57d9ffd4f0d821632c5dd116a5301c3305599b19Christian Maeder extension)</em>
57d9ffd4f0d821632c5dd116a5301c3305599b19Christian Maeder<h2>Directives</h2><ul><li><a href="#dav">Dav</a></li><li><a href="#davdepthinfinity">DavDepthInfinity</a></li><li><a href="#davlockdb">DavLockDB</a></li><li><a href="#davmintimeout">DavMinTimeout</a></li></ul><hr/><h2><a name="Dav">Dav</a> <a name="dav">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Enable WebDAV HTTP methods</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>Dav on|off</td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>Dav off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_dav</td></tr></table></td></tr></table>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <p>Use the <code class="directive">Dav</code> directive to enable the
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang WebDAV HTTP methods for the given container. You may wish to add a
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <a href="core.html#limit" class="directive"><code class="directive"><Limit></code></a> clause
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang inside the <a href="core.html#location" class="directive"><code class="directive"><location></code></a> directive to limit access to
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang DAV-enabled locations.</p>
57d9ffd4f0d821632c5dd116a5301c3305599b19Christian Maeder<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Example</strong></p><code>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <Location /foo><br>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang AuthType Basic<br>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang AuthName DAV<br>
8519df804b37f95a2394a6cd5662da02efa3400bChristian Maeder <LimitExcept GET HEAD OPTIONS><br>
8519df804b37f95a2394a6cd5662da02efa3400bChristian Maeder require user admin<br>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang </LimitExcept><br>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang </Location><br>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang<hr/><h2><a name="DavDepthInfinity">DavDepthInfinity</a> <a name="davdepthinfinity">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Allow PROPFIND, Depth: Infinity requests</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>DavDepthInfinity on|off</td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>DavDepthInfinity off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_dav</td></tr></table></td></tr></table>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <p>Use the <code class="directive">DavDepthInfinity</code> directive to
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang allow the processing of PROPFIND requests containing the header
8519df804b37f95a2394a6cd5662da02efa3400bChristian Maeder 'Depth: Infinity'. Because this type of request could constitute a
8519df804b37f95a2394a6cd5662da02efa3400bChristian Maeder denial-of-service attack, by default it is not allowed.</p>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang<hr/><h2><a name="DavLockDB">DavLockDB</a> <a name="davlockdb">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Location of the DAV lock database</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>DavLockDB <em>file-path</em></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_dav</td></tr></table></td></tr></table>
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang <p>Use the <code class="directive">DavLockDB</code> directive to specify
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang the full path to the lock database, excluding an extension. The
264b794970b6f2bd437f14233f367f1067565728Jian Chun Wang default (file system) implementation of mod_dav uses a SDBM
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder database to track user locks. The utility
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder <code>modules/dav/util/lockview</code> can be used from the server
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder to display all locks in a lock database.</p>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Example</strong></p><code>
84855a862ab77950c0c5059b1bba98cce0fb8ac3Christian Maeder<hr/><h2><a name="DavMinTimeout">DavMinTimeout</a> <a name="davmintimeout">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Minimum amount of time the server holds a lock on
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maedera DAV resource</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>DavMinTimeout <em>seconds</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>DavMinTimeout 0</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_dav</td></tr></table></td></tr></table>
03a6bbff551286168d0b15dc53476c2ede4e60d0Christian Maeder <p>When a client requests a DAV resource lock, it can also
84855a862ab77950c0c5059b1bba98cce0fb8ac3Christian Maeder specify a time when the lock will be automatically removed by
84855a862ab77950c0c5059b1bba98cce0fb8ac3Christian Maeder the server. This value is only a request, and the server can
84855a862ab77950c0c5059b1bba98cce0fb8ac3Christian Maeder ignore it or inform the client of an arbitrary value.</p>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <p>Use the <code class="directive">DavMinTimeout</code> directive to specify, in
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder seconds, the minimum lock timeout to return to a client.
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder Microsoft Web Folders defaults to a timeout of 120 seconds; the
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder <code class="directive">DavMinTimeout</code> can override this to a higher value
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder (like 600 seconds) to reduce the chance of the client losing
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder the lock due to network latency.</p>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Example</strong></p><code>
0015e1756b734b34d4b550318c078f9a0c585611Christian Maeder <Location /MSWord><br>
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder DavMinTimeout 600<br>
479da8506f391abe070ced2fb93c9759a280fa68Christian Maeder </Location><br>
f799084b320209cdd71a29e74fff1be054c1d342Christian Maeder<hr/></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="/images/index.gif" alt="Index"/></a><a href="../"><img src="/images/home.gif" alt="Home"/></a></body></html>
