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:09:12 UTC
svn commit: r1855660 [1/2] - in /httpd/httpd/branches/2.4.x/docs/manual/mod:
directives.html.fr.utf8 mod_http2.html.fr.utf8 mod_reqtimeout.html.fr.utf8
quickreference.html.fr.utf8
Author: lgentis
Date: Sat Mar 16 15:09:12 2019
New Revision: 1855660
URL: http://svn.apache.org/viewvc?rev=1855660&view=rev
Log:
fr doc rebuild.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/directives.html.fr.utf8
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.html.fr.utf8
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.html.fr.utf8
httpd/httpd/branches/2.4.x/docs/manual/mod/quickreference.html.fr.utf8
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/directives.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/directives.html.fr.utf8?rev=1855660&r1=1855659&r2=1855660&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/directives.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/directives.html.fr.utf8 [utf-8] Sat Mar 16 15:09:12 2019
@@ -298,6 +298,7 @@
<li><a href="mod_http2.html#h2maxworkers">H2MaxWorkers</a></li>
<li><a href="mod_http2.html#h2minworkers">H2MinWorkers</a></li>
<li><a href="mod_http2.html#h2moderntlsonly">H2ModernTLSOnly</a></li>
+<li><a href="mod_http2.html#h2padding">H2Padding</a></li>
<li><a href="mod_http2.html#h2push">H2Push</a></li>
<li><a href="mod_http2.html#h2pushdiarysize">H2PushDiarySize</a></li>
<li><a href="mod_http2.html#h2pushpriority">H2PushPriority</a></li>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.html.fr.utf8?rev=1855660&r1=1855659&r2=1855660&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_http2.html.fr.utf8 [utf-8] Sat Mar 16 15:09:12 2019
@@ -90,6 +90,7 @@
<li><img alt="" src="../images/down.gif" /> <a href="#h2maxworkers">H2MaxWorkers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2minworkers">H2MinWorkers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2moderntlsonly">H2ModernTLSOnly</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#h2padding">H2Padding</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2push">H2Push</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2pushdiarysize">H2PushDiarySize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2pushpriority">H2PushPriority</a></li>
@@ -495,12 +496,55 @@
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="h2padding" id="h2padding">Directive</a> <a name="H2Padding" id="H2Padding">H2Padding</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie un intervalle de nombres d'octets de bourrage à
+ ajouter aux trames utiles</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Padding numbits</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Padding 0</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.39 du serveur HTTP
+ Apache.</td></tr>
+</table>
+ <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>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="h2push" id="h2push">Directive</a> <a name="H2Push" id="H2Push">H2Push</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/désactivation du server push H2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Push on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Push on</code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.18 du serveur HTTP
@@ -535,6 +579,7 @@
<p>
Les en-têtes link des réponses sont soit définis par
l'application, soit configurés via
+ <code class="directive">H2PushResource</code> ou
<code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> comme suit :
</p>
<div class="example"><h3>Exemple de configuration d'en-tête link via mod_headers</h3><pre class="prettyprint lang-config"><Location /index.html>
@@ -550,9 +595,13 @@
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>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2Push off</pre>
</div>
@@ -934,7 +983,7 @@ H2PushPriority text/css interleaved
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/Désactivation du protocole de mise à jour H2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Upgrade on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Upgrade on pour h2c, off pour h2</code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr>
</table>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.html.fr.utf8?rev=1855660&r1=1855659&r2=1855660&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_reqtimeout.html.fr.utf8 [utf-8] Sat Mar 16 15:09:12 2019
@@ -66,10 +66,11 @@ 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 :
- <pre class="prettyprint lang-config">RequestReadTimeout headerinit=10 body=30</pre>
+ <pre class="prettyprint lang-config">RequestReadTimeout handshake=5 header=10 body=30</pre>
</li>
@@ -85,10 +86,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 :
<pre class="prettyprint lang-config">RequestReadTimeout header=10-30,MinRate=500</pre>
@@ -109,85 +110,90 @@ données pour la réception des requête
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="requestreadtimeout" id="requestreadtimeout">Directive</a> <a name="RequestReadTimeout" id="RequestReadTimeout">RequestReadTimeout</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des délais maximums pour la réception des en-têtes
-et corps des requêtes en provenance du client.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>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.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>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>]
</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>RequestReadTimeout handshake=0 header=20-40,MinRate=500 body=20,MinRate=500</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_reqtimeout</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.15 du serveur HTTP
-Apache ; désactivée par défaut depuis la version 2.3.14.</td></tr>
+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.</td></tr>
</table>
- <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 <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> 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
- <code class="directive">RequestReadTimeout</code> 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 <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code>
+ 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
+ <code class="directive">RequestReadTimeout</code> 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 />
- <div class="example"><p><code><var>type</var>=<var>délai</var></code></p></div>
+ <div class="example"><p><code><var>phase</var>=<var>timeout</var></code></p></div>
- <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 />
- <div class="example"><p><code>header=0 body=0</code></p></div>
+ <div class="example"><p><code>handshake=0 header=0 body=0</code></p></div>
<p>Avec cet exemple, le module <code class="module"><a href="../mod/mod_reqtimeout.html">mod_reqtimeout</a></code> 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 />
<div class="example"><p><code>
- <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
+ <var>phase</var>=<var>timeout</var>,MinRate=<var>débit</var>
</code></p></div>
<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 />
<div class="example"><p><code>
- <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>
</code></p></div>
- <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>