manual/mod/mod_dav.html

	mod_dav.html revision dff77f20d3ca0296e740d4369989e57949a06e92
0N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2362N/A<HTML>
0N/A<HEAD>
0N/A<TITLE>Apache module mod_dav</TITLE>
0N/A</HEAD>
0N/A
2362N/A<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
0N/A<BODY
2362N/A BGCOLOR="#FFFFFF"
0N/A TEXT="#000000"
0N/A LINK="#0000FF"
0N/A VLINK="#000080"
0N/A ALINK="#FF0000"
0N/A>
0N/A<!--#include virtual="header.html" -->
0N/A<H1 ALIGN="CENTER">Module mod_dav</H1>
0N/A
0N/A<p>This module provides Distributed Authoring and Versioning
0N/A(<a href="http://www.webdav.org/">WebDAV</a>) functionality.</p>
0N/A
2362N/A<A
2362N/AHREF="module-dict.html#Status"
2362N/AREL="Help"
0N/A><STRONG>Status:</STRONG></A> Extension
0N/A<BR>
0N/A<A
0N/AHREF="module-dict.html#SourceFile"
0N/AREL="Help"
0N/A><STRONG>Source File:</STRONG></A> mod_dav.c
0N/A<BR>
0N/A<A
0N/AHREF="module-dict.html#ModuleIdentifier"
0N/AREL="Help"
0N/A><STRONG>Module Identifier:</STRONG></A> dav_module
0N/A
0N/A<h2>Summary</h2>
0N/A
0N/A<p>This module provides class 1 and class 2
0N/A<A HREF="http://www.webdav.org">WebDAV</A> ('Web-based
0N/ADistributed Authoring and Versioning') functionality for Apache.
0N/AThis extension to the HTTP protocol allows creating, moving,
0N/Acopying, and deleting resources and collections on a remote web
0N/Aserver.</p>
0N/A
2610N/A<P>
2610N/ATo enable mod_dav, add the following to a container in your <CODE>httpd.conf</CODE> file:</P>
0N/A
0N/A<blockquote>
0N/A<CODE>Dav On</CODE>
0N/A</blockquote>
0N/A
0N/A<p>Also, specify a valid filename for the DAV lock database by adding
0N/Athe following to the global section in your <CODE>httpd.conf</CODE>
0N/Afile:</p>
0N/A
0N/A<blockquote>
0N/A<CODE>DavLockDB /tmp/DavLock&nbsp;&nbsp;&nbsp;&nbsp;</CODE><EM>(Any web-server writable filename, without an extension)</EM>
0N/A</blockquote>
0N/A
0N/A
0N/A
0N/A<H2>Directives</H2>
0N/A<UL>
0N/A<LI><A HREF="#DAV">Dav</A>
0N/A<LI><A HREF="#DAVLockDB">DavLockDB</A>
0N/A<LI><A HREF="#DAVMinTimeout">DavMinTimeout</A>
0N/A<LI><A HREF="#DAVDepthInfinity">DavDepthInfinity</A>
0N/A</UL>
0N/A
0N/A<HR>
0N/A
0N/A<H2><A NAME="DAV">Dav</A></H2>
0N/A<A
0N/A HREF="directive-dict.html#Syntax"
1422N/A REL="Help"
1422N/A><STRONG>Syntax:</STRONG></A> Dav on|off<BR>
1422N/A<A
1422N/A HREF="directive-dict.html#Default"
1422N/A REL="Help"
1422N/A><STRONG>Default:</STRONG></A>
0N/A    <CODE>Dav off</CODE><BR>
0N/A<A
802N/A HREF="directive-dict.html#Context"
0N/A REL="Help"
0N/A><STRONG>Context:</STRONG></A> directory<BR>
0N/A<A
0N/A HREF="directive-dict.html#Status"
0N/A REL="Help"
0N/A><STRONG>Status:</STRONG></A> extension<BR>
0N/A<A
1422N/A HREF="directive-dict.html#Module"
1422N/A REL="Help"
0N/A><STRONG>Module:</STRONG></A> mod_dav<BR>
0N/A<A
0N/A HREF="directive-dict.html#Compatibility"
0N/A REL="Help"
0N/A><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above
0N/A
0N/A<p>Use the <CODE>Dav</CODE> directive to enable the WebDAV HTTP methods
0N/Afor the given container.
0N/AYou may wish to add a
0N/A<A
0N/A HREF="core.html#limit"
0N/A>&lt;Limit&gt;</A>
0N/Aclause inside the
0N/A<A
1422N/A HREF="core.html#location"
1422N/A>location</A>
0N/Adirective to limit access to DAV-enabled locations.</P>
0N/A
0N/A<TABLE WIDTH="70%" BORDER=0 BGCOLOR="#E0E0F0" CELLSPACING=0 CELLPADDING=10>
0N/A<TR><TD>
0N/A<STRONG>Example</STRONG>:<BR><BR>
3054N/A<CODE>DavLockDB /tmp/DavLock<BR>
0N/A<BR>
0N/A&lt;Location /foo&gt;<BR>
0N/ADav On<BR>
0N/A<BR>
0N/AAuthType     Basic<BR>
0N/AAuthName     DAV<BR>
0N/AAuthUserFile user.passwd<BR>
0N/A<BR>
1422N/A&nbsp;&nbsp;&lt;LimitExcept GET HEAD OPTIONS&gt;<BR>
0N/A&nbsp;&nbsp;require user admin<BR>
1422N/A&nbsp;&nbsp;&lt;/LimitExcept&gt;<BR>
0N/A&lt;/Location&gt;<BR>
0N/A</CODE>
0N/A</TD></TR>
1422N/A</TABLE>
1422N/A
1422N/A<BR>
1422N/A<HR>
1422N/A
1422N/A<H2><A NAME="DavLockDB">DavLockDB</A></H2>
1387N/A<A
0N/A HREF="directive-dict.html#Syntax"
0N/A REL="Help"
0N/A><STRONG>Syntax:</STRONG></A> DavLockDB <em>filename</em><BR>
1422N/A<A
1422N/A HREF="directive-dict.html#Default"
0N/A REL="Help"
0N/A><STRONG>Default:</STRONG></A>
0N/A    <EM>None</EM><BR>
0N/A<A
0N/A HREF="directive-dict.html#Context"
1387N/A REL="Help"
1422N/A><STRONG>Context:</STRONG></A> server config, virtual host<BR>
1387N/A<A
1387N/A HREF="directive-dict.html#Status"
1387N/A REL="Help"
1387N/A><STRONG>Status:</STRONG></A> extension<BR>
1387N/A<A
1422N/A HREF="directive-dict.html#Module"
0N/A REL="Help"
0N/A><STRONG>Module:</STRONG></A> mod_dav
0N/A
0N/A<p>Use the <CODE>DavLockDB</CODE> directive to specify the full path to the
0N/Alock database, excluding an extension.  The default (file system)
0N/Aimplementation of mod_dav uses a SDBM database to track user locks.
0N/AThe utility <CODE>modules/dav/util/lockview</CODE> can be
0N/Aused from the server to display all locks in a lock database.</P>
0N/A
0N/A<TABLE WIDTH="70%" BORDER=0 BGCOLOR="#E0E0F0" CELLSPACING=0 CELLPADDING=10>
0N/A<TR><TD>
0N/A<STRONG>Example</STRONG>:<BR><BR>
0N/A<CODE>DavLockDB /tmp/DavLock<BR>
0N/A<BR>
0N/A</CODE>
0N/A</TD></TR>
0N/A</TABLE>
0N/A
0N/A<BR>
0N/A<HR>
0N/A
0N/A<H2><A NAME="DavMinTimeout">DavMinTimeout</A></H2>
0N/A<A
0N/A HREF="directive-dict.html#Syntax"
0N/A REL="Help"
0N/A><STRONG>Syntax:</STRONG></A> DavMinTimeout <em>seconds</em><BR>
0N/A<A
0N/A HREF="directive-dict.html#Default"
0N/A REL="Help"
0N/A><STRONG>Default:</STRONG></A>
0N/A    <CODE>DavMinTimeout 0</CODE><BR>
0N/A<A
0N/A HREF="directive-dict.html#Context"
0N/A REL="Help"
0N/A><STRONG>Context:</STRONG></A> directory<BR>
0N/A<A
0N/A HREF="directive-dict.html#Status"
0N/A REL="Help"
0N/A><STRONG>Status:</STRONG></A> extension<BR>
0N/A<A
0N/A HREF="directive-dict.html#Module"
0N/A REL="Help"
0N/A><STRONG>Module:</STRONG></A> mod_dav
0N/A
0N/A<p>When a client requests a DAV resource lock, it can also specify a time
0N/Awhen the lock will be automatically removed by the server.  This value
0N/Ais only a request, and the server can ignore it or inform the client
0N/Aof an arbitrary value.</P>
0N/A
0N/A<p>Use the <CODE>DavMinTimeout</CODE> directive to specify, in seconds,
0N/Athe minimum lock timeout to return to a client.  Microsoft Web Folders
0N/Adefaults to a timeout of 120 seconds; the <CODE>DavMinTimeout</CODE>
0N/Acan override this to a higher value (like 600 seconds) to reduce the chance
0N/Aof the client losing the lock due to network latency.</P>
0N/A
0N/A<TABLE WIDTH="70%" BORDER=0 BGCOLOR="#E0E0F0" CELLSPACING=0 CELLPADDING=10>
0N/A<TR><TD>
0N/A<STRONG>Example</STRONG>:<BR><BR>
0N/A<CODE>&lt;Location /MSWord&gt;<BR>
0N/ADavMinTimeout 600<BR>
0N/A&lt;/Location&gt;<BR>
0N/A<BR>
0N/A</CODE>
0N/A</TD></TR>
0N/A</TABLE>
0N/A
0N/A<BR>
0N/A<HR>
0N/A
0N/A<H2><A NAME="DavDepthInfinity">DavDepthInfinity</A></H2>
0N/A<A
0N/A HREF="directive-dict.html#Syntax"
0N/A REL="Help"
0N/A><STRONG>Syntax:</STRONG></A> DavDepthInfinity on|off<BR>
0N/A<A
0N/A HREF="directive-dict.html#Default"
0N/A REL="Help"
0N/A><STRONG>Default:</STRONG></A>
0N/A    <CODE>DavDepthInfinity off</CODE><BR>
0N/A<A
0N/A HREF="directive-dict.html#Context"
0N/A REL="Help"
0N/A><STRONG>Context:</STRONG></A> directory<BR>
0N/A<A
0N/A HREF="directive-dict.html#Status"
0N/A REL="Help"
0N/A><STRONG>Status:</STRONG></A> extension<BR>
0N/A<A
0N/A HREF="directive-dict.html#Module"
0N/A REL="Help"
0N/A><STRONG>Module:</STRONG></A> mod_dav
0N/A
0N/A<p>Use the <CODE>DavDepthInfinity</CODE> directive to allow the processing
0N/Aof PROPFIND requests containing the header 'Depth: Infinity'.
0N/ABecause this type of request could constitute a denial-of-service attack,
0N/Aby default it is not allowed.</P>
0N/A
0N/A<!--#include virtual="footer.html" -->
0N/A</BODY>
0N/A</HTML>
0N/A