Commit 659a67eb authored by Joshua Slive's avatar Joshua Slive
Browse files

Bring mod_dav.html up to the new format, fix up some questionable 

HTML, and remove the LimitXMLRequestBody which is actually
in the core.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87121 13f79535-47bb-0310-9956-ffa450edef68
parent 3984ea4a

docs/manual/mod/mod_dav.html

+53 −72
Original line number Diff line number Diff line
@@ -15,12 +15,49 @@ 
<!--#include virtual="header.html" -->

<H1 ALIGN="CENTER">Module mod_dav</H1>



This module provides class 1 and class 2 

<p>This module provides Distributed Authoring and Versioning

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



<A

HREF="module-dict.html#Status"

REL="Help"

><STRONG>Status:</STRONG></A> Extension

<BR>

<A

HREF="module-dict.html#SourceFile"

REL="Help"

><STRONG>Source File:</STRONG></A> mod_dav.c

<BR>

<A

HREF="module-dict.html#ModuleIdentifier"

REL="Help"

><STRONG>Module Identifier:</STRONG></A> dav_module



<h2>Summary</h2>



<p>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.  

server.</p>



<P>

To enable mod_dav, add the following to a container in your <CODE>httpd.conf</CODE> file:</P>



<blockquote>

<CODE>Dav On</CODE>

</blockquote>



<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>



<blockquote>

<CODE>DavLockDB /tmp/DavLock&nbsp;&nbsp;&nbsp;&nbsp;</CODE><EM>(Any web-server writeable filename, without an extension)</EM>

</blockquote>







<H2>Directives</H2>

<UL>
@@ -28,17 +65,8 @@ server. 
<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&nbsp;&nbsp;&nbsp;&nbsp;</CODE><EM>(Any web-server writeable filename, without an extension)</EM><P>

<HR>



<H2><A NAME="DAV">Dav</A></H2>
@@ -66,9 +94,9 @@ Also, specify a valid filename for the DAV lock database by adding the following 
<A

 HREF="directive-dict.html#Compatibility"

 REL="Help"

><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above<P>

><STRONG>Compatibility:</STRONG></A> Apache 1.3.4 and above



Use the <CODE>Dav</CODE> directive to enable the WebDAV HTTP methods

<p>Use the <CODE>Dav</CODE> directive to enable the WebDAV HTTP methods

for the given container.

You may wish to add a

<A
@@ -78,7 +106,7 @@ clause inside the 
<A

 HREF="core.html#location"

>location</A>

directive to limit access to DAV-enabled locations.<P>

directive to limit access to DAV-enabled locations.</P>



<TABLE WIDTH="70%" BORDER=0 BGCOLOR="#E0E0F0" CELLSPACING=0 CELLPADDING=10>

<TR><TD>
@@ -124,17 +152,13 @@ AuthUserFile user.passwd<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>

><STRONG>Module:</STRONG></A> mod_dav



Use the <CODE>DavLockDB</CODE> directive to specify the full path to the

<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>

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>
@@ -169,22 +193,18 @@ used from the server to display all locks in a lock database.<P> 
<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>

><STRONG>Module:</STRONG></A> mod_dav



When a client requests a DAV resource lock, it can also specify a time

<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>

of an arbitrary value.</P>



Use the <CODE>DavMinTimeout</CODE> directive to specify, in seconds,

<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>

of the client losing the lock due to network latency.</P>



<TABLE WIDTH="70%" BORDER=0 BGCOLOR="#E0E0F0" CELLSPACING=0 CELLPADDING=10>

<TR><TD>
@@ -221,51 +241,12 @@ DavMinTimeout 600<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>

><STRONG>Module:</STRONG></A> mod_dav



Use the <CODE>DavDepthInfinity</CODE> directive to allow the processing

<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  &lt;size in bytes&gt;<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>

by default it is not allowed.</P>



<!--#include virtual="footer.html" -->

</BODY>