| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| <HTML> |
| <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> |
| |
| 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. |
| |
| <H2>Directives</H2> |
| <UL> |
| <LI><A HREF="#DAV">Dav</A> |
| <LI><A HREF="#DAVLockDB">DavLockDB</A> |
| <LI><A HREF="#DAVMinTimeout">DavMinTimeout</A> |
| <LI><A HREF="#DAVDepthInfinity">DavDepthInfinity</A> |
| <LI><A HREF="#LimitXMLRequestBody">LimitXMLRequestBody</A> |
| </UL> |
| <HR> |
| <P> |
| To enable mod_dav, add the following to a container in your <CODE>httpd.conf</CODE> file:<P> |
| |
| <CODE>Dav On</CODE><P> |
| |
| Also, specify a valid filename for the DAV lock database by adding the following to the global section in your <CODE>httpd.conf</CODE> file:<P> |
| |
| <CODE>DavLockDB /tmp/DavLock </CODE><EM>(Any web-server writeable filename, without an extension)</EM><P> |
| <HR> |
| |
| <H2><A 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#limit" |
| ><Limit></A> |
| clause inside the |
| <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> |
| <CODE>DavLockDB /tmp/DavLock<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 NAME="DavLockDB">DavLockDB</A></H2> |
| <A |
| HREF="directive-dict.html#Syntax" |
| REL="Help" |
| ><STRONG>Syntax:</STRONG></A> DavLockDB <Full path to lock database><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<BR> |
| <A |
| HREF="directive-dict.html#Compatibility" |
| REL="Help" |
| ><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above<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 <CODE>modules/dav/util/lockview</CODE> can be |
| used from the 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> |
| <CODE>DavLockDB /tmp/DavLock<BR> |
| <BR> |
| </CODE> |
| </TD></TR> |
| </TABLE> |
| |
| <BR> |
| <HR> |
| |
| <H2><A NAME="DavMinTimeout">DavMinTimeout</A></H2> |
| <A |
| HREF="directive-dict.html#Syntax" |
| REL="Help" |
| ><STRONG>Syntax:</STRONG></A> DavMinTimeout <seconds><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<BR> |
| <A |
| HREF="directive-dict.html#Compatibility" |
| REL="Help" |
| ><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above<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> |
| |
| 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 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<BR> |
| <A |
| HREF="directive-dict.html#Compatibility" |
| REL="Help" |
| ><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above<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> |
| |
| <HR> |
| |
| <H2><A NAME="LimitXMLRequestBody">LimitXMLRequestBody</A></H2> |
| <A |
| HREF="directive-dict.html#Syntax" |
| REL="Help" |
| ><STRONG>Syntax:</STRONG></A> LimitXMLRequestBody <size in bytes><BR> |
| <A |
| HREF="directive-dict.html#Default" |
| REL="Help" |
| ><STRONG>Default:</STRONG></A> |
| <CODE>LimitXMLRequestBody 1000000</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>LimitXMLRequestBody</CODE> directive to limit the |
| size of an XML request which mod_dav will attempt to parse. Specify |
| a size greater than zero. |
| <P> |
| |
| <!--#include virtual="footer.html" --> |
| </BODY> |
| </HTML> |