granicus.if.org Git - apache/blob - docs/manual/mod/mod_reqtimeout.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1421821:1827780 (outdated) -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- $LastChangedRevision: 2013010301 $ -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_reqtimeout.xml.meta">
  26
  27 <name>mod_reqtimeout</name>
  28 <description>Définit le délai maximum et le taux de transfert des
  29 données minimum pour la réception des requêtes
  30 </description>
  31 <status>Extension</status>
  32 <sourcefile>mod_reqtimeout.c</sourcefile>
  33 <identifier>reqtimeout_module</identifier>
  34
  35 <section id="examples"><title>Exemples</title>
  36
  37     <ol>
  38       <li>
  39         Accorde 10 secondes pour la réception des en-têtes de la requête
  40         et 30 secondes pour la réception du corps :
  41
  42         <highlight language="config">
  43           RequestReadTimeout headerinit=10 body=30
  44         </highlight>
  45       </li>
  46
  47       <li>
  48         Accorde au moins 10 secondes pour la réception du corps de
  49         la requête. Si le client envoie des données, augmente ce délai
  50         d'une seconde pour chaque paquet de 1000 octets reçus, sans
  51         limite supérieure (sauf si une limite a été
  52         spécifiée via la directive <directive
  53         module="core">LimitRequestBody</directive>) :
  54
  55         <highlight language="config">
  56           RequestReadTimeout body=10,MinRate=1000
  57         </highlight>
  58       </li>
  59
  60       <li>
  61         Accorde au moins 10 secondes pour la réception de de la
  62         requête, en-têtes inclus. Si le client envoie des données, augmente ce délai
  63         d'une seconde pour chaque paquet de 500 octets reçus, mais
  64         n'alloue que 30 secondes pour la requête, en-têtes inclus :
  65
  66         <highlight language="config">
  67           RequestReadTimeout header=10-30,MinRate=500
  68         </highlight>
  69       </li>
  70
  71       <li>
  72         En général, un serveur doit avoir ses délais d'en-tête et de
  73         corps configurés. Si les serveurs virtuels http et https
  74         utilisent une configuration commune, les délais ne doivent pas
  75         être définis trop bas :
  76
  77         <highlight language="config">
  78           RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
  79         </highlight>
  80       </li>
  81
  82     </ol>
  83 </section>
  84
  85 <directivesynopsis>
  86 <name>RequestReadTimeout</name>
  87 <description>Définit des délais maximums pour la réception des en-têtes
  88 et corps des requêtes en provenance du client.
  89 </description>
  90 <syntax>RequestReadTimeout
  91 [header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
  92 [body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
  93 </syntax>
  94 <default>header=20-40,MinRate=500 body=20,MinRate=500</default>
  95 <contextlist><context>server config</context><context>virtual host</context>
  96 </contextlist>
  97 <compatibility>Désactivée par défaut jusqu'à la version 2.3.14.</compatibility>
  98
  99 <usage>
 100     <p>Cette directive permet de définir différents délais pour la
 101     réception des en-têtes et corps des requêtes en provenance du
 102     client. Si le client ne parvient pas à respecter ces délais, un code
 103     d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>
 104
 105     <p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes
 106     inclut le temps nécessaire à la négociation SSL initiale. Si le
 107     navigateur du client est configuré pour demander des listes de
 108     révocations de certificats, et si le serveur correspondant n'est pas
 109     disponible, le délai avant lequel le navigateur va abandonner son
 110     attente de CRL au cours de la négociation SSL initiale peut être
 111     assez important. Par conséquent, les valeurs de délais d'en-têtes ne
 112     doivent pas être trop basses pour les serveurs virtuels SSL. Le délai
 113     concernant le corps inclut le temps nécessaire à la renégociation
 114     SSL (si elle est nécessaire).</p>
 115
 116     <p>Lorsqu'une directive <directive
 117     module="core">AcceptFilter</directive> est active (ce qui est en
 118     général le cas sous Linux et FreeBSD), le socket n'est envoyé au
 119     processus du serveur qu'après la réception du premier octet (ou de
 120     l'ensemble de la requête si <code>httpready</code> est défini). Le
 121     délai configuré pour les en-têtes via la directive
 122     <code>RequestReadTimeout</code> n'entre en ligne de compte qu'une fois
 123     le socket reçu par le processus du serveur.</p>
 124
 125     <p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
 126     ou le corps) :
 127     </p>
 128
 129     <ul>
 130
 131     <li><strong>Valeur de délai fixe</strong>:<br />
 132
 133     <example><var>type</var>=<var>délai</var></example>
 134
 135     <p>Le temps en secondes alloué pour la lecture des en-têtes ou du
 136     corps de la requête. La valeur 0 signifie aucune limite.</p>
 137     </li>
 138
 139     <li><strong>Désactivation du module pour un serveur virtuel :</strong>:<br />
 140
 141     <example>header=0 body=0</example>
 142
 143     <p>Avec cet exemple, le module <module>mod_reqtimeout</module> est
 144     complètement désactivé.</p>
 145     </li>
 146
 147     <li><strong>La valeur du délai qui est augmentée lorsque des données
 148     sont reçues</strong> :<br />
 149     <example>
 150     <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
 151     </example>
 152
 153     <p>Identique à ce qui précède, mais chaque fois que des données sont
 154     reçues, la valeur du délai est augmentée en fonction du taux-mini
 155     spécifié (en octets par seconde).</p>
 156     </li>
 157
 158     <li><strong>La valeur du délai augmente lorsque des données sont
 159     reçues, jusqu'à une limite supérieure</strong>:<br />
 160     <example>
 161     <var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>
 162     </example>
 163
 164     <p>Identique à ce qui précède, mais le délai n'augmentera pas au
 165     delà de la borne supérieure du délai spécifiée.</p>
 166     </li>
 167
 168     </ul>
 169
 170
 171
 172
 173 </usage>
 174
 175 </directivesynopsis>
 176
 177 </modulesynopsis>