<?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 : 1897755 -->
+<!-- English Revision : 1910699 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</usage>
</directivesynopsis>
- <directivesynopsis>
- <name>H2Timeout</name>
- <description>Délai (en secondes) pour les connexions HTTP/2</description>
- <syntax>H2Timeout secondes</syntax>
- <default>H2Timeout 5</default>
- <contextlist>
- <context>server config</context>
- <context>virtual host</context>
- </contextlist>
- <compatibility>Disponible à partir de la version 2.4.19 du serveur HTTP
- Apache.</compatibility>
-
- <usage>
- <p>
- Cette directive permet de définir un délai pour les opérations
- de lecture/écriture lorsqu'une connexion HTTP/2 a été
- négociée. Elle peut être définie pour l'ensemble du serveur ou
- pour un <directive module="core" type="section">serveur
- virtuel</directive> spécifique.
- </p>
- <p>
- Elle est similaire à la directive <directive module="core"
- type="section">Timeout</directive>, mais elle ne s'applique
- qu'aux connexions HTTP/2.
- </p>
- <p>
- Une valeur de 0 signifie qu'aucun délai n'est imposé.
- </p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>H2KeepAliveTimeout</name>
- <description>Durée de vie en secondes des connexions HTTP/2 inactives</description>
- <syntax>H2KeepAliveTimeout secondes</syntax>
- <contextlist>
- <context>server config</context>
- <context>virtual host</context>
- </contextlist>
- <compatibility>Disponible à partir de la version 2.4.19 du serveur HTTP
- Apache.</compatibility>
-
- <usage>
- <p>
- Cette directive permet de définir la durée de vie des connexions
- HTTP/2 inactives. Sa portée peut s'étendre à l'ensemble du
- serveur, ou seulement à un <directive module="core"
- type="section">VirtualHost</directive> spécifique.
- </p>
- <p>
- Cette directive est équivalente à la directive <directive
- module="core" type="section">KeepAliveTimeout</directive>, mais
- elle ne s'applique qu'aux connexions HTTP/2. Une connexion
- HTTP/2 est considérée comme inactive lorsqu'aucun flux n'est
- ouvert, autrement dit lorsqu'aucune requête n'est sur le point
- d'être traitée.
- </p>
- <p>
- Pour les MPMs non-asynch (prefork, worker), la durée de vie
- sera par défaut égale à H2Timeout. Pour les MPMs async, il
- semble qu'aucune action ne soit à entreprendre pour la durée de
- vie des connexions HTTP/1.
- </p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>H2StreamTimeout</name>
- <description>Durée de vie en secondes des connexions HTTP/2 inactives</description>
- <syntax>H2StreamTimeout secondes</syntax>
- <default>H2StreamTimeout 0</default>
- <contextlist>
- <context>server config</context>
- <context>virtual host</context>
- </contextlist>
- <compatibility>Disponible à partir de la version 2.4.19 du serveur HTTP
- Apache.</compatibility>
-
- <usage>
- <p>
- Cette directive permet de définir la durée de vie des flux
- HTTP/2 pour les requêtes individuelles. Sa portée peut s'étendre
- à l'ensemble du serveur, ou seulement à un <directive
- module="core" type="section">VirtualHost</directive> spécifique
- </p>
- <p>
- De par la nature de HTTP/2 qui transmet plusieurs requêtes sur
- une seule connexion et gère une planification des priorités, les
- flux individuels ne sont pas susceptibles de recevoir des
- données en entrée beaucoup plus longtemps qu'une connexion
- HTTP/1.1.
- </p>
- <p>
- Si cette directive est définie à 0, la durée de vie des flux
- HTTP/2 n'a aucune limite, et il peuvent attendre indéfiniment
- l'arrivée de données à lire ou écrire. Cela expose cependant le
- serveur à atteindre sa limite en nombre de threads.
- </p>
- <p>
- Un site peut nécessiter une augmentation de cette valeur en
- fonction de votre gestion des flux PUSHés, des priorités et de
- la réactivité générale. Par exemple, si vous PUSHez une
- ressource de taille importante <em>avant</em> celle qui a fait
- l'objet d'une requête, le flux initiale n'effectuera aucune
- écriture jusqu'à ce que la ressource PUSHée ne soit envoyée dans
- son intégralité.
- </p>
- </usage>
- </directivesynopsis>
-
<directivesynopsis>
<name>H2CopyFiles</name>
<description>Contrôle la gestion des fichiers dans les réponses</description>
d'inter-opérations avec certaines versions de gRPC.
</p>
</usage>
+ </directivesynopsis>
+
+ <directivesynopsis>
+ <name>H2StreamTimeout</name>
+ <description>Temps d'attente maximum lors de l'envoi/réception de
+ données pour le traitement d'un flux</description>
+ <syntax>H2StreamTimeout <var>time-interval</var>[s]</syntax>
+ <default>La valeur de la directive <directive module="core">Timeout</directive></default>
+ <contextlist>
+ <context>server config</context>
+ <context>virtual host</context>
+ <context>directory</context>
+ </contextlist>
+ <compatibility>Disponible à partir de la version 2.5.1 du serveur HTTP
+ Apache.</compatibility>
+
+ <usage>
+ <p>
+ <directive>H2StreamTimeout</directive> permet de spécifier le
+ temps maximum pendant lequel un flux en cours de traitement
+ attendra pour l'envoi/réception de ses données.
+ </p>
+ </usage>
+ </directivesynopsis>
+
+ <directivesynopsis>
+ <name>H2MaxDataFrameLen</name>
+ <description>Nombre maximal d'octets dans une trame HTTP/2 DATA</description>
+ <syntax>H2MaxDataFrameLen <em>n</em></syntax>
+ <default>H2MaxDataFrameLen 0</default>
+ <contextlist>
+ <context>server config</context>
+ <context>virtual host</context>
+ </contextlist>
+ <compatibility>Disponible à partir de la version 2.5.1 du serveur HTTP
+ Apache.</compatibility>
+
+ <usage>
+ <p>
+ La directive <directive>H2MaxDataFrameLen</directive> permet de
+ définir le nombre maximal d'octets du corps de réponse que l'on
+ peut placer dans une seule trame HTTP/2 DATA. La valeur 0
+ signifie aucune limite (mais la taille maximale permise par le
+ protocole est respectée).
+ </p><p>
+ Par défaut, le module essaie d'utiliser la taille maximale
+ possible qui est d'environ 16 Ko. Il s'agit cependant de la
+ taille maximale, et lorsque la taille des données de la réponse
+ est inférieure, les trames envoyées sont plus courtes.
+ </p>
+ </usage>
+ </directivesynopsis>
+
+ <directivesynopsis>
+ <name>H2EarlyHint</name>
+ <description>Ajoute un en-tête de réponse à consulter dans le code de
+ retour 103 Early Hints</description>
+ <syntax>H2EarlyHint <em>name</em> <em>value</em></syntax>
+ <contextlist>
+ <context>server config</context>
+ <context>virtual host</context>
+ <context>directory</context>
+ <context>.htaccess</context>
+ </contextlist>
+ <compatibility>Disponible à partir de la version 2.5.1 du serveur HTTP
+ Apache.</compatibility>
+
+ <usage>
+ <p>
+ La directive <directive>H2EarlyHint</directive> permet d'ajouter
+ un en-tête de réponse avant le démarrage du traitement
+ proprement dit de la requête. Les en-têtes de ce style sont
+ consultables dans les réponses intermédiaires "103 Early Hints"
+ et ils ont pour but principal d'envoyer des informations de
+ "préchargement" aux navigateurs clients.
+ </p><p>
+ <em>name</em> et <em>value</em> doivent être des champs
+ d'en-tête HTTP valables sous peine de provoquer des échecs de
+ réponse. La directive <directive>H2EarlyHints</directive> doit
+ encore être activée pour permettre l'envoi de réponses
+ intermédiaires de code 103. Elle peut être répétée plusieurs
+ fois et les champs d'en-tête de même nom s'ajoutent.
+ </p>
+ <example><title>Exemple</title>
+ <highlight language="config">
+H2EarlyHint Link "</my.css>;rel=preload;as=style"
+ </highlight>
+ </example>
+ </usage>
</directivesynopsis>
</modulesynopsis>
projects / thirdparty / apache / httpd.git / commitdiff
