You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2018/07/12 13:50:30 UTC
svn commit: r1835738 [3/5] - in /httpd/httpd/trunk/docs/manual: mod/
platform/ programs/ rewrite/
Added: httpd/httpd/trunk/docs/manual/programs/configure.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/configure.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/configure.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/configure.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,777 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision: 1750567 -->
+<!-- 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="configure.xml.meta">
+<parentdocument href="./">Programmes</parentdocument>
+
+ <title>configure - Configure l'arborescence des sources</title>
+
+<summary>
+ <p>Le script <code>configure</code> permet de configurer
+ l'arborescence des sources afin de compiler et installer le serveur
+ HTTP Apache sur votre plate-forme spécifique. De nombreuses options
+ vous permettent de compiler un serveur correspondant à vos propres
+ besoins.</p>
+
+ <p>Ce script, situé dans le répertoire racine de la distribution des
+ sources, ne concerne que la compilation sur les systèmes Unix et
+ apparentés. Pour les autres plates-formes, voir la <a
+ href="../platform/">documentation spécifique</a> de ces
+ dernières.</p>
+</summary>
+
+<seealso><a href="../install.html">Compilation et installation</a></seealso>
+
+<section id="synopsis"><title>Résumé</title>
+ <p>Vous devez appeler le script <code>configure</code> depuis le
+ répertoire racine de la distribution.</p>
+
+ <p><code><strong>./configure</strong> [<var>OPTION</var>]...
+ [<var>VARIABLE</var>=<var>VALEUR</var>]...</code></p>
+
+ <p>Pour définir des variables d'environnement (par exemple
+ <code>CC</code>,<code>CFLAGS</code>, etc...), utilisez la clause
+ <code><var>VARIABLE</var>=<var>VALEUR</var></code>. Voir <a
+ href="#env">ci-dessous</a> pour la description de quelques variables
+ usuelles.</p>
+</section>
+
+<section id="options"><title>Options</title>
+ <ul>
+ <li><a href="#configurationoptions">Options de Configuration</a></li>
+ <li><a href="#installationdirectories">Répertoires d'installation</a></li>
+ <li><a href="#systemtypes">Types de Systèmes</a></li>
+ <li><a href="#optionalfeatures">Fonctionnalités optionnelles</a></li>
+ <li><a href="#supportopt">Options pour les programmes support</a></li>
+ </ul>
+
+ <section id="configurationoptions"><title>Options de Configuration</title>
+
+ <p>Les options suivantes affectent le comportement du script
+ <code>configure</code>.</p>
+
+ <dl>
+ <dt><code>-C</code></dt>
+ <dt><code>--config-cache</code></dt>
+ <dd>C'est un alias pour <code>--cache-file=config.cache</code></dd>
+
+ <dt><code>--cache-file=<var>FICHIER</var></code></dt>
+ <dd>Les résultats des tests seront mis en cache dans le fichier
+ <var>FICHIER</var>. Cette option est désactivée par défaut.</dd>
+
+ <dt><code>-h</code></dt>
+ <dt><code>--help [short|recursive]</code></dt>
+ <dd>Affichage de l'aide et sortie du script. Avec l'argument
+ <code>short</code>, seules les options spécifiques à ce paquet
+ seront affichées. L'argument <code>recursive</code> permet
+ d'afficher l'aide de tous les paquets inclus.</dd>
+
+ <dt><code>-n</code></dt>
+ <dt><code>--no-create</code></dt>
+ <dd>Le script <code>configure</code> s'exécute normalement, mais
+ ne crée pas les fichiers résultants. Ceci permet de vérifier les
+ résultats des tests avant de générer les fichiers makefile pour la
+ compilation.</dd>
+
+ <dt><code>-q</code></dt>
+ <dt><code>--quiet</code></dt>
+ <dd>Les messages <code>checking ...</code> ne sont pas affichés au
+ cours du processus de configuration.</dd>
+
+ <dt><code>--srcdir=<var>DIR</var></code></dt>
+ <dd>Définit le répertoire <var>DIR</var> comme répertoire des
+ fichiers sources. Par défaut, c'est le répertoire où se situe le
+ script <code>configure</code>, ou le répertoire parent.</dd>
+
+ <dt><code>--silent</code></dt>
+ <dd>Identique à <code>--quiet</code></dd>
+
+ <dt>-V</dt>
+ <dt>--version</dt>
+ <dd>Affichage des informations de copyright et sortie du
+ script.</dd>
+ </dl>
+ </section>
+
+ <section id="installationdirectories"><title>Répertoires
+ d'installation</title>
+
+ <p>Ces options permettent de spécifier le répertoire d'installation.
+ L'arborescence de l'installation dépend de l'organisation (layout)
+ sélectionnée.</p>
+
+ <dl>
+ <dt><code>--prefix=<var>PREFIX</var></code></dt>
+ <dd>Installe les fichiers indépendants de l'architecture dans
+ <var>PREFIX</var>. Par défaut, le répertoire d'installation est
+ <code>/usr/local/apache2</code>.</dd>
+
+ <dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
+ <dd>Installe les fichiers dépendants de l'architecture dans
+ <var>EPREFIX</var>. La valeur par défaut de cette option
+ correspond à la valeur de la variable
+ <var>PREFIX</var>.</dd>
+ </dl>
+
+ <p>Par défaut, <code>make install</code> va installer tous les
+ fichiers dans <code>/usr/local/apache2/bin</code>,
+ <code>/usr/local/apache2/lib</code>, etc... Vous pouvez cependant
+ spécifier un préfixe d'installation autre que
+ <code>/usr/local/apache2</code> en utilisant l'option
+ <code>--prefix</code> (par exemple <code>--prefix=$HOME</code>).</p>
+
+ <section id="layout"><title>Spécifier une organisation (layout) des
+ répertoires</title>
+ <dl>
+ <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
+ <dd>Configure le code source et les scripts de compilation de
+ façon à ce que l'arborescence d'installation adopte
+ l'organisation <var>LAYOUT</var>. Ceci vous permet de spécifier
+ des chemins séparés pour chaque type de fichier de
+ l'installation du serveur HTTP Apache. Le fichier
+ <code>config.layout</code> contient de nombreux exemples de
+ configurations, et vous pouvez créer vos propres configurations
+ personnalisées en vous basant sur ces exemples. Les différentes
+ organisations contenues dans ce fichier sont enregistrées sous
+ forme de sections <code><Layout
+ FOO>...</Layout></code> et référencées dans ce cas par
+ le nom <code>FOO</code>. L'organisation par défaut
+ est <code>Apache</code>.</dd>
+ </dl>
+ </section>
+
+ <section id="directoryfinetuning"><title>Configuration avancée des
+ répertoires d'installation</title>
+
+ <p>Pour une définition plus précise des répertoires
+ d'installation, utilisez les options ci-dessous. Notez que les
+ répertoires par défaut sont définis par <code>autoconf</code>, et
+ que leurs valeurs sont écrasées par les valeurs correspondantes
+ définies lors du choix de l'organisation des répertoires
+ (layout).</p>
+
+ <dl>
+ <dt><code>--bindir=<var>DIR</var></code></dt>
+ <dd>Installe les exécutables utilisateur dans <var>DIR</var>.
+ Les exécutables utilisateur sont des programmes support comme
+ <program>htpasswd</program>, <program>dbmmanage</program>,
+ etc..., et destinés aux administrateurs du site. Par défaut,
+ <var>DIR</var> est défini à
+ <code><var>EPREFIX</var>/bin</code>.</dd>
+
+ <dt><code>--datadir=<var>DIR</var></code></dt>
+ <dd>Installe les données non modifiables indépendantes de
+ l'architecture dans <var>DIR</var>. Par défaut,
+ <code>datadir</code> est défini à
+ <code><var>PREFIX</var>/share</code>. Cette option est fournie
+ par autoconf et actuellement inutilisée.</dd>
+
+ <dt><code>--includedir=<var>DIR</var></code></dt>
+ <dd>Installe les fichiers d'en-têtes C dans <var>DIR</var>. Par
+ défaut, <code>includedir</code> est défini à
+ <code><var>EPREFIX</var>/include</code>.</dd>
+
+ <dt><code>--infodir=<var>DIR</var></code></dt>
+ <dd>Installe la documentation info dans <var>DIR</var>. Par
+ défaut, <code>infodir</code> est défini à
+ <code><var>PREFIX</var>/info</code>. Cette option est
+ actuellement inutilisée.</dd>
+
+ <dt><code>--libdir=<var>DIR</var></code></dt>
+ <dd>Installe les fichiers objet des bibliothèques dans
+ <var>DIR</var>. Par défaut, <code>libdir</code> est défini à
+ <code><var>EPREFIX</var>/lib</code>.</dd>
+
+ <dt><code>--libexecdir=<var>DIR</var></code></dt>
+ <dd>Installe les exécutables du programme (autrement dit les
+ modules partagés) dans <var>DIR</var>. Par défaut,
+ <code>libexecdir</code> est défini à
+ <code><var>EPREFIX</var>/modules</code>.</dd>
+
+ <dt><code>--localstatedir=<var>DIR</var></code></dt>
+ <dd>Installe les données temporaires modifiables spécifiques à
+ la machine dans
+ <var>DIR</var>. Par défaut, <code>localstatedir</code> est
+ défini à <code><var>PREFIX</var>/var</code>. Cette option est
+ fournie par <code>autoconf</code> et est actuellement
+ inutilisée.</dd>
+
+ <dt><code>--mandir=<var>DIR</var></code></dt>
+ <dd>Installe les pages de manuel dans <var>DIR</var>. Par
+ défaut, <code>mandir</code> est défini à
+ <code><var>EPREFIX</var>/man</code>.</dd>
+
+ <dt><code>--oldincludedir=<var>DIR</var></code></dt>
+ <dd>Installe les fichiers d'en-têtes C pour les programmes
+ autres que gcc dans <var>DIR</var>. Par défaut,
+ <code>oldincludedir</code> est défini à
+ <code>/usr/include</code>. Cette option est fournie par
+ <code>autoconf</code> et est actuellement inutilisée.</dd>
+
+ <dt><code>--sbindir=<var>DIR</var></code></dt>
+ <dd>Installe les exécutables de l'administrateur système dans
+ <var>DIR</var>. Ce sont les programmes du serveur comme
+ <program>httpd</program>, <program>apachectl</program>,
+ <program>suexec</program>, etc..., qui sont nécessaires à
+ l'exécution du serveur HTTP Apache. Par défaut,
+ <code>sbindir</code> est défini à
+ <code><var>EPREFIX</var>/sbin</code>.</dd>
+
+ <dt><code>--sharedstatedir=<var>DIR</var></code></dt>
+ <dd>Installe les données modifiables indépendantes de
+ l'architecture dans <var>DIR</var>. Par défaut,
+ <code>sharedstatedir</code> est défini à
+ <code><var>PREFIX</var>/com</code>. Cette option est fournie par
+ <code>autoconf</code> et est actuellement inutilisée.</dd>
+
+ <dt><code>--sysconfdir=<var>DIR</var></code></dt>
+ <dd>Installe les données non modifiables spécifiques à la
+ machine comme les fichiers de configuration du serveur
+ <code>httpd.conf</code>, <code>mime.types</code>, etc... dans
+ <var>DIR</var>. Par défaut, <code>sysconfdir</code> est défini à
+ <code><var>PREFIX</var>/conf</code>.</dd>
+ </dl>
+ </section>
+ </section>
+
+ <section id="systemtypes"><title>Types de systèmes</title>
+
+ <p>Ces options sont utilisées pour la cross-compilation du serveur
+ HTTP Apache afin de pouvoir l'utiliser sur un autre système. Dans le
+ cas général où la compilation et l'exécution du serveur ont lieu sur
+ le même système, ces options ne sont pas utilisées.</p>
+
+ <dl>
+ <dt><code>--build=<var>BUILD</var></code></dt>
+ <dd>Définit le type du système sur lequel les outils sont
+ compilés. Par défaut, il s'agit de la chaîne renvoyée par le
+ script <code>config.guess</code>.</dd>
+
+ <dt><code>--host=<var>HOST</var></code></dt>
+ <dd>Définit le type du système sur lequel le serveur s'exécutera.
+ Par défaut, <var>HOST</var> est identique à <var>BUILD</var>.</dd>
+
+ <dt><code>--target=<var>TARGET</var></code></dt>
+ <dd>Configure pour construire des compilateurs pour le type de
+ système <var>TARGET</var>. Par défaut, <var>TARGET</var> est
+ identique à <var>HOST</var>. Cette option est fournie par
+ <code>autoconf</code> et n'est pas requise par le serveur HTTP
+ Apache.</dd>
+ </dl>
+ </section>
+
+ <section id="optionalfeatures"><title>Fonctionnalités
+ optionnelles</title>
+
+ <p>Ces options vous permettent de configurer avec précision les
+ fonctionnalités de votre futur serveur HTTP.</p>
+
+ <section id="generaloptfeat"><title>Syntaxe générale</title>
+ <p>D'une manière générale, vous pouvez utiliser la syntaxe
+ suivante pour activer ou désactiver une fonctionnalité :</p>
+
+ <dl>
+ <dt><code>--disable-<var>FONCTIONNALITE</var></code></dt>
+ <dd>Désactive la fonctionnalité <var>FONCTIONNALITE</var>.
+ Identique à
+ <code>--enable-<var>FONCTIONNALITE</var>=no</code>.</dd>
+
+ <dt><code>--enable-<var>FONCTIONNALITE</var>[=<var>ARG</var>]</code></dt>
+ <dd>Active la fonctionnalité <var>FONCTIONNALITE</var>. La
+ valeur par défaut de <var>ARG</var> est <code>yes</code>.</dd>
+
+ <dt><code>--enable-<var>MODULE</var>=shared</code></dt>
+ <dd>Le module spécifié sera compilé en tant que module DSO. Par
+ défaut, les modules activés sont liés dynamiquement.</dd>
+
+ <dt><code>--enable-<var>MODULE</var>=static</code></dt>
+ <dd>Le module correspondant sera lié statiquement.</dd>
+ </dl>
+
+ <note><title>Note</title>
+ Si vous spécifiez <code>--enable-<var>foo</var></code>, et si
+ <var>foo</var> n'existe pas, <code>configure</code> ne le
+ signalera pas ; vous devez donc prendre soin de taper les
+ options correctement.
+ </note>
+ </section>
+
+ <section id="choosemodules"><title>Choix des modules à compiler</title>
+ <p>La plupart des modules sont compilés par défaut et ils doivent être
+ désactivés de manière explicite ou via le mots-clé <code>few</code> (voir
+ ci-dessous <code>--enable-modules</code>,
+ <code>--enable-mods-shared</code> et <code>--enable-mods-static</code>
+ pour une explication plus détaillée), ou
+ <code>--enable-modules=none</code> pour les désactiver tous.</p>
+
+ <p>Par défaut, les autres modules ne sont pas compilés et doivent
+ être activés explicitement, ou en utilisant les mots-clés
+ <code>all</code> ou <code>reallyall</code> pour être disponibles.</p>
+
+ <p>Pour déterminer quels modules sont compilés par défaut,
+ exécutez la commande <code>./configure -h</code> ou
+ <code>./configure --help</code>, et consultez les <code>Optional
+ Features</code>. Par exemple, supposons que vous soyez intéressé
+ par les modules <code>mod_example1</code> et
+ <code>mod_example2</code>, et que vous voyiez ceci :</p>
+
+ <example><pre>Optional Features:
+ ...
+ --disable-example1 example module 1
+ --enable-example2 example module 2
+ ...</pre></example>
+
+ <p>Le module <code>mod_example1</code> est ici activé par
+ défaut, et vous devez spécifier <code>--disable-example1</code>
+ si vous ne voulez pas le compiler. Par contre, le module
+ <code>mod_example2</code> est désactivé par défaut, et vous
+ devez spécifier <code>--enable-example2</code> si vous voulez le
+ compiler.</p>
+
+ </section>
+
+ <section id="mpms"><title>Modules Multi-Processus</title>
+ <p>Les <a href="../mpm.html">Modules Multi-Processus</a>, ou MPMs,
+ constituent le coeur du serveur. Un seul MPM doit être actif pour
+ que le serveur puisse fonctionner. Vous trouverez la liste des
+ MPMs disponibles à <a href="../mod/">module index page</a>.</p>
+
+ <p>Les MPMs peuvent être compilés en tant que modules DSO pour un
+ chargement dynamique, ou liés statiquement avec le serveur, et
+ sont activés via les options suivantes :</p>
+
+ <dl>
+ <dt><code>--with-mpm=MPM</code></dt>
+ <dd>
+ <p>Sélectionne le MPM par défaut pour votre serveur. Si les
+ MPMs sont compilés en tant que modules DSO (voir
+ <code>--enable-mpms-shared</code>), cette option spécifie le
+ MPM qui sera chargé par défaut selon le fichier de
+ configuration. Dans le cas contraire, cette option spécifie le
+ seul MPM disponible qui sera lié statiquement avec le
+ serveur.</p>
+ <p>Si cette option est omise, c'est le <a
+ href="../mpm.html#defaults">MPM par défaut</a> pour votre
+ système d'exploitation qui sera utilisé.</p>
+ </dd>
+
+ <dt><code>--enable-mpms-shared=<var>Liste de MPM</var></code></dt>
+ <dd>
+ <p>Définit une liste de MPMs à compiler en tant que modules
+ dynamiquement partagés (DSO). Un de ces modules doit être
+ chargé dynamiquement via la directive <directive
+ module="mod_so">LoadModule</directive>.</p>
+ <p><var>Liste de MPM</var> est une liste, entourée
+ d'apostrophes, de noms de MPM séparés par des espaces. Par
+ exemple :</p>
+ <example>
+ --enable-mpms-shared='prefork worker'
+ </example>
+ <p>Vous pouvez aussi utiliser le mot-clé <code>all</code>, ce
+ qui aura pour effet de spécifier tous les MPMs qui supportent
+ le chargement dynamique sur la plate-forme considérée, et de
+ les compiler en tant que modules DSO. Par exemple :</p>
+ <example>
+ --enable-mpms-shared=all
+ </example>
+ </dd>
+ </dl>
+ </section>
+
+ <section id="modules"><title>Modules tiers</title>
+ <p>Pour ajouter des modules tiers, utilisez les options suivantes
+ :</p>
+
+ <dl>
+ <dt><code>--with-module=<var>type-module</var>:<var>fichier-module</var>[,
+ <var>type-module</var>:<var>fichier-module</var>]</code></dt>
+ <dd><p>Ajoute un ou plusieurs modules tiers à la liste des
+ modules liés statiquement. Le fichier source du module
+ <var>fichier-module</var> sera recherché dans le sous-répertoire
+ <var>type-module</var> de l'arborescence des sources de votre
+ serveur HTTP Apache. S'il ne l'y trouve pas,
+ <code>configure</code> considèrera <var>fichier-module</var>
+ comme un chemin de fichier absolu et essaiera de copier le
+ fichier source dans le sous-répertoire <var>type-module</var>.
+ Si ce sous-répertoire n'existe pas, il sera créé et un fichier
+ <code>Makefile.in</code> standard y sera enregistré.</p>
+ <p>Cette option est conçue pour ajouter de petits modules
+ externes ne comportant qu'un seul fichier source. Pour des
+ modules plus complexes, vous devrez lire la documentation du
+ fournisseur du module.</p>
+ <note><title>Note</title>
+ Si vous voulez compiler un module DSO (lié de manière
+ dynamique au lieu de statique), utilisez le programme
+ <program>apxs</program>.</note>
+ </dd>
+
+ </dl>
+ </section>
+
+ <section id="otheroptfeat"><title>Options cumulatives et autres
+ options</title>
+ <dl>
+ <dt><code>--enable-maintainer-mode</code></dt>
+ <dd>Active les avertissements de débogage et de compilation et
+ charge tous les modules compilés.</dd>
+
+ <dt><code>--enable-mods-shared=<var>LISTE-MODULES</var></code></dt>
+ <dd>
+ <p>Définit une liste de modules à activer et à compiler en
+ tant que modules dynamiques partagés. Cela signifie que ces
+ modules doivent être chargés dynamiquement en utilisant la
+ directive <directive
+ module="mod_so">LoadModule</directive>.</p>
+ <p><var>LISTE-MODULES</var> est une liste, entourée
+ d'apostrophes, de noms de modules
+ séparés par des espaces. Les noms
+ des modules sont spécifiés sans le préfixe <code>mod_</code>.
+ Par exemple :</p>
+ <example>
+ --enable-mods-shared='headers rewrite dav'
+ </example>
+ <p>Vous pouvez aussi utiliser les mots-clés <code>reallyall</code>,
+ <code>all</code>, <code>most</code> et <code>few</code>. Par
+ exemple,</p>
+ <example>
+ --enable-mods-shared=most
+ </example>
+ <p>va compiler la plupart des modules en tant que modules DSO,</p>
+ <example>
+ --enable-mods-shared=few
+ </example>
+ <p>ne compilera qu'un jeu de modules de base.</p>
+ <p>Le jeu par défaut correspond au mot-clé <code>most</code>.</p>
+ <!-- See <a href="../install/enabledmodules.html">Overview of
+ enabled modules</a> for further information. -->
+ <p>Les directives <directive
+ module="mod_so">LoadModule</directive> correspondant aux
+ différents modules choisis sont automatiquement générées dans
+ le fichier de configuration principal. Par défaut, toutes ces
+ directives sont mises en commentaire, sauf pour les modules
+ requis ou ceux explicitement sélectionnés par un argument
+ <code>--enable-nom-module</code> du script configure. Vous
+ pouvez modifier le jeu de modules chargé en activant ou
+ désactivant les directives <directive
+ module="mod_so">LoadModule</directive> dans le fichier
+ <code>httpd.conf</code>. En outre, les directives <directive
+ module="mod_so">LoadModule</directive> peuvent être activées
+ pour tous les modules compilés via l'option
+ <code>--enable-load-all-modules</code> du script configure.</p>
+
+ </dd>
+
+ <dt><code>--enable-mods-static=<var>MODULE-LIST</var></code></dt>
+ <dd>Cette option produit le même effet que l'option
+ <code>--enable-mods-shared</code>, à l'exception que les modules
+ seront liés statiquement. Cela signifie que les modules
+ spécifiés seront toujours disponibles au cours du fonctionnement
+ de <program>httpd</program>. Ils n'ont pas besoin d'être chargés
+ via la directive <directive
+ module="mod_so">LoadModule</directive>.</dd>
+
+ <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
+ <dd>Cette option se comporte comme
+ <code>--enable-mods-shared</code>, et va aussi lier les modules
+ concernés dynamiquement. Le mot-clé spécial <code>none</code>
+ désactive la compilation de tous les modules.</dd>
+
+ <dt><code>--enable-v4-mapped</code></dt>
+ <dd>Permet aux sockets IPv6 de traiter les connexions IPv4.</dd>
+
+ <dt><code>--with-port=<var>PORT</var></code></dt>
+ <dd>Permet de définir le port que le programme
+ <program>httpd</program> va écouter. Ce numéro de port est
+ utilisé lors de la génération du fichier de configuration
+ <code>httpd.conf</code>. Sa valeur par défaut est 80.</dd>
+
+ <dt><code>--with-program-name</code></dt>
+ <dd>Permet de définir un nom d'exécutable alternatif. Le nom par
+ défaut est <code>httpd</code>.</dd>
+ </dl>
+ </section>
+ </section>
+
+ <section id="packages"><title>Paquets optionnels</title>
+ <p>Ces options permettent de définir des paquets optionnels.</p>
+
+ <section id="generalpackages"><title>Syntaxe générale</title>
+ <p>D'une manière générale, vous pouvez utiliser la syntaxe
+ suivante pour définir un paquet optionnel :</p>
+
+ <dl>
+ <dt><code>--with-<var>PAQUET</var>[=<var>ARG</var>]</code></dt>
+ <dd>Utilise le paquet <var>PAQUET</var>. La valeur par défaut de
+ <var>ARG</var> est <code>yes</code>.</dd>
+
+ <dt><code>--without-<var>PAQUET</var></code></dt>
+ <dd>N'utilise pas le paquet <var>PAQUET</var>. Cette option est
+ identique à <code>--with-<var>PAQUET</var>=no</code>. Elle est
+ fournie par <code>autoconf</code> mais n'est pas très utile pour
+ le serveur HTTP Apache.</dd>
+ </dl>
+ </section>
+
+ <!-- options not known are passed to packages?
+ are there other important options for packages? -->
+
+ <section id="packageopt"><title>Paquets spécifiques</title>
+ <dl>
+ <dt><code>--with-apr=<var>REP</var>|<var>FICHIER</var></code></dt>
+ <dd>La <glossary ref="apr">Bibliothèque pour la portabilité
+ d'Apache ou
+ Apache Portable Runtime</glossary> (APR) fait partie de la
+ distribution des sources de httpd et est compilée
+ automatiquement avec le serveur HTTP. Si vous voulez utiliser
+ une APR déjà installée à la place, vous devez indiquer à
+ <code>configure</code> le chemin du script
+ <code>apr-config</code>. Vous pouvez spécifier le chemin absolu
+ et le nom ou le répertoire d'installation de l'APR.
+ <code>apr-config</code> doit se trouver dans ce répertoire ou
+ dans le sous-repertoire <code>bin</code>.</dd>
+
+ <dt><code>--with-apr-util=<var>REP</var>|<var>FICHIER</var></code></dt>
+ <dd>Les utilitaires pour la Bibliothèque pour la portabilité
+ d'Apache ou Apache Portable Runtime Utilities (APU) font partie de la
+ distribution des sources de httpd et sont compilés
+ automatiquement avec le serveur HTTP. Si vous voulez utiliser
+ des APU déjà installés à la place, vous devez indiquer à
+ <code>configure</code> le chemin du script
+ <code>apu-config</code>. Vous pouvez spécifier le chemin absolu
+ et le nom ou le répertoire d'installation des APU.
+ <code>apu-config</code> doit se trouver dans ce répertoire ou
+ dans le sous-repertoire <code>bin</code>.</dd>
+
+ <dt><code>--with-ssl=<var>REP</var></code></dt>
+ <dd>Si <module>mod_ssl</module> a été activé,
+ <code>configure</code> recherche une installation d'OpenSSL.
+ Vous pouvez définir le répertoire de la boîte à outils SSL/TLS à
+ la place.</dd>
+
+ <dt><code>--with-z=<var>REP</var></code></dt>
+ <dd><code>configure</code> recherche automatiquement une
+ bibliothèque <code>zlib</code> installée si la configuration de
+ vos sources en nécessite une (par exemple lorsque
+ <module>mod_deflate</module> est activé). Vous pouvez définir le
+ répertoire de la bibliothèque de compression à la place.</dd>
+ </dl>
+
+ <p>De nombreuses fonctionnalités du serveur HTTP Apache, y compris
+ les directives <directive
+ module="mod_rewrite">RewriteMap</directive> DBM de
+ <module>mod_rewrite</module> et <module>mod_authn_dbm</module>
+ utilisent une base de données simple
+ de la forme clé/valeur pour une recherche rapide d'informations.
+ SDBM, inclus dans les APU, est donc toujours disponible. Si vous
+ souhaitez utiliser d'autres types de bases de données, utilisez
+ les options suivantes afin de les activer :</p>
+
+ <dl>
+ <dt><code>--with-gdbm[=<var>chemin</var>]</code></dt>
+ <dd>Si aucun <var>chemin</var> n'est spécifié,
+ <code>configure</code> va rechercher les fichiers d'en-têtes et
+ les bibliothèques d'une installation DBM GNU dans les chemins
+ standards. Avec un <var>chemin</var> explicite,
+ <code>configure</code> recherchera les fichiers concernés dans
+ <code><var>chemin</var>/lib</code> et
+ <code><var>chemin</var>/include</code>. En fait,
+ <var>chemin</var> permet de spécifier plusieurs chemins
+ d'en-têtes et bibliothèques spécifiques en les séparant par des
+ caractères ':'.</dd>
+
+ <dt><code>--with-ndbm[=<var>chemin</var>]</code></dt>
+ <dd>Identique à <code>--with-gdbm</code>, mais recherche une
+ installation de New DBM.</dd>
+
+ <dt><code>--with-berkeley-db[=<var>chemin</var>]</code></dt>
+ <dd>Identique à <code>--with-gdbm</code>, mais recherche une
+ installation de Berkeley DB.</dd>
+ </dl>
+
+ <note><title>Note</title>
+ <p>Les options DBM sont fournies par les APU et passées en
+ paramètres à son script de configuration. Elles sont inutiles
+ lorsqu'on utilise des APU déjà installés définis par
+ <code>--with-apr-util</code>.</p>
+ <p>Vous pouvez utiliser plusieurs implémentations DBM avec votre
+ serveur HTTP. Le type DBM approprié sera choisi au cours de la
+ configuration de l'exécution à chaque démarrage.</p>
+ </note>
+ </section>
+ </section>
+
+ <section id="supportopt"><title>Options pour les programmes de
+ support</title>
+ <dl>
+ <dt><code>--enable-static-support</code></dt>
+ <dd>Permet de compiler une version des binaires de support liés
+ statiquement. En d'autres termes, la compilation produira un
+ exécutable indépendant comportant toutes les bibliothèques
+ nécessaires. Sans cette option, les binaires de supports sont liés
+ dynamiquement.</dd>
+
+ <dt><code>--enable-suexec</code></dt>
+ <dd>Utilisez cette option pour activer la programme
+ <program>suexec</program>, qui vous permet de définir un uid et un
+ gid pour les processus lancés. <strong>N'utilisez cette option que
+ si vous maîtrisez toutes les implications en matière de sécurité
+ de l'exécution d'un binaire suid sur votre serveur.</strong>
+ D'autres options permettent de configurer
+ <program>suexec</program> comme décrit <a
+ href="#suexec">ci-dessous</a>.</dd>
+ </dl>
+
+ <p>Il est possible de lier statiquement le binaire d'un programme
+ support particulier en utilisant les options suivantes :</p>
+
+ <dl>
+ <dt><code>--enable-static-ab</code></dt>
+ <dd>Compile une version liée statiquement du programme
+ <program>ab</program>.</dd>
+
+ <!-- missing documentation for chechgid -->
+ <dt><code>--enable-static-checkgid</code></dt>
+ <dd>>Compile une version liée statiquement du programme
+ <code>checkgid</code>.</dd>
+
+ <dt><code>--enable-static-htdbm</code></dt>
+ <dd>Compile une version liée statiquement du programme <program>
+ htdbm</program>.</dd>
+
+ <dt><code>--enable-static-htdigest</code></dt>
+ <dd>Compile une version liée statiquement du programme <program>
+ htdigest</program>.</dd>
+
+ <dt><code>--enable-static-htpasswd</code></dt>
+ <dd>Compile une version liée statiquement du programme <program>
+ htpasswd</program>.</dd>
+
+ <dt><code>--enable-static-logresolve</code></dt>
+ <dd>Compile une version liée statiquement du programme <program>
+ logresolve</program>.</dd>
+
+ <dt><code>--enable-static-rotatelogs</code></dt>
+ <dd>Compile une version liée statiquement du programme <program>
+ rotatelogs</program>.</dd>
+ </dl>
+
+ <section id="suexec">
+ <title>Options de configuration de <code>suexec</code></title>
+ <p>Les options suivantes permettent de définir avec précision le
+ comportement du programme <program>suexec</program>. Voir <a
+ href="suexec.html#install">Configurer et installer suEXEC</a>
+ pour plus de détails.</p>
+
+ <dl>
+ <dt><code>--with-suexec-bin</code></dt>
+ <dd>Définit le chemin du binaire <program>suexec</program>. La
+ valeur par défaut est <code>--sbindir</code> (voir <a
+ href="#directoryfinetuning">Définition précise des répertoires
+ d'installation</a>).</dd>
+
+ <dt><code>--with-suexec-caller</code></dt>
+ <dd>Définit l'utilisateur qui a l'autorisation d'appeler
+ <program>suexec</program>. Il est en général souhaitable que ce
+ soit le même que celui sous lequel <program>httpd</program>
+ s'exécute.</dd>
+
+ <dt><code>--with-suexec-docroot</code></dt>
+ <dd>Définit l'arborescence des répertoires dans laquelle le
+ lancement des exécutables via <program>suexec</program> est
+ autorisé. La valeur par défaut est
+ <code>--datadir/htdocs</code>.</dd>
+
+ <dt><code>--with-suexec-gidmin</code></dt>
+ <dd>Définit la valeur de GID la plus basse autorisée comme
+ valeur cible pour <program>suexec</program>. La valeur par
+ défaut est 100.</dd>
+
+ <dt><code>--with-suexec-logfile</code></dt>
+ <dd>Définit le nom du fichier journal de
+ <program>suexec</program>. La valeur par défaut est
+ <code>--logfiledir/suexec_log</code>.</dd>
+
+ <dt><code>--with-suexec-safepath</code></dt>
+ <dd>Définit la valeur de la variable d'environnement
+ <code>PATH</code> pour les processus lancés par
+ <program>suexec</program>. La valeur par défaut est
+ <code>/usr/local/bin:/usr/bin:/bin</code>.</dd>
+
+ <dt><code>--with-suexec-userdir</code></dt>
+ <dd>Définit le sous-répertoire du répertoire utilisateur qui
+ contient tous les exécutables pouvant être lancés par
+ <program>suexec</program>. Cette option est nécessaire si vous
+ souhaitez utiliser <program>suexec</program> avec des
+ répertoires utilisateurs (définis via
+ <module>mod_userdir</module>). La valeur par défaut est
+ <code>public_html</code>.</dd>
+
+ <dt><code>--with-suexec-uidmin</code></dt>
+ <dd>Définit la valeur d'UID la plus basse autorisée comme
+ valeur cible pour <program>suexec</program>. La valeur par
+ défaut est 100.</dd>
+
+ <dt><code>--with-suexec-umask</code></dt>
+ <dd>Définit le masque de permissions <code>umask</code> pour les
+ processus lancés par <program>suexec</program>. Il correspond
+ par défaut au masque défini par la configuration de votre
+ système.</dd>
+ </dl>
+ </section>
+ </section>
+</section>
+
+<section id="env"><title>Variables d'environnement</title>
+ <p>Certaines variables d'environnement permettent de modifier les
+ choix effectués par <code>configure</code>, ou d'aider ce dernier à
+ trouver les bibliothèques et programmes possédant des noms et chemins
+ non standards.</p>
+
+ <!-- are these all useful variables? -->
+ <dl>
+ <dt><code>CC</code></dt>
+ <dd>Définit la commande du compilateur C à utiliser pour la
+ compilation.</dd>
+
+ <dt><code>CFLAGS</code></dt>
+ <dd>Définit les paramètres du compilateur C que vous voulez utiliser
+ pour la compilation.</dd>
+
+ <dt><code>CPP</code></dt>
+ <dd>Définit la commande du préprocesseur C à utiliser.</dd>
+
+ <dt><code>CPPFLAGS</code></dt>
+ <dd>Définit les paramètres du préprocesseur C/C++, par exemple
+ <code>-I<var>répertoire-include</var></code>, si certains de vos
+ fichiers d'en-têtes se trouvent dans le répertoire non standard
+ <var>répertoire-include</var>.</dd>
+
+ <dt><code>LDFLAGS</code></dt>
+ <dd>Définit les paramètres de l'éditeur de liens, par exemple
+ <code>-L<var>répertoire-lib</var></code>, si certaines de vos
+ bibliothèques se trouvent dans le répertoire non standard
+ <var>répertoire-lib</var>.</dd>
+ </dl>
+</section>
+</manualpage>
Added: httpd/httpd/trunk/docs/manual/programs/dbmmanage.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/dbmmanage.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/dbmmanage.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/dbmmanage.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,217 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1420686 -->
+<!-- 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é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 <module>mod_authn_dbm</module>. 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
+ <program>htpasswd</program>.</p>
+
+ <p>Le programme <program>htdbm</program> est aussi un utilitaire
+ permettant de maintenir une base de données de mots de passe DBM.</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
+ <program>httpd</program>, 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>
+</summary>
+<seealso><program>httpd</program></seealso>
+<seealso><program>htdbm</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é</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é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, sont 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é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>
+ </section>
+
+ <section id="options.commands"><title>Commandes</title>
+ <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>.
+
+ <example>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</example>
+ </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>.
+
+ <example>dbmmanage passwords.dat adduser krietz</example>
+ </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.
+
+ <example>dbmmanage passwords.dat check rbowen</example>
+ </dd>
+
+ <dt><code>delete</code></dt>
+ <dd>Supprime l'entré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é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.
+
+ <example>dbmmanage passwords.dat update rbowen</example>
+ </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.
+
+ <example>dbmmanage passwords.dat view</example>
+ </dd>
+ </dl>
+ </section>
+</section>
+
+<section id="bugs"><title>Bogues</title>
+ <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>
+</section>
+
+</manualpage>
Added: httpd/httpd/trunk/docs/manual/programs/fcgistarter.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/fcgistarter.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/fcgistarter.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/fcgistarter.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1469398 -->
+<!-- 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é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è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 é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>
+</section>
+</manualpage>
Added: httpd/httpd/trunk/docs/manual/programs/htcacheclean.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htcacheclean.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htcacheclean.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/htcacheclean.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,228 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!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éservé à <module>mod_disk_cache</module> 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>
+</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é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 <directive
+ module="mod_disk_cache">CacheRoot</directive>.</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>
+</section>
+
+<section id="delete"><title>Suppression d'une URL particulière</title>
+ <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>
+
+</section>
+
+<section id="list"><title>Affichage des URLs présentes dans le cache</title>
+ <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>
+
+</section>
+
+<section id="exit"><title>Valeur renvoyée</title>
+ <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>
+</section>
+
+</manualpage>
Added: httpd/httpd/trunk/docs/manual/programs/htdbm.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htdbm.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htdbm.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/htdbm.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,365 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1751351 -->
+<!-- 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ées DBM de mots de
+passe</title>
+
+<summary>
+ <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
+ <module>mod_authn_dbm</module>. Voir la documentation de
+ <program>dbmmanage</program> pour plus de détails à 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>i</strong> ]
+ [ -<strong>c</strong> ]
+ [ -<strong>m</strong> |
+ -<strong>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<strong>t</strong> ]
+ [ -<strong>v</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>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<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>i</strong> ]
+ [ -<strong>c</strong> ]
+ [ -<strong>m</strong> |
+ -<strong>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<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>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<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>i</strong> ]
+ [ -<strong>c</strong> ]
+ [ -<strong>m</strong> |
+ -<strong>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<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>B</strong> |
+ -<strong>d</strong> |
+ -<strong>s</strong> |
+ -<strong>p</strong> ]
+ [ -<strong>C</strong> <var>cost</var> ]
+ [ -<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> ]
+ <var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
+
+ <p><code><strong>htdbm</strong> -<strong>l</strong>
+ [ -<strong>T</strong><var>DBTYPE</var> ]
+ <var>nom-fichier</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'ê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. Pour utiliser un script, voir l'option
+ <code>-i</code>.</dd>
+
+ <dt><code>-i</code></dt>
+ <dd>Lit le mot de passe depuis stdin sans vérification (à utiliser
+ dans le cadre d'un script).</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>-B</code></dt>
+ <dd>Utilise l'algorythme de chiffrement bcrypt pour les mots de
+ passe. C'est un algorythme actuellement considéré comme sûr.</dd>
+
+ <dt><code>-C</code></dt>
+ <dd>Ce drapeau n'est autorisé qu'en conjonction avec le drapeau
+ <code>-B</code> (chiffrement bcrypt). Il permet de définir la durée
+ de traitement pour l'algorythme de chiffrement bcrypt (plus elle est
+ longue, plus la sécurité est élevée, mais la rapidité est diminuée
+ d'autant) ; la valeur par défaut est 5, les valeurs valides vont de
+ 4 à 31.</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 <program>httpd</program> sous Windows et Netware. Cet
+ algorythme est considéré comme <strong>non sûr</strong> selon 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
+ algorythme est considéré comme <strong>non sûr</strong> selon les
+ standards actuels.</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 <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ées
+ accompagné de son commentaire sur la sortie standard.</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>-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><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>
+</section>
+
+<section id="bugs"><title>Bugs</title>
+ <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>
+</section>
+
+<section id="exit"><title>Valeur renvoyée</title>
+ <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 illégaux (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é à 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>
+
+ <example>
+ htdbm -c /home/doe/public_html/.htdbm jane
+ </example>
+
+ <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>
+
+ <example>
+ htdbm -mb /usr/web/.htdbm-tous jones Pwd4Steve
+ </example>
+
+ <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>
+
+ <p>Pour convertir en fichier <code>dbm</code> un fichier de mots de passe
+ généré par <code>htpasswd</code>, utilisez <code>awk</code> pour rediriger
+ chaque ligne de ce fichier vers <code>htdbm</code> :</p>
+
+ <example>
+ htdbm -cbp passwords.dbm bogus bogus
+ awk ‘BEGIN { FS=”:” }; {system (“htdbm -bp passwords.dbm ” $1 ” ” $2)}’ passwords
+ htdbm -x bogus
+ </example>
+
+ <p>La première ligne crée une nouvelle base de données de mots de passe avec
+ une entrée temporaire servant de place réservée, et la troisième ligne
+ supprime cette entrée temporaire.</p>
+</section>
+
+<section id="security"><title>Considérations à propos de sécurité</title>
+ <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>
+
+ <p>Notez que lorsque vous utilisez l'algorythme
+ <code>crypt()</code>, seuls les 8 premiers caractères du mot de
+ passe sont pris en compte. Si le mot de passe fourni est plus long,
+ les caractères supplémentaires seront ignorés sans avertissement.</p>
+
+ <p>L'algorythme SHA ne permet pas de spécifier une valeur
+ d'initialisation pour la génération de nombres aléatoires (salting)
+ : un mot de passe donné ne possède ainsi qu'une réprésentation
+ chiffrée. Les algorythmes <code>crypt()</code> et MD5 permettent quant à
+ eux des représentations chiffrées multiples en acceptant comme
+ paramètre une chaîne d'initialisation (salt), rendant les attaques à
+ base de dictionnaires contre les mots de passe plus difficiles.</p>
+
+ <p>Les algorythmes SHA et <code>crypt()</code> sont considérés comme
+ non sûrs selon les standards actuels.</p>
+</section>
+
+<section id="restrictions"><title>Restrictions</title>
+ <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>
+</section>
+
+</manualpage>
Added: httpd/httpd/trunk/docs/manual/programs/htdigest.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htdigest.xml.fr?rev=1835738&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htdigest.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/programs/htdigest.xml.fr [utf-8] Thu Jul 12 13:50:29 2018
@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1673947 -->
+<!-- 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 à base de condensés</title>
+
+<summary>
+ <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
+ <program>httpd</program>, 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>
+</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é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>
+</section>
+
+<section id="security"><title>Considérations à propos de sécurité</title>
+ <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>
+</section>
+
+</manualpage>