httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject 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
Date Sat, 16 Mar 2019 15:08:18 GMT
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>



Mime
View raw message