c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<?xml version="1.0"?>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<!DOCTYPE xml:manual [ <!ENTITY nbsp "&#160;"> ]>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<?xml-stylesheet type="text/xsl" href="/style/manual.xsl"?>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<modulesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<name>mod_dav</name>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<description>Distributed Authoring and Versioning

d24d4c5159bcb11c25bb294926cfe7105c789ea9slive(<a href="http://www.webdav.org/">WebDAV</a>) functionality</description>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<status>Extension</status>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<sourcefile>mod_dav.c</sourcefile>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<identifier>dav_module</identifier>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<summary>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>This module provides class 1 and class 2 <a

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive href="http://www.webdav.org">WebDAV</a> ('Web-based Distributed

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive Authoring and Versioning') functionality for Apache. This

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive extension to the HTTP protocol allows creating, moving,

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive copying, and deleting resources and collections on a remote web

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive server.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>To enable mod_dav, add the following to a container in your

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <code>httpd.conf</code> file:</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<example>Dav On</example>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>Also, specify a valid filename for the DAV lock database by

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive adding the following to the global section in your

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <code>httpd.conf</code> file:</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<example>DavLockDB /tmp/DavLock&nbsp;&nbsp;&nbsp;&nbsp;

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <em>(Any web-server writable filename, without an

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive extension)</em>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</example>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</summary>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<name>Dav</name>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<description>Enable WebDAV HTTP methods</description>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<syntax>Dav on|off</syntax>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<default>Dav off</default>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<contextlist><context>directory</context></contextlist>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>Use the <directive>Dav</directive> directive to enable the

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive WebDAV HTTP methods for the given container. You may wish to add a

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <directive module="core" type="section">Limit</directive> clause

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive inside the <directive module="core"

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive type="section">location</directive> directive to limit access to

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive DAV-enabled locations.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<example><title>Example</title>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive DavLockDB /tmp/DavLock<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &lt;Location /foo&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive Dav On<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive AuthType Basic<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive AuthName DAV<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive AuthUserFile user.passwd<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &nbsp;&nbsp;&lt;LimitExcept GET HEAD OPTIONS&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &nbsp;&nbsp;require user admin<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &nbsp;&nbsp;&lt;/LimitExcept&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &lt;/Location&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</example>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<description>Location of the DAV lock database</description>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<name>DavLockDB</name>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<syntax>DavLockDB <em>file-path</em></syntax>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<contextlist><context>server config</context><context>virtual host</context>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</contextlist>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>Use the <directive>DavLockDB</directive> directive to specify

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive the full path to the lock database, excluding an extension. The

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive default (file system) implementation of mod_dav uses a SDBM

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive database to track user locks. The utility

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <code>modules/dav/util/lockview</code> can be used from the server

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive to display all locks in a lock database.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<example><title>Example</title>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4sliveDavLockDB /tmp/DavLock

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</example>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<name>DavMinTimeout</name>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<description>Minimum amount of time the server holds a lock on

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slivea DAV resource</description>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<syntax>DavMinTimeout <em>seconds</em></syntax>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<default>DavMinTimeout 0</default>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<contextlist><context>directory</context></contextlist>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>When a client requests a DAV resource lock, it can also

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive specify a time when the lock will be automatically removed by

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive the server. This value is only a request, and the server can

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive ignore it or inform the client of an arbitrary value.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>Use the <directive>DavMinTimeout</directive> directive to specify, in

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive seconds, the minimum lock timeout to return to a client.

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive Microsoft Web Folders defaults to a timeout of 120 seconds; the

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <directive>DavMinTimeout</directive> can override this to a higher value

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive (like 600 seconds) to reduce the chance of the client losing

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive the lock due to network latency.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<example><title>Example</title>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &lt;Location /MSWord&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive DavMinTimeout 600<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive &lt;/Location&gt;<br />

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</example>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<name>DavDepthInfinity</name>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<description>Allow PROPFIND, Depth: Infinity requests</description>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<syntax>DavDepthInfinity on|off</syntax>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<default>DavDepthInfinity off</default>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<contextlist><context>directory</context></contextlist>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive <p>Use the <directive>DavDepthInfinity</directive> directive to

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive allow the processing of PROPFIND requests containing the header

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive 'Depth: Infinity'. Because this type of request could constitute a

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive denial-of-service attack, by default it is not allowed.</p>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</usage>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</directivesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</modulesynopsis>

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive

c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive