mirror of
https://github.com/apache/httpd.git
synced 2025-05-17 15:21:13 +03:00
e3489b6948
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87273 13f79535-47bb-0310-9956-ffa450edef68
254 lines
6.4 KiB
HTML
254 lines
6.4 KiB
HTML
<!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>
|
|
|
|
<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.</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 </CODE><EM>(Any web-server writeable filename, without an extension)</EM>
|
|
</blockquote>
|
|
|
|
|
|
|
|
<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>
|
|
</UL>
|
|
|
|
<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 <em>filename</em><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
|
|
|
|
<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 <em>seconds</em><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
|
|
|
|
<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>
|
|
|
|
<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
|
|
|
|
<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>
|
|
|
|
<!--#include virtual="footer.html" -->
|
|
</BODY>
|
|
</HTML>
|