mod_dav_fs.xml revision 7087ccb939b4146f850f4d482fd8ab13de6335dc
d1e705efc6b288edbe466fd1af69d228f508361end<?xml version="1.0"?>
d1e705efc6b288edbe466fd1af69d228f508361end<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
d1e705efc6b288edbe466fd1af69d228f508361end<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd<!-- $LastChangedRevision$ -->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<!--
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding Licensed to the Apache Software Foundation (ASF) under one or more
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding contributor license agreements. See the NOTICE file distributed with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding this work for additional information regarding copyright ownership.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding The ASF licenses this file to You under the Apache License, Version 2.0
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding (the "License"); you may not use this file except in compliance with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd http://www.apache.org/licenses/LICENSE-2.0
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd-->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
7db9f691a00ead175b03335457ca296a33ddf31bnd<modulesynopsis metafile="mod_dav_fs.xml.meta">
d1e705efc6b288edbe466fd1af69d228f508361end
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<name>mod_dav_fs</name>
d1e705efc6b288edbe466fd1af69d228f508361end<description>filesystem provider for <module>mod_dav</module></description>
d1e705efc6b288edbe466fd1af69d228f508361end<status>Extension</status>
d1e705efc6b288edbe466fd1af69d228f508361end<sourcefile>mod_dav_fs.c</sourcefile>
d1e705efc6b288edbe466fd1af69d228f508361end<identifier>dav_fs_module</identifier>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end<summary>
d1e705efc6b288edbe466fd1af69d228f508361end <p>This module <em>requires</em> the service of <module
d1e705efc6b288edbe466fd1af69d228f508361end >mod_dav</module>. It acts as a support module for <module
d1e705efc6b288edbe466fd1af69d228f508361end >mod_dav</module> and provides access to resources located in the
d1e705efc6b288edbe466fd1af69d228f508361end server's file system. The formal name of this provider is
d1e705efc6b288edbe466fd1af69d228f508361end <code>filesystem</code>. <module>mod_dav</module> backend providers
d1e705efc6b288edbe466fd1af69d228f508361end will be invoked by using the <directive module="mod_dav">Dav</directive>
d1e705efc6b288edbe466fd1af69d228f508361end directive:</p>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end <example><title>Example</title>
7087ccb939b4146f850f4d482fd8ab13de6335dchumbedooh <highlight language="config">
d1e705efc6b288edbe466fd1af69d228f508361end Dav filesystem
7087ccb939b4146f850f4d482fd8ab13de6335dchumbedooh </highlight>
d1e705efc6b288edbe466fd1af69d228f508361end </example>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end <p>Since <code>filesystem</code> is the default provider for
d1e705efc6b288edbe466fd1af69d228f508361end <module>mod_dav</module>, you may simply use the value
d1e705efc6b288edbe466fd1af69d228f508361end <code>On</code> instead.</p>
d1e705efc6b288edbe466fd1af69d228f508361end</summary>
d1e705efc6b288edbe466fd1af69d228f508361end<seealso><module>mod_dav</module></seealso>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end<directivesynopsis>
d1e705efc6b288edbe466fd1af69d228f508361end<name>DavLockDB</name>
d1e705efc6b288edbe466fd1af69d228f508361end<description>Location of the DAV lock database</description>
d1e705efc6b288edbe466fd1af69d228f508361end<syntax>DavLockDB <var>file-path</var></syntax>
d1e705efc6b288edbe466fd1af69d228f508361end<contextlist><context>server config</context><context>virtual host</context>
d1e705efc6b288edbe466fd1af69d228f508361end</contextlist>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end<usage>
d1e705efc6b288edbe466fd1af69d228f508361end <p>Use the <directive>DavLockDB</directive> directive to specify
d1e705efc6b288edbe466fd1af69d228f508361end the full path to the lock database, excluding an extension. If
d1e705efc6b288edbe466fd1af69d228f508361end the path is not absolute, it will be taken relative to <directive
d1e705efc6b288edbe466fd1af69d228f508361end module="core">ServerRoot</directive>. The implementation of
d1e705efc6b288edbe466fd1af69d228f508361end <module>mod_dav_fs</module> uses a SDBM database to track user
d1e705efc6b288edbe466fd1af69d228f508361end locks.</p>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end <!-- XXX: someone should add that tool to the support directory...
d1e705efc6b288edbe466fd1af69d228f508361end The utility <code>modules/dav/util/lockview</code> can be used from
d1e705efc6b288edbe466fd1af69d228f508361end the server to display all locks in a lock database.</p> -->
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end <example><title>Example</title>
7087ccb939b4146f850f4d482fd8ab13de6335dchumbedooh <highlight language="config">
283c8419679dcabdd6605521b5094c7e31e44f4dslive DavLockDB var/DavLock
7087ccb939b4146f850f4d482fd8ab13de6335dchumbedooh </highlight>
d1e705efc6b288edbe466fd1af69d228f508361end </example>
283c8419679dcabdd6605521b5094c7e31e44f4dslive
283c8419679dcabdd6605521b5094c7e31e44f4dslive <p>The directory containing the lock database file must be
4c894c7d7c34890a8984b6cc1bcf6c19f15c4c0aniq writable by the <directive module="mod_unixd">User</directive>
4c894c7d7c34890a8984b6cc1bcf6c19f15c4c0aniq and <directive module="mod_unixd" >Group</directive> under which
283c8419679dcabdd6605521b5094c7e31e44f4dslive Apache is running. For security reasons, you should create a
283c8419679dcabdd6605521b5094c7e31e44f4dslive directory for this purpose rather than changing the permissions on
283c8419679dcabdd6605521b5094c7e31e44f4dslive an existing directory. In the above example, Apache will create
283c8419679dcabdd6605521b5094c7e31e44f4dslive files in the <code>var/</code> directory under the <directive
283c8419679dcabdd6605521b5094c7e31e44f4dslive module="core">ServerRoot</directive> with the base filename
283c8419679dcabdd6605521b5094c7e31e44f4dslive <code>DavLock</code> and extension name chosen by the server.</p>
283c8419679dcabdd6605521b5094c7e31e44f4dslive
d1e705efc6b288edbe466fd1af69d228f508361end</usage>
d1e705efc6b288edbe466fd1af69d228f508361end</directivesynopsis>
d1e705efc6b288edbe466fd1af69d228f508361end
d1e705efc6b288edbe466fd1af69d228f508361end</modulesynopsis>
d1e705efc6b288edbe466fd1af69d228f508361end