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="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
22<div id="path">
23<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <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">&nbsp;de&nbsp;</a> |
28<a href="/en/mod/mpm_common.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
29<a href="/fr/mod/mpm_common.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
30<a href="/ja/mod/mpm_common.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
31<a href="/tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</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">&nbsp;de&nbsp;</a> |
835<a href="/en/mod/mpm_common.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
836<a href="/fr/mod/mpm_common.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
837<a href="/ja/mod/mpm_common.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
838<a href="/tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</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&amp;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>