1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mpm_common - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Apache MPM : Directives Communes</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/de/mod/mpm_common.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 28<a href="/en/mod/mpm_common.html" hreflang="en" rel="alternate" title="English"> en </a> | 29<a href="/fr/mod/mpm_common.html" title="Fran�ais"> fr </a> | 30<a href="/ja/mod/mpm_common.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 31<a href="/tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 32</div> 33<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Une s�rie de directives impl�ment�es par plusieurs 34modules multi-processus (MPM)</td></tr> 35<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr></table> 36</div> 37<div id="quickview"><h3 class="directives">Directives</h3> 38<ul id="toc"> 39<li><img alt="" src="/images/down.gif" /> <a href="#coredumpdirectory">CoreDumpDirectory</a></li> 40<li><img alt="" src="/images/down.gif" /> <a href="#enableexceptionhook">EnableExceptionHook</a></li> 41<li><img alt="" src="/images/down.gif" /> <a href="#gracefulshutdowntimeout">GracefulShutdownTimeout</a></li> 42<li><img alt="" src="/images/down.gif" /> <a href="#listen">Listen</a></li> 43<li><img alt="" src="/images/down.gif" /> <a href="#listenbacklog">ListenBackLog</a></li> 44<li><img alt="" src="/images/down.gif" /> <a href="#maxconnectionsperchild">MaxConnectionsPerChild</a></li> 45<li><img alt="" src="/images/down.gif" /> <a href="#maxmemfree">MaxMemFree</a></li> 46<li><img alt="" src="/images/down.gif" /> <a href="#maxrequestworkers">MaxRequestWorkers</a></li> 47<li><img alt="" src="/images/down.gif" /> <a href="#maxsparethreads">MaxSpareThreads</a></li> 48<li><img alt="" src="/images/down.gif" /> <a href="#minsparethreads">MinSpareThreads</a></li> 49<li><img alt="" src="/images/down.gif" /> <a href="#pidfile">PidFile</a></li> 50<li><img alt="" src="/images/down.gif" /> <a href="#receivebuffersize">ReceiveBufferSize</a></li> 51<li><img alt="" src="/images/down.gif" /> <a href="#scoreboardfile">ScoreBoardFile</a></li> 52<li><img alt="" src="/images/down.gif" /> <a href="#sendbuffersize">SendBufferSize</a></li> 53<li><img alt="" src="/images/down.gif" /> <a href="#serverlimit">ServerLimit</a></li> 54<li><img alt="" src="/images/down.gif" /> <a href="#startservers">StartServers</a></li> 55<li><img alt="" src="/images/down.gif" /> <a href="#startthreads">StartThreads</a></li> 56<li><img alt="" src="/images/down.gif" /> <a href="#threadlimit">ThreadLimit</a></li> 57<li><img alt="" src="/images/down.gif" /> <a href="#threadsperchild">ThreadsPerChild</a></li> 58<li><img alt="" src="/images/down.gif" /> <a href="#threadstacksize">ThreadStackSize</a></li> 59</ul> 60<ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 61 62<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 63<div class="directive-section"><h2><a name="CoreDumpDirectory" id="CoreDumpDirectory">CoreDumpDirectory</a> <a name="coredumpdirectory" id="coredumpdirectory">Directive</a></h2> 64<table class="directive"> 65<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le r�pertoire dans lequel le serveur HTTP Apache va tenter de se 66positionner avant d'effectuer un vidage m�moire</td></tr> 67<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CoreDumpDirectory <var>r�pertoire</var></code></td></tr> 68<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour le r�pertoire par d�faut</code></td></tr> 69<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 70<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 71<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 72</table> 73 <p>Cette directive permet de d�finir le r�pertoire dans lequel 74 Apache httpd va tenter de se positionner avant d'effectuer un vidage 75 m�moire sur disque. 76 Si votre syst�me d'exploitation est configur� pour cr�er des 77 fichiers de vidage m�moire dans le r�pertoire de travail des 78 processus qui se sont crash�s, 79 <code class="directive">CoreDumpDirectory</code> est n�cessaire pour 80 d�finir un r�pertoire de travail autre que le r�pertoire par d�faut 81 <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>, ce r�pertoire de 82 travail ne devant pas �tre accessible en �criture par l'utilisateur sous 83 lequel le serveur s'ex�cute.</p> 84 85 <p>Si vous avez besoin d'un vidage m�moire pour le d�bogage, vous 86 pouvez utiliser cette directive pour le placer � un endroit 87 diff�rent. Cette directive n'a aucun effet si votre syst�me 88 d'exploitation n'est pas configur� pour cr�er des 89 fichiers de vidage m�moire dans le r�pertoire de travail des 90 processus qui se sont crash�s.</p> 91 92 <div class="note"><h3>Vidages m�moire sous Linux</h3> 93 <p>Si Apache httpd est d�marr� sous l'utilisateur root puis bascule vers 94 un autre utilisateur, le noyau Linux <em>d�sactive</em> les 95 vidages m�moire, m�me si le r�pertoire est accessible en �criture au 96 processus. Apache httpd (versions 2.0.46 et sup�rieures) r�active les 97 vidages m�moire sous Linux 2.4 et au del�, mais seulement si vous 98 d�finissez une directive <code class="directive">CoreDumpDirectory</code>.</p> 99 </div> 100 101 <div class="note"> 102 <h3>Vidages m�moire sous BSD</h3> 103 <p>Pour activer le vidage m�moire des ex�cutables suid sur les 104 syst�mes de style BSD (comme FreeBSD), d�finissez 105 <code>kern.sugid_coredump</code> � 1. 106 </p> 107 </div> 108 109 <div class="note"><h3>Signaux sp�cifiques</h3> 110 <p><code class="directive">CoreDumpDirectory</code> n'est trait� qu'� la 111 reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT, 112 SIGSEGV, et SIGBUS.</p> 113 <p> 114 Sur certains syst�mes d'exploitation, SIGQUIT provoque aussi un 115 vidage m�moire, mais n'est pas trait� par les directives 116 <code class="directive">CoreDumpDirectory</code> ou 117 <code class="directive">EnableExceptionHook</code>, si bien que la 118 d�finition du r�pertoire d'enregistrement du vidage m�moire est 119 enti�rement d�volue au syst�me d'exploitation.</p> 120 </div> 121 122</div> 123<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 124<div class="directive-section"><h2><a name="EnableExceptionHook" id="EnableExceptionHook">EnableExceptionHook</a> <a name="enableexceptionhook" id="enableexceptionhook">Directive</a></h2> 125<table class="directive"> 126<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un hook ("point d'accrochage logiciel") qui ex�cute des 127gestionnaires d'exception apr�s un crash</td></tr> 128<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableExceptionHook On|Off</code></td></tr> 129<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>EnableExceptionHook Off</code></td></tr> 130<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 131<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 132<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 133</table> 134 <p>Pour des raisons de s�curit�, cette directive n'est disponible 135 que si la compilation du serveur a �t� configur�e avec l'option 136 <code>--enable-exception-hook</code>. Elle permet d'activer un hook 137 ("point d'accrochage logiciel") 138 qui autorise certains modules externes � effectuer un branchement et 139 accomplir telle ou telle action apr�s le crash d'un processus 140 enfant.</p> 141 142 <p>Deux modules, <code>mod_whatkilledus</code> et 143 <code>mod_backtrace</code> utilisent ce hook. Veuillez vous 144 r�f�rer � la <a href="http://people.apache.org/~trawick/exception_hook.html">page EnableExceptionHook</a> de Jeff Trawick pour plus 145 d'informations � leur sujet.</p> 146 147</div> 148<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 149<div class="directive-section"><h2><a name="GracefulShutdownTimeout" id="GracefulShutdownTimeout">GracefulShutdownTimeout</a> <a name="gracefulshutdowntimeout" id="gracefulshutdowntimeout">Directive</a></h2> 150<table class="directive"> 151<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie le d�lai maximum apr�s lequel le serveur va 152s'arr�ter dans le cas d'un arr�t "en douceur"</td></tr> 153<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GracefulShutDownTimeout <var>secondes</var></code></td></tr> 154<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>GracefulShutDownTimeout 0</code></td></tr> 155<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 156<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 157<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code>, <code class="module"><a href="/mod/event.html">event</a></code></td></tr> 158<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans les versions 2.2 et sup�rieures</td></tr> 159</table> 160 <p>La directive <code class="directive">GracefulShutdownTimeout</code> 161 permet de sp�cifier le temps, en secondes, pendant lequel le serveur 162 va continuer � fonctionner apr�s avoir re�u un signal 163 "graceful-stop" ("Arr�t en douceur"), afin de terminer le traitement 164 des connexions en cours.</p> 165 166 <p>D�finir cette valeur � z�ro signifie au serveur d'attendre 167 jusqu'� ce que toutes les requ�tes en cours aient �t� trait�es.</p> 168 169</div> 170<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 171<div class="directive-section"><h2><a name="Listen" id="Listen">Listen</a> <a name="listen" id="listen">Directive</a></h2> 172<table class="directive"> 173<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les adresses IP et ports sur lesquels le serveur �coute</td></tr> 174<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Listen [<var>adresse IP</var>:]<var>num�ro port</var> 175[<var>protocole</var>]</code></td></tr> 176<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 177<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 178<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code>, <code class="module"><a href="/mod/event.html">event</a></code></td></tr> 179<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>L'argument <var>protocole</var> est support� depuis la version 1802.1.5</td></tr> 181</table> 182 <p>La directive <code class="directive">Listen</code> permet de signifier � 183 Apache httpd de ne se mettre � l'�coute que sur les adresses IP et ports sp�cifi�s ; par 184 d�faut, le serveur r�pond aux requ�tes en provenance de toutes les 185 interfaces r�seau. La directive <code class="directive">Listen</code> est 186 dor�navant requise, et si elle est absente du fichier de 187 configuration, le serveur refusera de d�marrer. Ceci constitue un 188 changement par rapport aux versions pr�c�dentes d'Apache httpd.</p> 189 190 <p>La directive <code class="directive">Listen</code> signifie au serveur de 191 n'accepter les requ�tes entrantes que vers le port ou le couple 192 adresse-port sp�cifi�. Si seulement un port est sp�cifi�, le serveur 193 se met � l'�coute sur ce port sur toutes les interfaces r�seau. Si une adresse IP 194 et un port sont sp�cifi�s, le serveur va se mettre � l'�coute sur ce port sur 195 l'interface r�seau correspondant � l'adresse IP.</p> 196 197 <p>On peut utiliser autant de directives 198 <code class="directive">Listen</code> que n�cessaire pour sp�cifier 199 plusieurs adresses et/ou ports � �couter. Le serveur r�pondra aux 200 requ�tes vers tous les adresses et ports sp�cifi�s.</p> 201 202 <p>Par exemple, pour que le serveur accepte les connexions sur les 203 ports 80 et 8000, utilisez :</p> 204 205 <pre class="prettyprint lang-config">Listen 80 206Listen 8000</pre> 207 208 209 <p>Pour que le serveur accepte les connexions sur deux interfaces et 210 ports particuliers, sp�cifiez :</p> 211 212 <pre class="prettyprint lang-config">Listen 192.170.2.1:80 213Listen 192.170.2.5:8000</pre> 214 215 216 <p>Les adressee IPv6 doivent �tre entour�es de crochets, comme dans 217 l'exemple suivant :</p> 218 219 <pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre> 220 221 222 <p>L'argument optionnel <var>protocole</var> n'est pas n�cessaire 223 dans la plupart des configurations. S'il est absent, 224 <code>https</code> est la valeur par d�faut pour le port 443 et 225 <code>http</code> l'est pour tous les autres ports. L'argument 226 protocole sert � d�terminer quel module doit traiter une requ�te, et 227 � appliquer des optimisations sp�cifiques � certains protocoles � 228 l'aide de la directive <code class="directive"><a href="/mod/core.html#acceptfilter">AcceptFilter</a></code>.</p> 229 230 <p>La sp�cification d'un protocole n'est n�cessaire que si vous 231 utilisez des ports non standards. Par exemple, pour configurer un 232 site en <code>https</code> sur le port 8443 :</p> 233 234 <pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre> 235 236 237 <div class="note"><h3>Condition d'erreur</h3> 238 Plusieurs directives <code class="directive">Listen</code> pour les m�mes 239 adresse IP/port vont provoquer l'envoi d'un message d'erreur 240 <code>Address already in use</code>. 241 </div> 242 243 244<h3>Voir aussi</h3> 245<ul> 246<li><a href="/dns-caveats.html">Probl�mes avec DNS</a></li> 247<li><a href="/bind.html">D�finition des adresses et ports 248qu'utilise le serveur HTTP Apache</a></li> 249<li><a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Autre 250discussion � propos du message d'erreur <code>Address already in 251use</code>, citant d'autres causes possibles.</a></li> 252</ul> 253</div> 254<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 255<div class="directive-section"><h2><a name="ListenBackLog" id="ListenBackLog">ListenBackLog</a> <a name="listenbacklog" id="listenbacklog">Directive</a></h2> 256<table class="directive"> 257<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Longueur maximale de la liste d'attente des 258connexions</td></tr> 259<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ListenBacklog <var>backlog</var></code></td></tr> 260<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ListenBacklog 511</code></td></tr> 261<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 262<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 263<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 264</table> 265 <p>La longueur maximale de la liste d'attente des connexions. En 266 g�n�ral, aucune modification n'est n�cessaire, ni m�me souhaitable ; 267 cependant, sur certains syst�mes, il peut �tre n�cessaire 268 d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en 269 masse de requ�tes SYN pour saturer le serveur). Voir le param�tre 270 backlog de l'appel syst�me <code>listen(2)</code>.</p> 271 272 <p>En fait, l'argument backlog sera souvent limit� � une valeur 273 inf�rieure en fonction du syst�me d'exploitation. Notez aussi que de 274 nombreux syst�mes d'exploitation ne tiennent pas vraiment compte de 275 la valeur sp�cifi�e pour l'argument backlog, mais s'en inspirent 276 seulement (et choisissent en g�n�ral une valeur sup�rieure).</p> 277 278</div> 279<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 280<div class="directive-section"><h2><a name="MaxConnectionsPerChild" id="MaxConnectionsPerChild">MaxConnectionsPerChild</a> <a name="maxconnectionsperchild" id="maxconnectionsperchild">Directive</a></h2> 281<table class="directive"> 282<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de connexions qu'un processus enfant va 283traiter au cours de son fonctionnement</td></tr> 284<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxConnectionsPerChild <var>number</var></code></td></tr> 285<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxConnectionsPerChild 0</code></td></tr> 286<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 287<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 288<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 289<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.9 du serveur HTTP 290Apache. L'ancien nom <code>MaxRequestsPerChild</code> est encore 291support�.</td></tr> 292</table> 293 <p>La directive <code class="directive">MaxConnectionsPerChild</code> permet de 294 d�finir le nombre maximum de connexions qu'un processus enfant va 295 pouvoir traiter au cours de son fonctionnement. Lorsqu'il a trait� 296 <code class="directive">MaxConnectionsPerChild</code> connexions, le processus 297 enfant est arr�t�. Si <code class="directive">MaxConnectionsPerChild</code> est 298 d�finie � <code>0</code>, il n'y a plus aucune limite sur le nombre 299 de connexions que le processus pourra traiter.</p> 300 301 <p>D�finir <code class="directive">MaxConnectionsPerChild</code> � une valeur 302 non nulle limite la quantit� de m�moire qu'un processus peut 303 consommer � cause de fuites (accidentelles) de m�moire.</p> 304 305 306</div> 307<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 308<div class="directive-section"><h2><a name="MaxMemFree" id="MaxMemFree">MaxMemFree</a> <a name="maxmemfree" id="maxmemfree">Directive</a></h2> 309<table class="directive"> 310<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Quantit� maximale de m�moire que l'allocateur principal est 311autoris� � conserver sans appeler <code>free()</code></td></tr> 312<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxMemFree <var>KOctets</var></code></td></tr> 313<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxMemFree 2048</code></td></tr> 314<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 315<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 316<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code></td></tr> 317</table> 318 <p>La directive <code class="directive">MaxMemFree</code> permet de d�finir 319 le nombre maximum de KOctets libres que tout allocateur est 320 autoris� � conserver sans appeler <code>free()</code>. Dans les MPMs 321 thread�s, chaque thread poss�de son propre allocateur. Si elle est 322 d�finie � 0, la quantit� de m�moire libre que peut conserver un 323 allocateur est illimit�e.</p> 324 325</div> 326<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 327<div class="directive-section"><h2><a name="MaxRequestWorkers" id="MaxRequestWorkers">MaxRequestWorkers</a> <a name="maxrequestworkers" id="maxrequestworkers">Directive</a></h2> 328<table class="directive"> 329<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions pouvant �tre trait�es 330simultan�ment</td></tr> 331<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRequestWorkers <var>nombre</var></code></td></tr> 332<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 333<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 334<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 335<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 336</table> 337 <p>La directive <code class="directive">MaxRequestWorkers</code> permet de fixer le 338 nombre maximum de requ�tes pouvant �tre trait�es simultan�ment. 339 Si la limite <code class="directive">MaxRequestWorkers</code> est atteinte, toute 340 tentative de connexion sera normalement mise dans une file 341 d'attente, et ceci jusqu'� un certain nombre d�pendant de la 342 directive <code class="directive"><a href="#listenbacklog">ListenBacklog</a></code>. 343 Lorsqu'un processus enfant se lib�rera suite � la fin du traitement 344 d'une requ�te, la connexion en attente pourra �tre trait�e � son 345 tour.</p> 346 347 <p>Pour les serveurs non thread�s (<em>c'est � dire</em> utilisant 348 <code class="module"><a href="/mod/prefork.html">prefork</a></code>), la directive 349 <code class="directive">MaxRequestWorkers</code> d�finit alors le nombre maximum de 350 processus enfants qui pourront �tre lanc�s simultan�ment pour 351 traiter les requ�tes. La valeur par d�faut est <code>256</code> ; si 352 vous l'augmentez, vous devez aussi augmenter la valeur de la 353 directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p> 354 355 <p>Pour les serveur thread�s et hybrides (utilisant <em>par 356 exemple</em> <code class="module"><a href="/mod/event.html">event</a></code> ou <code class="module"><a href="/mod/worker.html">worker</a></code>), 357 <code class="directive">MaxRequestWorkers</code> d�finit alors le nombre total de 358 threads qui seront disponibles pour servir les clients. Dans le 359 cas des MPMs hybrides, la valeur par d�faut est <code>16</code> 360 (directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>) multipli� par la valeur 361 <code>25</code> (directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>). Par cons�quent, pour affecter � la 362 directive <code class="directive">MaxRequestWorkers</code> une valeur qui requiert 363 plus de 16 processus, vous devez aussi augmenter la valeur de la 364 directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p> 365 366 <p>Le nom de la directive <code class="directive">MaxRequestWorkers</code> 367 �tait <code class="directive">MaxClients</code> avant la version 2.3.13. Cet 368 ancien nom est encore support�.</p> 369 370</div> 371<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 372<div class="directive-section"><h2><a name="MaxSpareThreads" id="MaxSpareThreads">MaxSpareThreads</a> <a name="maxsparethreads" id="maxsparethreads">Directive</a></h2> 373<table class="directive"> 374<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de threads inactifs</td></tr> 375<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareThreads <var>nombre</var></code></td></tr> 376<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 377<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 378<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 379<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 380</table> 381 <p>C'est le nombre maximum de threads inactifs. Les MPMs utilisent 382 cette directive de diff�rentes mani�res.</p> 383 384 <p>Pour <code class="module"><a href="/mod/worker.html">worker</a></code>, la d�finition par d�faut est 385 <code>MaxSpareThreads 250</code>. Ce MPM g�re les threads inactifs 386 au niveau du serveur. Si le serveur poss�de trop de threads 387 inactifs, des processus enfants seront arr�t�s jusqu'� ce que le 388 nombre de threads inactifs repasse en dessous de cette limite.</p> 389 390 <p>Pour <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, la d�finition par d�faut est 391 <code>MaxSpareThreads 100</code>. Comme ce MPM n'ex�cute qu'un seul 392 processus, le nombre de processus inactifs est surveill� au 393 niveau du serveur.</p> 394 395 <p><code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de mani�re similaire � 396 <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>. Pour <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, la 397 valeur par d�faut est <code>10</code>.</p> 398 399 <div class="note"><h3>Contraintes</h3> 400 <p>La gamme de valeurs pour <code class="directive">MaxSpareThreads</code> 401 est limit�e. Apache httpd corrigera automatiquement cette valeur selon 402 les r�gles suivantes :</p> 403 <ul> 404 <li>Avec <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="directive">MaxSpareThreads</code> doit �tre sup�rieure � <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>.</li> 405 406 <li>Avec 407 <code class="module"><a href="/mod/worker.html">worker</a></code>, <code class="directive">MaxSpareThreads</code> 408 doit �tre sup�rieure ou �gale � la somme de <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>.</li> 409 </ul> 410 </div> 411 412<h3>Voir aussi</h3> 413<ul> 414<li><code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code></li> 415<li><code class="directive"><a href="#startservers">StartServers</a></code></li> 416<li><code class="directive"><a href="/mod/prefork.html#maxspareservers">MaxSpareServers</a></code></li> 417</ul> 418</div> 419<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 420<div class="directive-section"><h2><a name="MinSpareThreads" id="MinSpareThreads">MinSpareThreads</a> <a name="minsparethreads" id="minsparethreads">Directive</a></h2> 421<table class="directive"> 422<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de threads inactifs qui seront disponibles 423pour pouvoir traiter les pics de requ�tes</td></tr> 424<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareThreads <var>nombre</var></code></td></tr> 425<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 426<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 427<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 428<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 429</table> 430 <p>C'est le nombre minimum de threads inactifs pour �tre en mesure 431 de traiter les pics de requ�tes. Les MPMs utilisent cette directive 432 de diff�rentes mani�res.</p> 433 434 <p>Avec <code class="module"><a href="/mod/worker.html">worker</a></code>, la d�finition par d�faut est 435 <code>MinSpareThreads 75</code>, et le nombre de threads inactifs 436 est surveill� au niveau du serveur. Si le serveur ne poss�de pas 437 assez de threads inactifs, des processus enfants sont cr��s jusqu'� 438 ce que le nombre de threads inactifs repasse au dessus de 439 <var>nombre</var>.</p> 440 441 <p>Avec <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, la d�finition par d�faut est 442 <code>MinSpareThreads 10</code> et, comme ce MPM n'ex�cute qu'un 443 seul processus, le nombre de threads est surveill� au niveau du 444 serveur.</p> 445 446 <p><code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de mani�re similaire � 447 <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>. Pour <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, la 448 valeur par d�faut est <code>5</code>.</p> 449 450 451<h3>Voir aussi</h3> 452<ul> 453<li><code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code></li> 454<li><code class="directive"><a href="#startservers">StartServers</a></code></li> 455<li><code class="directive"><a href="/mod/prefork.html#minspareservers">MinSpareServers</a></code></li> 456</ul> 457</div> 458<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 459<div class="directive-section"><h2><a name="PidFile" id="PidFile">PidFile</a> <a name="pidfile" id="pidfile">Directive</a></h2> 460<table class="directive"> 461<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ficher dans lequel le serveur enregistre l'identificateur 462de processus du d�mon</td></tr> 463<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PidFile <var>nom fichier</var></code></td></tr> 464<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>PidFile logs/httpd.pid</code></td></tr> 465<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 466<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 467<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 468</table> 469 <p>La directive <code class="directive">PidFile</code> permet de d�finir le 470 ficher dans lequel le serveur 471 enregistre l'identificateur de processus du d�mon. Si le chemin du 472 fichier n'est pas absolu, il est consid�r� comme relatif au chemin 473 d�fini par la directive <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>.</p> 474 475 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">PidFile /var/run/apache.pid</pre> 476</div> 477 478 <p>Il est souvent utile de pouvoir envoyer un signal au 479 serveur afin qu'il ferme et ouvre � nouveau ses journaux 480 d'<code class="directive"><a href="/mod/core.html#erreur">erreur</a></code> et de <code class="directive"><a href="/mod/mod_log_config.html#transfert">transfert</a></code>, et recharge son 481 fichier de configuration. Pour ce faire, on envoie un signal SIGHUP 482 (kill -1) � l'identificateur de processus enregistr� dans le fichier 483 d�fini par la directive <code class="directive">PidFile</code>.</p> 484 485 <p>La directive <code class="directive">PidFile</code> fait l'objet des 486 m�mes avertissements que ceux concernant le chemin d'enregistrement 487 des fichiers journaux et la <a href="/misc/security_tips.html#serverroot">s�curit�</a>.</p> 488 489 <div class="note"><h3>Note</h3> 490 <p>Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser 491 que le script <code class="program"><a href="/programs/apachectl.html">apachectl</a></code>, ou le script de 492 d�marrage fourni avec votre syst�me d'exploitation pour (re)d�marrer ou 493 arr�ter le serveur.</p> 494 </div> 495 496</div> 497<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 498<div class="directive-section"><h2><a name="ReceiveBufferSize" id="ReceiveBufferSize">ReceiveBufferSize</a> <a name="receivebuffersize" id="receivebuffersize">Directive</a></h2> 499<table class="directive"> 500<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en entr�e</td></tr> 501<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReceiveBufferSize <var>octets</var></code></td></tr> 502<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ReceiveBufferSize 0</code></td></tr> 503<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 504<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 505<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 506</table> 507 <p>Le serveur va fixer la taille du tampon TCP en entr�e au 508 nombre d'octets sp�cifi�.</p> 509 510 <p>Si la directive est d�finie � <code>0</code>, le serveur va 511 utiliser la valeur par d�faut adopt�e par le syst�me 512 d'exploitation.</p> 513 514</div> 515<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 516<div class="directive-section"><h2><a name="ScoreBoardFile" id="ScoreBoardFile">ScoreBoardFile</a> <a name="scoreboardfile" id="scoreboardfile">Directive</a></h2> 517<table class="directive"> 518<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier o� sont stock�es les donn�es concernant 519la coordination des processus enfants</td></tr> 520<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScoreBoardFile <var>chemin fichier</var></code></td></tr> 521<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ScoreBoardFile logs/apache_runtime_status</code></td></tr> 522<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 523<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 524<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 525</table> 526 <p>Le serveur HTTP Apache utilise un tableau de bord pour la 527 communication entre le processus parent et les processus enfants. 528 Pour faciliter cette communication, certaines architectures 529 n�cessitent un fichier. En l'absence de cette directive, donc si 530 aucun nom de fichier n'est sp�cifi�, Apache httpd tentera tout 531 d'abord de cr�er un tableau uniquement en m�moire (en utilisant la 532 m�moire partag�e anonyme) ; et si il n'y parvient pas, il tentera de 533 cr�er un fichier sur disque (en utilisant la m�moire partag�e � base 534 de fichier). Si cette directive est utilis�e, Apache httpd cr�era 535 syst�matiquement un fichier sur disque.</p> 536 537 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ScoreBoardFile /var/run/apache_runtime_status</pre> 538</div> 539 540 <p>Une m�moire partag�e sous forme de fichier est utile pour les 541 applications tierces qui n�cessitent un acc�s direct au tableau de 542 bord des processus.</p> 543 544 <p>Si vous utilisez un <code class="directive">ScoreBoardFile</code>, vous 545 pourrez constater une am�lioration des performances en le pla�ant 546 sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte 547 des m�mes avertissements que ceux concernant le chemin du fichier 548 journal et la <a href="/misc/security_tips.html">s�curit�</a>.</p> 549 550<h3>Voir aussi</h3> 551<ul> 552<li><a href="/stopping.html">Arr�ter et red�marrer 553le serveur HTTP Apache</a></li> 554</ul> 555</div> 556<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 557<div class="directive-section"><h2><a name="SendBufferSize" id="SendBufferSize">SendBufferSize</a> <a name="sendbuffersize" id="sendbuffersize">Directive</a></h2> 558<table class="directive"> 559<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en sortie</td></tr> 560<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SendBufferSize <var>octets</var></code></td></tr> 561<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>SendBufferSize 0</code></td></tr> 562<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 563<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 564<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 565</table> 566 <p>D�finit la taille du tampon TCP en sortie avec le nombre 567 d'octets sp�cifi�. Ceci s'av�re souvent tr�s utile pour augmenter les 568 valeurs par d�faut standards du pass� des syst�mes d'exploitation 569 pour les transmissions � grande vitesse et haute densit� (<em>c'est 570 � dire</em> de l'ordre de 100ms comme sur les liaisons rapides 571 transcontinentales).</p> 572 573 <p>Si la directive est d�finie � <code>0</code>, le serveur va 574 utiliser la valeur par d�faut adopt�e par le syst�me 575 d'exploitation.</p> 576 577 <p>L'am�lioration des performances des connexions � grande vitesse 578 et � temps de latence �lev�, peut n�cessiter 579 une intervention au niveau de la configuration de votre syst�me 580 d'exploitation.</p> 581 582 <div class="note"><p>Sous certains syst�mes d'exploitation, la modification du 583 comportement TCP via une augmentation de la valeur de 584 <code class="directive">SendBufferSize</code> risque de ne pas �tre 585 perceptible, si la directive <code class="directive"><a href="/mod/core.html#enablesendfile">EnableSendfile</a></code> n'est pas d�finie � OFF. 586 Cette interaction ne s'applique qu'aux fichiers statiques.</p> </div> 587 588</div> 589<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 590<div class="directive-section"><h2><a name="ServerLimit" id="ServerLimit">ServerLimit</a> <a name="serverlimit" id="serverlimit">Directive</a></h2> 591<table class="directive"> 592<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite sup�rieure de la d�finition du nombre de 593processus</td></tr> 594<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerLimit <var>nombre</var></code></td></tr> 595<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 596<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 597<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 598<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 599</table> 600 <p>Avec le MPM <code class="module"><a href="/mod/prefork.html">prefork</a></code>, cette directive d�finit le 601 nombre maximum que l'on peut affecter � la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la 602 dur�e de vie du processus Apache httpd. Avec le 603 MPM <code class="module"><a href="/mod/worker.html">worker</a></code>, cette directive, en combinaison avec 604 <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, d�finit le 605 nombre maximum que l'on peut affecter � <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la dur�e de 606 vie du processus Apache httpd. Au cours d'un red�marrage, vous pouvez 607 modifier la valeur de la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, alors que toute 608 tentative de modification de la valeur de la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> sera ignor�e.</p> 609 610 <p>Cette directive doit �tre utilis�e avec pr�caution. Si 611 <code class="directive">ServerLimit</code> est d�finie � une valeur beaucoup 612 plus grande que n�cessaire, de la m�moire partag�e suppl�mentaire 613 sera inutilement allou�e. Si � la fois 614 <code class="directive">ServerLimit</code> et <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> poss�dent des valeurs 615 sup�rieures � ce que le syst�me peut supporter, ce dernier peut 616 devenir instable ou Apache httpd peut tout simplement refuser de d�marrer.</p> 617 618 <p>Avec le MPM <code class="module"><a href="/mod/prefork.html">prefork</a></code>, n'utilisez cette directive 619 que si vous devez d�finir <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> � une valeur sup�rieure � 620 256 (valeur par d�faut). N'affectez pas � la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une valeur sup�rieure � 621 celle que vous avez pr�vu d'affecter � la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>.</p> 622 623 <p>Avec <code class="module"><a href="/mod/worker.html">worker</a></code>, n'utilisez cette directive que si 624 la d�finition de vos directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> n�cessitent plus de 625 16 processus serveurs (valeur par d�faut). N'affectez pas � la 626 directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une 627 valeur sup�rieure au nombre de processus requis pour la d�finition 628 des directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers 629 </a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>.</p> 630 631 <div class="note"><h3>Note</h3> 632 <p>Il existe une limite de <code>ServerLimit 20000</code> cod�e en 633 dur dans le serveur (200000 pour le MPM <code class="module"><a href="/mod/prefork.html">prefork</a></code>). 634 Ceci est cens� �viter les effets d�sastreux que pourrait provoquer 635 une faute de frappe. Pour d�passer cette limite, vous devez 636 modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du 637 mpm et recompiler le serveur.</p> 638 </div> 639 640<h3>Voir aussi</h3> 641<ul> 642<li><a href="/stopping.html">Arr�ter et red�marrer 643le serveur HTTP Apache</a></li> 644</ul> 645</div> 646<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 647<div class="directive-section"><h2><a name="StartServers" id="StartServers">StartServers</a> <a name="startservers" id="startservers">Directive</a></h2> 648<table class="directive"> 649<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de processus enfants du serveur cr��s au 650d�marrage</td></tr> 651<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartServers <var>nombre</var></code></td></tr> 652<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 653<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 654<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 655<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/prefork.html">prefork</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 656</table> 657 <p>La directive <code class="directive">StartServers</code> permet de 658 d�finir le nombre de processus enfants du serveur cr��s au 659 d�marrage. Comme le nombre de processus est contr�l� dynamiquement 660 en fonction de la charge (voir <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>, <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>, <code class="directive"><a href="/mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="/mod/prefork.html#maxspareservers">MaxSpareServers</a></code>), il n'est en g�n�ral 661 pas n�cessaire d'ajuster ce param�tre.</p> 662 663 <p>La valeur par d�faut diff�re d'un MPM � l'autre. Pour 664 <code class="module"><a href="/mod/worker.html">worker</a></code>, la d�finition par d�faut est 665 <code>StartServers 3</code> ; la valeur par d�faut est 666 <code>5</code> pour <code class="module"><a href="/mod/prefork.html">prefork</a></code> et <code>2</code> 667 pour <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>.</p> 668 669</div> 670<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 671<div class="directive-section"><h2><a name="StartThreads" id="StartThreads">StartThreads</a> <a name="startthreads" id="startthreads">Directive</a></h2> 672<table class="directive"> 673<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads cr��s au d�marrage</td></tr> 674<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartThreads <var>nombre</var></code></td></tr> 675<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 676<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 677<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 678<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code></td></tr> 679</table> 680 <p>C'est le nombre de threads cr��s au d�marrage du serveur. Comme 681 le nombre de threads est contr�l� dynamiquement 682 en fonction de la charge (voir <code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code>, <code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code>, <code class="directive"><a href="/mod/prefork.html#minspareservers">MinSpareServers</a></code>, <code class="directive"><a href="/mod/prefork.html#maxspareservers">MaxSpareServers</a></code>), il n'est en g�n�ral 683 pas n�cessaire d'ajuster ce param�tre.</p> 684 685 <p>Pour <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, la d�finition par d�faut est 686 <code>StartThreads 50</code> et, comme il n'y a qu'un processus, il 687 s'agit du nombre total de threads cr��s au d�marrage pour servir les 688 requ�tes.</p> 689 690</div> 691<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 692<div class="directive-section"><h2><a name="ThreadLimit" id="ThreadLimit">ThreadLimit</a> <a name="threadlimit" id="threadlimit">Directive</a></h2> 693<table class="directive"> 694<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de threads maximum que l'on peut d�finir par 695processus enfant</td></tr> 696<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadLimit <var>nombre</var></code></td></tr> 697<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 698<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 699<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 700<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 701</table> 702 <p>Cette directive permet de d�finir le nombre maximum que l'on peut 703 affecter � la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour la dur�e de vie 704 du processus Apache httpd. La directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> peut �tre modifi�e 705 au cours d'un red�marrage jusqu'� la valeur de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, mais toute tentative 706 de modification de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code> au cours d'un 707 red�marrage sera ignor�e.</p> 708 709 <p>L'utilisation de cette directive doit faire l'objet de 710 pr�cautions particuli�res. Si <code class="directive">ThreadLimit</code> est 711 d�finie � une valeur tr�s sup�rieure � la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>, de la m�moire 712 partag�e suppl�mentaire sera inutilement allou�e. Si les directives 713 <code class="directive">ThreadLimit</code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> sont d�finies � des 714 valeurs sup�rieures � ce que le syst�me peut supporter, ce dernier 715 peut devenir instable, ou Apache httpd peut tout simplement refuser de 716 d�marrer. Ne d�finissez pas cette directive � une valeur sup�rieure 717 � la valeur maximale que vous pensez affecter � la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour le processus 718 Apache httpd en cours d'ex�cution.</p> 719 720 <p>La valeur par d�faut de la directive 721 <code class="directive">ThreadLimit</code> est <code>1920</code> avec 722 <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>64</code> avec les autres 723 MPMs.</p> 724 725 <div class="note"><h3>Note</h3> 726 <p>Il existe une limite de <code>ThreadLimit 20000</code> (ou 727 <code>ThreadLimit 100000</code> avec <code class="module"><a href="/mod/event.html">event</a></code>, 728 <code>ThreadLimit 15000</code> avec <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>) 729 cod�e en dur dans le serveur. Ceci est cens� �viter les effets 730 d�sastreux que pourrait provoquer une faute de frappe. Pour 731 d�passer cette limite, vous devez modifier la valeur de 732 MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le 733 serveur.</p> 734 </div> 735 736</div> 737<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 738<div class="directive-section"><h2><a name="ThreadsPerChild" id="ThreadsPerChild">ThreadsPerChild</a> <a name="threadsperchild" id="threadsperchild">Directive</a></h2> 739<table class="directive"> 740<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads cr��s par chaque processus 741enfant</td></tr> 742<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadsPerChild <var>nombre</var></code></td></tr> 743<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir ci-dessous pour plus de d�tails</code></td></tr> 744<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 745<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 746<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code></td></tr> 747</table> 748 <p>Cette directive permet de d�finir le nombre de threads que va 749 cr�er chaque processus enfant. Un processus enfant cr�e ces threads 750 au d�marrage et n'en cr�e plus d'autres par la suite. Si l'on 751 utilise un MPM comme <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code> qui ne lance qu'un 752 processus enfant, ce nombre doit �tre suffisamment grand pour 753 supporter la charge du serveur. Avec un MPM comme 754 <code class="module"><a href="/mod/worker.html">worker</a></code> qui lance plusieurs processus enfants, c'est 755 le nombre <em>total</em> de threads qui doit �tre suffisamment grand 756 pour supporter la charge du serveur.</p> 757 758 <p>La valeur par d�faut de la directive 759 <code class="directive">ThreadsPerChild</code> est <code>64</code> avec 760 <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>25</code> avec les autres 761 MPMs.</p> 762 763</div> 764<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 765<div class="directive-section"><h2><a name="ThreadStackSize" id="ThreadStackSize">ThreadStackSize</a> <a name="threadstacksize" id="threadstacksize">Directive</a></h2> 766<table class="directive"> 767<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille en octets de la pile qu'utilisent les threads qui 768traitent les connexions clients</td></tr> 769<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadStackSize <var>taille</var></code></td></tr> 770<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>65536 sous NetWare; varie en fonction des autres syst�mes 771d'exploitation</code></td></tr> 772<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 773<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr> 774<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/event.html">event</a></code>, <code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="/mod/worker.html">worker</a></code>, <code class="module"><a href="/mod/event.html">event</a></code></td></tr> 775<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans les versions 2.1 et sup�rieures 776du serveur HTTP Apache</td></tr> 777</table> 778 <p>La directive <code class="directive">ThreadStackSize</code> permet de 779 d�finir la taille de la pile (pour les donn�es propres) qu'utilisent 780 les threads qui traitent les connexions clients en faisant appel � 781 des modules. Dans la plupart des cas, la valeur par d�faut de la 782 taille de la pile du syst�me d'exploitation convient, mais il existe 783 certaines situations o� il peut s'av�rer n�cessaire de l'ajuster 784 :</p> 785 786 <ul> 787 <li>Sur les plates-formes qui poss�dent une valeur par d�faut de 788 taille de la pile relativement petite (par exemple HP-UX), Apache 789 httpd peut se crasher si l'on utilise certains modules tiers qui 790 poss�dent un quantit� de donn�es propres stock�es relativement 791 importante. Il se peut que ces m�mes modules fonctionnent 792 correctement sur d'autres plate-formes o� la valeur par d�faut de 793 la taille de la pile est sup�rieure. Ce type de crash peut �tre 794 evit� en d�finissant <code class="directive">ThreadStackSize</code> � une 795 valeur sup�rieure � la valeur par d�faut du syst�me 796 d'exploitation. Ce type d'ajustement n'est n�cessaire que si le 797 fournisseur du module tiers en fait mention, ou si le diagnostic 798 d'un crash d'Apache httpd indique que la taille de la pile �tait trop 799 petite.</li> 800 801 <li>Sur les plates-formes o� la taille par d�faut de la pile des 802 threads est sensiblement sup�rieure � la taille n�cessaire pour la 803 configuration du serveur web, il est possible de disposer d'un 804 plus grand nombre de threads par processus enfant si la directive 805 <code class="directive">ThreadStackSize</code> est d�finie � une valeur 806 inf�rieure � la valeur par d�faut du syst�me d'exploitation. 807 Cependant, ce 808 type d'ajustement ne doit �tre effectu� que dans un environnement 809 de test permettant de qualifier le serveur web au maximum de ses 810 possibilit�s, car il peut arriver, dans de rares cas, que des 811 requ�tes n�cessitent une taille de pile sup�rieure pour pouvoir 812 �tre trait�es. La taille minimale requise pour la pile d�pend 813 fortement des modules utilis�s, mais toute modification dans la 814 configuration du serveur web peut invalider la d�finition courante 815 de la directive <code class="directive">ThreadStackSize</code>.</li> 816 817 <li>Sous Linux, cette directive ne peut �tre utilis�e que pour 818 augmenter la valeur par defaut de la taille de la pile, car 819 l'appel syst�me sous-jacent utilise cette valeur comme taille de pile 820 <em>minimale</em>. C'est la limite logicielle (souvent �lev�e) 821 pour <code>ulimit -s</code> (8Mo si aucune limite) qui est 822 utilis�e comme taille de pile par d�faut.</li> 823 </ul> 824 825 <div class="note">Il est recommand� de ne pas r�duire 826 <code class="directive">ThreadStackSize</code>, � moins qu'un grand nombre 827 de threads par processus enfant ne soit n�cessaire. Sur certaines 828 plates-formes (y compris Linux), une valeur de 128000 est d�j� trop 829 basse et provoque des crashes avec certains modules courants.</div> 830 831</div> 832</div> 833<div class="bottomlang"> 834<p><span>Langues Disponibles: </span><a href="/de/mod/mpm_common.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 835<a href="/en/mod/mpm_common.html" hreflang="en" rel="alternate" title="English"> en </a> | 836<a href="/fr/mod/mpm_common.html" title="Fran�ais"> fr </a> | 837<a href="/ja/mod/mpm_common.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 838<a href="/tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 839</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 840<script type="text/javascript"><!--//--><![CDATA[//><!-- 841var comments_shortname = 'httpd'; 842var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mpm_common.html'; 843(function(w, d) { 844 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 845 d.write('<div id="comments_thread"><\/div>'); 846 var s = d.createElement('script'); 847 s.type = 'text/javascript'; 848 s.async = true; 849 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 850 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 851 } 852 else { 853 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 854 } 855})(window, document); 856//--><!]]></script></div><div id="footer"> 857<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 858<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 859if (typeof(prettyPrint) !== 'undefined') { 860 prettyPrint(); 861} 862//--><!]]></script> 863</body></html>