-<?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: 1544626:1799456 (outdated) -->
+<!-- English Revision: 1799456 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<manualpage metafile="directive-dict.xml.meta">
- <title>Termes utilisés pour la description des directives</title>
+ <title>Termes utilisés pour la description des directives</title>
<summary>
- <p>Ce document d
écrit les termes utilisés pour décrire chaque <a
+ <p>Ce document d
écrit les termes utilisés pour décrire chaque <a
href="directives.html">directive de configuration</a> d'Apache.</p>
</summary>
<seealso><a href="../configuring.html">Fichiers de configuration</a></seealso>
<section id="Description"><title>Description</title>
-<p>Une brève description des fonctions de cette directive.</p>
+<p>Une brève description des fonctions de cette directive.</p>
</section>
<section id="Syntax"><title>Syntaxe</title>
<p>Ce terme introduit le format sous lequel la directive doit
- apparaître dans le fichier de configuration. Cette syntaxe est très
- spécifique à la directive et est décrite en détail dans la
- définition de cette dernière. En général, le nom de la directive est
- suivi d'un ou plusieurs arguments séparés par des espaces. Si un
- argument contient un espace, il doit être entouré de guillemets. Les
- arguments optionnels sont entourés de crochets. Lorsqu'un argument
+ apparaître dans le fichier de configuration. Cette syntaxe est très
+ spécifique à la directive et est décrite en détail dans la
+ définition de cette dernière. En général, le nom de la directive est
+ suivi d'un ou plusieurs arguments séparés par des espaces. Si un
+ argument contient un espace, il doit être entouré de guillemets. Les
+ arguments optionnels sont entourés de crochets. Lorsqu'un argument
accepte une valeur parmi une liste de valeurs possibles, cette liste
- est spécifiée en séparant les valeurs par une barre verticale "|".
- Les textes littéraux sont présentés dans la fonte par défaut, alors
+ est spécifiée en séparant les valeurs par une barre verticale "|".
+ Les textes littéraux sont présentés dans la fonte par défaut, alors
que les types d'argument pour lesquels une substitution est
- nécessaire sont en <em>gras</em>. La syntaxe des directives
+ nécessaire sont en <em>gras</em>. La syntaxe des directives
acceptant un nombre variable d'arguments se termine par "...", ce
- qui indique que le dernier argument peut être répété.</p>
+ qui indique que le dernier argument peut être répété.</p>
<p>Les directives utilisent un grand nombre de types d'arguments
- différents. Les plus courants sont définis ci-dessous.</p>
+ différents. Les plus courants sont définis ci-dessous.</p>
<dl>
<dt><em>URL</em></dt>
<dd>Un Localisateur de Ressource Uniforme (Uniform Resource
- Locator) complet comportant un protocole, un nom d'hôte et un nom
+ Locator) complet comportant un protocole, un nom d'hôte et un nom
de chemin optionnel comme dans
<code>http://www.example.com/chemin/vers/fichier.html</code></dd>
<dt><em>chemin-URL</em></dt>
<dd>La partie de l'<em>url</em> qui suit le protocole et le nom
- d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le
- <em>chemin-URL</em> représente la ressource vue depuis le web, et est
- différente de la représentation de cette même ressource vue depuis le
- système de fichiers.</dd>
+ d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le
+ <em>chemin-URL</em> représente la ressource vue depuis le web, et est
+ différente de la représentation de cette même ressource vue depuis le
+ système de fichiers.</dd>
<dt><em>chemin-fichier</em></dt>
- <dd>Le chemin d'un fichier dans le système de fichiers local
- commençant par le répertoire racine comme dans
+ <dd>Le chemin d'un fichier dans le système de fichiers local
+ commençant par le répertoire racine comme dans
<code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>.
Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence
- pas par un slash sera considéré comme relatif au répertoire défini
+ pas par un slash sera considéré comme relatif au répertoire défini
par la directive <a
href="core.html#serverroot">ServerRoot</a>.</dd>
- <dt><em>chemin-répertoire</em></dt>
+ <dt><em>chemin-répertoire</em></dt>
- <dd>Le chemin d'un répertoire dans le système de fichiers local
- commençant par le répertoire racine comme dans
+ <dd>Le chemin d'un répertoire dans le système de fichiers local
+ commençant par le répertoire racine comme dans
<code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd>
<dt><em>nom-fichier</em></dt>
<dt><em>regex</em></dt>
<dd>Une <glossary ref="regex">expression rationnelle</glossary>
- compatible Perl. La définition de la directive spécifiera à quoi
- <em>regex</em> sera comparée.</dd>
+ compatible Perl. La définition de la directive spécifiera à quoi
+ <em>regex</em> sera comparée.</dd>
<dt><em>extension</em></dt>
- <dd>En général, c'est la partie du <em>nom de fichier</em> qui
- suit le dernier point. Cependant, Apache reconnaît plusieurs
+ <dd>En général, c'est la partie du <em>nom de fichier</em> qui
+ suit le dernier point. Cependant, Apache reconnaît plusieurs
extensions de noms de fichiers ; ainsi, si un <em>nom de
fichier</em>
contient plusieurs points, chacune des parties du nom de fichier
- séparées par des points et situées après le premier point est une
+ séparées par des points et situées après le premier point est une
<em>extension</em>. Par exemple, le <em>nom de fichier</em>
<code>fichier.html.en</code> comporte deux extensions :
<code>.html</code> et <code>.en</code>. Pour les directives
- Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans
+ Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans
le point initial. Enfin, les <em>extension</em>s ne sont pas
- sensibles à la casse.</dd>
+ sensibles à la casse.</dd>
<dt><em>MIME-type</em></dt>
- <dd>Une méthode de description du format d'un fichier consistant
- en un type de format majeur et un type de format mineur séparés
+ <dd>Une méthode de description du format d'un fichier consistant
+ en un type de format majeur et un type de format mineur séparés
par un slash comme dans <code>text/html</code>.</dd>
<dt><em>env-variable</em></dt>
<dd>Le nom d'une <a href="../env.html">variable
- d'environnement</a> définie au cours du processus de configuration
- d'Apache. Notez qu'elle peut être différente d'une variable
- d'environnement du syst
ème d'exploitation. Voir la <a
+ d'environnement</a> définie au cours du processus de configuration
+ d'Apache. Notez qu'elle peut être différente d'une variable
+ d'environnement du syst
ème d'exploitation. Voir la <a
href="../env.html">documentation sur les variables d'environnement</a>
- pour plus de détails.</dd>
+ pour plus de détails.</dd>
+
+ <dt><em>time-interval</em></dt>
+
+ <dd>Un format d'intervalle de temps spécifique à divers paramètres de
+ timeout. Les formats supportés sont les suivants :
+ <ul>
+ <li><em>s</em>: Secondes</li>
+ <li><em>h</em>: Heures</li>
+ <li><em>ms</em>: Millisecondes</li>
+ <li><em>mi[n]</em>: Minutes</li>
+ </ul>
+ Par exemple : <code>Timeout 575ms</code>
+ </dd>
</dl>
</section>
-<section id="Default"><title>Défaut</title>
+<section id="Default"><title>Défaut</title>
- <p>Si la directive possède une valeur par défaut (en d'autres
+ <p>Si la directive possède une valeur par défaut (en d'autres
termes, si le serveur Web Apache se comporte comme si vous l'aviez
- définie à une valeur particulière, alors que vous l'avez omise dans
- votre configuration), elle est spécifiée ici. Si la directive ne
- possède pas de valeur par défaut, cette section doit spécifier
- "<em>Aucune</em>". Notez que la valeur par défaut dont il est
- question n'est pas nécessairement la même que la valeur attribuée à
- la directive dans le fichier httpd.conf par défaut distribué avec le
+ définie à une valeur particulière, alors que vous l'avez omise dans
+ votre configuration), elle est spécifiée ici. Si la directive ne
+ possède pas de valeur par défaut, cette section doit spécifier
+ "<em>Aucune</em>". Notez que la valeur par défaut dont il est
+ question n'est pas nécessairement la même que la valeur attribuée à
+ la directive dans le fichier httpd.conf par défaut distribué avec le
serveur.</p>
</section>
<section id="Context"><title>Contexte</title>
<p>Indique les parties des fichiers de configuration du serveur
- où cette directive est valide. Il s'agit d'une liste d'une ou
- plusieurs des valeurs suivantes séparées par des virgules :</p>
+ où cette directive est valide. Il s'agit d'une liste d'une ou
+ plusieurs des valeurs suivantes séparées par des virgules :</p>
<dl>
<dt>configuration du serveur</dt>
- <dd>Signifie que la directive peut être utilisée dans les fichiers
+ <dd>Signifie que la directive peut être utilisée dans les fichiers
de configuration du serveur (par exemple <code>httpd.conf</code>),
- mais <strong>pas</strong> à l'intérieur d'un conteneur <directive
+ mais <strong>pas</strong> à l'intérieur d'un conteneur <directive
module="core" type="section">VirtualHost</directive> ou <directive
- module="core" type="section">Directory</directive>. De même, elle
+ module="core" type="section">Directory</directive>. De même, elle
n'est pas valide dans les fichiers <code>.htaccess</code>.</dd>
<dt>serveur virtuel</dt>
- <dd>Signifie que la directive peut apparaître à l'intérieur d'un
+ <dd>Signifie que la directive peut apparaître à l'intérieur d'un
conteneur <directive module="core"
type="section">VirtualHost</directive> dans les fichiers de
configuration du serveur.</dd>
- <dt>répertoire</dt>
+ <dt>répertoire</dt>
- <dd>Une directive spécifiée comme valide dans ce contexte peut
- être utilisée à l'intérieur de conteneurs <directive module="core"
+ <dd>Une directive spécifiée comme valide dans ce contexte peut
+ être utilisée à l'intérieur de conteneurs <directive module="core"
type="section">Directory</directive>, <directive type="section"
module="core">Location</directive>, <directive module="core"
type="section">Files</directive>, <directive module="core"
type="section">If</directive>, et <directive
module="mod_proxy" type="section">Proxy</directive> dans les
fichiers de configuration du serveur, en tenant compte des
- restrictions pr
écisées dans la documentation sur les <a
+ restrictions pr
écisées dans la documentation sur les <a
href="../sections.html">Sections de configuration</a>.</dd>
<dt>.htaccess</dt>
<dd>Si une directive est valide dans ce contexte, cela signifie
- qu'elle peut apparaître à l'intérieur de fichiers de configuration
- de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou
- ne sera pas trait
ée, selon la définition de l'option <a
+ qu'elle peut apparaître à l'intérieur de fichiers de configuration
+ de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou
+ ne sera pas trait
ée, selon la définition de l'option <a
href="#Override">overrides</a> pour le contexte courant.</dd>
</dl>
- <p>La directive n'est autorisée <em>que</em> dans le contexte
- désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une
- erreur de configuration qui va soit empêcher le serveur de traiter
- les requêtes correctement dans ce contexte, soit tout simplement
- empêcher le serveur de fonctionner -- en d'autres termes, le serveur
- refusera de démarrer.</p>
+ <p>La directive n'est autorisée <em>que</em> dans le contexte
+ désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une
+ erreur de configuration qui va soit empêcher le serveur de traiter
+ les requêtes correctement dans ce contexte, soit tout simplement
+ empêcher le serveur de fonctionner -- en d'autres termes, le serveur
+ refusera de démarrer.</p>
- <p>Les lieux de définition valides pour une directive résultent en
+ <p>Les lieux de définition valides pour une directive résultent en
fait d'un
- OU logique de tous les contextes spécifiés. En d'autres termes, une
- directive spécifiée comme valide dans "<code>configuration du
- serveur, .htaccess</code>" peut être utilisée dans le fichier
+ OU logique de tous les contextes spécifiés. En d'autres termes, une
+ directive spécifiée comme valide dans "<code>configuration du
+ serveur, .htaccess</code>" peut être utilisée dans le fichier
<code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>,
mais pas dans un conteneur <directive module="core"
type="section">Directory</directive> ou <directive module="core"
<section id="Override"><title>Surcharge .htaccess</title>
- <p>Ce terme indique quelle autorisation de surcharge doit être
- active pour que la directive puisse être traitée lorsqu'elle
- appara
ît dans un fichier <code>.htaccess</code>. Si le <a
+ <p>Ce terme indique quelle autorisation de surcharge doit être
+ active pour que la directive puisse être traitée lorsqu'elle
+ appara
ît dans un fichier <code>.htaccess</code>. Si le <a
href="#Context" >context</a> de la directive ne lui permet pas
- d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte
- ne sera spécifié.</p>
-
- <p>Les autorisations de surcharge sont activées via la directive
- <directive module="core">AllowOverride</directive>, et possèdent une
- portée particulière, comme un répertoire et tous ses
- sous-répertoires, sauf si une autre directive <directive
- module="core">AllowOverride</directive> apparaît à un niveau
- inférieur. La documentation pour cette directive spécifie aussi les
+ d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte
+ ne sera spécifié.</p>
+
+ <p>Les autorisations de surcharge sont activées via la directive
+ <directive module="core">AllowOverride</directive>, et possèdent une
+ portée particulière, comme un répertoire et tous ses
+ sous-répertoires, sauf si une autre directive <directive
+ module="core">AllowOverride</directive> apparaît à un niveau
+ inférieur. La documentation pour cette directive spécifie aussi les
noms d'autorisations de surcharge disponibles.</p>
</section>
<section id="Status"><title>Statut</title>
- <p>Cet attribut indique le degré de rapprochement de la directive du
- coeur d'Apache ; en d'autres termes, vous pouvez être amené à
- recompiler le serveur avec un jeu de modules supplémentaires pour
- pouvoir utiliser la directive, et ainsi accéder à ses
- fonctionnalités. Les valeurs possible pour cet attribut sont :</p>
+ <p>Cet attribut indique le degré de rapprochement de la directive du
+ coeur d'Apache ; en d'autres termes, vous pouvez être amené à
+ recompiler le serveur avec un jeu de modules supplémentaires pour
+ pouvoir utiliser la directive, et ainsi accéder à ses
+ fonctionnalités. Les valeurs possible pour cet attribut sont :</p>
<dl>
<dt>Core</dt>
<dd>Une directive dont le statut est "MPM" est fournie par un <a
href="../mpm.html">module Multi-Processus</a>. Ce type de
directive sera disponible si et seulement si vous utilisez un des
- MPMs sp
écifiés dans la ligne <a href="#Module">Module</a> de la
- définition de la directive.</dd>
+ MPMs sp
écifiés dans la ligne <a href="#Module">Module</a> de la
+ définition de la directive.</dd>
<dt>Base</dt>
<dd>Une directive dont le statut est "Base" est fournie par un des
- modules Apache standards qui sont compilés dans le serveur par
- défaut, et sont de ce fait toujours disponibles, sauf si vous avez
+ modules Apache standards qui sont compilés dans le serveur par
+ défaut, et sont de ce fait toujours disponibles, sauf si vous avez
fait en sorte de les supprimer de votre configuration.</dd>
<dt>Extension</dt>
<dd>Une directive dont le statut est "Extension" est fournie par
un des modules inclus dans le kit du serveur Apache, mais qui ne
- sont pas compilés dans le serveur par défaut. Pour activer la
- directive et accéder à ses fonctionnalités, vous devez modifier
+ sont pas compilés dans le serveur par défaut. Pour activer la
+ directive et accéder à ses fonctionnalités, vous devez modifier
les fichiers de configuration de la compilation du serveur, et
recompiler Apache.</dd>
- <dt>Expérimental</dt>
+ <dt>Expérimental</dt>
<dd>Le statut "Experimental" indique que la directive fait partie
- du kit Apache, mais que vous l'utilisez à vos risques et périls.
- La directive est documentée à titre d'exhaustivité, et n'est pas
- obligatoirement supportée. Le module qui fournit la directive peut
- être compilé par défaut dans le serveur ou non ; consultez le haut
- de la page qui décrit la directive et son module pour vérifier sa
- disponibilité.</dd>
+ du kit Apache, mais que vous l'utilisez à vos risques et périls.
+ La directive est documentée à titre d'exhaustivité, et n'est pas
+ obligatoirement supportée. Le module qui fournit la directive peut
+ être compilé par défaut dans le serveur ou non ; consultez le haut
+ de la page qui décrit la directive et son module pour vérifier sa
+ disponibilité.</dd>
</dl>
</section>
fournissent la directive.</p>
</section>
-<section id="Compatibility"><title>Compatibilité</title>
+<section id="Compatibility"><title>Compatibilité</title>
<p>Si la directive ne faisait pas partie de la distribution
- originale d'Apache version 2, la version dans laquelle elle a été
- introduite est indiquée ici. Cette section indique aussi si la
+ originale d'Apache version 2, la version dans laquelle elle a été
+ introduite est indiquée ici. Cette section indique aussi si la
directive n'est disponible que sur certaines plates-formes.</p>
</section>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1792092:1799463 (outdated) -->
+<!-- English Revision: 1799463 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</example>
- <p>Cette directive va créer un worker associé à l'URL du serveur
- original <code>http://backend.example.com</code>, qui utilisera les
- valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre
- d'un mandataire direct, les workers sont en général définis via la
- directive <directive module="mod_proxy">ProxySet</directive>,</p>
+ <p>Cette directive va créer un worker associé à l'URL du serveur original
+ <code>http://backend.example.com</code>, qui utilisera les valeurs de
+ timeout données. Toutes les spécifications de timeouts utilisent la
+ syntaxe <a href="directive-dict.html#Syntax">time-interval</a>. Lorsqu'ils
+ sont utilisés dans le cadre d'un mandataire direct, les workers sont en
+ général définis via la directive <directive
+ module="mod_proxy">ProxySet</directive> :</p>
<example>
<highlight language="config">
La durée en secondes pendant laquelle Apache httpd va attendre pour
l'établissement d'une connexion vers le serveur d'arrière-plan.
Le délai peut être spécifié en millisecondes en ajoutant le
- suffixe ms.
+ suffixe ms. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>disablereuse</td>
<td>Off</td>
<td>10</td>
<td>Le délai d'attente pour une entrée additionnelle, en
millisecondes, avant le vidage du tampon en sortie dans le cas
- où 'flushpackets' est à 'auto'.
+ où 'flushpackets' est à 'auto'. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>iobuffersize</td>
<td>8192</td>
<p>La fréquence de vérification des connexions TCP persistantes
initiale et subséquentes dépend de la configuration globale de l'OS,
et peut atteindre 2 heures. Pour être utile, la fréquence configurée
- dans l'OS doit être inférieure au seuil utilisé par le pare-feu.</p>
+ dans l'OS doit être inférieure au seuil utilisé par le pare-feu. Utilise la
+ syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.</p>
</td></tr>
<tr><td>lbset</td>
cas où les noeuds de cluster sont arrêtés ou
surchargés. Le délai peut
aussi être défini en millisecondes en ajoutant le suffixe
- ms.
+ ms. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>receivebuffersize</td>
<td>0</td>
spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
maintenance, et de le remettre en ligne plus tard. Une valeur de
0 implique de toujours essayer les serveurs cibles dans un état d'erreur
- sans délai.
+ sans délai. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>route</td>
<td>-</td>
<td><directive module="mod_proxy">ProxyTimeout</directive></td>
<td>Délai d'attente de la connexion en secondes. Le nombre de
secondes pendant lesquelles Apache httpd attend l'envoi de
- données vers le serveur d'arrière-plan.
+ données vers le serveur d'arrière-plan. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>ttl</td>
<td>-</td>
<td>Durée de vie des connexions inactives et des entrées du pool
de connexions associées en secondes. Une fois cette
limite atteinte, une connexion ne sera pas réutilisée ; elle
- sera fermée après un délai variable.
+ sera fermée après un délai variable. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>flusher</td>
<td>flush</td>
<td>Délai du répartiteur en secondes. Si ce paramètre est
défini, sa valeur correspond à la durée maximale d'attente pour
un serveur cible libre. Le comportement par défaut est de ne pas
- attendre.
+ attendre. Utilise la syntaxe <a
+ href="directive-dict.html#Syntax">time-interval</a>.
</td></tr>
<tr><td>failonstatus</td>
<td>-</td>
<name>ProxyTimeout</name>
<description>Délai d'attente réseau pour les requêtes
mandatées</description>
-<syntax>ProxyTimeout <var>secondes</var></syntax>
+<syntax>ProxyTimeout <var>time-interval</var>[s]</syntax>
<default>Valeur de la directive <directive
module="core">Timeout</directive></default>
<contextlist><context>server config</context><context>virtual host</context>
projects / apache / commitdiff