You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2019/03/16 15:08:18 UTC
svn commit: r1855659 - in /httpd/httpd/branches/2.4.x/docs/manual:
mod/mod_http2.xml.fr mod/mod_reqtimeout.xml.fr rewrite/rewritemap.xml.fr
Author: lgentis
Date: Sat Mar 16 15:08:18 2019
New Revision: 1855659
URL: http://svn.apache.org/viewvc?rev=1855659&view=rev
Log:
xml fr doc updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/rewrite/rewritemap.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.xml.fr?rev=1855659&r1=1855658&r2=1855659&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.xml.fr [utf-8] Sat Mar 16 15:08:18 2019
@@ -1,7 +1,7 @@
<?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 : 1798481 -->
+<!-- English Revision : 1855431 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -291,6 +291,8 @@ Protocols h2 h2c http/1.1
<contextlist>
<context>server config</context>
<context>virtual host</context>
+ <context>directory</context>
+ <context>.htaccess</context>
</contextlist>
<compatibility>Disponible à partir de la version 2.4.18 du serveur HTTP
Apache.</compatibility>
@@ -325,6 +327,7 @@ Protocols h2 h2c http/1.1
<p>
Les en-têtes link des réponses sont soit définis par
l'application, soit configurés via
+ <directive>H2PushResource</directive> ou
<module>mod_headers</module> comme suit :
</p>
<example><title>Exemple de configuration d'en-tête link via mod_headers</title>
@@ -343,9 +346,13 @@ Protocols h2 h2c http/1.1
une ressource n'a pas déjà été "pushée" vers un client.
</p>
<p>
- Les server pushes HTTP/2 sont activés par défaut. Cette
- directive permet de désactiver cette fonctionnalité pour
- le serveur virtuel ou non considéré.
+ Les PUSH HTTP/2 sont activés par défaut. Vous pouvez
+ activer/désactiver cette fonctionnalité pour toute connexion au
+ serveur au niveau global ou serveur virtuel. Vous pouvez en
+ outre désactiver PUSH pour un jeu de ressources dans une
+ section Directory/Location. Notez que ceci permet de contrôler
+ quelles ressources peuvent déclencher un PUSH, mais pas les
+ ressources qui peuvent être envoyées via PUSH.
</p>
<example><title>Exemple</title>
<highlight language="config">
@@ -560,6 +567,8 @@ H2PushPriority text/css interleaved
<contextlist>
<context>server config</context>
<context>virtual host</context>
+ <context>directory</context>
+ <context>.htaccess</context>
</contextlist>
<usage>
@@ -1185,5 +1194,50 @@ H2PushPriority text/css interleaved
</p>
</usage>
</directivesynopsis>
+
+ <directivesynopsis>
+ <name>H2Padding</name>
+ <description>Spécifie un intervalle de nombres d'octets de bourrage à
+ ajouter aux trames utiles</description>
+ <syntax>H2Padding numbits</syntax>
+ <default>H2Padding 0</default>
+ <contextlist>
+ <context>server config</context>
+ <context>virtual host</context>
+ </contextlist>
+ <compatibility>Disponible à partir de la version 2.4.39 du serveur HTTP
+ Apache.</compatibility>
+
+ <usage>
+ <p>
+ La valeur par défaut 0 indique qu'aucun octet de bourrage ne
+ sera ajouté aux trames utiles comme HEADERS, DATA et
+ PUSH_PROMISE. Ceci correspond au comportement des versions
+ précédentes. Dans ce cas et sous certaines conditions, un
+ observateur du trafic réseau pourra alors déterminer la longueur
+ de ces trames dans le flux TLS.
+ </p>
+ <p>
+ Si on attribue à numbits la valeur 1-8, un nombre aléatoire
+ d'octets entre 0 et 2^numbits sont ajoutés à chaque trame. Une
+ valeur aléatoire d'octets de bourrage est attribué
+ indépendamment à chaque trame que le module renvoie au client.
+ </p>
+ <p>
+ Pour améliorer la dissimulation de la longueur des trames, on
+ peut augmenter le nombre moyen d'octets de bourrage, mais cela
+ augmente d'autant le trafic réseau. Le nombre optimal d'octets
+ de bourrage dépend donc du type de trafic web que le serveur
+ engendre.
+ </p>
+ <p>
+ La valeur par défaut de 0 (aucun octet de bourrage) a été
+ choisie dans un but de compatibilité ascendante. Il peut en
+ effet exister des installations où les octets de bourrage ne
+ sont pas souhaités ou sont néfastes. La cause principale peut
+ provenir d'un client dont l'implémentation comporte des erreurs.
+ </p>
+ </usage>
+ </directivesynopsis>
</modulesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.xml.fr?rev=1855659&r1=1855658&r2=1855659&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.xml.fr [utf-8] Sat Mar 16 15:08:18 2019
@@ -1,7 +1,7 @@
<?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: 1853625 -->
+<!-- English Revision: 1855413 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -53,11 +53,12 @@ données pour la réception des requête
<ol>
<li>
- Accorde 10 secondes pour la réception des en-têtes de la requête
- et 30 secondes pour la réception du corps :
+ Accorde 5 secondes pour terminer la négociation TLS, 10 secondes pour la
+ réception des en-têtes de la requête et 30 secondes pour la réception du
+ corps :
<highlight language="config">
- RequestReadTimeout headerinit=10 body=30
+ RequestReadTimeout handshake=5 header=10 body=30
</highlight>
</li>
@@ -75,10 +76,10 @@ données pour la réception des requête
</li>
<li>
- Accorde au moins 10 secondes pour la réception de de la
- requête, en-têtes inclus. Si le client envoie des données, augmente ce délai
+ Accorde au moins 10 secondes pour la réception des en-têtes de la
+ requête. Si le client envoie des données, augmente ce délai
d'une seconde pour chaque paquet de 500 octets reçus, mais
- n'alloue que 30 secondes pour la requête, en-têtes inclus :
+ n'alloue que 30 secondes pour les en-têtes de la requête :
<highlight language="config">
RequestReadTimeout header=10-30,MinRate=500
@@ -101,86 +102,90 @@ données pour la réception des requête
<directivesynopsis>
<name>RequestReadTimeout</name>
-<description>Définit des délais maximums pour la réception des en-têtes
-et corps des requêtes en provenance du client.
+<description>Définit des délais maximums pour la négociation TLS, la réception
+des en-têtes et/ou corps des requêtes en provenance du client.
</description>
<syntax>RequestReadTimeout
-[header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
-[body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
+[handshake=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]
+[header=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>MinRate</var>]
+[body=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>MinRate</var>]
</syntax>
-<default>RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500</default>
+<default>RequestReadTimeout handshake=0 header=20-40,MinRate=500 body=20,MinRate=500</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP
-Apache ; désactivée par défaut depuis la version 2.3.14.</compatibility>
+Apache ; désactivée par défaut depuis la version 2.3.14. La phase de
+<code>négociation</code> est prise en compte à partir de la version 2.4.39.</compatibility>
<usage>
- <p>Cette directive permet de définir différents délais pour la
- réception des en-têtes et corps des requêtes en provenance du
- client. Si le client ne parvient pas à respecter ces délais, un code
+ <p>Cette directive permet de définir différents timeouts pour la négociation
+ TLS, la réception des en-têtes et/ou corps des requêtes en provenance du
+ client. Si le client ne parvient pas à respecter ces timeouts, un code
d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>
- <p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes
- inclut le temps nécessaire à la négociation SSL initiale. Si le
- navigateur du client est configuré pour demander des listes de
- révocations de certificats, et si le serveur correspondant n'est pas
- disponible, le délai avant lequel le navigateur va abandonner son
- attente de CRL au cours de la négociation SSL initiale peut être
- assez important. Par conséquent, les valeurs de délais d'en-têtes ne
- doivent pas être trop basses pour les serveurs virtuels SSL. Le délai
- concernant le corps inclut le temps nécessaire à la renégociation
- SSL (si elle est nécessaire).</p>
-
- <p>Lorsqu'une directive <directive
- module="core">AcceptFilter</directive> est active (ce qui est en
- général le cas sous Linux et FreeBSD), la socket n'est envoyée au
- processus du serveur qu'après la réception du premier octet (ou de
- l'ensemble de la requête si <code>httpready</code> est défini). Le
- délai configuré pour les en-têtes via la directive
- <directive>RequestReadTimeout</directive> n'entre en ligne de compte qu'une fois
- la socket reçue par le processus du serveur.</p>
+ <p>Pour les serveurs virtuels SSL, la valeur de timeout pour la
+ <code>négociation</code> correspond au temps nécessaire pour la négociation
+ SSL initiale. Si le navigateur du client est configuré pour demander des
+ listes de révocations de certificats, et si le serveur correspondant n'est
+ pas disponible, le timeout avant lequel le navigateur va abandonner son
+ attente de CRL au cours de la négociation SSL initiale peut être assez
+ important. Par conséquent, les valeurs de timeouts pour la
+ <code>négociation</code> doivent prendre en compte un temps supplémentaire
+ pour les serveurs virtuels SSL (si nécessaire). Le timeout concernant le
+ corps inclut le temps nécessaire à la renégociation SSL (si elle est
+ nécessaire).</p>
+
+ <p>Lorsqu'une directive <directive module="core">AcceptFilter</directive>
+ est active (ce qui est en général le cas sous Linux et FreeBSD), la socket
+ n'est envoyée au processus du serveur qu'après la réception du premier octet
+ (ou de l'ensemble de la requête si <code>httpready</code> est défini). Les
+ timeouts configurés pour la négociation et les en-têtes via la directive
+ <directive>RequestReadTimeout</directive> n'entrent en ligne de compte
+ qu'une fois le socket reçu par le processus du serveur.</p>
- <p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
- ou le corps) :
+ <p>Il existe trois méthodes pour spécifier le timeout pour chacune des trois
+ phases (négociation, en-tête ou corps) :
</p>
<ul>
- <li><strong>Valeur de délai fixe</strong>:<br />
+ <li><strong>Valeur de timeout fixe</strong>:<br />
- <example><var>type</var>=<var>délai</var></example>
+ <example><var>phase</var>=<var>timeout</var></example>
- <p>Le temps en secondes alloué pour la lecture des en-têtes ou du
- corps de la requête. La valeur 0 signifie aucune limite.</p>
+ <p>Le temps en secondes alloué pour terminer l'ensemble de la phase
+ (négociation, lecture de tous les en-têtes de la requête ou du corps de
+ cette dernière). La valeur 0 signifie aucune limite.</p>
</li>
<li><strong>Désactivation du module pour un serveur virtuel</strong>:<br />
- <example>header=0 body=0</example>
+ <example>handshake=0 header=0 body=0</example>
<p>Avec cet exemple, le module <module>mod_reqtimeout</module> est
- complètement désactivé.</p>
+ complètement désactivé (notez que <code>handshake=0</code> correspond à la
+ valeur par défaut et peut donc être omis).</p>
</li>
- <li><strong>La valeur du délai qui est augmentée lorsque des données
+ <li><strong>La valeur du timeout qui est augmentée lorsque des données
sont reçues</strong> :<br />
<example>
- <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
+ <var>phase</var>=<var>timeout</var>,MinRate=<var>débit</var>
</example>
<p>Identique à ce qui précède, mais chaque fois que des données sont
- reçues, la valeur du délai est augmentée en fonction du taux-mini
+ reçues, la valeur du timeout est augmentée en fonction du MinRate
spécifié (en octets par seconde).</p>
</li>
- <li><strong>La valeur du délai augmente lorsque des données sont
+ <li><strong>La valeur du timeout augmente lorsque des données sont
reçues, jusqu'à une limite supérieure</strong>:<br />
<example>
- <var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>
+ <var>phase</var>=<var>timeout</var>-<var>maxtimeout</var>,MinRate=<var>débit</var>
</example>
- <p>Identique à ce qui précède, mais le délai n'augmentera pas au
- delà de la borne supérieure du délai spécifiée.</p>
+ <p>Identique à ce qui précède, mais le timeout n'augmentera pas au
+ delà de la borne supérieure du timeout spécifiée.</p>
</li>
</ul>
Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/rewritemap.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/rewritemap.xml.fr?rev=1855659&r1=1855658&r2=1855659&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/rewritemap.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/rewritemap.xml.fr [utf-8] Sat Mar 16 15:08:18 2019
@@ -1,7 +1,7 @@
<?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: 1828122 -->
+<!-- English Revision: 1855357 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : VIncent Deffontaines -->
<!--
@@ -153,7 +153,6 @@ exemples pour chacun d'entre eux.</p>
<p> <strong>Redirige un URI vers son équivalent en minuscules</strong></p>
<highlight language="config">
-
RewriteMap lc int:tolower
RewriteRule "(.*)" "${lc:$1}" [R]
</highlight>