]> granicus.if.org Git - apache/commitdiff
Adding .fr translation for a number of program documentations
authorVincent Deffontaines <gryzor@apache.org>
Sun, 25 Nov 2012 20:52:23 +0000 (20:52 +0000)
committerVincent Deffontaines <gryzor@apache.org>
Sun, 25 Nov 2012 20:52:23 +0000 (20:52 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1413413 13f79535-47bb-0310-9956-ffa450edef68

40 files changed:
docs/manual/programs/dbmmanage.html
docs/manual/programs/dbmmanage.html.fr [new file with mode: 0644]
docs/manual/programs/dbmmanage.xml.fr [new file with mode: 0644]
docs/manual/programs/dbmmanage.xml.meta
docs/manual/programs/fcgistarter.html
docs/manual/programs/fcgistarter.html.fr [new file with mode: 0644]
docs/manual/programs/fcgistarter.xml.fr [new file with mode: 0644]
docs/manual/programs/fcgistarter.xml.meta
docs/manual/programs/htcacheclean.html
docs/manual/programs/htcacheclean.html.fr [new file with mode: 0644]
docs/manual/programs/htcacheclean.xml.fr [new file with mode: 0644]
docs/manual/programs/htcacheclean.xml.meta
docs/manual/programs/htdbm.html
docs/manual/programs/htdbm.html.fr [new file with mode: 0644]
docs/manual/programs/htdbm.xml.fr [new file with mode: 0644]
docs/manual/programs/htdbm.xml.meta
docs/manual/programs/htdigest.html
docs/manual/programs/htdigest.html.fr [new file with mode: 0644]
docs/manual/programs/htdigest.xml.fr [new file with mode: 0644]
docs/manual/programs/htdigest.xml.meta
docs/manual/programs/htpasswd.html
docs/manual/programs/htpasswd.html.fr [new file with mode: 0644]
docs/manual/programs/htpasswd.xml.fr [new file with mode: 0644]
docs/manual/programs/htpasswd.xml.meta
docs/manual/programs/index.html
docs/manual/programs/index.html.fr [new file with mode: 0644]
docs/manual/programs/index.xml.fr [new file with mode: 0644]
docs/manual/programs/index.xml.meta
docs/manual/programs/logresolve.html
docs/manual/programs/logresolve.html.fr [new file with mode: 0644]
docs/manual/programs/logresolve.xml.fr [new file with mode: 0644]
docs/manual/programs/logresolve.xml.meta
docs/manual/programs/other.html
docs/manual/programs/other.html.fr [new file with mode: 0644]
docs/manual/programs/other.xml.fr [new file with mode: 0644]
docs/manual/programs/other.xml.meta
docs/manual/programs/rotatelogs.html
docs/manual/programs/rotatelogs.html.fr [new file with mode: 0644]
docs/manual/programs/rotatelogs.xml.fr [new file with mode: 0644]
docs/manual/programs/rotatelogs.xml.meta

index dcbee7abdff613ddcbde723fd1cf266c317877f6..89c4dce3cfff64251ab9fde30809351361420869 100644 (file)
@@ -4,6 +4,10 @@ URI: dbmmanage.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: dbmmanage.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: dbmmanage.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/dbmmanage.html.fr b/docs/manual/programs/dbmmanage.html.fr
new file mode 100644 (file)
index 0000000..51d40d4
--- /dev/null
@@ -0,0 +1,242 @@
+<?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>dbmmanage - Gestion des fichiers d'authentification des
+utilisateurs au format DBM - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>dbmmanage - Gestion des fichiers d'authentification des
+utilisateurs au format DBM</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/dbmmanage.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p><code>dbmmanage</code> permet de créer et de maintenir les
+    fichiers au format DBM où sont stockés les noms d'utilisateurs et
+    mots de passe à des fins d'authentification de base des utilisateurs
+    HTTP via le module <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>. Il est possible
+    de restreindre l'accès aux ressources disponibles sur le serveur
+    HTTP Apache aux seuls utilisateurs spécifiés dans les fichiers créés
+    par <code>dbmmanage</code>. Ce programme ne peut être utilisé
+    qu'avec des fichiers d'utilisateurs au format DBM. Pour
+    l'utilisation de fichiers textes, voir le programme
+    <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</p>
+
+    <p>Cette page de manuel ne décrit que les arguments de la ligne de
+    commande. Pour plus de détails à propos des directives nécessaires
+    pour configurer l'authentification des utilisateurs dans
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel httpd qui est fourni avec
+    la distribution d'Apache, ou peut être consulté à <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bogues</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</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="section">
+<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>dbmmanage</strong> [ <var>codage</var> ]
+    <var>nom-fichier</var> add|adduser|check|delete|update
+    <var>nom-utilisateur</var>
+    [ <var>mot-de-passe-chiffré</var>
+      [ <var>groupe</var>[,<var>groupe</var>...]
+        [ <var>commentaire</var> ] ] ]</code></p>
+
+    <p><code><strong>dbmmanage</strong> <var>nom-fichier</var>
+    view [ <var>nom-utilisateur</var> ]</code></p>
+
+    <p><code><strong>dbmmanage</strong> <var>nom-fichier</var>import</code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code><var>nom-fichier</var></code></dt>
+    <dd>Le nom du fichier au format DBM, en général sans l'extension
+    <code>.db</code>, <code>.pag</code>, ou <code>.dir</code>.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>L'utilisateur concerné par l'opération effectuée. Le
+    <var>nom-utilisateur</var> ne doit pas contenir de caractère
+    <code>:</code>.</dd>
+
+    <dt><code><var>mot-de-passe-chiffré</var></code></dt>
+    <dd>C'est le mot de passe sous sa forme chiffrée à utiliser avec les
+    commandes <code>update</code> et <code>add</code>. Vous pouvez
+    utiliser un tiret (<code>-</code>) si vous voulez que le mot de
+    passe vous soit demandé, mais remplissez les champs par la suite. En
+    outre, avec la commande <code>update</code>, un point
+    (<code>.</code>) permet de conserver le mot de passe original.</dd>
+
+    <dt><code><var>groupe</var></code></dt>
+    <dd>Un groupe dont l'utilisateur est membre. Un nom de groupe ne
+    doit pas contenir de caractère (<code>:</code>). Vous pouvez
+    utiliser un tiret (<code>-</code>) si vous ne voulez pas associer
+    l'utilisateur à un groupe, mais remplissez le champ commentaire. En
+    outre, avec la commande <code>update</code>, un point
+    (<code>.</code>) permet de conserver le groupe original.</dd>
+
+    <dt><code><var>commentaire</var></code></dt>
+    <dd>C'est l'endroit où vous pouvez enregistrer diverses informations
+    à propos de l'utilisateur telles que son nom réel, son e-mail,
+    etc... Le serveur ignore ce champ.</dd>
+    </dl>
+
+    <h3><a name="options.encodings" id="options.encodings">Codages</a></h3>
+      <dl>
+      <dt><code>-d</code></dt>
+      <dd>chiffrement crypt (chiffrement par défaut sauf sous Win32,
+      Netware)</dd>
+
+      <dt><code>-m</code></dt>
+      <dd>chiffrement MD5 (chiffrement par défaut sous Win32,
+      Netware)</dd>
+
+      <dt><code>-s</code></dt>
+      <dd>chiffrement SHA1</dd>
+
+      <dt><code>-p</code></dt>
+      <dd>en clair (<em>déconseillé</em>)</dd>
+      </dl>
+    
+
+    <h3><a name="options.commands" id="options.commands">Commandes</a></h3>
+      <dl>
+      <dt><code>add</code></dt>
+      <dd>Ajoute une entrée pour <var>nom-utilisateur</var> à
+      <var>nom-fichier</var> en utilisant le mot de passe chiffré
+      <var>mot-de-passe-chiffré</var>.
+
+      <div class="example"><p><code>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</code></p></div>
+      </dd>
+
+      <dt><code>adduser</code></dt>
+      <dd>Demande un mot de passe puis ajoute une entrée pour
+      <var>nom-utilisateur</var> à <var>nom-fichier</var>.
+
+      <div class="example"><p><code>dbmmanage passwords.dat adduser krietz</code></p></div>
+      </dd>
+
+      <dt><code>check</code></dt>
+      <dd>Demande un mot de passe puis vérifie si
+      <var>nom-utilisateur</var> est présent dans <var>nom-fichier</var>
+      et si son mot de passe correspond au mot de passe fourni.
+
+      <div class="example"><p><code>dbmmanage passwords.dat check rbowen</code></p></div>
+      </dd>
+
+      <dt><code>delete</code></dt>
+      <dd>Supprime l'entrée <var>nom-utilisateur</var> de
+      <var>nom-fichier</var>.
+
+      <div class="example"><p><code>dbmmanage passwords.dat delete rbowen</code></p></div>
+      </dd>
+
+      <dt><code>import</code></dt>
+      <dd>Lit les entrées
+      <code><var>nom-utilisateur</var>:<var>mot-de-passe</var></code>
+      (une par ligne) depuis <code>STDIN</code>, et les ajoute à
+      <var>nom-fichier</var>. Les mots de passe doivent être déjà
+      chiffrés.</dd>
+
+      <dt><code>update</code></dt>
+      <dd>Identique à la commande <code>adduser</code>, à l'exception
+      que la présence de <var>nom-utilisateur</var> dans
+      <var>nom-fichier</var> est vérifiée.
+
+      <div class="example"><p><code>dbmmanage passwords.dat update rbowen</code></p></div>
+      </dd>
+
+      <dt><code>view</code></dt>
+      <dd>Affiche le contenu du fichier DBM. Si vous spécifiez un
+      <var>nom-utilisateur</var>, seule l'entrée correspondante est
+      affichée.
+
+      <div class="example"><p><code>dbmmanage passwords.dat view</code></p></div>
+      </dd>
+      </dl>
+    
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="bugs" id="bugs">Bogues</a></h2>
+    <p>Vous devez garder à l'esprit qu'il existe de nombreux formats de
+    fichiers DBM différents, et que selon toute vraisemblance, des
+    bibliothèques pour plus d'un format sont présentes sur votre
+    système. Les trois exemples de base sont SDBM, NDBM, le projet GNU
+    GDBM, et Berkeley DB 2. Malheureusement, toutes ces bibliothèques
+    utilisent des formats de fichiers différents, et vous devez vous
+    assurer que le format de fichier utilisé par <var>nom-fichier</var>
+    correspond au format attendu par <code>dbmmanage</code>.
+    Actuellement, <code>dbmmanage</code> n'a aucun moyen de savoir à
+    quel type de fichier DBM il a à faire. S'il est utilisé avec un
+    format inapproprié, il ne renverra rien, ou pourra créer un fichier
+    DBM différent avec un nom différent, ou au pire, va corrompre le
+    fichier DBM si vous avez tenté de le modifier.</p>
+
+    <p><code>dbmmanage</code> possède une liste de préférences en
+    matière de formats DBM, définies dans le tableau
+    <code>@AnyDBM::ISA</code> au début du programme. Comme nous
+    préférons le format de fichier Berkeley DB 2, l'ordre dans lequel
+    <code>dbmmanage</code> va rechercher les bibliothèques système est
+    Berkeley DB 2, puis NDBM, GDBM et enfin SDBM. La première
+    bibliothèque trouvée sera celle que <code>dbmmanage</code> tentera
+    d'utiliser pour toutes les opérations sur les fichiers DBM. Cette
+    ordre est sensiblement différent de l'ordre standard de Perl
+    <code>@AnyDBM::ISA</code>, et de l'ordre utilisé par l'appel
+    <code>dbmopen()</code> de Perl ; si vous utilisez un autre
+    utilitaire pour gérer vos fichiers DBM, il doit donc se conformer à
+    l'ordre de préférence indiqué précédemment. Vous devez prêter la
+    même attention si vous utilisez des programmes écrits dans d'autres
+    langages, comme C, pour accéder à ces fichiers.</p>
+
+    <p>Vous pouvez utiliser le programme <code>file</code> fourni par la
+    plupart des systèmes Unix pour déterminer le format d'un fichier
+    DBM.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/dbmmanage.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/dbmmanage.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 2012 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/directives.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/programs/dbmmanage.xml.fr b/docs/manual/programs/dbmmanage.xml.fr
new file mode 100644 (file)
index 0000000..bd8e910
--- /dev/null
@@ -0,0 +1,213 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1174747 -->
+<!-- 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.
+-->
+
+<manualpage metafile="dbmmanage.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>dbmmanage - Gestion des fichiers d'authentification des
+utilisateurs au format DBM</title>
+
+<summary>
+    <p><code>dbmmanage</code> permet de cr&eacute;er et de maintenir les
+    fichiers au format DBM o&ugrave; sont stock&eacute;s les noms d'utilisateurs et
+    mots de passe &agrave; des fins d'authentification de base des utilisateurs
+    HTTP via le module <module>mod_authn_dbm</module>. Il est possible
+    de restreindre l'acc&egrave;s aux ressources disponibles sur le serveur
+    HTTP Apache aux seuls utilisateurs sp&eacute;cifi&eacute;s dans les fichiers cr&eacute;&eacute;s
+    par <code>dbmmanage</code>. Ce programme ne peut &ecirc;tre utilis&eacute;
+    qu'avec des fichiers d'utilisateurs au format DBM. Pour
+    l'utilisation de fichiers textes, voir le programme
+    <program>htpasswd</program>.</p>
+
+    <p>Cette page de manuel ne d&eacute;crit que les arguments de la ligne de
+    commande. Pour plus de d&eacute;tails &agrave; propos des directives n&eacute;cessaires
+    pour configurer l'authentification des utilisateurs dans
+    <program>httpd</program>, voir le manuel httpd qui est fourni avec
+    la distribution d'Apache, ou peut &ecirc;tre consult&eacute; &agrave; <a
+    href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</summary>
+<seealso><program>httpd</program></seealso>
+<seealso><module>mod_authn_dbm</module></seealso>
+<seealso><module>mod_authz_dbm</module></seealso>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>dbmmanage</strong> [ <var>codage</var> ]
+    <var>nom-fichier</var> add|adduser|check|delete|update
+    <var>nom-utilisateur</var>
+    [ <var>mot-de-passe-chiffr&eacute;</var>
+      [ <var>groupe</var>[,<var>groupe</var>...]
+        [ <var>commentaire</var> ] ] ]</code></p>
+
+    <p><code><strong>dbmmanage</strong> <var>nom-fichier</var>
+    view [ <var>nom-utilisateur</var> ]</code></p>
+
+    <p><code><strong>dbmmanage</strong> <var>nom-fichier</var>import</code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code><var>nom-fichier</var></code></dt>
+    <dd>Le nom du fichier au format DBM, en g&eacute;n&eacute;ral sans l'extension
+    <code>.db</code>, <code>.pag</code>, ou <code>.dir</code>.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>L'utilisateur concern&eacute; par l'op&eacute;ration effectu&eacute;e. Le
+    <var>nom-utilisateur</var> ne doit pas contenir de caract&egrave;re
+    <code>:</code>.</dd>
+
+    <dt><code><var>mot-de-passe-chiffr&eacute;</var></code></dt>
+    <dd>C'est le mot de passe sous sa forme chiffr&eacute;e &agrave; utiliser avec les
+    commandes <code>update</code> et <code>add</code>. Vous pouvez
+    utiliser un tiret (<code>-</code>) si vous voulez que le mot de
+    passe vous soit demand&eacute;, mais remplissez les champs par la suite. En
+    outre, avec la commande <code>update</code>, un point
+    (<code>.</code>) permet de conserver le mot de passe original.</dd>
+
+    <dt><code><var>groupe</var></code></dt>
+    <dd>Un groupe dont l'utilisateur est membre. Un nom de groupe ne
+    doit pas contenir de caract&egrave;re (<code>:</code>). Vous pouvez
+    utiliser un tiret (<code>-</code>) si vous ne voulez pas associer
+    l'utilisateur &agrave; un groupe, mais remplissez le champ commentaire. En
+    outre, avec la commande <code>update</code>, un point
+    (<code>.</code>) permet de conserver le groupe original.</dd>
+
+    <dt><code><var>commentaire</var></code></dt>
+    <dd>C'est l'endroit o&ugrave; vous pouvez enregistrer diverses informations
+    &agrave; propos de l'utilisateur telles que son nom r&eacute;el, son e-mail,
+    etc... Le serveur ignore ce champ.</dd>
+    </dl>
+
+    <section id="options.encodings"><title>Codages</title>
+      <dl>
+      <dt><code>-d</code></dt>
+      <dd>chiffrement crypt (chiffrement par d&eacute;faut sauf sous Win32,
+      Netware)</dd>
+
+      <dt><code>-m</code></dt>
+      <dd>chiffrement MD5 (chiffrement par d&eacute;faut sous Win32,
+      Netware)</dd>
+
+      <dt><code>-s</code></dt>
+      <dd>chiffrement SHA1</dd>
+
+      <dt><code>-p</code></dt>
+      <dd>en clair (<em>d&eacute;conseill&eacute;</em>)</dd>
+      </dl>
+    </section>
+
+    <section id="options.commands"><title>Commandes</title>
+      <dl>
+      <dt><code>add</code></dt>
+      <dd>Ajoute une entr&eacute;e pour <var>nom-utilisateur</var> &agrave;
+      <var>nom-fichier</var> en utilisant le mot de passe chiffr&eacute;
+      <var>mot-de-passe-chiffr&eacute;</var>.
+
+      <example>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</example>
+      </dd>
+
+      <dt><code>adduser</code></dt>
+      <dd>Demande un mot de passe puis ajoute une entr&eacute;e pour
+      <var>nom-utilisateur</var> &agrave; <var>nom-fichier</var>.
+
+      <example>dbmmanage passwords.dat adduser krietz</example>
+      </dd>
+
+      <dt><code>check</code></dt>
+      <dd>Demande un mot de passe puis v&eacute;rifie si
+      <var>nom-utilisateur</var> est pr&eacute;sent dans <var>nom-fichier</var>
+      et si son mot de passe correspond au mot de passe fourni.
+
+      <example>dbmmanage passwords.dat check rbowen</example>
+      </dd>
+
+      <dt><code>delete</code></dt>
+      <dd>Supprime l'entr&eacute;e <var>nom-utilisateur</var> de
+      <var>nom-fichier</var>.
+
+      <example>dbmmanage passwords.dat delete rbowen</example>
+      </dd>
+
+      <dt><code>import</code></dt>
+      <dd>Lit les entr&eacute;es
+      <code><var>nom-utilisateur</var>:<var>mot-de-passe</var></code>
+      (une par ligne) depuis <code>STDIN</code>, et les ajoute &agrave;
+      <var>nom-fichier</var>. Les mots de passe doivent &ecirc;tre d&eacute;j&agrave;
+      chiffr&eacute;s.</dd>
+
+      <dt><code>update</code></dt>
+      <dd>Identique &agrave; la commande <code>adduser</code>, &agrave; l'exception
+      que la pr&eacute;sence de <var>nom-utilisateur</var> dans
+      <var>nom-fichier</var> est v&eacute;rifi&eacute;e.
+
+      <example>dbmmanage passwords.dat update rbowen</example>
+      </dd>
+
+      <dt><code>view</code></dt>
+      <dd>Affiche le contenu du fichier DBM. Si vous sp&eacute;cifiez un
+      <var>nom-utilisateur</var>, seule l'entr&eacute;e correspondante est
+      affich&eacute;e.
+
+      <example>dbmmanage passwords.dat view</example>
+      </dd>
+      </dl>
+    </section>
+</section>
+
+<section id="bugs"><title>Bogues</title>
+    <p>Vous devez garder &agrave; l'esprit qu'il existe de nombreux formats de
+    fichiers DBM diff&eacute;rents, et que selon toute vraisemblance, des
+    biblioth&egrave;ques pour plus d'un format sont pr&eacute;sentes sur votre
+    syst&egrave;me. Les trois exemples de base sont SDBM, NDBM, le projet GNU
+    GDBM, et Berkeley DB 2. Malheureusement, toutes ces biblioth&egrave;ques
+    utilisent des formats de fichiers diff&eacute;rents, et vous devez vous
+    assurer que le format de fichier utilis&eacute; par <var>nom-fichier</var>
+    correspond au format attendu par <code>dbmmanage</code>.
+    Actuellement, <code>dbmmanage</code> n'a aucun moyen de savoir &agrave;
+    quel type de fichier DBM il a &agrave; faire. S'il est utilis&eacute; avec un
+    format inappropri&eacute;, il ne renverra rien, ou pourra cr&eacute;er un fichier
+    DBM diff&eacute;rent avec un nom diff&eacute;rent, ou au pire, va corrompre le
+    fichier DBM si vous avez tent&eacute; de le modifier.</p>
+
+    <p><code>dbmmanage</code> poss&egrave;de une liste de pr&eacute;f&eacute;rences en
+    mati&egrave;re de formats DBM, d&eacute;finies dans le tableau
+    <code>@AnyDBM::ISA</code> au d&eacute;but du programme. Comme nous
+    pr&eacute;f&eacute;rons le format de fichier Berkeley DB 2, l'ordre dans lequel
+    <code>dbmmanage</code> va rechercher les biblioth&egrave;ques syst&egrave;me est
+    Berkeley DB 2, puis NDBM, GDBM et enfin SDBM. La premi&egrave;re
+    biblioth&egrave;que trouv&eacute;e sera celle que <code>dbmmanage</code> tentera
+    d'utiliser pour toutes les op&eacute;rations sur les fichiers DBM. Cette
+    ordre est sensiblement diff&eacute;rent de l'ordre standard de Perl
+    <code>@AnyDBM::ISA</code>, et de l'ordre utilis&eacute; par l'appel
+    <code>dbmopen()</code> de Perl ; si vous utilisez un autre
+    utilitaire pour g&eacute;rer vos fichiers DBM, il doit donc se conformer &agrave;
+    l'ordre de pr&eacute;f&eacute;rence indiqu&eacute; pr&eacute;c&eacute;demment. Vous devez pr&ecirc;ter la
+    m&ecirc;me attention si vous utilisez des programmes &eacute;crits dans d'autres
+    langages, comme C, pour acc&eacute;der &agrave; ces fichiers.</p>
+
+    <p>Vous pouvez utiliser le programme <code>file</code> fourni par la
+    plupart des syst&egrave;mes Unix pour d&eacute;terminer le format d'un fichier
+    DBM.</p>
+</section>
+
+</manualpage>
index 66bff749461cc3afb70e65a96baa4d7faef384e1..7d4539def7410764ceec28d7b0016b23de8379ed 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant>tr</variant>
   </variants>
index b90abe9a9002752030b37e123e02da596d804e18..8d0fc8026075e5dbd67bb43d5437de5b10f59361 100644 (file)
@@ -4,6 +4,10 @@ URI: fcgistarter.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: fcgistarter.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: fcgistarter.html.tr.utf8
 Content-Language: tr
 Content-type: text/html; charset=UTF-8
diff --git a/docs/manual/programs/fcgistarter.html.fr b/docs/manual/programs/fcgistarter.html.fr
new file mode 100644 (file)
index 0000000..db0c8da
--- /dev/null
@@ -0,0 +1,94 @@
+<?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>fcgistarter - Démarrer un programme FastCGI - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>fcgistarter - Démarrer un programme FastCGI</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/fcgistarter.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p />
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#note">Note</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</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="section">
+<h2><a name="note" id="note">Note</a></h2>
+      <p>Ne fonctionne actuellement que sur les systèmes de type Unix.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>fcgistarter</strong>
+    -<strong>c</strong> <var>commande</var>
+    -<strong>p</strong> <var>port</var>
+    [ -<strong>i</strong> <var>interface</var> ]
+    -<strong>N</strong> <var>nombre</var>
+    </code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code>-c <var>commande</var></code></dt>
+    <dd>Le programme FastCGI</dd>
+
+    <dt><code>-p <var>port</var></code></dt>
+    <dd>Port sur lequel le programme va se mettre en écoute</dd>
+
+    <dt><code>-i <var>interface</var></code></dt>
+    <dd>Interface sur laquelle le programme va se mettre en écoute</dd>
+
+    <dt><code>-N <var>nombre</var></code></dt>
+    <dd>Nombre d'instances du programme</dd>
+
+    </dl>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/fcgistarter.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/fcgistarter.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 2012 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/directives.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/programs/fcgistarter.xml.fr b/docs/manual/programs/fcgistarter.xml.fr
new file mode 100644 (file)
index 0000000..7a10c5b
--- /dev/null
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1301728 -->
+<!-- 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.
+-->
+
+<manualpage metafile="fcgistarter.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>fcgistarter - D&eacute;marrer un programme FastCGI</title>
+
+<summary>
+    <p></p>
+</summary>
+
+<seealso><module>mod_proxy_fcgi</module></seealso>
+
+<section id="note"><title>Note</title>
+      <p>Ne fonctionne actuellement que sur les syst&egrave;mes de type Unix.</p>
+</section>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>fcgistarter</strong>
+    -<strong>c</strong> <var>commande</var>
+    -<strong>p</strong> <var>port</var>
+    [ -<strong>i</strong> <var>interface</var> ]
+    -<strong>N</strong> <var>nombre</var>
+    </code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code>-c <var>commande</var></code></dt>
+    <dd>Le programme FastCGI</dd>
+
+    <dt><code>-p <var>port</var></code></dt>
+    <dd>Port sur lequel le programme va se mettre en &eacute;coute</dd>
+
+    <dt><code>-i <var>interface</var></code></dt>
+    <dd>Interface sur laquelle le programme va se mettre en &eacute;coute</dd>
+
+    <dt><code>-N <var>nombre</var></code></dt>
+    <dd>Nombre d'instances du programme</dd>
+
+    </dl>
+</section>
+</manualpage>
index 728df887da4f1961af315a990362f2b6b6f5d78b..2aec6066d53c6beb2f3dcb6249ff021cbaeb2777 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant>tr</variant>
   </variants>
 </metafile>
index 28d47ea810ea1675c28ee0c8b6db60812551e30c..8bdd88e1d129344c7001a6f00721e36c1967acd6 100644 (file)
@@ -4,6 +4,10 @@ URI: htcacheclean.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: htcacheclean.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: htcacheclean.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/htcacheclean.html.fr b/docs/manual/programs/htcacheclean.html.fr
new file mode 100644 (file)
index 0000000..3e7cdf7
--- /dev/null
@@ -0,0 +1,260 @@
+<?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>htcacheclean - Nettoyage du cache sur disque - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Nettoyage du cache sur disque</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htcacheclean.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p><code>htcacheclean</code> permet de maintenir la taille de
+    l'espace de stockage réservé à <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> en
+    dessous d'une limite de taille donnée ou d'inodes utilisés. Cet
+    utilitaire peut s'exécuter
+    soit manuellement, soit en mode démon. Lorsqu'il fonctionne en mode
+    démon, il se met en attente en arrière-plan et recherche à
+    intervalles réguliers dans le répertoire du cache les contenus à
+    supprimer. Pour arrêter proprement le démon, vous pouvez lui envoyer
+    un signal TERM ou INT. Lorsqu'il est lancé manuellement, une
+    recherche des contenus du cache qui peuvent être supprimés est
+    effectuée une seule fois. Si une ou plusieurs URLs sont spécifiées,
+    chacune d'entre elles sera supprimée du cache, si elle est présente.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#delete">Suppression d'une URL particulière</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#list">Affichage des URLs présentes dans le cache</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</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="section">
+<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>D</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>r</strong> ]
+    [ -<strong>n</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    [-<strong>l</strong><var>limite</var>|
+    -<strong>L</strong><var>limite</var>]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>n</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>i</strong> ]
+    [ -<strong>P</strong><var>fichier-pid</var> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>d</strong><var>intervalle</var>
+    -<strong>p</strong><var>chemin</var>
+    [-<strong>l</strong><var>limite</var>|
+    -<strong>L</strong><var>limite</var>]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>v</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    [ -<strong>a</strong> ]
+    [ -<strong>A</strong> ]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>D</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    <var>url</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code>-d<var>intervalle</var></code></dt>
+    <dd>Configure en mode démon et planifie le nettoyage du cache toutes
+    les <var>intervalle</var> minutes. Cette option et les options
+    <code>-D</code>, <code>-v</code> et <code>-r</code> s'excluent
+    mutuellement. Pour arrêter le démon proprement, il suffit de lui
+    envoyer un signal <code>SIGTERM</code> ou <code>SIGINT</code>.</dd>
+
+    <dt><code>-D</code></dt>
+    <dd>Le programme s'exécute mais ne supprime aucun contenu ("dry run"). Cette
+    option et l'option <code>-d</code> s'excluent mutuellement. Si ce mode
+    est combiné avec la suppression des répertoires avec
+    <code>-t</code>, les inodes signalés comme supprimés dans les
+    statistiques ne peuvent pas prendre en compte les répertoires
+    supprimés, et seront marqués en tant qu'estimation.</dd>
+
+    <dt><code>-v</code></dt>
+    <dd>Exécution verbeuse et affichage de statistiques. Cette
+    option et l'option <code>-d</code> s'excluent mutuellement.</dd>
+
+    <dt><code>-r</code></dt>
+    <dd>Nettoyage en profondeur. Le serveur web Apache doit être arrêté
+    (dans le cas contraire, il risque de rester des déchets dans le
+    cache). Cette option implique l'option <code>-t</code> et s'exclue
+    mutuellement avec l'option <code>-d</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Exécution en retrait. L'exécution du programme est ralentie en
+    faveur des autres processus. <code>htcacheclean</code> s'interrompt
+    de temps en temps de façon à ce que a) les entrées/sorties disque
+    soient retardées et b) que le noyau puisse mettre ce temps
+    processeur à disposition des autres processus.</dd>
+
+    <dt><code>-t</code></dt>
+    <dd>Supprime tous les répertoires vides. Par défaut, seuls les
+    fichiers sont supprimés du cache ; avec certaines configurations,
+    cependant, un grand nombre de répertoires sont créés et méritent que
+    l'on y prête attention. Si votre configuration nécessite un grand
+    nombre de répertoires, au point que le remplissage de la table
+    d'inodes ou d'allocation de fichiers puisse poser problème,
+    l'utilisation de cette option est conseillée.</dd>
+
+    <dt><code>-p<var>chemin</var></code></dt>
+    <dd>Définit <var>chemin</var> comme répertoire racine du cache sur
+    disque. Cette valeur doit correspondre à celle spécifiée par la
+    directive <code class="directive"><a href="../mod/mod_disk_cache.html#cacheroot">CacheRoot</a></code>.</dd>
+
+    <dt><code>-P<var>fichier-pid</var></code></dt>
+    <dd>Permet de spécifier <var>fichier-pid</var> comme nom du fichier
+    dans le lequel sera enregistré l'identifiant du processus en mode
+    démon.</dd>
+
+    <dt><code>-R<var>round</var></code></dt>
+    <dd>Permet de spécifier le plus petit commun multiple de la taille
+    du cache, afin de tenir compte de la taille des blocs. Définir ce
+    paramètre à la taille d'un bloc de la partition du cache.</dd>
+
+    <dt><code>-l<var>limite</var></code></dt>
+    <dd>Définit <var>limite</var> comme la taille maximale du cache sur
+    disque. La valeur s'exprime par défaut en octets (ou en ajoutant le
+    suffixe <code>B</code> à la valeur). Ajoutez le suffixe
+    <code>K</code> pour KOctets ou <code>M</code> pour MOctets.</dd>
+
+    <dt><code>-L<var>limite</var></code></dt>
+    <dd>Spécifie <var>limite</var> comme la limite totale en inodes du
+    cache disque.</dd>
+
+    <dt><code>-i</code></dt>
+    <dd>Exécution intelligente. Le programme ne s'exécute que lorsque le
+    cache sur disque a été modifié. Cette option ne peut s'utiliser
+    qu'avec l'option <code>-d</code>.</dd>
+
+    <dt><code>-a</code></dt>
+    <dd>Affiche la liste des URLs actuellement stockées dans le cache.
+    Les variantes de la même URL seront listées une seule fois par
+    variante.</dd>
+
+    <dt><code>-A</code></dt>
+    <dd>Affiche la liste des URLs actuellement stockées dans le cache,
+    ainsi que leurs attributs dans l'ordre suivant : url, header size,
+    body size, status, entity version, date, expiry, request time,
+    response time, body present, head request.</dd>
+    </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="delete" id="delete">Suppression d'une URL particulière</a></h2>
+    <p>Si une ou plusieurs URLs sont passées en argument à
+    <code>htcacheclean</code>, chacune d'entre elles sera supprimée du
+    cache. S'il existe plusieurs variantes de ces URLs, elles seront
+    toutes supprimées.</p>
+
+    <p>Lorsqu'une URL mandatée en inverse doit être supprimée, l'URL
+    effective est construite à partir de l'en-tête
+    <strong>Host</strong>, du <strong>port</strong>, du
+    <strong>chemin</strong> et de la <strong>requête</strong>. Notez que
+    le '?' doit toujours être spécifié explicitement dans l'URL, qu'une
+    chaîne de paramètres soit présente ou non. Par exemple, pour
+    supprimer le chemin <strong>/</strong> du serveur
+    <strong>localhost</strong>, l'URL devra être spécifiée comme suit :
+    <strong>http://localhost:80/?</strong>.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="list" id="list">Affichage des URLs présentes dans le cache</a></h2>
+    <p>Les options <code>-a</code> ou <code>-A</code> permettent
+    d'afficher les URLs présentes dans le cache telles qu'elles s'y
+    trouvent, une URL par ligne. L'option <code>-A</code> affiche
+    l'entrée du cache complète pour chaque URL, avec ses différents
+    champs dans l'ordre suivant :</p>
+
+    <dl>
+        <dt>url</dt><dd>L'URL de l'entrée considérée.</dd>
+        <dt>header size</dt><dd>La taille de l'en-tête en octets.</dd>
+        <dt>body size</dt><dd>La taille du corps en octets.</dd>
+        <dt>status</dt><dd>Etat de la réponse en cache.</dd>
+        <dt>entity version</dt><dd>Le nombre de fois que cette entrée a
+       été revalidée sans être effacée.</dd>
+        <dt>date</dt><dd>Date de la réponse.</dd>
+        <dt>expiry</dt><dd>Date d'expiration de la réponse.</dd>
+        <dt>request time</dt><dd>Date du début de la requête.</dd>
+        <dt>response time</dt><dd>Date de la fin de la requête.</dd>
+        <dt>body present</dt><dd>Ce champ contient la valeur 0 si aucun
+       corps n'est stocké avec cette requête, 1 dans le cas contraire.</dd>
+        <dt>head request</dt><dd>Ce champ contient la valeur 1 si
+       l'entrée comporte une requête HEAD en cache sans corps, 0 dans
+       le cas contraire.</dd>
+    </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
+    <p><code>htcacheclean</code> renvoie zéro ("true") si toutes les
+    opérations se sont déroulées normalement, et <code>1</code> dans le
+    cas contraire. Si une URL est spécifiée, et si cette URL était
+    présente dans le cache et a été supprimée avec succès,
+    <code>htcacheclean</code> renvoie <code>0</code>, et <code>2</code>
+    dans le cas contraire. Si une erreur est survenue au cours de la
+    suppression de l'URL, <code>htcacheclean</code> renvoie
+    <code>1</code>.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htcacheclean.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/htcacheclean.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 2012 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/directives.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/programs/htcacheclean.xml.fr b/docs/manual/programs/htcacheclean.xml.fr
new file mode 100644 (file)
index 0000000..802385b
--- /dev/null
@@ -0,0 +1,228 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1174747 -->
+<!-- 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.
+-->
+
+<manualpage metafile="htcacheclean.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>htcacheclean - Nettoyage du cache sur disque</title>
+
+<summary>
+    <p><code>htcacheclean</code> permet de maintenir la taille de
+    l'espace de stockage r&eacute;serv&eacute; &agrave; <module>mod_disk_cache</module> en
+    dessous d'une limite de taille donn&eacute;e ou d'inodes utilis&eacute;s. Cet
+    utilitaire peut s'ex&eacute;cuter
+    soit manuellement, soit en mode d&eacute;mon. Lorsqu'il fonctionne en mode
+    d&eacute;mon, il se met en attente en arri&egrave;re-plan et recherche &agrave;
+    intervalles r&eacute;guliers dans le r&eacute;pertoire du cache les contenus &agrave;
+    supprimer. Pour arr&ecirc;ter proprement le d&eacute;mon, vous pouvez lui envoyer
+    un signal TERM ou INT. Lorsqu'il est lanc&eacute; manuellement, une
+    recherche des contenus du cache qui peuvent &ecirc;tre supprim&eacute;s est
+    effectu&eacute;e une seule fois. Si une ou plusieurs URLs sont sp&eacute;cifi&eacute;es,
+    chacune d'entre elles sera supprim&eacute;e du cache, si elle est pr&eacute;sente.</p>
+</summary>
+<seealso><module>mod_disk_cache</module></seealso>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>D</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>r</strong> ]
+    [ -<strong>n</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    [-<strong>l</strong><var>limite</var>|
+    -<strong>L</strong><var>limite</var>]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>n</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>i</strong> ]
+    [ -<strong>P</strong><var>fichier-pid</var> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>d</strong><var>intervalle</var>
+    -<strong>p</strong><var>chemin</var>
+    [-<strong>l</strong><var>limite</var>|
+    -<strong>L</strong><var>limite</var>]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>v</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    [ -<strong>a</strong> ]
+    [ -<strong>A</strong> ]</code></p>
+
+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>D</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>R</strong><var>arrondi</var> ]
+    -<strong>p</strong><var>chemin</var>
+    <var>url</var></code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code>-d<var>intervalle</var></code></dt>
+    <dd>Configure en mode d&eacute;mon et planifie le nettoyage du cache toutes
+    les <var>intervalle</var> minutes. Cette option et les options
+    <code>-D</code>, <code>-v</code> et <code>-r</code> s'excluent
+    mutuellement. Pour arr&ecirc;ter le d&eacute;mon proprement, il suffit de lui
+    envoyer un signal <code>SIGTERM</code> ou <code>SIGINT</code>.</dd>
+
+    <dt><code>-D</code></dt>
+    <dd>Le programme s'ex&eacute;cute mais ne supprime aucun contenu ("dry run"). Cette
+    option et l'option <code>-d</code> s'excluent mutuellement. Si ce mode
+    est combin&eacute; avec la suppression des r&eacute;pertoires avec
+    <code>-t</code>, les inodes signal&eacute;s comme supprim&eacute;s dans les
+    statistiques ne peuvent pas prendre en compte les r&eacute;pertoires
+    supprim&eacute;s, et seront marqu&eacute;s en tant qu'estimation.</dd>
+
+    <dt><code>-v</code></dt>
+    <dd>Ex&eacute;cution verbeuse et affichage de statistiques. Cette
+    option et l'option <code>-d</code> s'excluent mutuellement.</dd>
+
+    <dt><code>-r</code></dt>
+    <dd>Nettoyage en profondeur. Le serveur web Apache doit &ecirc;tre arr&ecirc;t&eacute;
+    (dans le cas contraire, il risque de rester des d&eacute;chets dans le
+    cache). Cette option implique l'option <code>-t</code> et s'exclue
+    mutuellement avec l'option <code>-d</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Ex&eacute;cution en retrait. L'ex&eacute;cution du programme est ralentie en
+    faveur des autres processus. <code>htcacheclean</code> s'interrompt
+    de temps en temps de fa&ccedil;on &agrave; ce que a) les entr&eacute;es/sorties disque
+    soient retard&eacute;es et b) que le noyau puisse mettre ce temps
+    processeur &agrave; disposition des autres processus.</dd>
+
+    <dt><code>-t</code></dt>
+    <dd>Supprime tous les r&eacute;pertoires vides. Par d&eacute;faut, seuls les
+    fichiers sont supprim&eacute;s du cache ; avec certaines configurations,
+    cependant, un grand nombre de r&eacute;pertoires sont cr&eacute;&eacute;s et m&eacute;ritent que
+    l'on y pr&ecirc;te attention. Si votre configuration n&eacute;cessite un grand
+    nombre de r&eacute;pertoires, au point que le remplissage de la table
+    d'inodes ou d'allocation de fichiers puisse poser probl&egrave;me,
+    l'utilisation de cette option est conseill&eacute;e.</dd>
+
+    <dt><code>-p<var>chemin</var></code></dt>
+    <dd>D&eacute;finit <var>chemin</var> comme r&eacute;pertoire racine du cache sur
+    disque. Cette valeur doit correspondre &agrave; celle sp&eacute;cifi&eacute;e par la
+    directive <directive
+    module="mod_disk_cache">CacheRoot</directive>.</dd>
+
+    <dt><code>-P<var>fichier-pid</var></code></dt>
+    <dd>Permet de sp&eacute;cifier <var>fichier-pid</var> comme nom du fichier
+    dans le lequel sera enregistr&eacute; l'identifiant du processus en mode
+    d&eacute;mon.</dd>
+
+    <dt><code>-R<var>round</var></code></dt>
+    <dd>Permet de sp&eacute;cifier le plus petit commun multiple de la taille
+    du cache, afin de tenir compte de la taille des blocs. D&eacute;finir ce
+    param&egrave;tre &agrave; la taille d'un bloc de la partition du cache.</dd>
+
+    <dt><code>-l<var>limite</var></code></dt>
+    <dd>D&eacute;finit <var>limite</var> comme la taille maximale du cache sur
+    disque. La valeur s'exprime par d&eacute;faut en octets (ou en ajoutant le
+    suffixe <code>B</code> &agrave; la valeur). Ajoutez le suffixe
+    <code>K</code> pour KOctets ou <code>M</code> pour MOctets.</dd>
+
+    <dt><code>-L<var>limite</var></code></dt>
+    <dd>Sp&eacute;cifie <var>limite</var> comme la limite totale en inodes du
+    cache disque.</dd>
+
+    <dt><code>-i</code></dt>
+    <dd>Ex&eacute;cution intelligente. Le programme ne s'ex&eacute;cute que lorsque le
+    cache sur disque a &eacute;t&eacute; modifi&eacute;. Cette option ne peut s'utiliser
+    qu'avec l'option <code>-d</code>.</dd>
+
+    <dt><code>-a</code></dt>
+    <dd>Affiche la liste des URLs actuellement stock&eacute;es dans le cache.
+    Les variantes de la m&ecirc;me URL seront list&eacute;es une seule fois par
+    variante.</dd>
+
+    <dt><code>-A</code></dt>
+    <dd>Affiche la liste des URLs actuellement stock&eacute;es dans le cache,
+    ainsi que leurs attributs dans l'ordre suivant : url, header size,
+    body size, status, entity version, date, expiry, request time,
+    response time, body present, head request.</dd>
+    </dl>
+</section>
+
+<section id="delete"><title>Suppression d'une URL particuli&egrave;re</title>
+    <p>Si une ou plusieurs URLs sont pass&eacute;es en argument &agrave;
+    <code>htcacheclean</code>, chacune d'entre elles sera supprim&eacute;e du
+    cache. S'il existe plusieurs variantes de ces URLs, elles seront
+    toutes supprim&eacute;es.</p>
+
+    <p>Lorsqu'une URL mandat&eacute;e en inverse doit &ecirc;tre supprim&eacute;e, l'URL
+    effective est construite &agrave; partir de l'en-t&ecirc;te
+    <strong>Host</strong>, du <strong>port</strong>, du
+    <strong>chemin</strong> et de la <strong>requ&ecirc;te</strong>. Notez que
+    le '?' doit toujours &ecirc;tre sp&eacute;cifi&eacute; explicitement dans l'URL, qu'une
+    cha&icirc;ne de param&egrave;tres soit pr&eacute;sente ou non. Par exemple, pour
+    supprimer le chemin <strong>/</strong> du serveur
+    <strong>localhost</strong>, l'URL devra &ecirc;tre sp&eacute;cifi&eacute;e comme suit :
+    <strong>http://localhost:80/?</strong>.</p>
+
+</section>
+
+<section id="list"><title>Affichage des URLs pr&eacute;sentes dans le cache</title>
+    <p>Les options <code>-a</code> ou <code>-A</code> permettent
+    d'afficher les URLs pr&eacute;sentes dans le cache telles qu'elles s'y
+    trouvent, une URL par ligne. L'option <code>-A</code> affiche
+    l'entr&eacute;e du cache compl&egrave;te pour chaque URL, avec ses diff&eacute;rents
+    champs dans l'ordre suivant :</p>
+
+    <dl>
+        <dt>url</dt><dd>L'URL de l'entr&eacute;e consid&eacute;r&eacute;e.</dd>
+        <dt>header size</dt><dd>La taille de l'en-t&ecirc;te en octets.</dd>
+        <dt>body size</dt><dd>La taille du corps en octets.</dd>
+        <dt>status</dt><dd>Etat de la r&eacute;ponse en cache.</dd>
+        <dt>entity version</dt><dd>Le nombre de fois que cette entr&eacute;e a
+       &eacute;t&eacute; revalid&eacute;e sans &ecirc;tre effac&eacute;e.</dd>
+        <dt>date</dt><dd>Date de la r&eacute;ponse.</dd>
+        <dt>expiry</dt><dd>Date d'expiration de la r&eacute;ponse.</dd>
+        <dt>request time</dt><dd>Date du d&eacute;but de la requ&ecirc;te.</dd>
+        <dt>response time</dt><dd>Date de la fin de la requ&ecirc;te.</dd>
+        <dt>body present</dt><dd>Ce champ contient la valeur 0 si aucun
+       corps n'est stock&eacute; avec cette requ&ecirc;te, 1 dans le cas contraire.</dd>
+        <dt>head request</dt><dd>Ce champ contient la valeur 1 si
+       l'entr&eacute;e comporte une requ&ecirc;te HEAD en cache sans corps, 0 dans
+       le cas contraire.</dd>
+    </dl>
+
+</section>
+
+<section id="exit"><title>Valeur renvoy&eacute;e</title>
+    <p><code>htcacheclean</code> renvoie z&eacute;ro ("true") si toutes les
+    op&eacute;rations se sont d&eacute;roul&eacute;es normalement, et <code>1</code> dans le
+    cas contraire. Si une URL est sp&eacute;cifi&eacute;e, et si cette URL &eacute;tait
+    pr&eacute;sente dans le cache et a &eacute;t&eacute; supprim&eacute;e avec succ&egrave;s,
+    <code>htcacheclean</code> renvoie <code>0</code>, et <code>2</code>
+    dans le cas contraire. Si une erreur est survenue au cours de la
+    suppression de l'URL, <code>htcacheclean</code> renvoie
+    <code>1</code>.</p>
+</section>
+
+</manualpage>
index 3b614d641895893db98204fe3857bbc2e73f3e6a..7f2146f77ddc4278fb4e47973e815e8704d79efe 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant>tr</variant>
   </variants>
index 9adf3229f9e4d7982abac15717beb4612110b70f..bb2f95029fbde3c47d2c1c2c8dfc361ebcffa126 100644 (file)
@@ -4,6 +4,10 @@ URI: htdbm.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: htdbm.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: htdbm.html.tr.utf8
 Content-Language: tr
 Content-type: text/html; charset=UTF-8
diff --git a/docs/manual/programs/htdbm.html.fr b/docs/manual/programs/htdbm.html.fr
new file mode 100644 (file)
index 0000000..df79e88
--- /dev/null
@@ -0,0 +1,334 @@
+<?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>htdbm - Manipuler des bases de données DBM de mots de
+passe - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htdbm - Manipuler des bases de données DBM de mots de
+passe</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htdbm.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p><code>htdbm</code> permet de manipuler des fichiers au format DBM
+    ou sont stockés des nom d'utilisateurs et mots de passe à des fins
+    d'authentification de base des utilisateurs HTTP via le module
+    <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>. Voir la documentation de
+    <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> pour plus de détails à propos de ces
+    fichiers DBM.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bogues</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</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="section">
+<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>htdbm</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>x</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>b</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>n</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>nb</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>v</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>vb</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>x</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>l</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    </code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code>-b</code></dt>
+    <dd>Utilise le mode batch ; en d'autres termes, le mot de passe est
+    extrait de la ligne de commande au lieu d'être demandé à
+    l'opérateur. Cette option doit être utilisée avec la plus grande
+    prudence, car <strong>le mot de passe est visible en clair</strong>
+    dans la ligne de commande.</dd>
+
+    <dt><code>-c</code></dt>
+    <dd>Crée le <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe déjà, il est réécrit et
+    tronqué. Cette option ne peut pas être combinée avec l'option
+    <code>-n</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Affiche les résultats sur la sortie standard et ne met pas à
+    jour la base de données. Cette option modifie la syntaxe de la ligne
+    de commande, car l'argument <var>fichier-mots-de-passe</var> (en
+    général le premier) est omis. Elle ne peut pas être combinée avec
+    l'option <code>-c</code>.</dd>
+
+    <dt><code>-m</code></dt>
+    <dd>Utilise un chiffrement MD5 pour les mots de passe. Sous Windows
+    et Netware, c'est l'option par défaut..</dd>
+
+    <dt><code>-d</code></dt>
+    <dd>Utilise un chiffrement <code>crypt()</code> pour les mots de
+    passe. C'est l'option par défaut sur toutes les plates-formes, sauf
+    Windows et Netware. Bien que <code>htdbm</code> supporte ce
+    chiffrement sur toutes les plates-formes, il n'est pas supporté par
+    le serveur <code class="program"><a href="../programs/httpd.html">httpd</a></code> sous Windows et Netware.</dd>
+
+    <dt><code>-s</code></dt>
+    <dd>Utilise le chiffrement SHA pour les mots de passe. Facilite la
+    migration vers/depuis les serveurs Netscape qui utilisent le format
+    LDAP Directory Interchange (ldif).</dd>
+
+    <dt><code>-p</code></dt>
+    <dd>Utilise des mots de passe au format texte en clair. Bien que
+    <code>htdbm</code> supporte ce format sur toutes les plates-formes,
+    le démon <code class="program"><a href="../programs/httpd.html">httpd</a></code> n'accepte les mots de passe au
+    format texte en clair que sous Windows et Netware.</dd>
+
+    <dt><code>-l</code></dt>
+    <dd>Affiche chaque nom d'utilisateur de la base de données
+    accompagné de son commentaire sur la sortie standard.</dd>
+
+    <dt><code>-t</code></dt>
+    <dd>Interprète le dernier paramètre en tant que commentaire. Avec
+    cette option, il est possible d'ajouter une chaîne supplémentaire à
+    la fin de la ligne de commande ; le contenu de cette chaîne sera
+    stocké dans la base de données dans le champ "Comment" associé au
+    nom d'utilisateur spécifié.</dd>
+
+    <dt><code>-v</code></dt>
+    <dd>Vérifie une association nom d'utilisateur/mot de passe. Le
+    programme affichera un message indiquant si le mot de passe fourni
+    est valide. Si le mot de passe n'est pas valide, le programme
+    s'arrête et renvoie un code d'erreur 3.</dd>
+
+    <dt><code>-x</code></dt>
+    <dd>Supprime l'utilisateur. Si le nom d'utilisateur existe dans le
+    fichier DBM spécifié, il sera supprimé.</dd>
+
+    <dt><code><var>nom-fichier</var></code></dt>
+    <dd>Le nom du fichier au format DBM en général sans l'extension
+    <code>.db</code>, <code>.pag</code>, ou <code>.dir</code>. Avec
+    l'option <code>-c</code>, le fichier DBM est mis à jour s'il existe
+    ou créé dans le cas contraire.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur à créer ou mettre à jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
+    n'existe pas dans ce fichier, une entrée est ajoutée. S'il existe,
+    son mot de passe est modifié.</dd>
+
+    <dt><code><var>mot-de-passe</var></code></dt>
+    <dd>Le mot de passe en clair destiné à être chiffré et stocké dans
+    le fichier DBM. Ne s'utilise qu'avec l'option <code>-b</code>.</dd>
+
+    <dt><code>-T<var>DBTYPE</var></code></dt>
+    <dd>Type de fichier DBM (SDBM, GDBM, DB, ou "default").</dd>
+    </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="bugs" id="bugs">Bogues</a></h2>
+    <p>Vous devez garder à l'esprit qu'il existe de nombreux formats de
+    fichiers DBM différents, et que selon toute vraisemblance, des
+    bibliothèques pour plus d'un format sont présentes sur votre
+    système. Les trois exemples de base sont SDBM, NDBM, le projet GNU
+    GDBM, et Berkeley/Sleepycat DB 2/3/4. Malheureusement, toutes ces
+    bibliothèques
+    utilisent des formats de fichiers différents, et vous devez vous
+    assurer que le format de fichier utilisé par <var>nom-fichier</var>
+    correspond au format attendu par <code>htdbm</code>.
+    Actuellement, <code>htdbm</code> n'a aucun moyen de savoir à
+    quel type de fichier DBM il a à faire. S'il est utilisé avec un
+    format inapproprié, il ne renverra rien, ou pourra créer un fichier
+    DBM différent avec un nom différent, ou au pire, va corrompre le
+    fichier DBM si vous avez tenté de le modifier.</p>
+
+    <p>Vous pouvez utiliser le programme <code>file</code> fourni par la
+    plupart des systèmes Unix pour déterminer le format d'un fichier
+    DBM.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
+    <p><code>htdbm</code> renvoie 0 ("true") si les nom d'utilisateur et
+    mot de passe ont été créés ou mis à jour avec succès dans le fichier
+    DBM. <code>htdbm</code> renvoie <code>1</code> s'il a rencontré un
+    problème d'accès aux fichiers, <code>2</code> si la ligne de
+    commande comportait une erreur de syntaxe, <code>3</code> si le mot
+    de passe a été fourni interactivement et s'il est invalide pour
+    l'entrée considérée, <code>4</code> si l'opération a été
+    interrompue, <code>5</code> si une valeur est trop longue (nom
+    utilisateur, nom fichier, mot de passe, ou l'enregistrement après
+    son élaboration), <code>6</code> si le nom d'utilisateur contient
+    des caractères interdits (voir la section <a href="#restrictions">Restrictions</a>), et <code>7</code> si le
+    fichier n'est pas un fichier de mots de passe DBM valide.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="examples" id="examples">Exemples</a></h2>
+    <div class="example"><p><code>
+      htdbm /usr/local/etc/apache/.utilisateurs-htdbm jsmith
+    </code></p></div>
+
+    <p>Ajoute ou modifie le mot de passe de l'utilisateur
+    <code>jsmith</code>. Le mot de passe est demandé à l'opérateur. Sous
+    Windows, le mot de passe sera chiffré en utilisant l'algorithme MD5
+    Apache modifié ; dans les autres cas, c'est la routine
+    <code>crypt()</code> du système qui sera utilisée. Si le fichier
+    n'existe pas, <code>htdbm</code> s'arrêtera et renverra une
+    erreur.</p>
+
+    <div class="example"><p><code>
+      htdbm -c /home/doe/public_html/.htdbm jane
+    </code></p></div>
+
+    <p>Crée un nouveau fichier et y enregistre une entrée pour
+    l'utilisateur <code>jane</code>. Le mot de passe est demandé à
+    l'opérateur. Si le fichier existe et ne peut pas être lu, ou ne peut
+    pas être écrit, il ne sera pas modifié et
+    <code>htdbm</code> affichera un message et renverra un code
+    d'erreur.</p>
+
+    <div class="example"><p><code>
+      htdbm -mb /usr/web/.htdbm-tous jones Pwd4Steve
+    </code></p></div>
+
+    <p>Chiffre le mot de passe entré avec la ligne de commande
+    (<code>Pwd4Steve</code>) à l'aide de l'algorithme MD5, et
+    l'enregistre dans le fichier spécifié.</p>
+</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">Considérations à propos de sécurité</a></h2>
+    <p>Les fichiers de mots de passe Web tels que ceux que gère
+    <code>htdbm</code> ne doivent <em>pas</em> être stockés dans
+    l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
+    être possible d'y accéder à l'aide d'un navigateur.</p>
+
+    <p>L'utilisation de l'option <code>-b</code> est déconseillée, car
+    lorsqu'il est utilisé, le mot de passe apparaît en clair dans la
+    ligne de commande.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
+    <p>Sur la plate-forme Windows, les mots de passe chiffrés avec
+    <code>htdbm</code> ont une taille limitée à <code>255</code>
+    caractères. Si le mot de passe fourni est plus long, il sera tronqué
+    à 255 caractères.</p>
+
+    <p>L'algorithme MD5 utilisé par <code>htdbm</code> est spécifique à
+    Apache ; les mots de passe chiffrés en utilisant cet algorithme
+    seront inutilisables sur d'autres serveurs Web.</p>
+
+    <p>Les noms d'utilisateurs ont une taille limitée à <code>255</code>
+    octets et ne doivent pas contenir de caractère <code>:</code>.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htdbm.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/htdbm.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 2012 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/directives.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/programs/htdbm.xml.fr b/docs/manual/programs/htdbm.xml.fr
new file mode 100644 (file)
index 0000000..c967bb9
--- /dev/null
@@ -0,0 +1,303 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 758944 -->
+<!-- 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.
+-->
+
+<manualpage metafile="htdbm.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>htdbm - Manipuler des bases de donn&eacute;es DBM de mots de
+passe</title>
+
+<summary>
+    <p><code>htdbm</code> permet de manipuler des fichiers au format DBM
+    ou sont stock&eacute;s des nom d'utilisateurs et mots de passe &agrave; des fins
+    d'authentification de base des utilisateurs HTTP via le module
+    <module>mod_authn_dbm</module>. Voir la documentation de
+    <program>dbmmanage</program> pour plus de d&eacute;tails &agrave; propos de ces
+    fichiers DBM.</p>
+</summary>
+<seealso><program>httpd</program></seealso>
+<seealso><program>dbmmanage</program></seealso>
+<seealso><module>mod_authn_dbm</module></seealso>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>htdbm</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    [ -<strong>x</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>b</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>n</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>nb</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>v</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>vb</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>t</strong> ]
+    [ -<strong>v</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>x</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htdbm</strong> -<strong>l</strong>
+    [ -<strong>T</strong><var>DBTYPE</var> ]
+    </code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code>-b</code></dt>
+    <dd>Utilise le mode batch ; en d'autres termes, le mot de passe est
+    extrait de la ligne de commande au lieu d'&ecirc;tre demand&eacute; &agrave;
+    l'op&eacute;rateur. Cette option doit &ecirc;tre utilis&eacute;e avec la plus grande
+    prudence, car <strong>le mot de passe est visible en clair</strong>
+    dans la ligne de commande.</dd>
+
+    <dt><code>-c</code></dt>
+    <dd>Cr&eacute;e le <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe d&eacute;j&agrave;, il est r&eacute;&eacute;crit et
+    tronqu&eacute;. Cette option ne peut pas &ecirc;tre combin&eacute;e avec l'option
+    <code>-n</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Affiche les r&eacute;sultats sur la sortie standard et ne met pas &agrave;
+    jour la base de donn&eacute;es. Cette option modifie la syntaxe de la ligne
+    de commande, car l'argument <var>fichier-mots-de-passe</var> (en
+    g&eacute;n&eacute;ral le premier) est omis. Elle ne peut pas &ecirc;tre combin&eacute;e avec
+    l'option <code>-c</code>.</dd>
+
+    <dt><code>-m</code></dt>
+    <dd>Utilise un chiffrement MD5 pour les mots de passe. Sous Windows
+    et Netware, c'est l'option par d&eacute;faut..</dd>
+
+    <dt><code>-d</code></dt>
+    <dd>Utilise un chiffrement <code>crypt()</code> pour les mots de
+    passe. C'est l'option par d&eacute;faut sur toutes les plates-formes, sauf
+    Windows et Netware. Bien que <code>htdbm</code> supporte ce
+    chiffrement sur toutes les plates-formes, il n'est pas support&eacute; par
+    le serveur <program>httpd</program> sous Windows et Netware.</dd>
+
+    <dt><code>-s</code></dt>
+    <dd>Utilise le chiffrement SHA pour les mots de passe. Facilite la
+    migration vers/depuis les serveurs Netscape qui utilisent le format
+    LDAP Directory Interchange (ldif).</dd>
+
+    <dt><code>-p</code></dt>
+    <dd>Utilise des mots de passe au format texte en clair. Bien que
+    <code>htdbm</code> supporte ce format sur toutes les plates-formes,
+    le d&eacute;mon <program>httpd</program> n'accepte les mots de passe au
+    format texte en clair que sous Windows et Netware.</dd>
+
+    <dt><code>-l</code></dt>
+    <dd>Affiche chaque nom d'utilisateur de la base de donn&eacute;es
+    accompagn&eacute; de son commentaire sur la sortie standard.</dd>
+
+    <dt><code>-t</code></dt>
+    <dd>Interpr&egrave;te le dernier param&egrave;tre en tant que commentaire. Avec
+    cette option, il est possible d'ajouter une cha&icirc;ne suppl&eacute;mentaire &agrave;
+    la fin de la ligne de commande ; le contenu de cette cha&icirc;ne sera
+    stock&eacute; dans la base de donn&eacute;es dans le champ "Comment" associ&eacute; au
+    nom d'utilisateur sp&eacute;cifi&eacute;.</dd>
+
+    <dt><code>-v</code></dt>
+    <dd>V&eacute;rifie une association nom d'utilisateur/mot de passe. Le
+    programme affichera un message indiquant si le mot de passe fourni
+    est valide. Si le mot de passe n'est pas valide, le programme
+    s'arr&ecirc;te et renvoie un code d'erreur 3.</dd>
+
+    <dt><code>-x</code></dt>
+    <dd>Supprime l'utilisateur. Si le nom d'utilisateur existe dans le
+    fichier DBM sp&eacute;cifi&eacute;, il sera supprim&eacute;.</dd>
+
+    <dt><code><var>nom-fichier</var></code></dt>
+    <dd>Le nom du fichier au format DBM en g&eacute;n&eacute;ral sans l'extension
+    <code>.db</code>, <code>.pag</code>, ou <code>.dir</code>. Avec
+    l'option <code>-c</code>, le fichier DBM est mis &agrave; jour s'il existe
+    ou cr&eacute;&eacute; dans le cas contraire.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur &agrave; cr&eacute;er ou mettre &agrave; jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
+    n'existe pas dans ce fichier, une entr&eacute;e est ajout&eacute;e. S'il existe,
+    son mot de passe est modifi&eacute;.</dd>
+
+    <dt><code><var>mot-de-passe</var></code></dt>
+    <dd>Le mot de passe en clair destin&eacute; &agrave; &ecirc;tre chiffr&eacute; et stock&eacute; dans
+    le fichier DBM. Ne s'utilise qu'avec l'option <code>-b</code>.</dd>
+
+    <dt><code>-T<var>DBTYPE</var></code></dt>
+    <dd>Type de fichier DBM (SDBM, GDBM, DB, ou "default").</dd>
+    </dl>
+</section>
+
+<section id="bugs"><title>Bogues</title>
+    <p>Vous devez garder &agrave; l'esprit qu'il existe de nombreux formats de
+    fichiers DBM diff&eacute;rents, et que selon toute vraisemblance, des
+    biblioth&egrave;ques pour plus d'un format sont pr&eacute;sentes sur votre
+    syst&egrave;me. Les trois exemples de base sont SDBM, NDBM, le projet GNU
+    GDBM, et Berkeley/Sleepycat DB 2/3/4. Malheureusement, toutes ces
+    biblioth&egrave;ques
+    utilisent des formats de fichiers diff&eacute;rents, et vous devez vous
+    assurer que le format de fichier utilis&eacute; par <var>nom-fichier</var>
+    correspond au format attendu par <code>htdbm</code>.
+    Actuellement, <code>htdbm</code> n'a aucun moyen de savoir &agrave;
+    quel type de fichier DBM il a &agrave; faire. S'il est utilis&eacute; avec un
+    format inappropri&eacute;, il ne renverra rien, ou pourra cr&eacute;er un fichier
+    DBM diff&eacute;rent avec un nom diff&eacute;rent, ou au pire, va corrompre le
+    fichier DBM si vous avez tent&eacute; de le modifier.</p>
+
+    <p>Vous pouvez utiliser le programme <code>file</code> fourni par la
+    plupart des syst&egrave;mes Unix pour d&eacute;terminer le format d'un fichier
+    DBM.</p>
+</section>
+
+<section id="exit"><title>Valeur renvoy&eacute;e</title>
+    <p><code>htdbm</code> renvoie 0 ("true") si les nom d'utilisateur et
+    mot de passe ont &eacute;t&eacute; cr&eacute;&eacute;s ou mis &agrave; jour avec succ&egrave;s dans le fichier
+    DBM. <code>htdbm</code> renvoie <code>1</code> s'il a rencontr&eacute; un
+    probl&egrave;me d'acc&egrave;s aux fichiers, <code>2</code> si la ligne de
+    commande comportait une erreur de syntaxe, <code>3</code> si le mot
+    de passe a &eacute;t&eacute; fourni interactivement et s'il est invalide pour
+    l'entr&eacute;e consid&eacute;r&eacute;e, <code>4</code> si l'op&eacute;ration a &eacute;t&eacute;
+    interrompue, <code>5</code> si une valeur est trop longue (nom
+    utilisateur, nom fichier, mot de passe, ou l'enregistrement apr&egrave;s
+    son &eacute;laboration), <code>6</code> si le nom d'utilisateur contient
+    des caract&egrave;res interdits (voir la section <a
+    href="#restrictions">Restrictions</a>), et <code>7</code> si le
+    fichier n'est pas un fichier de mots de passe DBM valide.</p>
+</section>
+
+<section id="examples"><title>Exemples</title>
+    <example>
+      htdbm /usr/local/etc/apache/.utilisateurs-htdbm jsmith
+    </example>
+
+    <p>Ajoute ou modifie le mot de passe de l'utilisateur
+    <code>jsmith</code>. Le mot de passe est demand&eacute; &agrave; l'op&eacute;rateur. Sous
+    Windows, le mot de passe sera chiffr&eacute; en utilisant l'algorithme MD5
+    Apache modifi&eacute; ; dans les autres cas, c'est la routine
+    <code>crypt()</code> du syst&egrave;me qui sera utilis&eacute;e. Si le fichier
+    n'existe pas, <code>htdbm</code> s'arr&ecirc;tera et renverra une
+    erreur.</p>
+
+    <example>
+      htdbm -c /home/doe/public_html/.htdbm jane
+    </example>
+
+    <p>Cr&eacute;e un nouveau fichier et y enregistre une entr&eacute;e pour
+    l'utilisateur <code>jane</code>. Le mot de passe est demand&eacute; &agrave;
+    l'op&eacute;rateur. Si le fichier existe et ne peut pas &ecirc;tre lu, ou ne peut
+    pas &ecirc;tre &eacute;crit, il ne sera pas modifi&eacute; et
+    <code>htdbm</code> affichera un message et renverra un code
+    d'erreur.</p>
+
+    <example>
+      htdbm -mb /usr/web/.htdbm-tous jones Pwd4Steve
+    </example>
+
+    <p>Chiffre le mot de passe entr&eacute; avec la ligne de commande
+    (<code>Pwd4Steve</code>) &agrave; l'aide de l'algorithme MD5, et
+    l'enregistre dans le fichier sp&eacute;cifi&eacute;.</p>
+</section>
+
+<section id="security"><title>Consid&eacute;rations &agrave; propos de s&eacute;curit&eacute;</title>
+    <p>Les fichiers de mots de passe Web tels que ceux que g&egrave;re
+    <code>htdbm</code> ne doivent <em>pas</em> &ecirc;tre stock&eacute;s dans
+    l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
+    &ecirc;tre possible d'y acc&eacute;der &agrave; l'aide d'un navigateur.</p>
+
+    <p>L'utilisation de l'option <code>-b</code> est d&eacute;conseill&eacute;e, car
+    lorsqu'il est utilis&eacute;, le mot de passe appara&icirc;t en clair dans la
+    ligne de commande.</p>
+</section>
+
+<section id="restrictions"><title>Restrictions</title>
+    <p>Sur la plate-forme Windows, les mots de passe chiffr&eacute;s avec
+    <code>htdbm</code> ont une taille limit&eacute;e &agrave; <code>255</code>
+    caract&egrave;res. Si le mot de passe fourni est plus long, il sera tronqu&eacute;
+    &agrave; 255 caract&egrave;res.</p>
+
+    <p>L'algorithme MD5 utilis&eacute; par <code>htdbm</code> est sp&eacute;cifique &agrave;
+    Apache ; les mots de passe chiffr&eacute;s en utilisant cet algorithme
+    seront inutilisables sur d'autres serveurs Web.</p>
+
+    <p>Les noms d'utilisateurs ont une taille limit&eacute;e &agrave; <code>255</code>
+    octets et ne doivent pas contenir de caract&egrave;re <code>:</code>.</p>
+</section>
+
+</manualpage>
index ff8aa0020717b033d516ad322d53f72639fd4253..3e6cd174bcf1d2b93d2c1d3fb226f4062bda3312 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant>tr</variant>
   </variants>
 </metafile>
index f2c567991e7b5a21e20fbb0521bf2bc2fdd1c41f..a104a4d890d234f8b52184e908824cb4fb1870a7 100644 (file)
@@ -4,6 +4,10 @@ URI: htdigest.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: htdigest.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: htdigest.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/htdigest.html.fr b/docs/manual/programs/htdigest.html.fr
new file mode 100644 (file)
index 0000000..a50598c
--- /dev/null
@@ -0,0 +1,117 @@
+<?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>htdigest - Gestion des fichiers d'utilisateurs pour
+l'authentification à base de condensés - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htdigest - Gestion des fichiers d'utilisateurs pour
+l'authentification à base de condensés</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htdigest.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p><code>htdigest</code> permet de créer et maintenir les fichiers
+    textes dans lesquels sont stockés des noms d'utilisateurs, des
+    domaines de protection (realms) et des mots de passe pour
+    l'authentification à base de condensés des utilisateurs HTTP.
+    L'accès aux ressources du serveur HTTP Apache peut être limité aux
+    seuls utilisateurs enregistrés dans les fichiers créés par
+    <code>htdigest</code>.</p>
+
+    <p>Cette page de manuel ne décrit que les arguments de la ligne de
+    commande. Pour plus de détails à propos des directives nécessaires à
+    la configuration de l'authentification à base de condensés dans
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel Apache qui est fourni avec
+    la distribution et peut être consulté à <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</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="section">
+<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+    <var>fichier-mots-de-passe</var> <var>realm</var>
+    <var>nom-utilisateur</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">options</a></h2>
+    <dl>
+    <dt><code>-c</code></dt>
+    <dd>Crée le fichier <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe déjà, il est tout d'abord
+    supprimé.</dd>
+
+    <dt><code><var>fichier-mots-de-passe</var></code></dt>
+    <dd>Nom du fichier contenant les noms utilisateurs, realms et mots
+    de passe. Si l'option <code>-c</code> est spécifiée, le fichier est
+    créé s'il n'existe pas, ou supprimé et recréé s'il existe
+    déjà.</dd>
+
+    <dt><code><var>realm</var></code></dt>
+    <dd>Le nom du domaine de protection auquel le nom d'utilisateur
+    appartient. Voir <a href="http://tools.ietf.org/html/rfc2617#section-3.2.1">http://tools.ietf.org/html/rfc2617#section-3.2.1</a>
+    pour plus de détails.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur à créer ou mettre à jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var> est
+    absent de ce fichier, une nouvelle entrée est ajoutée. Si
+    l'utilisateur existe déjà, le mot de passe est modifié.</dd>
+    </dl>
+</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">Considérations à propos de sécurité</a></h2>
+    <p>En tant qu'exécutable setuid, ce programme n'est pas sûr. En
+    conséquence, évitez de lui attribuer des permissions setuid.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htdigest.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/htdigest.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 2012 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/directives.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/programs/htdigest.xml.fr b/docs/manual/programs/htdigest.xml.fr
new file mode 100644 (file)
index 0000000..43f8404
--- /dev/null
@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1363282 -->
+<!-- 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.
+-->
+
+<manualpage metafile="htdigest.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>htdigest - Gestion des fichiers d'utilisateurs pour
+l'authentification &agrave; base de condens&eacute;s</title>
+
+<summary>
+    <p><code>htdigest</code> permet de cr&eacute;er et maintenir les fichiers
+    textes dans lesquels sont stock&eacute;s des noms d'utilisateurs, des
+    domaines de protection (realms) et des mots de passe pour
+    l'authentification &agrave; base de condens&eacute;s des utilisateurs HTTP.
+    L'acc&egrave;s aux ressources du serveur HTTP Apache peut &ecirc;tre limit&eacute; aux
+    seuls utilisateurs enregistr&eacute;s dans les fichiers cr&eacute;&eacute;s par
+    <code>htdigest</code>.</p>
+
+    <p>Cette page de manuel ne d&eacute;crit que les arguments de la ligne de
+    commande. Pour plus de d&eacute;tails &agrave; propos des directives n&eacute;cessaires &agrave;
+    la configuration de l'authentification &agrave; base de condens&eacute;s dans
+    <program>httpd</program>, voir le manuel Apache qui est fourni avec
+    la distribution et peut &ecirc;tre consult&eacute; &agrave; <a
+    href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</summary>
+<seealso><program>httpd</program></seealso>
+<seealso><module>mod_auth_digest</module></seealso>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+    <var>fichier-mots-de-passe</var> <var>realm</var>
+    <var>nom-utilisateur</var></code></p>
+</section>
+
+<section id="options"><title>options</title>
+    <dl>
+    <dt><code>-c</code></dt>
+    <dd>Cr&eacute;e le fichier <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe d&eacute;j&agrave;, il est tout d'abord
+    supprim&eacute;.</dd>
+
+    <dt><code><var>fichier-mots-de-passe</var></code></dt>
+    <dd>Nom du fichier contenant les noms utilisateurs, realms et mots
+    de passe. Si l'option <code>-c</code> est sp&eacute;cifi&eacute;e, le fichier est
+    cr&eacute;&eacute; s'il n'existe pas, ou supprim&eacute; et recr&eacute;&eacute; s'il existe
+    d&eacute;j&agrave;.</dd>
+
+    <dt><code><var>realm</var></code></dt>
+    <dd>Le nom du domaine de protection auquel le nom d'utilisateur
+    appartient. Voir <a
+    href="http://tools.ietf.org/html/rfc2617#section-3.2.1">http://tools.ietf.org/html/rfc2617#section-3.2.1</a>
+    pour plus de d&eacute;tails.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur &agrave; cr&eacute;er ou mettre &agrave; jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var> est
+    absent de ce fichier, une nouvelle entr&eacute;e est ajout&eacute;e. Si
+    l'utilisateur existe d&eacute;j&agrave;, le mot de passe est modifi&eacute;.</dd>
+    </dl>
+</section>
+
+<section id="security"><title>Consid&eacute;rations &agrave; propos de s&eacute;curit&eacute;</title>
+    <p>En tant qu'ex&eacute;cutable setuid, ce programme n'est pas s&ucirc;r. En
+    cons&eacute;quence, &eacute;vitez de lui attribuer des permissions setuid.</p>
+</section>
+
+</manualpage>
index 159c4350eebee4f3eadaa4371c3258fe449db14e..7115d485eae7b50a1b42ebf124f43a0c3eab5808 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant outdated="yes">tr</variant>
   </variants>
index 919ac18a64f335c74ac5d863fe704ed29347b61c..f27c2f4e3b42e814d91adbc6aaa6f29a7e06477e 100644 (file)
@@ -4,6 +4,10 @@ URI: htpasswd.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: htpasswd.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: htpasswd.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/htpasswd.html.fr b/docs/manual/programs/htpasswd.html.fr
new file mode 100644 (file)
index 0000000..a7d2124
--- /dev/null
@@ -0,0 +1,293 @@
+<?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>htpasswd - Gestion des fichiers d'utilisateurs pour
+l'authentification de base - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - Gestion des fichiers d'utilisateurs pour
+l'authentification de base</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htpasswd.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+    <p><code>htpasswd</code> permet de créer et de maintenir les
+    fichiers textes où sont stockés les noms d'utilisateurs et mots de
+    passe pour l'authentification de base des utilisateurs HTTP. Si
+    <code>htpasswd</code> rencontre un problème d'accès à un fichier,
+    que ce soit pour écrire dans le fichier de sortie, ou pour lire le
+    fichier d'entrée dans le but de le mettre à jour, il renvoie un code
+    d'erreur et n'effectue aucune modification.</p>
+
+    <p>Il est possible de limiter l'accès aux ressources du serveur HTTP
+    Apache aux seuls utilisateurs présents dans les fichiers créés par
+    <code>htpasswd</code>. Ce programme ne sait gérer les noms
+    d'utilisateurs et mots de passe que s'ils sont stockés dans des
+    fichiers textes. Il peut cependant chiffrer et afficher les mots de
+    passe à des fins d'utilisation dans d'autres types de bases de
+    données. Pour utiliser une base de données DBM, voir le programme
+    <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code>.</p>
+
+    <p><code>htpasswd</code> chiffre les mots de passe en utilisant soit
+    une version de MD5 modifiée pour Apache, soit la routine
+    <code>crypt()</code> du système. Les fichiers gérés par
+    <code>htpasswd</code> peuvent contenir deux types de mots de passe ;
+    certaines entrées peuvent contenir des mots de passe chiffrés en
+    MD5, alors que d'autres entrées du même fichier contiendront des
+    mots de passe chiffrés avec <code>crypt()</code>.</p>
+
+    <p>Cette page de manuel ne décrit que les arguments de la ligne de
+    commande. Pour plus de détails à propos des directives nécessaires à
+    la configuration de l'authentification des utilisateurs dans
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel Apache qui est fourni avec
+    la distribution ou peut être consulté à <a href="http://httpd.apache.org">http://httpd.apache.org/</a>.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li>Les scripts fournis avec la distibution d'Apache et situés dans
+support/SHA1.</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="synopsis" id="synopsis">Syntaxe</a></h2>
+    <p><code><strong>htpasswd</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> ]
+    [ -<strong>D</strong> ] <var>fichier-mots-de-passe</var>
+    <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>b</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>D</strong> ]  <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var>
+    <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>n</strong>
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>s</strong> |
+      -<strong>p</strong> ] <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>nb</strong>
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>s</strong> |
+      -<strong>p</strong> ] <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code>-b</code></dt>
+    <dd>Utilise le mode batch ; c'est à dire, extrait le mot de passe de
+    la ligne de commande au lieu de le demander à l'opérateur. Cette
+    option doit être utilisée avec la plus grande prudence, car
+    <strong>le mot de passe est visible en clair</strong> dans la ligne
+    de commande.</dd>
+
+    <dt><code>-c</code></dt>
+    <dd>Crée le <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe déjà, il est réécrit et
+    tronqué. Cette option ne peut pas être combinée avec l'option
+    <code>-n</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Affiche le résultat du traitement sur la sortie standard au lieu
+    de mettre à jour le fichier. Ceci peut s'avérer utile pour générer
+    des enregistrements de mots de passe qu'Apache pourra utiliser à des
+    fins d'inclusion dans des fichiers de données au format autre que
+    texte. Cette option modifie la syntaxe de la ligne de commande, car
+    l'argument <var>fichier-mots-de-passe</var> (en général le premier)
+    est omis. Elle ne peut pas être combinée avec l'option
+    <code>-c</code>.</dd>
+
+    <dt><code>-m</code></dt>
+    <dd>Utilise le chiffrement MD5 pour les mots de passe. C'est le
+    comportement par défaut.</dd>
+
+    <dt><code>-d</code></dt>
+    <dd>Utilise le chiffrement <code>crypt()</code> pour les mots de
+    passe. Cette option n'est pas supportée par le
+    serveur <code class="program"><a href="../programs/httpd.html">httpd</a></code> sous Windows ou Netware. Cet
+    algorithme impose une limite à 8 caractères pour les mots de passe.
+    Il est jugé <strong>non sûr</strong> pour les standards actuels.</dd>
+
+    <dt><code>-s</code></dt>
+    <dd>Utilise le chiffrement SHA pour les mots de passe. Facilite la
+    migration vers/depuis les serveurs Netscape qui utilisent le format
+    LDAP Directory Interchange (ldif). Cet algorithme est jugé
+    <strong>non sûr</strong> pour les standards actuels.</dd>
+
+    <dt><code>-p</code></dt>
+    <dd>Enregistre les mots de passe en clair. Bien que
+    <code>htpasswd</code> supporte la création des mots de passe en
+    clair sur toutes les plates-formes, le démon
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code> n'accepte les mots de passe en clair que
+    sous Windows et Netware.</dd>
+
+    <dt><code>-D</code></dt>
+    <dd>Supprime un utilisateur, sous réserve qu'il existe dans le
+    fichier spécifié par htpasswd.</dd>
+
+    <dt><code><var>fichier-mots-de-passe</var></code></dt>
+    <dd>Le nom du fichier contenant les noms d'utilisateurs et mots de
+    passe. Avec l'option <code>-c</code>, le fichier est créé s'il
+    n'existe pas, ou réécrit et tronqué s'il existe déjà.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur à créer ou mettre à jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
+    n'existe pas, une nouvelle entrée est ajoutée. Dans le cas
+    contraire, le mot de passe est modifié.</dd>
+
+    <dt><code><var>mot-de-passe</var></code></dt>
+    <dd>Le mot de passe en clair et destiné à être chiffré puis stocké
+    dans le fichier. Cet argument ne s'utilise qu'avec l'option
+    <code>-b</code>.</dd>
+    </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
+    <p><code>htpasswd</code> renvoie 0 ("true") si le nom d'utilisateur
+    et le mot de passe ont été enregistrés ou mis à jour avec succès
+    dans le <var>fichier-mots-de-passe</var>. <code>htpasswd</code>
+    renvoie <code>1</code> s'il a rencontré un problème d'accès aux
+    fichiers, <code>2</code> si la ligne de commande comportait une
+    erreur de syntaxe, <code>3</code> si le mot de passe entré
+    interactivement ne correspondait pas au nom d'utilisateur,
+    <code>4</code> si l'opération a été interrompue, <code>5</code> si
+    une valeur était trop longue (nom-utilisateur, nom-fichier,
+    mot-de-passe, ou l'enregistrement résultant), <code>6</code> si le
+    nom d'utilisateur contenait des caractères interdits (voir la section
+    <a href="#restrictions">Restrictions</a>), et <code>7</code> si le
+    fichier spécifié n'était pas un fichier de mots de passe
+    valide.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="examples" id="examples">Exemples</a></h2>
+    <div class="example"><p><code>
+      htpasswd /usr/local/etc/apache/.utilisateurs-htpasswd jsmith
+    </code></p></div>
+
+    <p>Ajoute ou modifie le mot de passe de l'utilisateur
+    <code>jsmith</code>. Le mot de passe est demandé à l'opérateur. Le
+    mot de passe sera chiffré en utilisant l'algorithme MD5
+    modifié pour Apache. Si le fichier spécifié
+    n'existe pas, <code>htpasswd</code> renverra un code d'erreur.</p>
+
+    <div class="example"><p><code>
+      htpasswd -c /home/doe/public_html/.htpasswd jane
+    </code></p></div>
+
+    <p>Crée un nouveau fichier de mots de passe et y enregistre une
+    entrée pour l'utilisateur <code>jane</code>. Le mot de passe est
+    demandé à l'opérateur. Si le fichier existe et ne peut être ni lu ni
+    écrit, il n'est pas modifié et <code>htpasswd</code> affichera un
+    message et renverra un code d'erreur.</p>
+
+    <div class="example"><p><code>
+      htpasswd -db /usr/web/.htpasswd-tous jones Pwd4Steve
+    </code></p></div>
+
+    <p>Chiffre le mot de passe spécifié dans la ligne de commande
+    (<code>Pwd4Steve</code>) en utilisant l'algorithme
+    <code>crypt()</code>, et le stocke dans le fichier spécifié.</p>
+</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">Considérations à propos de sécurité</a></h2>
+    <p>Les fichiers de mots de passe Web comme ceux que gère
+    <code>htpasswd</code> ne doivent <em>pas</em> être situés dans
+    l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
+    être possible d'y accéder à partir d'un navigateur.</p>
+
+    <p>En tant qu'exécutable setuid, ce programme n'est pas sûr, et il
+    ne faut par conséquent <em>pas</em> lui attribuer de permissions
+    setuid.</p>
+
+    <p>L'utilisation de l'option <code>-b</code> est déconseillée, car
+    avec elle, les mots de passe apparaissent en clair dans la ligne de
+    commande.</p>
+
+    <p>Notez qu'avec l'algorithme <code>crypt()</code>, seuls les huit
+    premiers caractères du mot de passe spécifié sont pris en compte. Si
+    le mot de passe spécifié est plus long, les caractères
+    supplémentaires sont ignorés.</p>
+
+    <p>Le format de chiffrement SHA n'utilise pas d'amorçage aléatoire
+    (salting) : à un mot de passe donné correspond une seule
+    représentation chiffrée. Les formats <code>crypt()</code> et MD5
+    permutent la représentation en la préfixant par une chaîne d'amorce
+    aléatoire, afin de rendre les attaques de mots de passe à base de
+    dictionnaires plus difficiles.</p>
+
+    <p>Les formats SHA et <code>crypt()</code> sont jugés <strong>non
+    sûrs</strong> pour les standards actuels.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
+    <p>Sur les plates-formes Windows, la taille des mots de passe
+    chiffrés avec <code>htpasswd</code> est limitée à <code>255</code>
+    caractères. Les mots de passe dont la taille est supérieure seront
+    tronqués.</p>
+
+    <p>L'algorithme MD5 utilisé par <code>htpasswd</code> est spécifique
+    à Apache ; les mots de passe chiffrés en utilisant cet algorithme
+    seront inutilisables sur d'autres serveurs Web.</p>
+
+    <p>La taille des noms d'utilisateurs est limitée à <code>255</code>
+    octets et ceux-ci ne doivent pas contenir de caractère
+    <code>:</code>.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/htpasswd.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/htpasswd.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 2012 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/directives.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/programs/htpasswd.xml.fr b/docs/manual/programs/htpasswd.xml.fr
new file mode 100644 (file)
index 0000000..f0a4934
--- /dev/null
@@ -0,0 +1,260 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1365528 -->
+<!-- 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.
+-->
+
+<manualpage metafile="htpasswd.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>htpasswd - Gestion des fichiers d'utilisateurs pour
+l'authentification de base</title>
+
+<summary>
+    <p><code>htpasswd</code> permet de cr&eacute;er et de maintenir les
+    fichiers textes o&ugrave; sont stock&eacute;s les noms d'utilisateurs et mots de
+    passe pour l'authentification de base des utilisateurs HTTP. Si
+    <code>htpasswd</code> rencontre un probl&egrave;me d'acc&egrave;s &agrave; un fichier,
+    que ce soit pour &eacute;crire dans le fichier de sortie, ou pour lire le
+    fichier d'entr&eacute;e dans le but de le mettre &agrave; jour, il renvoie un code
+    d'erreur et n'effectue aucune modification.</p>
+
+    <p>Il est possible de limiter l'acc&egrave;s aux ressources du serveur HTTP
+    Apache aux seuls utilisateurs pr&eacute;sents dans les fichiers cr&eacute;&eacute;s par
+    <code>htpasswd</code>. Ce programme ne sait g&eacute;rer les noms
+    d'utilisateurs et mots de passe que s'ils sont stock&eacute;s dans des
+    fichiers textes. Il peut cependant chiffrer et afficher les mots de
+    passe &agrave; des fins d'utilisation dans d'autres types de bases de
+    donn&eacute;es. Pour utiliser une base de donn&eacute;es DBM, voir le programme
+    <program>dbmmanage</program>.</p>
+
+    <p><code>htpasswd</code> chiffre les mots de passe en utilisant soit
+    une version de MD5 modifi&eacute;e pour Apache, soit la routine
+    <code>crypt()</code> du syst&egrave;me. Les fichiers g&eacute;r&eacute;s par
+    <code>htpasswd</code> peuvent contenir deux types de mots de passe ;
+    certaines entr&eacute;es peuvent contenir des mots de passe chiffr&eacute;s en
+    MD5, alors que d'autres entr&eacute;es du m&ecirc;me fichier contiendront des
+    mots de passe chiffr&eacute;s avec <code>crypt()</code>.</p>
+
+    <p>Cette page de manuel ne d&eacute;crit que les arguments de la ligne de
+    commande. Pour plus de d&eacute;tails &agrave; propos des directives n&eacute;cessaires &agrave;
+    la configuration de l'authentification des utilisateurs dans
+    <program>httpd</program>, voir le manuel Apache qui est fourni avec
+    la distribution ou peut &ecirc;tre consult&eacute; &agrave; <a
+    href="http://httpd.apache.org">http://httpd.apache.org/</a>.</p>
+</summary>
+<seealso><program>httpd</program></seealso>
+<seealso>Les scripts fournis avec la distibution d'Apache et situ&eacute;s dans
+support/SHA1.</seealso>
+
+<section id="synopsis"><title>Syntaxe</title>
+    <p><code><strong>htpasswd</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> ]
+    [ -<strong>D</strong> ] <var>fichier-mots-de-passe</var>
+    <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>b</strong>
+    [ -<strong>c</strong> ]
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>p</strong> |
+      -<strong>s</strong> ]
+    [ -<strong>D</strong> ]  <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var>
+    <var>mot-de-passe</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>n</strong>
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>s</strong> |
+      -<strong>p</strong> ] <var>nom-utilisateur</var></code></p>
+
+    <p><code><strong>htpasswd</strong> -<strong>nb</strong>
+    [ -<strong>m</strong> |
+      -<strong>d</strong> |
+      -<strong>s</strong> |
+      -<strong>p</strong> ] <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code>-b</code></dt>
+    <dd>Utilise le mode batch ; c'est &agrave; dire, extrait le mot de passe de
+    la ligne de commande au lieu de le demander &agrave; l'op&eacute;rateur. Cette
+    option doit &ecirc;tre utilis&eacute;e avec la plus grande prudence, car
+    <strong>le mot de passe est visible en clair</strong> dans la ligne
+    de commande.</dd>
+
+    <dt><code>-c</code></dt>
+    <dd>Cr&eacute;e le <var>fichier-mots-de-passe</var>. Si
+    <var>fichier-mots-de-passe</var> existe d&eacute;j&agrave;, il est r&eacute;&eacute;crit et
+    tronqu&eacute;. Cette option ne peut pas &ecirc;tre combin&eacute;e avec l'option
+    <code>-n</code>.</dd>
+
+    <dt><code>-n</code></dt>
+    <dd>Affiche le r&eacute;sultat du traitement sur la sortie standard au lieu
+    de mettre &agrave; jour le fichier. Ceci peut s'av&eacute;rer utile pour g&eacute;n&eacute;rer
+    des enregistrements de mots de passe qu'Apache pourra utiliser &agrave; des
+    fins d'inclusion dans des fichiers de donn&eacute;es au format autre que
+    texte. Cette option modifie la syntaxe de la ligne de commande, car
+    l'argument <var>fichier-mots-de-passe</var> (en g&eacute;n&eacute;ral le premier)
+    est omis. Elle ne peut pas &ecirc;tre combin&eacute;e avec l'option
+    <code>-c</code>.</dd>
+
+    <dt><code>-m</code></dt>
+    <dd>Utilise le chiffrement MD5 pour les mots de passe. C'est le
+    comportement par d&eacute;faut.</dd>
+
+    <dt><code>-d</code></dt>
+    <dd>Utilise le chiffrement <code>crypt()</code> pour les mots de
+    passe. Cette option n'est pas support&eacute;e par le
+    serveur <program>httpd</program> sous Windows ou Netware. Cet
+    algorithme impose une limite &agrave; 8 caract&egrave;res pour les mots de passe.
+    Il est jug&eacute; <strong>non s&ucirc;r</strong> pour les standards actuels.</dd>
+
+    <dt><code>-s</code></dt>
+    <dd>Utilise le chiffrement SHA pour les mots de passe. Facilite la
+    migration vers/depuis les serveurs Netscape qui utilisent le format
+    LDAP Directory Interchange (ldif). Cet algorithme est jug&eacute;
+    <strong>non s&ucirc;r</strong> pour les standards actuels.</dd>
+
+    <dt><code>-p</code></dt>
+    <dd>Enregistre les mots de passe en clair. Bien que
+    <code>htpasswd</code> supporte la cr&eacute;ation des mots de passe en
+    clair sur toutes les plates-formes, le d&eacute;mon
+    <program>httpd</program> n'accepte les mots de passe en clair que
+    sous Windows et Netware.</dd>
+
+    <dt><code>-D</code></dt>
+    <dd>Supprime un utilisateur, sous r&eacute;serve qu'il existe dans le
+    fichier sp&eacute;cifi&eacute; par htpasswd.</dd>
+
+    <dt><code><var>fichier-mots-de-passe</var></code></dt>
+    <dd>Le nom du fichier contenant les noms d'utilisateurs et mots de
+    passe. Avec l'option <code>-c</code>, le fichier est cr&eacute;&eacute; s'il
+    n'existe pas, ou r&eacute;&eacute;crit et tronqu&eacute; s'il existe d&eacute;j&agrave;.</dd>
+
+    <dt><code><var>nom-utilisateur</var></code></dt>
+    <dd>Le nom d'utilisateur &agrave; cr&eacute;er ou mettre &agrave; jour dans le
+    <var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
+    n'existe pas, une nouvelle entr&eacute;e est ajout&eacute;e. Dans le cas
+    contraire, le mot de passe est modifi&eacute;.</dd>
+
+    <dt><code><var>mot-de-passe</var></code></dt>
+    <dd>Le mot de passe en clair et destin&eacute; &agrave; &ecirc;tre chiffr&eacute; puis stock&eacute;
+    dans le fichier. Cet argument ne s'utilise qu'avec l'option
+    <code>-b</code>.</dd>
+    </dl>
+</section>
+
+<section id="exit"><title>Valeur renvoy&eacute;e</title>
+    <p><code>htpasswd</code> renvoie 0 ("true") si le nom d'utilisateur
+    et le mot de passe ont &eacute;t&eacute; enregistr&eacute;s ou mis &agrave; jour avec succ&egrave;s
+    dans le <var>fichier-mots-de-passe</var>. <code>htpasswd</code>
+    renvoie <code>1</code> s'il a rencontr&eacute; un probl&egrave;me d'acc&egrave;s aux
+    fichiers, <code>2</code> si la ligne de commande comportait une
+    erreur de syntaxe, <code>3</code> si le mot de passe entr&eacute;
+    interactivement ne correspondait pas au nom d'utilisateur,
+    <code>4</code> si l'op&eacute;ration a &eacute;t&eacute; interrompue, <code>5</code> si
+    une valeur &eacute;tait trop longue (nom-utilisateur, nom-fichier,
+    mot-de-passe, ou l'enregistrement r&eacute;sultant), <code>6</code> si le
+    nom d'utilisateur contenait des caract&egrave;res interdits (voir la section
+    <a href="#restrictions">Restrictions</a>), et <code>7</code> si le
+    fichier sp&eacute;cifi&eacute; n'&eacute;tait pas un fichier de mots de passe
+    valide.</p>
+</section>
+
+<section id="examples"><title>Exemples</title>
+    <example>
+      htpasswd /usr/local/etc/apache/.utilisateurs-htpasswd jsmith
+    </example>
+
+    <p>Ajoute ou modifie le mot de passe de l'utilisateur
+    <code>jsmith</code>. Le mot de passe est demand&eacute; &agrave; l'op&eacute;rateur. Le
+    mot de passe sera chiffr&eacute; en utilisant l'algorithme MD5
+    modifi&eacute; pour Apache. Si le fichier sp&eacute;cifi&eacute;
+    n'existe pas, <code>htpasswd</code> renverra un code d'erreur.</p>
+
+    <example>
+      htpasswd -c /home/doe/public_html/.htpasswd jane
+    </example>
+
+    <p>Cr&eacute;e un nouveau fichier de mots de passe et y enregistre une
+    entr&eacute;e pour l'utilisateur <code>jane</code>. Le mot de passe est
+    demand&eacute; &agrave; l'op&eacute;rateur. Si le fichier existe et ne peut &ecirc;tre ni lu ni
+    &eacute;crit, il n'est pas modifi&eacute; et <code>htpasswd</code> affichera un
+    message et renverra un code d'erreur.</p>
+
+    <example>
+      htpasswd -db /usr/web/.htpasswd-tous jones Pwd4Steve
+    </example>
+
+    <p>Chiffre le mot de passe sp&eacute;cifi&eacute; dans la ligne de commande
+    (<code>Pwd4Steve</code>) en utilisant l'algorithme
+    <code>crypt()</code>, et le stocke dans le fichier sp&eacute;cifi&eacute;.</p>
+</section>
+
+<section id="security"><title>Consid&eacute;rations &agrave; propos de s&eacute;curit&eacute;</title>
+    <p>Les fichiers de mots de passe Web comme ceux que g&egrave;re
+    <code>htpasswd</code> ne doivent <em>pas</em> &ecirc;tre situ&eacute;s dans
+    l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
+    &ecirc;tre possible d'y acc&eacute;der &agrave; partir d'un navigateur.</p>
+
+    <p>En tant qu'ex&eacute;cutable setuid, ce programme n'est pas s&ucirc;r, et il
+    ne faut par cons&eacute;quent <em>pas</em> lui attribuer de permissions
+    setuid.</p>
+
+    <p>L'utilisation de l'option <code>-b</code> est d&eacute;conseill&eacute;e, car
+    avec elle, les mots de passe apparaissent en clair dans la ligne de
+    commande.</p>
+
+    <p>Notez qu'avec l'algorithme <code>crypt()</code>, seuls les huit
+    premiers caract&egrave;res du mot de passe sp&eacute;cifi&eacute; sont pris en compte. Si
+    le mot de passe sp&eacute;cifi&eacute; est plus long, les caract&egrave;res
+    suppl&eacute;mentaires sont ignor&eacute;s.</p>
+
+    <p>Le format de chiffrement SHA n'utilise pas d'amor&ccedil;age al&eacute;atoire
+    (salting) : &agrave; un mot de passe donn&eacute; correspond une seule
+    repr&eacute;sentation chiffr&eacute;e. Les formats <code>crypt()</code> et MD5
+    permutent la repr&eacute;sentation en la pr&eacute;fixant par une cha&icirc;ne d'amorce
+    al&eacute;atoire, afin de rendre les attaques de mots de passe &agrave; base de
+    dictionnaires plus difficiles.</p>
+
+    <p>Les formats SHA et <code>crypt()</code> sont jug&eacute;s <strong>non
+    s&ucirc;rs</strong> pour les standards actuels.</p>
+</section>
+
+<section id="restrictions"><title>Restrictions</title>
+    <p>Sur les plates-formes Windows, la taille des mots de passe
+    chiffr&eacute;s avec <code>htpasswd</code> est limit&eacute;e &agrave; <code>255</code>
+    caract&egrave;res. Les mots de passe dont la taille est sup&eacute;rieure seront
+    tronqu&eacute;s.</p>
+
+    <p>L'algorithme MD5 utilis&eacute; par <code>htpasswd</code> est sp&eacute;cifique
+    &agrave; Apache ; les mots de passe chiffr&eacute;s en utilisant cet algorithme
+    seront inutilisables sur d'autres serveurs Web.</p>
+
+    <p>La taille des noms d'utilisateurs est limit&eacute;e &agrave; <code>255</code>
+    octets et ceux-ci ne doivent pas contenir de caract&egrave;re
+    <code>:</code>.</p>
+</section>
+
+</manualpage>
index 2ac1370b0c9f836759a0e7338392eef08cef25dc..92871292ad6005a864193f152443ccf080deb01d 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant outdated="yes">tr</variant>
   </variants>
index 2197e9ad2e631a2c8e67a9bbd25221270a6e7157..3a6088e9f7cef255fdab35683a2d6f8219c42857 100644 (file)
@@ -8,6 +8,10 @@ URI: index.html.es
 Content-Language: es
 Content-type: text/html; charset=ISO-8859-1
 
+URI: index.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: index.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/index.html.fr b/docs/manual/programs/index.html.fr
new file mode 100644 (file)
index 0000000..f536eaa
--- /dev/null
@@ -0,0 +1,130 @@
+<?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>Le serveur et ses utilitaires - 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 id="manual-page" class="no-sidebar"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a></div><div id="page-content"><div id="preamble"><h1>Le serveur et ses utilitaires</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../es/programs/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/programs/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a> |
+<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
+</div>
+
+    <p>Cette page documente tous les utilitaires inclus
+    dans le serveur HTTP Apache.</p>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="index" id="index">Index</a></h2>
+
+    <dl>
+      <dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
+
+      <dd>Le serveur de protocole de transfert hypertexte Apache</dd>
+
+      <dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
+
+      <dd>L'interface de contrôle du serveur HTTP Apache</dd>
+
+      <dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
+
+      <dd>L'outil de test de performances du serveur HTTP Apache</dd>
+
+      <dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
+
+      <dd>L'outil de gestion des extensions Apache</dd>
+
+      <dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
+
+      <dd>Configuration de l'arborescence des sources</dd>
+
+      <dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
+
+      <dd>Crée et met à jour les fichiers d'authentification utilisateurs au
+      format DBM pour une authentification basique</dd>
+
+      <dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
+
+      <dd>Lance un programme fastcgi</dd>
+
+      <dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
+
+      <dd>Nettoie le cache sur disque</dd>
+
+      <dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
+
+      <dd>Crée et met à jour les fichiers d'authentification pour une
+      authentification sommaire</dd>
+
+      <dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
+
+      <dd>Manipulation des bases de données DBM des mots de passe.</dd>
+
+      <dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
+
+      <dd>Crée et met à jour les fichiers d'authentification pour une
+      authentification basique</dd>
+
+      <dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
+
+      <dd>Crée des fichiers dbm destinés à être utilisés avec
+      RewriteMap</dd>
+
+      <dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
+
+      <dd>Résolution des noms d'hôtes en adresses IP dans les fichiers
+      de traces d'Apache</dd>
+
+      <dt><a href="other.html#log_server_status">log_server_status</a></dt>
+
+       <dd>Journalisation périodique du statut du serveur</dd>
+
+      <dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
+
+      <dd>Rotation des traces d'Apache sans devoir arrêter le serveur</dd>
+
+      <dt><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></dt>
+
+       <dd>Divise un journal pour plusieurs hôtes virtuels en journaux
+       spécifiques à chaque hôte</dd>
+
+      <dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
+
+      <dd>Change d'utilisateur pour l'exécution de certains programmes</dd>
+
+    </dl>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../es/programs/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/programs/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a> |
+<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2012 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/directives.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/programs/index.xml.fr b/docs/manual/programs/index.xml.fr
new file mode 100644 (file)
index 0000000..3370339
--- /dev/null
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1329864 -->
+<!-- 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.
+-->
+
+<manualpage metafile="index.xml.meta">
+<parentdocument href="../"/>
+
+  <title>Le serveur et ses utilitaires</title>
+
+<summary>
+    <p>Cette page documente tous les utilitaires inclus
+    dans le serveur HTTP Apache.</p>
+</summary>
+
+<section id="index"><title>Index</title>
+
+    <dl>
+      <dt><program>httpd</program></dt>
+
+      <dd>Le serveur de protocole de transfert hypertexte Apache</dd>
+
+      <dt><program>apachectl</program></dt>
+
+      <dd>L'interface de contr&ocirc;le du serveur HTTP Apache</dd>
+
+      <dt><program>ab</program></dt>
+
+      <dd>L'outil de test de performances du serveur HTTP Apache</dd>
+
+      <dt><program>apxs</program></dt>
+
+      <dd>L'outil de gestion des extensions Apache</dd>
+
+      <dt><program>configure</program></dt>
+
+      <dd>Configuration de l'arborescence des sources</dd>
+
+      <dt><program>dbmmanage</program></dt>
+
+      <dd>Cr&eacute;e et met &agrave; jour les fichiers d'authentification utilisateurs au
+      format DBM pour une authentification basique</dd>
+
+      <dt><program>fcgistarter</program></dt>
+
+      <dd>Lance un programme fastcgi</dd>
+
+      <dt><program>htcacheclean</program></dt>
+
+      <dd>Nettoie le cache sur disque</dd>
+
+      <dt><program>htdigest</program></dt>
+
+      <dd>Cr&eacute;e et met &agrave; jour les fichiers d'authentification pour une
+      authentification sommaire</dd>
+
+      <dt><program>htdbm</program></dt>
+
+      <dd>Manipulation des bases de donn&eacute;es DBM des mots de passe.</dd>
+
+      <dt><program>htpasswd</program></dt>
+
+      <dd>Cr&eacute;e et met &agrave; jour les fichiers d'authentification pour une
+      authentification basique</dd>
+
+      <dt><program>httxt2dbm</program></dt>
+
+      <dd>Cr&eacute;e des fichiers dbm destin&eacute;s &agrave; &ecirc;tre utilis&eacute;s avec
+      RewriteMap</dd>
+
+      <dt><program>logresolve</program></dt>
+
+      <dd>R&eacute;solution des noms d'h&ocirc;tes en adresses IP dans les fichiers
+      de traces d'Apache</dd>
+
+      <dt><a
+       href="other.html#log_server_status">log_server_status</a></dt>
+
+       <dd>Journalisation p&eacute;riodique du statut du serveur</dd>
+
+      <dt><program>rotatelogs</program></dt>
+
+      <dd>Rotation des traces d'Apache sans devoir arr&ecirc;ter le serveur</dd>
+
+      <dt><program>split-logfile</program></dt>
+
+       <dd>Divise un journal pour plusieurs h&ocirc;tes virtuels en journaux
+       sp&eacute;cifiques &agrave; chaque h&ocirc;te</dd>
+
+      <dt><program>suexec</program></dt>
+
+      <dd>Change d'utilisateur pour l'ex&eacute;cution de certains programmes</dd>
+
+    </dl>
+</section>
+
+</manualpage>
index b4db4d3f4835112901bfb9c20fa34fb131bf0b14..e6af686d9a5adf831eca41eee79c8184e8492049 100644 (file)
@@ -9,6 +9,7 @@
   <variants>
     <variant>en</variant>
     <variant outdated="yes">es</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant>tr</variant>
     <variant outdated="yes">zh-cn</variant>
index a8958c831e9166ca975ffb73abb857f7b4f2374a..0f81226e58f5110eebcdadeb54d547feb8b9a586 100644 (file)
@@ -4,6 +4,10 @@ URI: logresolve.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: logresolve.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: logresolve.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/logresolve.html.fr b/docs/manual/programs/logresolve.html.fr
new file mode 100644 (file)
index 0000000..2f805d6
--- /dev/null
@@ -0,0 +1,104 @@
+<?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>logresolve - Résoud les adresses IP en noms d'hôtes dans les
+  fichiers journaux d'Apache - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>logresolve - Résoud les adresses IP en noms d'hôtes dans les
+  fichiers journaux d'Apache</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/logresolve.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+     <p><code>logresolve</code> est un programme agissant après
+     traitement pour résoudre les adresses IP dans les journaux d'accès
+     d'Apache. Pour minimiser la charge de votre serveur de noms,
+     logresolve possède son propre cache interne sous forme d'une table
+     de hashage. Cela implique que chaque numéro IP ne fera l'objet
+     d'une requête DNS que la première fois où il est rencontré dans le
+     fichier journal.</p>
+
+     <p>Le programme reçoit le fichier journal sur son entrée standard.
+     Les adresses IP doivent se trouver en tête de chaque ligne et
+     doivent être séparées du reste de la ligne par un espace.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</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="synopsis" id="synopsis">Syntaxe</a></h2>
+
+     <p><code><strong>logresolve</strong> [ -<strong>s</strong>
+     <var>nom-fichier</var> ] [ -<strong>c</strong> ] &lt;
+     <var>access_log</var> &gt; <var>access_log.new</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+
+<dl>
+
+<dt><code>-s <var>nom-fichier</var></code></dt>
+
+<dd>Spécifie le nom du fichier où seront enregistrées des
+statistiques.</dd>
+
+<dt><code>-c</code></dt>
+
+<dd>Avec cette option, <code>logresolve</code> effectue certaines
+vérifications DNS : après avoir trouvé le nom d'hôte correspondant à une
+adresse IP, <code>logresolve</code> effectue une recherche DNS sur ce
+nom d'hôte et vérifie si une des adresses IP trouvées correspond à
+l'adresse originale.</dd>
+
+</dl>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/logresolve.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/logresolve.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 2012 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/directives.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/programs/logresolve.xml.fr b/docs/manual/programs/logresolve.xml.fr
new file mode 100644 (file)
index 0000000..f4262fb
--- /dev/null
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1174747 -->
+<!-- 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.
+-->
+
+<manualpage metafile="logresolve.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+  <title>logresolve - R&eacute;soud les adresses IP en noms d'h&ocirc;tes dans les
+  fichiers journaux d'Apache</title>
+
+<summary>
+     <p><code>logresolve</code> est un programme agissant apr&egrave;s
+     traitement pour r&eacute;soudre les adresses IP dans les journaux d'acc&egrave;s
+     d'Apache. Pour minimiser la charge de votre serveur de noms,
+     logresolve poss&egrave;de son propre cache interne sous forme d'une table
+     de hashage. Cela implique que chaque num&eacute;ro IP ne fera l'objet
+     d'une requ&ecirc;te DNS que la premi&egrave;re fois o&ugrave; il est rencontr&eacute; dans le
+     fichier journal.</p>
+
+     <p>Le programme re&ccedil;oit le fichier journal sur son entr&eacute;e standard.
+     Les adresses IP doivent se trouver en t&ecirc;te de chaque ligne et
+     doivent &ecirc;tre s&eacute;par&eacute;es du reste de la ligne par un espace.</p>
+</summary>
+
+<section id="synopsis"><title>Syntaxe</title>
+
+     <p><code><strong>logresolve</strong> [ -<strong>s</strong>
+     <var>nom-fichier</var> ] [ -<strong>c</strong> ] &lt;
+     <var>access_log</var> &gt; <var>access_log.new</var></code></p>
+</section>
+
+
+<section id="options"><title>Options</title>
+
+<dl>
+
+<dt><code>-s <var>nom-fichier</var></code></dt>
+
+<dd>Sp&eacute;cifie le nom du fichier o&ugrave; seront enregistr&eacute;es des
+statistiques.</dd>
+
+<dt><code>-c</code></dt>
+
+<dd>Avec cette option, <code>logresolve</code> effectue certaines
+v&eacute;rifications DNS : apr&egrave;s avoir trouv&eacute; le nom d'h&ocirc;te correspondant &agrave; une
+adresse IP, <code>logresolve</code> effectue une recherche DNS sur ce
+nom d'h&ocirc;te et v&eacute;rifie si une des adresses IP trouv&eacute;es correspond &agrave;
+l'adresse originale.</dd>
+
+</dl>
+</section>
+
+</manualpage>
index 15f655bf4d95ff9690d16bf61da7b265ea689cc4..1a678ffd4f9c7b8a628de171ba94dc84b4b382cd 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant>tr</variant>
   </variants>
index d9c31cd3c0c17eaa768e7dc9e3b7341337ac12b7..d1199ee1cd9bdcef71322b67bba4221565b3ce22 100644 (file)
@@ -4,6 +4,10 @@ URI: other.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: other.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: other.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/other.html.fr b/docs/manual/programs/other.html.fr
new file mode 100644 (file)
index 0000000..8a776ce
--- /dev/null
@@ -0,0 +1,68 @@
+<?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>Autres programmes - 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 id="manual-page" class="no-sidebar"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>Autres programmes</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/other.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+
+    <p>Cette page contenait la documentation de programmes qui possèdent
+    maintenant leurs propres pages de documentation. Merci de bien
+    vouloir mettre à jour vos liens.</p>
+
+    <p><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></p>
+    <p><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></p>
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/other.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/other.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 2012 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/directives.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/programs/other.xml.fr b/docs/manual/programs/other.xml.fr
new file mode 100644 (file)
index 0000000..07cac0a
--- /dev/null
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1332681 -->
+<!-- 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.
+-->
+
+<manualpage metafile="other.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+<title>Autres programmes</title>
+
+<summary>
+
+    <p>Cette page contenait la documentation de programmes qui poss&egrave;dent
+    maintenant leurs propres pages de documentation. Merci de bien
+    vouloir mettre &agrave; jour vos liens.</p>
+
+    <p><program>log_server_status</program></p>
+    <p><program>split-logfile</program></p>
+</summary>
+
+</manualpage>
index 8e637629acc9f79bd2af97249ea17797e4ff27fc..0dc5357c2f6526f196fb540a957c2ac23da4f1df 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant outdated="yes">tr</variant>
   </variants>
index 3879fb336772313c9b4575d63d5c969a0fc54078..d4c81baec7806867bb28facfa894159abd183e17 100644 (file)
@@ -4,6 +4,10 @@ URI: rotatelogs.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: rotatelogs.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: rotatelogs.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
diff --git a/docs/manual/programs/rotatelogs.html.fr b/docs/manual/programs/rotatelogs.html.fr
new file mode 100644 (file)
index 0000000..ad43be5
--- /dev/null
@@ -0,0 +1,291 @@
+<?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>rotatelogs - Rotation des journaux d'Apache par redirection de
+  ces derniers dans un "pipe" - 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 id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</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.4</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Rotation des journaux d'Apache par redirection de
+  ces derniers dans un "pipe"</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/rotatelogs.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
+</div>
+
+     <p><code>rotatelogs</code> est un programme simple à utiliser en
+     conjonction avec la fonctionnalité d'Apache de redirection dans un
+     "pipe" des fichiers journaux. Il supporte une rotation basée sur un
+     intervalle de temps ou une taille maximale du journal.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#portability">Portabilité</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="synopsis" id="synopsis">Syntaxe</a></h2>
+
+     <p><code><strong>rotatelogs</strong>
+     [ -<strong>l</strong> ]
+     [ -<strong>L</strong> <var>nom-lien</var> ]
+     [ -<strong>p</strong> <var>programme</var> ]
+     [ -<strong>f</strong> ]
+     [ -<strong>v</strong> ]
+     [ -<strong>e</strong> ]
+     [ -<strong>c</strong> ]
+     <var>fichier-journal</var>
+     <var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
+     [ <var>décalage</var> ]</code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+
+<dl>
+
+<dt><code>-l</code></dt>
+<dd>Utilise le temps local plutôt que GMT comme base pour l'intervalle
+de temps ou pour le formatage de <code>strftime(3)</code> avec une
+rotation basée sur la taille.</dd>
+
+<dt><code>-L</code> <var>nom-lien</var></dt>
+<dd>Etablit un lien physique entre le fichier journal courant et le lien
+spécifié. Cette option permet de consulter le journal de manière
+continue malgré les rotations via une commande du style <code>tail -F
+nom-lien</code>.</dd>
+
+<dt><code>-p</code> <var>programme</var></dt>
+<dd>Avec cette option, <code>rotatelogs</code> exécutera le programme
+<var>programme</var> chaque fois qu'un nouveau fichier journal sera
+ouvert. Le nom du fichier nouvellement ouvert est passé comme premier
+argument au programme. Si l'exécution se produit après une rotation,
+l'ancien nom du fichier journal est passé au programme comme second
+argument. <code>rotatelogs</code>
+n'attend pas la fin du <var>programme</var> pour continuer son
+exécution, et cessera tout enregistrement de codes d'erreur lorsqu'il
+aura terminé son processus. Le <var>programme</var> utilise les mêmes
+canaux stdin, stdout, et stderr que rotatelogs, et hérite de son
+environnement.</dd>
+
+<dt><code>-f</code></dt>
+<dd>Ouvre le fichier journal immédiatement, dès que
+<code>rotatelogs</code> démarre, au lieu d'attendre la lecture de la
+première entrée de journal (pour les sites peu chargés, il peut
+s'écouler un temps substantiel entre le démarrage du serveur et le
+traitement de la première requête, temps pendant lequel le fichier
+journal associé n'"existe" pas, ce qui peut causer des problèmes à
+certains utilitaires de journalisation automatiques).</dd>
+
+<dt><code>-t</code></dt>
+<dd>Provoque une troncature du fichier journal au lieu d'une rotation.
+Cela peut s'avérer utile lorsqu'un journal est élaboré en temps réel par
+une commande telle que tail, l'archivage des données n'étant ici pas
+nécessaire. Si aucun suffixe n'est ajouté au nom de fichier, les
+chaînes de format contenant des caractères '%' sont cependant
+respectées.
+</dd>
+
+<dt><code>-v</code></dt>
+<dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
+résultat de l'interprétation de la configuration, ainsi que toutes les
+opérations d'ouverture et de fermeture de fichiers.</dd>
+
+<dt><code>-c</code></dt>
+<dd>Crée un fichier journal pour chaque intervalle, même s'il est vide.</dd>
+
+<dt><code>-e</code></dt>
+<dd>Envoie les messages de journalisation vers stdout. Ceci s'avère
+utile lorsque les journaux doivent être traités par un autre programme.</dd>
+
+<dt><code><var>fichier-journal</var></code></dt>
+<dd><p>Le chemin et le nom de base du fichier journal. Si
+<var>fichier-journal</var> contient des caractères '%', il est considéré
+comme une chaîne de formatage pour <code>strftime(3)</code>. Dans le cas
+contraire, le suffixe <var>.nnnnnnnnnn</var> est automatiquement ajouté
+et correspond au temps en secondes (sauf si l'option -t est spécifiée).
+Les deux formats calculent le temps
+de démarrage depuis le début de la période courante. Par exemple, si un
+temps de rotation de 86400 est spécifié, les champs heure, minute et
+seconde créés à partir du format <code>strftime(3)</code> auront tous
+pour valeur 0, en référence au début de la période de 24 heures courante
+(minuit).</p>
+<p>Si vous utilisez le formatage de noms de fichiers
+<code>strftime(3)</code>, assurez-vous que le format du fichier journal
+possède une granularité suffisamment importante pour générer un nom de
+fichier différent à chaque rotation des journaux. Si ce n'est pas le
+cas, la rotation va écraser le fichier existant au lieu d'en générer un
+nouveau. Par exemple, si <var>fichier-journal</var> était
+<code>/var/logs/errorlog.%Y-%m-%d</code> avec une rotation à 5
+mégaoctets, et si la limite de 5 mégaoctets a été atteinte deux fois
+dans la même journée, le même nom de fichier va être généré, et la
+rotation va écraser le fichier existant.</p>
+</dd>
+
+<dt><code><var>temps-rotation</var></code></dt>
+
+<dd>Le temps entre deux rotations des fichiers journaux en secondes. La
+rotation intervient au début de cet intervalle. Par exemple, si le temps
+de rotation est de 3600, la rotation des fichiers journaux s'effectuera
+au début de chaque heure ; si le temps de rotation est de 86400, la
+rotation des fichiers journaux s'effectuera chaque nuit à minuit. (Si
+aucune donnée n'est enregistrée au cours d'un intervalle, aucun fichier
+ne sera créé).</dd>
+
+<dt><code><var>taille-fichier</var>(B|K|M|G)</code></dt>
+
+<dd>La taille maximale du fichier suivie par une des lettres
+<code>B</code> (Octets), <code>K</code> (KOctets), <code>M</code> (MOctets)
+ou <code>G</code> (GOctets).
+<p>
+Lorsque temps et taille sont spécifiés, la taille doit l'être après le
+temps. La rotation interviendra alors aussitôt que l'une des deux limites
+(temps ou taille) sera atteinte.
+</p>
+</dd>
+
+<dt><code><var>décalage</var></code></dt>
+
+<dd>Le décalage en minutes par rapport au temps UTC. Par défaut, le
+décalage est considéré comme nul et c'est le temps UTC qui est utilisé.
+Par exemple, pour utiliser le temps local de la zone UTC -5 heures,
+spécifiez une valeur de <code>-300</code> pour cette option. Dans la
+plupart des cas, il vaut mieux utiliser l'option <code>-l</code> que
+spécifier un décalage.</dd>
+
+</dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="examples" id="examples">Exemples</a></h2>
+
+<div class="example"><p><code>
+     CustomLog "|bin/rotatelogs /var/logs/fichier-journal 86400" common
+</code></p></div>
+
+     <p>Cette directive crée les fichiers /var/logs/fichier-journal.nnnn
+     où nnnn correspond au temps système auquel la journalisation
+     démarre effectivement (ce temps sera toujours un multiple du temps
+     de rotation, si bien que vous pouvez synchroniser les scripts cron
+     avec lui). A la fin de chaque temps de rotation (ici après 24
+     heures), une nouvelle journalisation démarre.</p>
+
+<div class="example"><p><code>
+     CustomLog "|bin/rotatelogs -l /var/logs/fichier-journal.%Y.%m.%d 86400" common
+</code></p></div>
+
+     <p>Cette directive crée les fichiers
+     /var/logs/fichier-journal.yyyy.mm.dd où yyyy correspond à l'année,
+     mm au mois et dd au jour du mois. La journalisation basculera vers
+     un nouveau fichier chaque jour à minuit, temps local.</p>
+
+<div class="example"><p><code>
+     CustomLog "|bin/rotatelogs /var/logs/fichier-journal 5M" common
+</code></p></div>
+
+     <p>Cette directive va effectuer une rotation du fichier journal
+     chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
+
+<div class="example"><p><code>
+     ErrorLog "|bin/rotatelogs /var/logs/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"
+</code></p></div>
+     <p>Cette directive va effectuer une rotation du fichier journal des
+     erreurs chaque fois que la taille de ce dernier atteindra 5
+     MOctets, et le nom du fichier journal se présentera sous
+     la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
+
+<div class="example"><p><code>
+     CustomLog "|bin/rotatelogs -t /var/logs/journal 86400" common
+</code></p></div>
+
+     <p>Cet exemple crée le fichier /var/logs/journal en le tronquant
+     au démarrage, puis une fois par jour. Ce scénario implique qu'un
+     processus séparé (tel que tail) traite le fichier en temps
+     réel.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="portability" id="portability">Portabilité</a></h2>
+
+<p>Les substitutions des chaînes de format du fichier journal suivantes
+doivent être supportées par toutes les implémentations de
+<code>strftime(3)</code> ; voir la page de manuel de
+<code>strftime(3)</code> pour les extensions spécifiques à une
+bibliothèque.</p>
+
+<table class="bordered"><tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
+(localisé)</td></tr>
+<tr class="odd"><td><code>%a</code></td><td>nom du jour de la semaine sur 3
+caractères (localisé)</td></tr>
+<tr><td><code>%B</code></td><td>nom du mois en entier (localisé)</td></tr>
+<tr class="odd"><td><code>%b</code></td><td>nom du mois sur 3 caractères (localisé)</td></tr>
+<tr><td><code>%c</code></td><td>date et heure (localisé)</td></tr>
+<tr class="odd"><td><code>%d</code></td><td>jour du mois sur 2 chiffres</td></tr>
+<tr><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 à 24h)</td></tr>
+<tr class="odd"><td><code>%I</code></td><td>heure sur 2 chiffres (de 0 à 12h)</td></tr>
+<tr><td><code>%j</code></td><td>jour de l'année sur 3 chiffres</td></tr>
+<tr class="odd"><td><code>%M</code></td><td>minutes sur 2 chiffres</td></tr>
+<tr><td><code>%m</code></td><td>mois sur 2 chiffres</td></tr>
+<tr class="odd"><td><code>%p</code></td><td>suffixe am/pm pour l'heure de 0 à 12h
+(localisé)</td></tr>
+<tr><td><code>%S</code></td><td>secondes sur 2 chiffres</td></tr>
+<tr class="odd"><td><code>%U</code></td><td>semaine de l'année sur 2 chiffres
+(Dimanche est le premier jour de la semaine)</td></tr>
+<tr><td><code>%W</code></td><td> semaine de l'année sur 2 chiffres
+(Lundi est le premier jour de la semaine)</td></tr>
+<tr class="odd"><td><code>%w</code></td><td>jour de la semaine sur 1 chiffre
+(Dimanche est le premier jour de la semaine)</td></tr>
+<tr><td><code>%X</code></td><td>heure (localisée)</td></tr>
+<tr class="odd"><td><code>%x</code></td><td>date (localisée)</td></tr>
+<tr><td><code>%Y</code></td><td>année sur 4 chiffres</td></tr>
+<tr class="odd"><td><code>%y</code></td><td>année sur 2 chiffres</td></tr>
+<tr><td><code>%Z</code></td><td>nom de la zone de temps</td></tr>
+<tr class="odd"><td><code>%%</code></td><td>caractère littéral `%'</td></tr>
+</table>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/programs/rotatelogs.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&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/2.4/programs/rotatelogs.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 2012 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/directives.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/programs/rotatelogs.xml.fr b/docs/manual/programs/rotatelogs.xml.fr
new file mode 100644 (file)
index 0000000..29cda9f
--- /dev/null
@@ -0,0 +1,257 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1189220 -->
+<!-- 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.
+-->
+
+<manualpage metafile="rotatelogs.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+  <title>rotatelogs - Rotation des journaux d'Apache par redirection de
+  ces derniers dans un "pipe"</title>
+
+<summary>
+     <p><code>rotatelogs</code> est un programme simple &agrave; utiliser en
+     conjonction avec la fonctionnalit&eacute; d'Apache de redirection dans un
+     "pipe" des fichiers journaux. Il supporte une rotation bas&eacute;e sur un
+     intervalle de temps ou une taille maximale du journal.</p>
+</summary>
+
+<section id="synopsis"><title>Syntaxe</title>
+
+     <p><code><strong>rotatelogs</strong>
+     [ -<strong>l</strong> ]
+     [ -<strong>L</strong> <var>nom-lien</var> ]
+     [ -<strong>p</strong> <var>programme</var> ]
+     [ -<strong>f</strong> ]
+     [ -<strong>v</strong> ]
+     [ -<strong>e</strong> ]
+     [ -<strong>c</strong> ]
+     <var>fichier-journal</var>
+     <var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
+     [ <var>d&eacute;calage</var> ]</code></p>
+</section>
+
+<section id="options"><title>Options</title>
+
+<dl>
+
+<dt><code>-l</code></dt>
+<dd>Utilise le temps local plut&ocirc;t que GMT comme base pour l'intervalle
+de temps ou pour le formatage de <code>strftime(3)</code> avec une
+rotation bas&eacute;e sur la taille.</dd>
+
+<dt><code>-L</code> <var>nom-lien</var></dt>
+<dd>Etablit un lien physique entre le fichier journal courant et le lien
+sp&eacute;cifi&eacute;. Cette option permet de consulter le journal de mani&egrave;re
+continue malgr&eacute; les rotations via une commande du style <code>tail -F
+nom-lien</code>.</dd>
+
+<dt><code>-p</code> <var>programme</var></dt>
+<dd>Avec cette option, <code>rotatelogs</code> ex&eacute;cutera le programme
+<var>programme</var> chaque fois qu'un nouveau fichier journal sera
+ouvert. Le nom du fichier nouvellement ouvert est pass&eacute; comme premier
+argument au programme. Si l'ex&eacute;cution se produit apr&egrave;s une rotation,
+l'ancien nom du fichier journal est pass&eacute; au programme comme second
+argument. <code>rotatelogs</code>
+n'attend pas la fin du <var>programme</var> pour continuer son
+ex&eacute;cution, et cessera tout enregistrement de codes d'erreur lorsqu'il
+aura termin&eacute; son processus. Le <var>programme</var> utilise les m&ecirc;mes
+canaux stdin, stdout, et stderr que rotatelogs, et h&eacute;rite de son
+environnement.</dd>
+
+<dt><code>-f</code></dt>
+<dd>Ouvre le fichier journal imm&eacute;diatement, d&egrave;s que
+<code>rotatelogs</code> d&eacute;marre, au lieu d'attendre la lecture de la
+premi&egrave;re entr&eacute;e de journal (pour les sites peu charg&eacute;s, il peut
+s'&eacute;couler un temps substantiel entre le d&eacute;marrage du serveur et le
+traitement de la premi&egrave;re requ&ecirc;te, temps pendant lequel le fichier
+journal associ&eacute; n'"existe" pas, ce qui peut causer des probl&egrave;mes &agrave;
+certains utilitaires de journalisation automatiques).</dd>
+
+<dt><code>-t</code></dt>
+<dd>Provoque une troncature du fichier journal au lieu d'une rotation.
+Cela peut s'av&eacute;rer utile lorsqu'un journal est &eacute;labor&eacute; en temps r&eacute;el par
+une commande telle que tail, l'archivage des donn&eacute;es n'&eacute;tant ici pas
+n&eacute;cessaire. Si aucun suffixe n'est ajout&eacute; au nom de fichier, les
+cha&icirc;nes de format contenant des caract&egrave;res '%' sont cependant
+respect&eacute;es.
+</dd>
+
+<dt><code>-v</code></dt>
+<dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
+r&eacute;sultat de l'interpr&eacute;tation de la configuration, ainsi que toutes les
+op&eacute;rations d'ouverture et de fermeture de fichiers.</dd>
+
+<dt><code>-c</code></dt>
+<dd>Cr&eacute;e un fichier journal pour chaque intervalle, m&ecirc;me s'il est vide.</dd>
+
+<dt><code>-e</code></dt>
+<dd>Envoie les messages de journalisation vers stdout. Ceci s'av&egrave;re
+utile lorsque les journaux doivent &ecirc;tre trait&eacute;s par un autre programme.</dd>
+
+<dt><code><var>fichier-journal</var></code></dt>
+<dd><p>Le chemin et le nom de base du fichier journal. Si
+<var>fichier-journal</var> contient des caract&egrave;res '%', il est consid&eacute;r&eacute;
+comme une cha&icirc;ne de formatage pour <code>strftime(3)</code>. Dans le cas
+contraire, le suffixe <var>.nnnnnnnnnn</var> est automatiquement ajout&eacute;
+et correspond au temps en secondes (sauf si l'option -t est sp&eacute;cifi&eacute;e).
+Les deux formats calculent le temps
+de d&eacute;marrage depuis le d&eacute;but de la p&eacute;riode courante. Par exemple, si un
+temps de rotation de 86400 est sp&eacute;cifi&eacute;, les champs heure, minute et
+seconde cr&eacute;&eacute;s &agrave; partir du format <code>strftime(3)</code> auront tous
+pour valeur 0, en r&eacute;f&eacute;rence au d&eacute;but de la p&eacute;riode de 24 heures courante
+(minuit).</p>
+<p>Si vous utilisez le formatage de noms de fichiers
+<code>strftime(3)</code>, assurez-vous que le format du fichier journal
+poss&egrave;de une granularit&eacute; suffisamment importante pour g&eacute;n&eacute;rer un nom de
+fichier diff&eacute;rent &agrave; chaque rotation des journaux. Si ce n'est pas le
+cas, la rotation va &eacute;craser le fichier existant au lieu d'en g&eacute;n&eacute;rer un
+nouveau. Par exemple, si <var>fichier-journal</var> &eacute;tait
+<code>/var/logs/errorlog.%Y-%m-%d</code> avec une rotation &agrave; 5
+m&eacute;gaoctets, et si la limite de 5 m&eacute;gaoctets a &eacute;t&eacute; atteinte deux fois
+dans la m&ecirc;me journ&eacute;e, le m&ecirc;me nom de fichier va &ecirc;tre g&eacute;n&eacute;r&eacute;, et la
+rotation va &eacute;craser le fichier existant.</p>
+</dd>
+
+<dt><code><var>temps-rotation</var></code></dt>
+
+<dd>Le temps entre deux rotations des fichiers journaux en secondes. La
+rotation intervient au d&eacute;but de cet intervalle. Par exemple, si le temps
+de rotation est de 3600, la rotation des fichiers journaux s'effectuera
+au d&eacute;but de chaque heure ; si le temps de rotation est de 86400, la
+rotation des fichiers journaux s'effectuera chaque nuit &agrave; minuit. (Si
+aucune donn&eacute;e n'est enregistr&eacute;e au cours d'un intervalle, aucun fichier
+ne sera cr&eacute;&eacute;).</dd>
+
+<dt><code><var>taille-fichier</var>(B|K|M|G)</code></dt>
+
+<dd>La taille maximale du fichier suivie par une des lettres
+<code>B</code> (Octets), <code>K</code> (KOctets), <code>M</code> (MOctets)
+ou <code>G</code> (GOctets).
+<p>
+Lorsque temps et taille sont sp&eacute;cifi&eacute;s, la taille doit l'&ecirc;tre apr&egrave;s le
+temps. La rotation interviendra alors aussit&ocirc;t que l'une des deux limites
+(temps ou taille) sera atteinte.
+</p>
+</dd>
+
+<dt><code><var>d&eacute;calage</var></code></dt>
+
+<dd>Le d&eacute;calage en minutes par rapport au temps UTC. Par d&eacute;faut, le
+d&eacute;calage est consid&eacute;r&eacute; comme nul et c'est le temps UTC qui est utilis&eacute;.
+Par exemple, pour utiliser le temps local de la zone UTC -5 heures,
+sp&eacute;cifiez une valeur de <code>-300</code> pour cette option. Dans la
+plupart des cas, il vaut mieux utiliser l'option <code>-l</code> que
+sp&eacute;cifier un d&eacute;calage.</dd>
+
+</dl>
+</section>
+
+<section id="examples"><title>Exemples</title>
+
+<example>
+     CustomLog "|bin/rotatelogs /var/logs/fichier-journal 86400" common
+</example>
+
+     <p>Cette directive cr&eacute;e les fichiers /var/logs/fichier-journal.nnnn
+     o&ugrave; nnnn correspond au temps syst&egrave;me auquel la journalisation
+     d&eacute;marre effectivement (ce temps sera toujours un multiple du temps
+     de rotation, si bien que vous pouvez synchroniser les scripts cron
+     avec lui). A la fin de chaque temps de rotation (ici apr&egrave;s 24
+     heures), une nouvelle journalisation d&eacute;marre.</p>
+
+<example>
+     CustomLog "|bin/rotatelogs -l /var/logs/fichier-journal.%Y.%m.%d 86400" common
+</example>
+
+     <p>Cette directive cr&eacute;e les fichiers
+     /var/logs/fichier-journal.yyyy.mm.dd o&ugrave; yyyy correspond &agrave; l'ann&eacute;e,
+     mm au mois et dd au jour du mois. La journalisation basculera vers
+     un nouveau fichier chaque jour &agrave; minuit, temps local.</p>
+
+<example>
+     CustomLog "|bin/rotatelogs /var/logs/fichier-journal 5M" common
+</example>
+
+     <p>Cette directive va effectuer une rotation du fichier journal
+     chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
+
+<example>
+     ErrorLog "|bin/rotatelogs /var/logs/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"
+</example>
+     <p>Cette directive va effectuer une rotation du fichier journal des
+     erreurs chaque fois que la taille de ce dernier atteindra 5
+     MOctets, et le nom du fichier journal se pr&eacute;sentera sous
+     la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
+
+<example>
+     CustomLog "|bin/rotatelogs -t /var/logs/journal 86400" common
+</example>
+
+     <p>Cet exemple cr&eacute;e le fichier /var/logs/journal en le tronquant
+     au d&eacute;marrage, puis une fois par jour. Ce sc&eacute;nario implique qu'un
+     processus s&eacute;par&eacute; (tel que tail) traite le fichier en temps
+     r&eacute;el.</p>
+
+</section>
+
+<section id="portability"><title>Portabilit&eacute;</title>
+
+<p>Les substitutions des cha&icirc;nes de format du fichier journal suivantes
+doivent &ecirc;tre support&eacute;es par toutes les impl&eacute;mentations de
+<code>strftime(3)</code> ; voir la page de manuel de
+<code>strftime(3)</code> pour les extensions sp&eacute;cifiques &agrave; une
+biblioth&egrave;que.</p>
+
+<table border="1" style="zebra">
+<tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
+(localis&eacute;)</td></tr>
+<tr><td><code>%a</code></td><td>nom du jour de la semaine sur 3
+caract&egrave;res (localis&eacute;)</td></tr>
+<tr><td><code>%B</code></td><td>nom du mois en entier (localis&eacute;)</td></tr>
+<tr><td><code>%b</code></td><td>nom du mois sur 3 caract&egrave;res (localis&eacute;)</td></tr>
+<tr><td><code>%c</code></td><td>date et heure (localis&eacute;)</td></tr>
+<tr><td><code>%d</code></td><td>jour du mois sur 2 chiffres</td></tr>
+<tr><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 &agrave; 24h)</td></tr>
+<tr><td><code>%I</code></td><td>heure sur 2 chiffres (de 0 &agrave; 12h)</td></tr>
+<tr><td><code>%j</code></td><td>jour de l'ann&eacute;e sur 3 chiffres</td></tr>
+<tr><td><code>%M</code></td><td>minutes sur 2 chiffres</td></tr>
+<tr><td><code>%m</code></td><td>mois sur 2 chiffres</td></tr>
+<tr><td><code>%p</code></td><td>suffixe am/pm pour l'heure de 0 &agrave; 12h
+(localis&eacute;)</td></tr>
+<tr><td><code>%S</code></td><td>secondes sur 2 chiffres</td></tr>
+<tr><td><code>%U</code></td><td>semaine de l'ann&eacute;e sur 2 chiffres
+(Dimanche est le premier jour de la semaine)</td></tr>
+<tr><td><code>%W</code></td><td> semaine de l'ann&eacute;e sur 2 chiffres
+(Lundi est le premier jour de la semaine)</td></tr>
+<tr><td><code>%w</code></td><td>jour de la semaine sur 1 chiffre
+(Dimanche est le premier jour de la semaine)</td></tr>
+<tr><td><code>%X</code></td><td>heure (localis&eacute;e)</td></tr>
+<tr><td><code>%x</code></td><td>date (localis&eacute;e)</td></tr>
+<tr><td><code>%Y</code></td><td>ann&eacute;e sur 4 chiffres</td></tr>
+<tr><td><code>%y</code></td><td>ann&eacute;e sur 2 chiffres</td></tr>
+<tr><td><code>%Z</code></td><td>nom de la zone de temps</td></tr>
+<tr><td><code>%%</code></td><td>caract&egrave;re litt&eacute;ral `%'</td></tr>
+</table>
+
+</section>
+</manualpage>
index dcc2687bb85d7bad76523fb2cf780a3de75d14e0..48448a255571713d44ad8bcddf53eb43f209e946 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant>tr</variant>
   </variants>