1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 --><title>mod_dav - Apache HTTP Server</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="../images/favicon.ico" rel="shortcut icon" /></head><body><div id="page-header"><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="../images/feather.gif" /></div><div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">Modules</a></div><div id="page-content"><div id="preamble"><h1>Apache Module mod_dav</h1><table class="module"><tr><th><a href="module-dict.html#Description">Description:
8 </a></th><td>Distributed Authoring and Versioning
9 (<a href="http://www.webdav.org/">WebDAV</a>) functionality</td></tr><tr><th><a href="module-dict.html#Status">Status:
10 </a></th><td>Extension</td></tr><tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:
11 </a></th><td>dav_module</td></tr><tr><th><a href="module-dict.html#SourceFile">Source File:
12 </a></th><td>mod_dav.c</td></tr></table><h3>Summary</h3>
13 <p>This module provides class 1 and class 2 <a href="http://www.webdav.org">WebDAV</a> ('Web-based Distributed
14 Authoring and Versioning') functionality for Apache. This
15 extension to the HTTP protocol allows creating, moving,
16 copying, and deleting resources and collections on a remote web
19 <p>To enable mod_dav, add the following to a container in your
20 <code>httpd.conf</code> file:</p>
22 <div class="example"><p><code>Dav On</code></p></div>
24 <p>Also, specify a valid filename for the DAV lock database by
25 adding the following to the global section in your
26 <code>httpd.conf</code> file:</p>
28 <div class="example"><p><code>DavLockDB /tmp/DavLock
29 <em>(Any web-server writable filename, without an
32 </div><div id="quickview"><h3 class="directives">Directives</h3><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#dav">Dav</a></li><li><img alt="" src="../images/down.gif" /> <a href="#davdepthinfinity">DavDepthInfinity</a></li><li><img alt="" src="../images/down.gif" /> <a href="#davlockdb">DavLockDB</a></li><li><img alt="" src="../images/down.gif" /> <a href="#davmintimeout">DavMinTimeout</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="Dav" id="Dav">Dav</a> <a name="dav" id="dav">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
33 </a></th><td>Enable WebDAV HTTP methods</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
34 </a></th><td>Dav on|off</td></tr><tr><th><a href="directive-dict.html#Default">Default:
35 </a></th><td><code>Dav off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
36 </a></th><td>directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
37 </a></th><td>Extension</td></tr><tr><th><a href="directive-dict.html#Module">Module:
38 </a></th><td>mod_dav</td></tr></table>
39 <p>Use the <code class="directive">Dav</code> directive to enable the
40 WebDAV HTTP methods for the given container. You may wish to add a
41 <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> clause
42 inside the <code class="directive"><a href="../mod/core.html#location"><location></a></code> directive to limit access to
43 DAV-enabled locations.</p>
45 <div class="example"><h3>Example</h3><p><code>
46 DavLockDB /tmp/DavLock<br />
48 <Location /foo><br />
53 AuthUserFile user.passwd<br />
55 <LimitExcept GET HEAD OPTIONS><br />
56 require user admin<br />
57 </LimitExcept><br />
58 </Location><br />
60 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="directive-section"><h2><a name="DavDepthInfinity" id="DavDepthInfinity">DavDepthInfinity</a> <a name="davdepthinfinity" id="davdepthinfinity">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
61 </a></th><td>Allow PROPFIND, Depth: Infinity requests</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
62 </a></th><td>DavDepthInfinity on|off</td></tr><tr><th><a href="directive-dict.html#Default">Default:
63 </a></th><td><code>DavDepthInfinity off</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
64 </a></th><td>directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
65 </a></th><td>Extension</td></tr><tr><th><a href="directive-dict.html#Module">Module:
66 </a></th><td>mod_dav</td></tr></table>
67 <p>Use the <code class="directive">DavDepthInfinity</code> directive to
68 allow the processing of PROPFIND requests containing the header
69 'Depth: Infinity'. Because this type of request could constitute a
70 denial-of-service attack, by default it is not allowed.</p>
71 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="directive-section"><h2><a name="DavLockDB" id="DavLockDB">DavLockDB</a> <a name="davlockdb" id="davlockdb">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
72 </a></th><td>Location of the DAV lock database</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
73 </a></th><td>DavLockDB <em>file-path</em></td></tr><tr><th><a href="directive-dict.html#Context">Context:
74 </a></th><td>server config, virtual host</td></tr><tr><th><a href="directive-dict.html#Status">Status:
75 </a></th><td>Extension</td></tr><tr><th><a href="directive-dict.html#Module">Module:
76 </a></th><td>mod_dav</td></tr></table>
77 <p>Use the <code class="directive">DavLockDB</code> directive to specify
78 the full path to the lock database, excluding an extension. The
79 default (file system) implementation of mod_dav uses a SDBM
80 database to track user locks. The utility
81 <code>modules/dav/util/lockview</code> can be used from the server
82 to display all locks in a lock database.</p>
84 <div class="example"><h3>Example</h3><p><code>
85 DavLockDB /tmp/DavLock
87 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="directive-section"><h2><a name="DavMinTimeout" id="DavMinTimeout">DavMinTimeout</a> <a name="davmintimeout" id="davmintimeout">Directive</a></h2><table class="directive"><tr><th><a href="directive-dict.html#Description">Description:
88 </a></th><td>Minimum amount of time the server holds a lock on
89 a DAV resource</td></tr><tr><th><a href="directive-dict.html#Syntax">Syntax:
90 </a></th><td>DavMinTimeout <em>seconds</em></td></tr><tr><th><a href="directive-dict.html#Default">Default:
91 </a></th><td><code>DavMinTimeout 0</code></td></tr><tr><th><a href="directive-dict.html#Context">Context:
92 </a></th><td>directory</td></tr><tr><th><a href="directive-dict.html#Status">Status:
93 </a></th><td>Extension</td></tr><tr><th><a href="directive-dict.html#Module">Module:
94 </a></th><td>mod_dav</td></tr></table>
95 <p>When a client requests a DAV resource lock, it can also
96 specify a time when the lock will be automatically removed by
97 the server. This value is only a request, and the server can
98 ignore it or inform the client of an arbitrary value.</p>
100 <p>Use the <code class="directive">DavMinTimeout</code> directive to specify, in
101 seconds, the minimum lock timeout to return to a client.
102 Microsoft Web Folders defaults to a timeout of 120 seconds; the
103 <code class="directive">DavMinTimeout</code> can override this to a higher value
104 (like 600 seconds) to reduce the chance of the client losing
105 the lock due to network latency.</p>
107 <div class="example"><h3>Example</h3><p><code>
108 <Location /MSWord><br />
109 DavMinTimeout 600<br />
110 </Location><br />
112 </div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div></body></html>