]> granicus.if.org Git - apache/commitdiff
[trunk][doc] Introducing .fr translation for mod_dav_lock.xml & mod_dav.xml
authorVincent Deffontaines <gryzor@apache.org>
Mon, 30 Dec 2013 16:14:27 +0000 (16:14 +0000)
committerVincent Deffontaines <gryzor@apache.org>
Mon, 30 Dec 2013 16:14:27 +0000 (16:14 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1554267 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/mod_dav.html
docs/manual/mod/mod_dav.html.fr [new file with mode: 0644]
docs/manual/mod/mod_dav.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_dav.xml.meta
docs/manual/mod/mod_dav_lock.html
docs/manual/mod/mod_dav_lock.html.fr [new file with mode: 0644]
docs/manual/mod/mod_dav_lock.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_dav_lock.xml.meta

index 5cdb02d8bafdb21cf923e85053b5f34a299c3138..02a71d348fe56abe631479fd495bf7e538a2b000 100644 (file)
@@ -4,6 +4,10 @@ URI: mod_dav.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: mod_dav.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: mod_dav.html.ja.utf8
 Content-Language: ja
 Content-type: text/html; charset=UTF-8
diff --git a/docs/manual/mod/mod_dav.html.fr b/docs/manual/mod/mod_dav.html.fr
new file mode 100644 (file)
index 0000000..efc27b1
--- /dev/null
@@ -0,0 +1,310 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>mod_dav - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.5</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_dav</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_dav.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalité de création et gestion de versions de
+documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav.c</td></tr></table>
+<h3>Sommaire</h3>
+
+    <p>Ce module ajoute à Apache une fonctionnalité <a href="http://www.webdav.org">WebDAV</a> de classes 1 et 2
+    ('Web-based Distributed Authoring and Versioning' ou Création et
+    gestion de versions de documents via le web). Il s'agit d'une
+    extension du protocole HTTP qui permet de créer, déplacer, copier et
+    supprimer des ressources ou collections de ressources sur un serveur
+    web distant.</p>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#dav">Dav</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#davdepthinfinity">DavDepthInfinity</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#davmintimeout">DavMinTimeout</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#example">Activation de WebDAV</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes concernant la sécurité</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#complex">Configurations complexes</a></li>
+</ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code></li>
+<li><code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code></li>
+<li><a href="http://www.webdav.org">Ressources WebDAV</a></li>
+</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="example" id="example">Activation de WebDAV</a></h2>
+    <p>Pour activer le module <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, ajoutez la ligne
+    suivante à un conteneur de votre fichier <code>httpd.conf</code>
+    :</p>
+
+    <pre class="prettyprint lang-config">Dav On</pre>
+
+
+    <p>Ceci active le fournisseur de système de fichier DAV implémenté par
+    le module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Ce dernier doit donc être
+    compilé dans le serveur ou chargé au démarrage à l'aide de la
+    directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</p>
+
+    <p>En outre, vous devez indiquer où se trouve la base de données des
+    verrous DAV via une directive <code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> dans la section globale de
+    votre fichier <code>httpd.conf</code> :</p>
+
+    <pre class="prettyprint lang-config">
+      DavLockDB /usr/local/apache2/var/DavLock
+    </pre>
+
+
+    <p>Le répertoire contenant le fichier de la base de données des
+    verrous doit avoir des droits en écriture pour l'utilisateur et le
+    groupe sous lesquels Apache s'exécute et définis respectivement par
+    les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et
+    <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code>.</p>
+
+    <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est
+    activé, vous pouvez ajouter une clause <code class="directive"><a href="../mod/core.html#limit">&lt;Limit&gt;</a></code> dans la section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> considérée. Pour
+    définir la quantité maximale de données en octets qu'un client
+    DAV peut envoyer par requête, vous devez utiliser la directive
+    <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code>, car La
+    directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code>
+    "habituelle" n'a aucune incidence sur les requêtes DAV.</p>
+
+    <div class="example"><h3>Exemple complet</h3><pre class="prettyprint lang-config">
+DavLockDB /usr/local/apache2/var/DavLock
+
+&lt;Directory /usr/local/apache2/htdocs/foo&gt;
+    Require all granted
+    Dav On
+
+    AuthType Basic
+    AuthName DAV
+    AuthUserFile user.passwd
+
+    &lt;LimitExcept GET POST OPTIONS&gt;
+        Require user admin
+    &lt;/LimitExcept&gt;
+&lt;/Directory&gt;
+      </pre>
+</div>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="security" id="security">Problèmes concernant la sécurité</a></h2>
+
+    <p>Etant donné que les méthodes d'accès DAV permettent à des clients
+    distants de manipuler des fichiers sur le serveur, vous devez vous
+    assurer que votre serveur est bien sécurisé avant d'activer
+    <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>.</p>
+
+    <p>Tout répertoire du serveur où DAV est activé doit être protégé
+    par une procédure d'authentification. L'utilisation de
+    l'authentification HTTP de base n'est pas recommandée. Vous devez
+    utiliser au moins l'authentification HTTP à base de condensés
+    qu'implémente le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>.
+    Pratiquement tous les clients WebDAV supportent cette méthode
+    d'authentification. Vous pouvez aussi utiliser l'authentification de
+    base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p>
+
+    <p>Pour que <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> puisse manipuler des fichiers,
+    il doit avoir des permissions en écriture sur les répertoires et les
+    fichiers qui sont sous son contrôle ; en d'autre termes, c'est
+    l'utilisateur et le groupe sous lesquels Apache s'exécute et définis
+    par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et
+    <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> qui doivent avoir
+    les droits en écriture sur ces fichiers et répertoires. Les fichiers
+    nouvellement créés appartiendront aussi à ces utilisateur et groupe.
+    Par conséquent, il est important de contrôler l'accès à ce compte.
+    Les répertoires DAV sont considérés comme privés du point de vue
+    d'Apache, et la modification des fichiers qu'ils contiennent
+    autrement que par l'intermédiaire d'Apache (par exemple par FTP ou
+    par des outils du niveau du système de fichiers) ne doit pas être
+    permise.</p>
+
+    <p><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut faire l'objet de plusieurs sortes
+    d'attaques par déni de service. La directive <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code> permet de limiter la
+    quantité de mémoire consommée pour interpréter des requêtes DAV de
+    grande taille. En outre, la directive <code class="directive"><a href="#davdepthinfinity">DavDepthInfinity</a></code> permet d'empêcher les
+    requêtes <code>PROPFIND</code> concernant un répertoire de très
+    grande taille de consommer de grandes quantités de mémoire. Un autre
+    type d'attaque par déni de service peut aussi être mené par un
+    client qui remplit simplement tout l'espace disque disponible avec
+    des fichiers de très grande taille. Etant donné qu'il n'existe aucun
+    moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez
+    accorder des accès DAV qu'à des utilisateurs de confiance.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="complex" id="complex">Configurations complexes</a></h2>
+
+    <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques
+    (scripts PHP, scripts CGI, etc...) en utilisant
+    <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont courantes. Ce traitement n'est pas
+    évident car une requête
+    <code>GET</code> va toujours tenter d'exécuter le script, plutôt que
+    de télécharger son contenu. Pour éviter cet inconvénient, une
+    méthode possible consiste à faire correspondre deux URLs
+    différentes au même contenu, l'une d'entre elles servant à lancer le
+    script, alors que l'autre peut être utilisée pour le télécharger et
+    le manipuler avec DAV.</p>
+
+<pre class="prettyprint lang-config">
+Alias /phparea /home/gstein/php_files
+Alias /php-source /home/gstein/php_files
+&lt;Location /php-source&gt;
+DAV On
+ForceType text/plain
+&lt;/Location&gt;
+</pre>
+
+
+    <p>Avec cette configuration, on peut utiliser
+    <code>http://example.com/phparea</code> pour afficher le résultat de
+    l'exécution des scripts PHP, et
+    <code>http://example.com/php-source</code> pour les manipuler avec
+    DAV.</p>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="Dav" id="Dav">Dav</a> <a name="dav" id="dav">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les méthodes HTTP WebDAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Dav On|Off|<var>nom fournisseur</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Dav Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
+</table>
+    <p>La directive <code class="directive">Dav</code> active les
+    méthodes HTTP WebDAV pour le conteneur condidéré :</p>
+
+    <pre class="prettyprint lang-config">
+&lt;Location /foo&gt;
+    Dav On
+&lt;/Location&gt;
+    </pre>
+
+
+    <p>La valeur <code>On</code> est en fait un alias vers le
+    fournisseur par défaut <code>filesystem</code> implémenté par le
+    module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Notez que lorsque DAV est activé
+    pour un conteneur, on <em>ne peut pas</em> le désactiver pour ses
+    sous-conteneurs. Pour un exemple de configuration complet,
+    reportez-vous à la <a href="#example">section précédente</a>.</p>
+
+    <div class="warning">
+      N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si
+      vous passez outre cette recommandation, tout le monde pourra
+      enregistrer des fichiers sur votre système.
+    </div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="DavDepthInfinity" id="DavDepthInfinity">DavDepthInfinity</a> <a name="davdepthinfinity" id="davdepthinfinity">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autorise les requêtes PROPFIND avec en-tête Depth:
+Infinity</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavDepthInfinity on|off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavDepthInfinity off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
+</table>
+    <p>La directive <code class="directive">DavDepthInfinity</code>
+    autorise le traitement des requêtes <code>PROPFIND</code>
+    contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête
+    n'est pas autorisé, car il peut favoriser les attaques de type Déni
+    de service.</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="DavMinTimeout" id="DavMinTimeout">DavMinTimeout</a> <a name="davmintimeout" id="davmintimeout">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée minimale pendant laquelle le serveur maintient un
+verrou sur une ressource DAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavMinTimeout <var>secondes</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavMinTimeout 0</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr>
+</table>
+    <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il
+    peut aussi spécifier une durée au bout de laquelle le verrou sera
+    automatiquement supprimé par le serveur. Cette valeur ne constitue
+    qu'une requête, et le serveur peut l'ignorer ou informer le client
+    qu'il va utiliser une valeur arbitraire.</p>
+
+    <p>La directive <code class="directive">DavMinTimeout</code>
+    spécifie, en secondes, la durée minimale de verrouillage à renvoyer
+    au client. Les Répertoires Web de Microsoft présentent une durée par
+    défaut de 120 secondes ; la directive
+    <code class="directive">DavMinTimeout</code> permet de définir une valeur
+    supérieure (par exemple 600 secondes), afin de réduire les risques
+    de perte du verrou par le client suite à une surcharge du
+    réseau.</p>
+
+    <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">
+&lt;Location /MSWord&gt;
+    DavMinTimeout 600
+&lt;/Location&gt;
+    </pre>
+</div>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_dav.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dav.html';
+(function(w, d) {
+    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+        d.write('<div id="comments_thread"><\/div>');
+        var s = d.createElement('script');
+        s.type = 'text/javascript';
+        s.async = true;
+        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+    }
+    else {
+        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+    }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+    prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/mod/mod_dav.xml.fr b/docs/manual/mod/mod_dav.xml.fr
new file mode 100644 (file)
index 0000000..f65f527
--- /dev/null
@@ -0,0 +1,268 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1330980 -->
+<!-- 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
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ 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.xml.meta">
+
+<name>mod_dav</name>
+<description>Fonctionnalit&eacute; de cr&eacute;ation et gestion de versions de
+documents via le web (<a
+href="http://www.webdav.org/">WebDAV</a>)</description>
+<status>Extension</status>
+<sourcefile>mod_dav.c</sourcefile>
+<identifier>dav_module</identifier>
+
+<summary>
+    <p>Ce module ajoute &agrave; Apache une fonctionnalit&eacute; <a
+    href="http://www.webdav.org">WebDAV</a> de classes 1 et 2
+    ('Web-based Distributed Authoring and Versioning' ou Cr&eacute;ation et
+    gestion de versions de documents via le web). Il s'agit d'une
+    extension du protocole HTTP qui permet de cr&eacute;er, d&eacute;placer, copier et
+    supprimer des ressources ou collections de ressources sur un serveur
+    web distant.</p>
+</summary>
+<seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso>
+<seealso><directive module="core">LimitXMLRequestBody</directive></seealso>
+<seealso><a href="http://www.webdav.org">Ressources WebDAV</a></seealso>
+
+<section id="example"><title>Activation de WebDAV</title>
+    <p>Pour activer le module <module>mod_dav</module>, ajoutez la ligne
+    suivante &agrave; un conteneur de votre fichier <code>httpd.conf</code>
+    :</p>
+
+    <highlight language="config">Dav On</highlight>
+
+    <p>Ceci active le fournisseur de syst&egrave;me de fichier DAV impl&eacute;ment&eacute; par
+    le module <module>mod_dav_fs</module>. Ce dernier doit donc &ecirc;tre
+    compil&eacute; dans le serveur ou charg&eacute; au d&eacute;marrage &agrave; l'aide de la
+    directive <directive module="mod_so">LoadModule</directive>.</p>
+
+    <p>En outre, vous devez indiquer o&ugrave; se trouve la base de donn&eacute;es des
+    verrous DAV via une directive <directive
+    module="mod_dav_fs">DavLockDB</directive> dans la section globale de
+    votre fichier <code>httpd.conf</code> :</p>
+
+    <highlight language="config">
+      DavLockDB /usr/local/apache2/var/DavLock
+    </highlight>
+
+    <p>Le r&eacute;pertoire contenant le fichier de la base de donn&eacute;es des
+    verrous doit avoir des droits en &eacute;criture pour l'utilisateur et le
+    groupe sous lesquels Apache s'ex&eacute;cute et d&eacute;finis respectivement par
+    les directives <directive module="mod_unixd">User</directive> et
+    <directive module="mod_unixd">Group</directive>.</p>
+
+    <p>Si vous souhaitez limiter l'acc&egrave;s aux r&eacute;pertoires o&ugrave; DAV est
+    activ&eacute;, vous pouvez ajouter une clause <directive module="core"
+    type="section">Limit</directive> dans la section <directive
+    module="core" type="section">Location</directive> consid&eacute;r&eacute;e. Pour
+    d&eacute;finir la quantit&eacute; maximale de donn&eacute;es en octets qu'un client
+    DAV peut envoyer par requ&ecirc;te, vous devez utiliser la directive
+    <directive module="core">LimitXMLRequestBody</directive>, car La
+    directive <directive module="core">LimitRequestBody</directive>
+    "habituelle" n'a aucune incidence sur les requ&ecirc;tes DAV.</p>
+
+    <example><title>Exemple complet</title>
+      <highlight language="config">
+DavLockDB /usr/local/apache2/var/DavLock
+
+&lt;Directory /usr/local/apache2/htdocs/foo&gt;
+    Require all granted
+    Dav On
+
+    AuthType Basic
+    AuthName DAV
+    AuthUserFile user.passwd
+
+    &lt;LimitExcept GET POST OPTIONS&gt;
+        Require user admin
+    &lt;/LimitExcept&gt;
+&lt;/Directory&gt;
+      </highlight>
+    </example>
+
+</section>
+
+<section id="security"><title>Probl&egrave;mes concernant la s&eacute;curit&eacute;</title>
+
+    <p>Etant donn&eacute; que les m&eacute;thodes d'acc&egrave;s DAV permettent &agrave; des clients
+    distants de manipuler des fichiers sur le serveur, vous devez vous
+    assurer que votre serveur est bien s&eacute;curis&eacute; avant d'activer
+    <module>mod_dav</module>.</p>
+
+    <p>Tout r&eacute;pertoire du serveur o&ugrave; DAV est activ&eacute; doit &ecirc;tre prot&eacute;g&eacute;
+    par une proc&eacute;dure d'authentification. L'utilisation de
+    l'authentification HTTP de base n'est pas recommand&eacute;e. Vous devez
+    utiliser au moins l'authentification HTTP &agrave; base de condens&eacute;s
+    qu'impl&eacute;mente le module <module>mod_auth_digest</module>.
+    Pratiquement tous les clients WebDAV supportent cette m&eacute;thode
+    d'authentification. Vous pouvez aussi utiliser l'authentification de
+    base sur une connexion o&ugrave; <a href="../ssl/">SSL</a> est activ&eacute;.</p>
+
+    <p>Pour que <module>mod_dav</module> puisse manipuler des fichiers,
+    il doit avoir des permissions en &eacute;criture sur les r&eacute;pertoires et les
+    fichiers qui sont sous son contr&ocirc;le ; en d'autre termes, c'est
+    l'utilisateur et le groupe sous lesquels Apache s'ex&eacute;cute et d&eacute;finis
+    par les directives <directive module="mod_unixd">User</directive> et
+    <directive module="mod_unixd">Group</directive> qui doivent avoir
+    les droits en &eacute;criture sur ces fichiers et r&eacute;pertoires. Les fichiers
+    nouvellement cr&eacute;&eacute;s appartiendront aussi &agrave; ces utilisateur et groupe.
+    Par cons&eacute;quent, il est important de contr&ocirc;ler l'acc&egrave;s &agrave; ce compte.
+    Les r&eacute;pertoires DAV sont consid&eacute;r&eacute;s comme priv&eacute;s du point de vue
+    d'Apache, et la modification des fichiers qu'ils contiennent
+    autrement que par l'interm&eacute;diaire d'Apache (par exemple par FTP ou
+    par des outils du niveau du syst&egrave;me de fichiers) ne doit pas &ecirc;tre
+    permise.</p>
+
+    <p><module>mod_dav</module> peut faire l'objet de plusieurs sortes
+    d'attaques par d&eacute;ni de service. La directive <directive
+    module="core">LimitXMLRequestBody</directive> permet de limiter la
+    quantit&eacute; de m&eacute;moire consomm&eacute;e pour interpr&eacute;ter des requ&ecirc;tes DAV de
+    grande taille. En outre, la directive <directive
+    module="mod_dav">DavDepthInfinity</directive> permet d'emp&ecirc;cher les
+    requ&ecirc;tes <code>PROPFIND</code> concernant un r&eacute;pertoire de tr&egrave;s
+    grande taille de consommer de grandes quantit&eacute;s de m&eacute;moire. Un autre
+    type d'attaque par d&eacute;ni de service peut aussi &ecirc;tre men&eacute; par un
+    client qui remplit simplement tout l'espace disque disponible avec
+    des fichiers de tr&egrave;s grande taille. Etant donn&eacute; qu'il n'existe aucun
+    moyen direct d'&eacute;viter ce genre d'attaque dans Apache, vous ne devez
+    accorder des acc&egrave;s DAV qu'&agrave; des utilisateurs de confiance.</p>
+</section>
+
+<section id="complex"><title>Configurations complexes</title>
+
+    <p>Les requ&ecirc;tes ayant pour but de manipuler des fichiers dynamiques
+    (scripts PHP, scripts CGI, etc...) en utilisant
+    <module>mod_dav</module> sont courantes. Ce traitement n'est pas
+    &eacute;vident car une requ&ecirc;te
+    <code>GET</code> va toujours tenter d'ex&eacute;cuter le script, plut&ocirc;t que
+    de t&eacute;l&eacute;charger son contenu. Pour &eacute;viter cet inconv&eacute;nient, une
+    m&eacute;thode possible consiste &agrave; faire correspondre deux URLs
+    diff&eacute;rentes au m&ecirc;me contenu, l'une d'entre elles servant &agrave; lancer le
+    script, alors que l'autre peut &ecirc;tre utilis&eacute;e pour le t&eacute;l&eacute;charger et
+    le manipuler avec DAV.</p>
+
+<highlight language="config">
+Alias /phparea /home/gstein/php_files
+Alias /php-source /home/gstein/php_files
+&lt;Location /php-source&gt;
+DAV On
+ForceType text/plain
+&lt;/Location&gt;
+</highlight>
+
+    <p>Avec cette configuration, on peut utiliser
+    <code>http://example.com/phparea</code> pour afficher le r&eacute;sultat de
+    l'ex&eacute;cution des scripts PHP, et
+    <code>http://example.com/php-source</code> pour les manipuler avec
+    DAV.</p>
+</section>
+
+<directivesynopsis>
+<name>Dav</name>
+<description>Active les m&eacute;thodes HTTP WebDAV</description>
+<syntax>Dav On|Off|<var>nom fournisseur</var></syntax>
+<default>Dav Off</default>
+<contextlist><context>directory</context></contextlist>
+
+<usage>
+    <p>La directive <directive>Dav</directive> active les
+    m&eacute;thodes HTTP WebDAV pour le conteneur condid&eacute;r&eacute; :</p>
+
+    <highlight language="config">
+&lt;Location /foo&gt;
+    Dav On
+&lt;/Location&gt;
+    </highlight>
+
+    <p>La valeur <code>On</code> est en fait un alias vers le
+    fournisseur par d&eacute;faut <code>filesystem</code> impl&eacute;ment&eacute; par le
+    module <module>mod_dav_fs</module>. Notez que lorsque DAV est activ&eacute;
+    pour un conteneur, on <em>ne peut pas</em> le d&eacute;sactiver pour ses
+    sous-conteneurs. Pour un exemple de configuration complet,
+    reportez-vous &agrave; la <a href="#example">section pr&eacute;c&eacute;dente</a>.</p>
+
+    <note type="warning">
+      N'activez pas WebDAV tant que votre serveur n'est pas s&eacute;curis&eacute;. Si
+      vous passez outre cette recommandation, tout le monde pourra
+      enregistrer des fichiers sur votre syst&egrave;me.
+    </note>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>DavMinTimeout</name>
+<description>Dur&eacute;e minimale pendant laquelle le serveur maintient un
+verrou sur une ressource DAV</description>
+<syntax>DavMinTimeout <var>secondes</var></syntax>
+<default>DavMinTimeout 0</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context></contextlist>
+
+<usage>
+    <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il
+    peut aussi sp&eacute;cifier une dur&eacute;e au bout de laquelle le verrou sera
+    automatiquement supprim&eacute; par le serveur. Cette valeur ne constitue
+    qu'une requ&ecirc;te, et le serveur peut l'ignorer ou informer le client
+    qu'il va utiliser une valeur arbitraire.</p>
+
+    <p>La directive <directive>DavMinTimeout</directive>
+    sp&eacute;cifie, en secondes, la dur&eacute;e minimale de verrouillage &agrave; renvoyer
+    au client. Les R&eacute;pertoires Web de Microsoft pr&eacute;sentent une dur&eacute;e par
+    d&eacute;faut de 120 secondes ; la directive
+    <directive>DavMinTimeout</directive> permet de d&eacute;finir une valeur
+    sup&eacute;rieure (par exemple 600 secondes), afin de r&eacute;duire les risques
+    de perte du verrou par le client suite &agrave; une surcharge du
+    r&eacute;seau.</p>
+
+    <example><title>Exemple</title>
+      <highlight language="config">
+&lt;Location /MSWord&gt;
+    DavMinTimeout 600
+&lt;/Location&gt;
+    </highlight>
+    </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>DavDepthInfinity</name>
+<description>Autorise les requ&ecirc;tes PROPFIND avec en-t&ecirc;te Depth:
+Infinity</description>
+<syntax>DavDepthInfinity on|off</syntax>
+<default>DavDepthInfinity off</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context></contextlist>
+
+<usage>
+    <p>La directive <directive>DavDepthInfinity</directive>
+    autorise le traitement des requ&ecirc;tes <code>PROPFIND</code>
+    contenant l'en-t&ecirc;te Depth: Infinity. Par d&eacute;faut, ce type de requ&ecirc;te
+    n'est pas autoris&eacute;, car il peut favoriser les attaques de type D&eacute;ni
+    de service.</p>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
+
+
index 63b414b26f73f3e82349119ae9508ce79ba1b43d..2d094cad4d96fe60e8f1f535186f122831e35072 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>
index 9c5bb17fd23ca12fdff30567e0c63e1573bb365b..81b865ab21fc9c86dd36795810cc879c6fb07652 100644 (file)
@@ -4,6 +4,10 @@ URI: mod_dav_lock.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: mod_dav_lock.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: mod_dav_lock.html.ja.utf8
 Content-Language: ja
 Content-type: text/html; charset=UTF-8
diff --git a/docs/manual/mod/mod_dav_lock.html.fr b/docs/manual/mod/mod_dav_lock.html.fr
new file mode 100644 (file)
index 0000000..93a4ee1
--- /dev/null
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>mod_dav_lock - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.5</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_dav_lock</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_dav_lock.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de verrouillage générique pour
+<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_lock_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_lock.c</td></tr></table>
+<h3>Sommaire</h3>
+
+    <p>ce module implémente une API de verrouillage générique que tout
+    fournisseur support de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut utiliser. Son
+    activation nécessite l'utilisation de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. 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
+    <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code>.</p>
+
+    <p>Notez que <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> 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 <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> puisse fonctionner, il
+    vous suffit de spécifier le chemin de la base de données des verrous
+    à l'aide de la directive <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> décrite
+    ci-dessous.</p>
+
+    <div class="note"><h3>Note du développeur</h3>
+      <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>
+    </div>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#davgenericlockdb">DavGenericLockDB</a></li>
+</ul>
+<h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li>
+</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
+
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a> <a name="davgenericlockdb" id="davgenericlockdb">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavGenericLockDB <var>chemin fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_lock</td></tr>
+</table>
+    <p>La directive <code class="directive">DavLockDB</code> 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 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. L'implémentation de
+    <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> utilise une base de données SDBM pour
+    surveiller les verrous utilisateurs.</p>
+
+    <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">
+      DavGenericLockDB var/DavLock
+      </pre>
+</div>
+
+    <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui
+    sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> 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 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base
+    <code>DavLock</code> suivi d'une extension choisie par le
+    serveur.</p>
+
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_dav_lock.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dav_lock.html';
+(function(w, d) {
+    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+        d.write('<div id="comments_thread"><\/div>');
+        var s = d.createElement('script');
+        s.type = 'text/javascript';
+        s.async = true;
+        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+    }
+    else {
+        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+    }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+    prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/mod/mod_dav_lock.xml.fr b/docs/manual/mod/mod_dav_lock.xml.fr
new file mode 100644 (file)
index 0000000..3d5850e
--- /dev/null
@@ -0,0 +1,108 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- 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
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ 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&eacute;n&eacute;rique pour
+<module>mod_dav</module></description>
+<status>Extension</status>
+<sourcefile>mod_dav_lock.c</sourcefile>
+<identifier>dav_lock_module</identifier>
+
+<summary>
+    <p>ce module impl&eacute;mente une API de verrouillage g&eacute;n&eacute;rique que tout
+    fournisseur support de <module>mod_dav</module> peut utiliser. Son
+    activation n&eacute;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 &ecirc;tre charg&eacute; dans le serveur. <a
+    href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui
+    impl&eacute;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&eacute;n&eacute;rique, car il utilise sa propre
+    version plus sp&eacute;cifique.</p>
+
+    <p>Pour que <module>mod_dav_lock</module> puisse fonctionner, il
+    vous suffit de sp&eacute;cifier le chemin de la base de donn&eacute;es des verrous
+    &agrave; l'aide de la directive <directive
+    module="mod_dav_lock">DavGenericLockDB</directive> d&eacute;crite
+    ci-dessous.</p>
+
+    <note><title>Note du d&eacute;veloppeur</title>
+      <p>Pour d&eacute;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&eacute;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&eacute;cifie
+    le chemin complet de la base de donn&eacute;es des verrous, sans extension.
+    Si le chemin n'est pas absolu, il sera consid&eacute;r&eacute; comme relatif au
+    r&eacute;pertoire d&eacute;fini par la directive <directive
+    module="core">ServerRoot</directive>. L'impl&eacute;mentation de
+    <module>mod_dav_lock</module> utilise une base de donn&eacute;es SDBM pour
+    surveiller les verrous utilisateurs.</p>
+
+    <example><title>Exemple</title>
+    <highlight language="config">
+      DavGenericLockDB var/DavLock
+      </highlight>
+    </example>
+
+    <p>Les utilisateur et groupe sous lesquels Apache s'ex&eacute;cute et qui
+    sont respectivement d&eacute;finis par les directives <directive
+    module="mod_unixd">User</directive> et <directive
+    module="mod_unixd">Group</directive> doivent pouvoir &eacute;crire dans le
+    r&eacute;pertoire qui contient le fichier de la base de donn&eacute;es des
+    verrous. Pour des raisons de s&eacute;curit&eacute;, il est recommand&eacute; de cr&eacute;er un
+    r&eacute;pertoire d&eacute;di&eacute; &agrave; la base de donn&eacute;es des verrous, plut&ocirc;t que de
+    modifier les permissions d'un r&eacute;pertoire existant. Dans l'exemple
+    ci-dessus, Apache va cr&eacute;er des fichiers dans le r&eacute;pertoire
+    <code>var/</code>, lui-m&ecirc;me sous-r&eacute;pertoire du r&eacute;pertoire d&eacute;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>
+
index 19a70cc4f2c2803e881a43a5842a5600cbafaef9..3c40c2c19b8378c3bbc9bd16a92d8a811281a475 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
   </variants>
 </metafile>