<?xml version="1.0"?>
<!-- English Revision : 1437836 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_dav_lock.xml.meta">
<name>mod_dav_lock</name>
<description>Module de verrouillage générique pour
<module>mod_dav</module></description>
<status>Extension</status>
<identifier>dav_lock_module</identifier>
<summary>
<p>ce module implémente une API de verrouillage générique que tout
fournisseur support de <module>mod_dav</module> peut utiliser. Son
activation nécessite l'utilisation de <module>mod_dav</module>. Mais
sans fournisseur support pour l'utiliser, il n'est d'aucun service
et ne doit pas être chargé dans le serveur. <a
href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui
implémente le fournisseur subversion, est un exemple
de module de support qui utilise effectivement
<module>mod_dav_lock</module>.</p>
<p>Notez que <module>mod_dav_fs</module> n'a <em>pas</em> besoin de
ce module de verrouillage générique, car il utilise sa propre
version plus spécifique.</p>
<p>Pour que <module>mod_dav_lock</module> puisse fonctionner, il
vous suffit de spécifier le chemin de la base de données des verrous
à l'aide de la directive <directive
module="mod_dav_lock">DavGenericLockDB</directive> décrite
ci-dessous.</p>
<note><title>Note du développeur</title>
<p>Pour déterminer le pointeur de la fonction du fournisseur de
verrouillage, vous devez utiliser l'API
<code>ap_lookup_provider</code> avec les arguments
<code>dav-lock</code>, <code>generic</code> et <code>0</code>.</p>
</note>
</summary>
<seealso><module>mod_dav</module></seealso>
<directivesynopsis>
<name>DavGenericLockDB</name>
<description>Chemin de la base de données des verrous DAV</description>
<syntax>DavGenericLockDB <var>chemin fichier</var></syntax>
<contextlist><context>server config</context><context>virtual
host</context>
<context>directory</context>
</contextlist>
<usage>
<p>La directive <directive>DavLockDB</directive> spécifie
le chemin complet de la base de données des verrous, sans extension.
Si le chemin n'est pas absolu, il sera considéré comme relatif au
répertoire défini par la directive <directive
module="core">ServerRoot</directive>. L'implémentation de
<module>mod_dav_lock</module> utilise une base de données SDBM pour
surveiller les verrous utilisateurs.</p>
<example><title>Exemple</title>
<highlight language="config">
</highlight>
</example>
<p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui
sont respectivement définis par les directives <directive
module="mod_unixd">User</directive> et <directive
module="mod_unixd">Group</directive> doivent pouvoir écrire dans le
répertoire qui contient le fichier de la base de données des
verrous. Pour des raisons de sécurité, il est recommandé de créer un
répertoire dédié à la base de données des verrous, plutôt que de
modifier les permissions d'un répertoire existant. Dans l'exemple
ci-dessus, Apache va créer des fichiers dans le répertoire
<code>var/</code>, lui-même sous-répertoire du répertoire défini par
la directive <directive
module="core">ServerRoot</directive>, avec le nom de base
<code>DavLock</code> suivi d'une extension choisie par le
serveur.</p>
</usage>
</directivesynopsis>
</modulesynopsis>