-<?xml version="1.0" ?>
+<?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 : 1494953 -->
<summary>
<p><code>apxs</code> est un utilitaire permettant de compiler et
d'installer des modules en tant qu'extensions du serveur HTTP
- Apache. A cet effet, un objet dynamique partagé (DSO) est compilé à
+ Apache. A cet effet, un objet dynamique partagé (DSO) est compilé à
partir d'un ou plusieurs <var>fichiers</var> sources ou objets et
- peut être chargé pendant l'exécution du serveur Apache via la
+ peut être chargé pendant l'exécution du serveur Apache via la
directive <directive module="mod_so">LoadModule</directive> du
module <module>mod_so</module>.</p>
- <p>Pour pouvoir utiliser ce mécanisme d'extensions, votre
- plate-forme doit supporter la fonctionnalité DSO, et votre binaire
- <program>httpd</program> Apache doit être compilé avec le module
+ <p>Pour pouvoir utiliser ce mécanisme d'extensions, votre
+ plate-forme doit supporter la fonctionnalité DSO, et votre binaire
+ <program>httpd</program> Apache doit être compilé avec le module
<module>mod_so</module>. Si ce n'est pas le cas, l'utilitaire
- <code>apxs</code> vous le signalera. Vous pouvez aussi vérifier
- vous-même ces prérequis en exécutant manuellement la commande :</p>
+ <code>apxs</code> vous le signalera. Vous pouvez aussi vérifier
+ vous-même ces prérequis en exécutant manuellement la commande :</p>
<example>
$ httpd -l
</example>
<p>Le module <module>mod_so</module> doit faire partie de la liste
- des modules affichée. Si ces prérequis sont présents, vous pouvez
- facilement étendre les fonctionnalités de votre serveur Apache en
- installant vos propres modules à l'aide de l'utilitaire
- <code>apxs</code>, via le mécanisme DSO :</p>
+ des modules affichée. Si ces prérequis sont présents, vous pouvez
+ facilement étendre les fonctionnalités de votre serveur Apache en
+ installant vos propres modules à l'aide de l'utilitaire
+ <code>apxs</code>, via le mécanisme DSO :</p>
<example>
$ apxs -i -a -c mod_foo.c<br />
$ _
</example>
- <p>Les arguments <var>fichiers</var> peuvent correspondre à un
- fichier source C (.c), un fichier objet (.o) ou même une archive de
- bibliothèques (.a). L'utilitaire <code>apxs</code> reconnaît
+ <p>Les arguments <var>fichiers</var> peuvent correspondre à un
+ fichier source C (.c), un fichier objet (.o) ou même une archive de
+ bibliothèques (.a). L'utilitaire <code>apxs</code> reconnaît
automatiquement ces extensions et utilise automatiquement les
fichiers source C pour la compilation, et les fichiers objets et
- archives pour l'édition de liens. Cependant, si vous utilisez des
- fichiers objets précompilés, assurez-vous que leur code soit
- indépendant de la position (PIC), afin de pouvoir les utiliser avec
- un objet partagé chargé dynamiquement. Avec GCC, par exemple, il
+ archives pour l'édition de liens. Cependant, si vous utilisez des
+ fichiers objets précompilés, assurez-vous que leur code soit
+ indépendant de la position (PIC), afin de pouvoir les utiliser avec
+ un objet partagé chargé dynamiquement. Avec GCC, par exemple, il
vous suffit de toujours utiliser l'option de compilation
<code>-fpic</code>. Pour les autres compilateurs C, consultez leur
- page de manuel, ou vérifiez les drapeaux qu'<code>apxs</code>
+ page de manuel, ou vérifiez les drapeaux qu'<code>apxs</code>
utilise pour compiler les fichiers objets.</p>
- <p>Pour plus de détails à propos du support DSO dans Apache, lire la
- documentation du module <module>mod_so</module>, ou même, consultez
+ <p>Pour plus de détails à propos du support DSO dans Apache, lire la
+ documentation du module <module>mod_so</module>, ou même, consultez
le fichier source <code>src/modules/standard/mod_so.c</code>.</p>
</summary>
<seealso><program>apachectl</program></seealso>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>v</strong> ]
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
- <var>requête</var> ...</code></p>
+ <var>requête</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
[ -<strong>o</strong> <var>fichier-dso</var> ]
- [ -<strong>I</strong> <var>répertoire-inc</var> ]
+ [ -<strong>I</strong> <var>répertoire-inc</var> ]
[ -<strong>D</strong> <var>nom</var>=<var>valeur</var> ]
- [ -<strong>L</strong> <var>répertoire-lib</var> ]
- [ -<strong>l</strong> <var>nom-bibliothèque</var> ]
+ [ -<strong>L</strong> <var>répertoire-lib</var> ]
+ [ -<strong>l</strong> <var>nom-bibliothèque</var> ]
[ -<strong>Wc,</strong><var>options-compilation</var> ]
[ -<strong>Wl,</strong><var>options-edition-liens</var> ]
<var>fichiers</var> ...</code></p>
<section id="options.common"><title>Options courantes</title>
<dl>
<dt><code>-n <var>nom-module</var></code></dt>
- <dd>Définit explicitement le nom du module pour les options
- <code>-i</code> (install) et <code>-g</code> (génération de
- modèles). Utilisez cette option pour spécifier de manière
+ <dd>Définit explicitement le nom du module pour les options
+ <code>-i</code> (install) et <code>-g</code> (génération de
+ modèles). Utilisez cette option pour spécifier de manière
explicite le nom du module. Pour l'option <code>-g</code>, cette
- option est nécessaire ; pour l'option <code>-i</code>,
- l'utilitaire <code>apxs</code> tente de déterminer le nom du
- module à partir des sources, ou (à défaut) en le déduisant du nom
+ option est nécessaire ; pour l'option <code>-i</code>,
+ l'utilitaire <code>apxs</code> tente de déterminer le nom du
+ module à partir des sources, ou (à défaut) en le déduisant du nom
de fichier.</dd>
</dl>
</section>
- <section id="options.query"><title>Options de requête</title>
+ <section id="options.query"><title>Options de requête</title>
<dl>
<dt><code>-q</code></dt>
- <dd>Effectue une requête à propos des variables et de
- l'environnement utilisés pour compiler <code>httpd</code>.
- Lorsqu'elle est invoquée sans paramètre <var>requête</var>, cette
+ <dd>Effectue une requête à propos des variables et de
+ l'environnement utilisés pour compiler <code>httpd</code>.
+ Lorsqu'elle est invoquée sans paramètre <var>requête</var>, cette
option affiche toutes les variables connues, ainsi que leurs
- valeurs. Le paramètre optionnel <code>-v</code> formate la liste
- affichée.
+ valeurs. Le paramètre optionnel <code>-v</code> formate la liste
+ affichée.
- <p>Utilisez cette option pour déterminer manuellement les options
- utilisées pour compiler le binaire <code>httpd</code> qui chargera
+ <p>Utilisez cette option pour déterminer manuellement les options
+ utilisées pour compiler le binaire <code>httpd</code> qui chargera
votre module. Ajoutez par exemple</p>
<example>
INC=-I`apxs -q INCLUDEDIR`
</example>
- <p>dans vos propres Makefiles si vous devez accéder manuellement
- aux fichiers d'en-têtes C d'Apache.</p></dd>
+ <p>dans vos propres Makefiles si vous devez accéder manuellement
+ aux fichiers d'en-têtes C d'Apache.</p></dd>
</dl>
</section>
<dl>
<dt><code>-S <var>nom</var>=<var>valeur</var></code></dt>
<dd>Cette option permet de modifier la configuration d'apxs
- décrite ci-dessus.</dd>
+ décrite ci-dessus.</dd>
</dl>
</section>
- <section id="options.template"><title>Option de génération des
- modèles</title>
+ <section id="options.template"><title>Option de génération des
+ modèles</title>
<dl>
<dt><code>-g</code></dt>
- <dd>Cette option permet de générer un sous-répertoire
+ <dd>Cette option permet de générer un sous-répertoire
<var>nom</var> (voir option <code>-n</code>) contenant deux
fichiers : le premier fichier est un exemple de fichier source de
- module nommé <code>mod_<var>nom</var>.c</code> que l'on peut
- utiliser comme modèle pour créer ses propres modules, ou comme
- point de départ pour se familiariser avec le mécanisme apxs ; le
+ module nommé <code>mod_<var>nom</var>.c</code> que l'on peut
+ utiliser comme modèle pour créer ses propres modules, ou comme
+ point de départ pour se familiariser avec le mécanisme apxs ; le
second fichier est le <code>Makefile</code> correspondant
facilitant la compilation et l'installation de ce module.</dd>
</dl>
<section id="options.dso"><title>Options de compilation DSO</title>
<dl>
<dt><code>-c</code></dt>
- <dd>Cette option indique une opération de compilation. Tout
- d'abord, les fichiers sources (.c) spécifiés par
- <var>fichiers</var> sont compilés en fichiers objets
- correspondants (.o), puis un objet dynamiquement partagé
- <var>fichier-dso</var> est compilé via une édition de liens de ces
+ <dd>Cette option indique une opération de compilation. Tout
+ d'abord, les fichiers sources (.c) spécifiés par
+ <var>fichiers</var> sont compilés en fichiers objets
+ correspondants (.o), puis un objet dynamiquement partagé
+ <var>fichier-dso</var> est compilé via une édition de liens de ces
fichiers objets avec les autres fichiers objets (.o and .a)
- spécifiés par <var>fichiers</var>. Si l'option <code>-o</code>
- n'est pas spécifiée, le nom du fichier résultant est déduit du
- premier nom de fichier spécifié par <var>fichiers</var>, et ainsi
- prend en général pour valeur par défaut
+ spécifiés par <var>fichiers</var>. Si l'option <code>-o</code>
+ n'est pas spécifiée, le nom du fichier résultant est déduit du
+ premier nom de fichier spécifié par <var>fichiers</var>, et ainsi
+ prend en général pour valeur par défaut
<code>mod_<var>nom</var>.so</code>.</dd>
<dt><code>-o <var>fichier-dso</var></code></dt>
- <dd>Spécifie de manière explicite le nom de fichier de l'objet
- partagé dynamiquement créé. Sans cette option, et si le nom ne
- peut pas être déduit de la liste <var>fichiers</var>, c'est le nom
- par défaut <code>mod_unknown.so</code> qui sera utilisé.</dd>
+ <dd>Spécifie de manière explicite le nom de fichier de l'objet
+ partagé dynamiquement créé. Sans cette option, et si le nom ne
+ peut pas être déduit de la liste <var>fichiers</var>, c'est le nom
+ par défaut <code>mod_unknown.so</code> qui sera utilisé.</dd>
<dt><code>-D <var>nom</var>=<var>valeur</var></code></dt>
- <dd>Cette option est transmise directement à la commande de
+ <dd>Cette option est transmise directement à la commande de
compilation. Vous pouvez l'utiliser pour ajouter vos propres
- définitions au processus de compilation. </dd>
+ définitions au processus de compilation. </dd>
- <dt><code>-I <var>répertoire-inc</var></code></dt>
- <dd>Cette option est transmise directement à la commande de
+ <dt><code>-I <var>répertoire-inc</var></code></dt>
+ <dd>Cette option est transmise directement à la commande de
compilation. Vous pouvez l'utiliser pour ajouter vos propres
- chemins de recherche des répertoires <code>include</code> au processus de
+ chemins de recherche des répertoires <code>include</code> au processus de
compilation.</dd>
- <dt><code>-L <var>répertoire-lib</var></code></dt>
- <dd>Cette option est transmise directement à la commande d'édition
+ <dt><code>-L <var>répertoire-lib</var></code></dt>
+ <dd>Cette option est transmise directement à la commande d'édition
de liens. Vous pouvez l'utiliser pour ajouter vos propres
- chemins de recherche des répertoires de bibliothèques au processus
+ chemins de recherche des répertoires de bibliothèques au processus
de compilation.</dd>
- <dt><code>-l <var>nom-bibliothèque</var></code></dt>
- <dd>Cette option est transmise directement à la commande d'édition
+ <dt><code>-l <var>nom-bibliothèque</var></code></dt>
+ <dd>Cette option est transmise directement à la commande d'édition
de liens. Vous pouvez l'utiliser pour ajouter vos propres
- bibliothèques à rechercher au processus de compilation.</dd>
+ bibliothèques à rechercher au processus de compilation.</dd>
<dt><code>-Wc,<var>options-compilation</var></code></dt>
<dd>Cette option transmet les <var>options-compilation</var> en
- tant qu'options supplémentaires à la commande <code>libtool
+ tant qu'options supplémentaires à la commande <code>libtool
--mode=compile</code>. Vous pouvez l'utiliser pour ajouter des
- options locales spécifiques au compilateur.</dd>
+ options locales spécifiques au compilateur.</dd>
<dt><code>-Wl,<var>options-edition-liens</var></code></dt>
<dd>Cette option transmet les <var>options-edition-liens</var> en
- tant qu'options supplémentaires à la commande <code>libtool
+ tant qu'options supplémentaires à la commande <code>libtool
--mode=link</code>. Vous pouvez l'utiliser pour ajouter des
- options locales spécifiques à l'éditeur de liens.</dd>
+ options locales spécifiques à l'éditeur de liens.</dd>
<dt><code>-p</code></dt>
- <dd>Avec cette option, apxs effectue l'édition de liens avec les
- bibliothèques apr/apr-util. Elle permet de compiler les programmes
- helper qui utilisent les bibliothèques apr/apr-util.</dd>
+ <dd>Avec cette option, apxs effectue l'édition de liens avec les
+ bibliothèques apr/apr-util. Elle permet de compiler les programmes
+ helper qui utilisent les bibliothèques apr/apr-util.</dd>
</dl>
</section>
<title>Options d'installation et de configuration DSO</title>
<dl>
<dt><code>-i</code></dt>
- <dd>Cette option indique une opération d'installation et installe
- un ou plusieurs objets dynamiquement partagés dans le répertoire
+ <dd>Cette option indique une opération d'installation et installe
+ un ou plusieurs objets dynamiquement partagés dans le répertoire
<var>modules</var> du serveur.</dd>
<dt><code>-a</code></dt>
<dd>Cette option active le module en ajoutant automatiquement une
directive <directive module="mod_so">LoadModule</directive>
correspondante au fichier de configuration d'Apache
- <code>httpd.conf</code>, ou en l'activant s'il existe déjà.</dd>
+ <code>httpd.conf</code>, ou en l'activant s'il existe déjà.</dd>
<dt><code>-A</code></dt>
- <dd>Identique à l'option <code>-a</code>, à la différence que la
- directive <directive module="mod_so">LoadModule</directive> créée
- est préfixée par un caractère dièse (<code>#</code>) ; le module
- est ainsi préparé pour une activation ultérieure, mais est
- désactivé dans un premier temps.</dd>
+ <dd>Identique à l'option <code>-a</code>, à la différence que la
+ directive <directive module="mod_so">LoadModule</directive> créée
+ est préfixée par un caractère dièse (<code>#</code>) ; le module
+ est ainsi préparé pour une activation ultérieure, mais est
+ désactivé dans un premier temps.</dd>
<dt><code>-e</code></dt>
- <dd>Cette option indique une opération d'édition de liens et peut
- être utilisée avec les options <code>-a</code> et <code>-A</code>
- de la même manière qu'au cours de l'opération d'installation pour
- éditer le fichier de configuration d'Apache
+ <dd>Cette option indique une opération d'édition de liens et peut
+ être utilisée avec les options <code>-a</code> et <code>-A</code>
+ de la même manière qu'au cours de l'opération d'installation pour
+ éditer le fichier de configuration d'Apache
<code>httpd.conf</code>, sans toutefois installer le module.</dd>
</dl>
</section>
</section>
<section id="examples"><title>Exemples</title>
- <p>Supposons que vous disposiez d'un module Apache nommé
- <code>mod_foo.c</code> et destiné à étendre les fonctionnalités du
+ <p>Supposons que vous disposiez d'un module Apache nommé
+ <code>mod_foo.c</code> et destiné à étendre les fonctionnalités du
serveur. Pour ce faire, vous devez tout d'abord compiler le fichier
- source C en un objet partagé pouvant être chargé dans le serveur
- Apache à l'exécution, via la commande suivante :</p>
+ source C en un objet partagé pouvant être chargé dans le serveur
+ Apache à l'exécution, via la commande suivante :</p>
<example>
$ apxs -c mod_foo.c<br />
$ _
</example>
- <p>Vous devez ensuite vérifier la configuration d'Apache en vous
+ <p>Vous devez ensuite vérifier la configuration d'Apache en vous
assurant qu'une directive <directive
- module="mod_so">LoadModule</directive> est bien présente pour
- charger cet objet partagé. Pour simplifier cette étape,
- <code>apxs</code> propose une méthode automatique d'installation de
- l'objet partagé dans son répertoire "modules", et de mise à jour du
- fichier <code>httpd.conf</code> en conséquence. Pour bénéficier de
+ module="mod_so">LoadModule</directive> est bien présente pour
+ charger cet objet partagé. Pour simplifier cette étape,
+ <code>apxs</code> propose une méthode automatique d'installation de
+ l'objet partagé dans son répertoire "modules", et de mise à jour du
+ fichier <code>httpd.conf</code> en conséquence. Pour bénéficier de
cette automatisation, utilisez la commande suivante :</p>
<example>
LoadModule foo_module modules/mod_foo.so
</example>
- <p>est alors ajoutée au fichier de configuration si ce n'est pas
- déjà fait. Si vous voulez que le module soit désactivé par défaut,
+ <p>est alors ajoutée au fichier de configuration si ce n'est pas
+ déjà fait. Si vous voulez que le module soit désactivé par défaut,
utilisez l'option <code>-A</code> comme suit :</p>
<example>
$ apxs -i -A mod_foo.c
</example>
- <p>Pour un test rapide du mécanisme apxs, vous pouvez créer un
- exemple de modèle de module Apache, ainsi que le Makefile
+ <p>Pour un test rapide du mécanisme apxs, vous pouvez créer un
+ exemple de modèle de module Apache, ainsi que le Makefile
correspondant via :</p>
<example>
$ _
</example>
- <p>Vous pouvez ensuite compiler immédiatement ce module exemple en
- objet partagé et le charger dans le serveur Apache :</p>
+ <p>Vous pouvez ensuite compiler immédiatement ce module exemple en
+ objet partagé et le charger dans le serveur Apache :</p>
<example>
$ cd foo<br />
-<?xml version="1.0" ?>
+<?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 : 1420732 -->
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
+ <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é
+ 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>
+ 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
+ <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
+ 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>
<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>mot-de-passe-chiffré</var>
[ <var>groupe</var>[,<var>groupe</var>...]
[ <var>commentaire</var> ] ] ]</code></p>
<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
+ <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
+ <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
+ <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
+ 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
+ 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
+ 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,
+ <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,
+ <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,
+ <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>
+ <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>.
+ <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>.
+ <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>
+ <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
+ <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
+ <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>
+ (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.
+ <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.
+ <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>
</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>
+ <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
+ 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>
+ 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
+ plupart des systèmes Unix pour déterminer le format d'un fichier
DBM.</p>
</section>
-<?xml version="1.0" ?>
+<?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 : 1469400 -->
<manualpage metafile="fcgistarter.xml.meta">
<parentdocument href="./">Programmes</parentdocument>
-<title>fcgistarter - Démarrer un programme FastCGI</title>
+<title>fcgistarter - Démarrer un programme FastCGI</title>
<summary>
<p></p>
<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>
+ <p>Ne fonctionne actuellement que sur les systèmes de type Unix.</p>
</section>
<section id="synopsis"><title>Syntaxe</title>
<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>
+ <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>
+ <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>
-<?xml version="1.0" ?>
+<?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 -->
<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>
+ 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="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
+ <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
+ 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
+ <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>
+ 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
+ <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
+ <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
+ <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>
+ 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>
+ <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
+ <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>
+ <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>
+ <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
+ <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
+ <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
+ <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
+ <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,
+ <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
+<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>
+ 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
+ <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
+ <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>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>
+<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
+ 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
+ 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>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>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>
+ 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
+ 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,
+<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
-<?xml version="1.0" ?>
+<?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 : 1420732 -->
<manualpage metafile="htdbm.xml.meta">
<parentdocument href="./">Programmes</parentdocument>
-<title>htdbm - Manipuler des bases de données DBM de mots de
+<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
+ 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
+ <program>dbmmanage</program> pour plus de détails à propos de ces
fichiers DBM.</p>
</summary>
<seealso><program>httpd</program></seealso>
<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
+ 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
+ <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
+ <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
+ <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
+ 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>
+ 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>
+ 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
+ <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>
+ 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
+ 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
+ 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
+ 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
+ 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
+ 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>
+ <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
+ <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>
+ 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>
+ 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>
+ <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
+ <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>
+ 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
+ <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>
+ 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
+ <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>
</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
+ <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>
+ 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>
+ 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
+ plupart des systèmes Unix pour déterminer le format d'un fichier
DBM.</p>
</section>
-<section id="exit"><title>Valeur renvoyée</title>
+<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
+ 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é
+ 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
+ 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>
</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
+ <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
+ <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>
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>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>
</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
+<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>
+ ê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
+ <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
+ <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 à
+ 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>
+ <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>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
+ <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>
+ <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>
-<?xml version="1.0" ?>
+<?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 : 1363282 -->
<parentdocument href="./">Programmes</parentdocument>
<title>htdigest - Gestion des fichiers d'utilisateurs pour
-l'authentification à base de condensés</title>
+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
+ <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
+ 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
+ <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
+ la distribution et peut
être consulté à <a
href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
</summary>
<seealso><program>httpd</program></seealso>
<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>
+ <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>
+ 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>
+ 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
+ <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>
+ 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 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>
-<?xml version="1.0" ?>
+<?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 : 1450091 -->
<manualpage metafile="httxt2dbm.xml.meta">
<parentdocument href="./">Programmes</parentdocument>
-<title>httxt2dbm - Génère des fichiers dbm à utiliser avec
+<title>httxt2dbm - Génère des fichiers dbm à utiliser avec
RewriteMap</title>
<summary>
- <p><code>httxt2dbm</code> permet, à partir d'une entrée au format
- texte, de générer des fichiers dbm à utiliser dans les directives
+ <p><code>httxt2dbm</code> permet, à partir d'une entrée au format
+ texte, de générer des fichiers dbm à utiliser dans les directives
<directive module="mod_rewrite">RewriteMap</directive> avec le type
de table <code>dbm</code>.
</p>
- <p>Si le fichier de sortie existe déjà, il ne sera pas tronqué. Les
- nouvelles clés seront ajoutées et les clés préexistantes mises à
+ <p>Si le fichier de sortie existe déjà, il ne sera pas tronqué. Les
+ nouvelles clés seront ajoutées et les clés préexistantes mises à
jour.</p>
</summary>
<seealso><program>httpd</program></seealso>
<dd>Sortie plus verbeuse</dd>
<dt><code>-f <var>TYPE_DBM</var></code></dt>
- <dd>Spécifie le type DBM à utiliser pour le fichier de sortie.
- S'il n'est pas spécifié, c'est la valeur par défaut de
- l'<glossary>APR</glossary> qui sera utilisée. Les types disponibles
+ <dd>Spécifie le type DBM à utiliser pour le fichier de sortie.
+ S'il n'est pas spécifié, c'est la valeur par défaut de
+ l'<glossary>APR</glossary> qui sera utilisée. Les types disponibles
sont :
<code>GDBM</code> pour les fichiers GDBM,
<code>SDBM</code> pour les fichiers SDBM,
<code>DB</code> pour les fichiers DB,
<code>NDBM</code> pour les fichiers NDBM,
- <code>default</code> pour le type DBM par défaut
+ <code>default</code> pour le type DBM par défaut
</dd>
<dt><code>-i <var>TEXTE_SOURCE</var></code></dt>
- <dd>Le fichier d'entrée à partir duquel le fichier dbm sera créé. Le
- fichier doit être formaté de façon à ne contenir qu'un seul
- enregistrement par ligne, de la forme : <code>clé valeur</code>.
+ <dd>Le fichier d'entrée à partir duquel le fichier dbm sera créé. Le
+ fichier doit être formaté de façon à ne contenir qu'un seul
+ enregistrement par ligne, de la forme : <code>clé valeur</code>.
Voir la documentation de la directive <directive
- module="mod_rewrite">RewriteMap</directive> pour plus de détails à
+ module="mod_rewrite">RewriteMap</directive> pour plus de détails à
propos du format de ce fichier et de sa signification.
</dd>
-<?xml version="1.0" ?>
+<?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 : 1645865 -->
ces derniers dans un "pipe"</title>
<summary>
- <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
+ <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>
</summary>
[ -<strong>n</strong> <var>nombre-de-fichiers</var> ]
<var>fichier-journal</var>
<var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
- [ <var>décalage</var> ]</code></p>
+ [ <var>décalage</var> ]</code></p>
</section>
<section id="options"><title>Options</title>
<dl>
<dt><code>-l</code></dt>
-<dd>Utilise le temps local plutôt que GMT comme base pour l'intervalle
+<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>
+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
+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
+<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
+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
+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 à
+<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.
+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>
+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>
+<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>
+<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>-n <var>nombre-de-fichiers</var></code></dt>
-<dd>Utilise une liste circulaire de fichiers sans repères de temps. Avec
--n 3, la série de fichiers conservés sera "logfile",
-"logfile.1", "logfile.2" avec écrasement de "logfile".
-Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</dd>
+<dd>Utilise une liste circulaire de fichiers sans repères de temps. Avec
+-n 3, la série de fichiers conservés sera "logfile",
+"logfile.1", "logfile.2" avec écrasement de "logfile".
+Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</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).
+<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
+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/log/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>
+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/log/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
+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>
+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>
<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
+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>
+<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é.
+<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
+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>
+spécifier un décalage.</dd>
</dl>
</section>
CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common
</example>
- <p>Cette directive crée les fichiers /var/log/fichier-journal.nnnn
- où nnnn correspond au temps système auquel la journalisation
- démarre effectivement (ce temps sera toujours un multiple du temps
+ <p>Cette directive crée les fichiers /var/log/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>
+ avec lui). A la fin de chaque temps de rotation (ici après 24
+ heures), une nouvelle journalisation démarre.</p>
<example>
CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common
</example>
- <p>Cette directive crée les fichiers
- /var/log/fichier-journal.yyyy.mm.dd où yyyy correspond à l'année,
+ <p>Cette directive crée les fichiers
+ /var/log/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>
+ un nouveau fichier chaque jour à minuit, temps local.</p>
<example>
CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common
</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ésentera sous
+ MOctets, et le nom du fichier journal se présentera sous
la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
<example>
CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common
</example>
- <p>Cet exemple crée le fichier /var/log/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>
+ <p>Cet exemple crée le fichier /var/log/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>
</section>
-<section id="portability"><title>Portabilité</title>
+<section id="portability"><title>Portabilité</title>
-<p>Les substitutions des chaînes de format du fichier journal suivantes
-doivent être supportées par toutes les implémentations de
+<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>
+<code>strftime(3)</code> pour les extensions spécifiques à une
+bibliothèque.</p>
<table border="1" style="zebra">
<tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
-(localisé)</td></tr>
+(localisé)</td></tr>
<tr><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><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>
+caractères (localisé)</td></tr>
+<tr><td><code>%B</code></td><td>nom du mois en entier (localisé)</td></tr>
+<tr><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><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><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><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 à 24h)</td></tr>
+<tr><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><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 à 12h
-(localisé)</td></tr>
+<tr><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><td><code>%U</code></td><td>semaine de l'année sur 2 chiffres
+<tr><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
+<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><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><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><td><code>%y</code></td><td>année sur 2 chiffres</td></tr>
+<tr><td><code>%X</code></td><td>heure (localisée)</td></tr>
+<tr><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><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><td><code>%%</code></td><td>caractère littéral `%'</td></tr>
+<tr><td><code>%%</code></td><td>caractère littéral `%'</td></tr>
</table>
</section>
projects / thirdparty / apache / httpd.git / commitdiff
