1
0
mirror of https://github.com/apache/httpd.git synced 2025-10-27 09:35:38 +03:00
Files
apache/docs/manual/mod/mod_dav.html
Rich Bowen f88b50dec4 w3c tidy to convert to xhtml
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@91116 13f79535-47bb-0310-9956-ffa450edef68
2001-09-22 19:39:26 +00:00

215 lines
7.5 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<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&nbsp;&nbsp;&nbsp;&nbsp;</code>
<em>(Any web-server writable filename, without an
extension)</em>
</blockquote>
<h2>Directives</h2>
<ul>
<li><a href="#DAV">Dav</a></li>
<li><a href="#DAVLockDB">DavLockDB</a></li>
<li><a href="#DAVMinTimeout">DavMinTimeout</a></li>
<li><a href="#DAVDepthInfinity">DavDepthInfinity</a></li>
</ul>
<hr />
<h2><a id="DAV" 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">&lt;Limit&gt;</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 />
&lt;Location /foo&gt;<br />
Dav On<br />
<br />
AuthType Basic<br />
AuthName DAV<br />
AuthUserFile user.passwd<br />
<br />
&nbsp;&nbsp;&lt;LimitExcept GET HEAD OPTIONS&gt;<br />
&nbsp;&nbsp;require user admin<br />
&nbsp;&nbsp;&lt;/LimitExcept&gt;<br />
&lt;/Location&gt;<br />
</code> </td>
</tr>
</table>
<br />
<hr />
<h2><a id="DavLockDB" 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 id="DavMinTimeout"
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>&lt;Location /MSWord&gt;<br />
DavMinTimeout 600<br />
&lt;/Location&gt;<br />
<br />
</code> </td>
</tr>
</table>
<br />
<hr />
<h2><a id="DavDepthInfinity"
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>