Commit 9c2ee51a authored by Lucien Gentis's avatar Lucien Gentis
Browse files

fr doc rebuild.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1855660 13f79535-47bb-0310-9956-ffa450edef68
parent 747956b4
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -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>
+54 −5
Original line number Diff line number Diff line
@@ -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>
@@ -493,6 +494,49 @@
            <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2ModernTLSOnly off</pre>
</div>
        
</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>
@@ -500,7 +544,7 @@
<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">&lt;Location /index.html&gt;
@@ -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 # poids de 256 par défaut</pre>
<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>
+55 −49
Original line number Diff line number Diff line
@@ -66,10 +66,11 @@ données pour la réception des requêtes

    <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êtes
      </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êtes
<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>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
    ou le corps) :
    <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 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>
+495 −492

File changed.

Preview size limit exceeded, changes collapsed.