]> granicus.if.org Git - apache/blob - docs/manual/mod/mpm_common.html.fr
update transformation
[apache] / docs / manual / mod / mpm_common.html.fr
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.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
34 modules 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
66 positionner 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
127 gestionnaires 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
152 s'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
180 2.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">
206 Listen 80
207 Listen 8000
208     </pre>
209
210
211     <p>Pour que le serveur accepte les connexions sur deux interfaces et
212     ports particuliers, spécifiez :</p>
213
214     <pre class="prettyprint lang-config">
215 Listen 192.170.2.1:80
216 Listen 192.170.2.5:8000
217     </pre>
218
219
220     <p>Les adressee IPv6 doivent être entourées de crochets, comme dans
221     l'exemple suivant :</p>
222
223     <pre class="prettyprint lang-config">
224       Listen [2001:db8::a00:20ff:fea7:ccea]:80
225     </pre>
226
227
228     <p>L'argument optionnel <var>protocole</var> n'est pas nécessaire
229     dans la plupart des configurations. S'il est absent,
230     <code>https</code> est la valeur par défaut pour le port 443 et
231     <code>http</code> l'est pour tous les autres ports. L'argument
232     protocole sert à déterminer quel module doit traiter une requête, et
233     à appliquer des optimisations spécifiques à certains protocoles à
234     l'aide de la directive <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code>.</p>
235
236     <p>La spécification d'un protocole n'est nécessaire que si vous
237     utilisez des ports non standards. Par exemple, pour configurer un
238     site en <code>https</code> sur le port 8443 :</p>
239
240     <pre class="prettyprint lang-config">
241       Listen 192.170.2.1:8443 https
242     </pre>
243
244
245     <div class="note"><h3>Condition d'erreur</h3>
246       Plusieurs directives <code class="directive">Listen</code> pour les mêmes
247       adresse IP/port vont provoquer l'envoi d'un message d'erreur
248       <code>Address already in use</code>.
249     </div>
250
251
252 <h3>Voir aussi</h3>
253 <ul>
254 <li><a href="../dns-caveats.html">Problèmes avec DNS</a></li>
255 <li><a href="../bind.html">Définition des adresses et ports
256 qu'utilise le serveur HTTP Apache</a></li>
257 <li><a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Autre
258 discussion à propos du message d'erreur <code>Address already in
259 use</code>, citant d'autres causes possibles.</a></li>
260 </ul>
261 </div>
262 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
263 <div class="directive-section"><h2><a name="ListenBackLog" id="ListenBackLog">ListenBackLog</a> <a name="listenbacklog" id="listenbacklog">Directive</a></h2>
264 <table class="directive">
265 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Longueur maximale de la liste d'attente des
266 connexions</td></tr>
267 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ListenBacklog <var>backlog</var></code></td></tr>
268 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ListenBacklog 511</code></td></tr>
269 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
270 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
271 <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>
272 </table>
273     <p>La longueur maximale de la liste d'attente des connexions. En
274     général, aucune modification n'est nécessaire, ni même souhaitable ;
275     cependant, sur certains systèmes, il peut être nécessaire
276     d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en
277     masse de requêtes SYN pour saturer le serveur). Voir le paramètre
278     backlog de l'appel système <code>listen(2)</code>.</p>
279
280     <p>En fait, l'argument backlog sera souvent limité à une valeur
281     inférieure en fonction du système d'exploitation. Notez aussi que de
282     nombreux systèmes d'exploitation ne tiennent pas vraiment compte de
283     la valeur spécifiée pour l'argument backlog, mais s'en inspirent
284     seulement (et choisissent en général une valeur supérieure).</p>
285
286 </div>
287 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
288 <div class="directive-section"><h2><a name="MaxConnectionsPerChild" id="MaxConnectionsPerChild">MaxConnectionsPerChild</a> <a name="maxconnectionsperchild" id="maxconnectionsperchild">Directive</a></h2>
289 <table class="directive">
290 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de connexions qu'un processus enfant va
291 traiter au cours de son fonctionnement</td></tr>
292 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxConnectionsPerChild <var>number</var></code></td></tr>
293 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxConnectionsPerChild 0</code></td></tr>
294 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
295 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
296 <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>
297 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 du serveur HTTP
298 Apache. L'ancien nom <code>MaxRequestsPerChild</code> est encore
299 supporté.</td></tr>
300 </table>
301     <p>La directive <code class="directive">MaxConnectionsPerChild</code> permet de
302     définir le nombre maximum de connexions qu'un processus enfant va
303     pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
304     <code class="directive">MaxConnectionsPerChild</code> connexions, le processus
305     enfant est arrêté. Si <code class="directive">MaxConnectionsPerChild</code> est
306     définie à <code>0</code>, il n'y a plus aucune limite sur le nombre
307     de connexions que le processus pourra traiter.</p>
308
309     <p>Définir <code class="directive">MaxConnectionsPerChild</code> à une valeur
310     non nulle limite la quantité de mémoire qu'un processus peut
311     consommer à cause de fuites (accidentelles) de mémoire.</p>
312
313
314 </div>
315 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
316 <div class="directive-section"><h2><a name="MaxMemFree" id="MaxMemFree">MaxMemFree</a> <a name="maxmemfree" id="maxmemfree">Directive</a></h2>
317 <table class="directive">
318 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Quantité maximale de mémoire que l'allocateur principal est
319 autorisé à conserver sans appeler <code>free()</code></td></tr>
320 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxMemFree <var>KOctets</var></code></td></tr>
321 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxMemFree 2048</code></td></tr>
322 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
323 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
324 <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>
325 </table>
326     <p>La directive <code class="directive">MaxMemFree</code> permet de définir
327     le nombre maximum de KOctets libres que tout allocateur est
328     autorisé à conserver sans appeler <code>free()</code>. Dans les MPMs
329     threadés, chaque thread possède son propre allocateur. Si elle est
330     définie à 0, la quantité de mémoire libre que peut conserver un
331     allocateur est illimitée.</p>
332
333 </div>
334 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
335 <div class="directive-section"><h2><a name="MaxRequestWorkers" id="MaxRequestWorkers">MaxRequestWorkers</a> <a name="maxrequestworkers" id="maxrequestworkers">Directive</a></h2>
336 <table class="directive">
337 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions pouvant être traitées
338 simultanément</td></tr>
339 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRequestWorkers <var>nombre</var></code></td></tr>
340 <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>
341 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
342 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
343 <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>
344 </table>
345     <p>La directive <code class="directive">MaxRequestWorkers</code> permet de fixer le
346     nombre maximum de requêtes pouvant être traitées simultanément.
347     Si la limite <code class="directive">MaxRequestWorkers</code> est atteinte, toute
348     tentative de connexion sera normalement mise dans une file
349     d'attente, et ceci jusqu'à un certain nombre dépendant de la
350     directive <code class="directive"><a href="#listenbacklog">ListenBacklog</a></code>.
351     Lorsqu'un processus enfant se libèrera suite à la fin du traitement
352     d'une requête, la connexion en attente pourra être traitée à son
353     tour.</p>
354
355     <p>Pour les serveurs non threadés (<em>c'est à dire</em> utilisant
356     <code class="module"><a href="../mod/prefork.html">prefork</a></code>), la directive
357     <code class="directive">MaxRequestWorkers</code> définit alors le nombre maximum de
358     processus enfants qui pourront être lancés simultanément pour
359     traiter les requêtes. La valeur par défaut est <code>256</code> ; si
360     vous l'augmentez, vous devez aussi augmenter la valeur de la
361     directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
362
363     <p>Pour les serveur threadés et hybrides (utilisant <em>par
364     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>),
365     <code class="directive">MaxRequestWorkers</code> définit alors le nombre total de
366     threads qui seront disponibles pour servir les clients. Dans le
367     cas des MPMs hybrides, la valeur par défaut est <code>16</code>
368     (directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>) multiplié par la valeur
369     <code>25</code> (directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>). Par conséquent, pour affecter à la
370     directive <code class="directive">MaxRequestWorkers</code> une valeur qui requiert
371     plus de 16 processus, vous devez aussi augmenter la valeur de la
372     directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code>.</p>
373
374     <p>Le nom de la directive <code class="directive">MaxRequestWorkers</code>
375     était <code class="directive">MaxClients</code> avant la version 2.3.13. Cet
376     ancien nom est encore supporté.</p>
377
378 </div>
379 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
380 <div class="directive-section"><h2><a name="MaxSpareThreads" id="MaxSpareThreads">MaxSpareThreads</a> <a name="maxsparethreads" id="maxsparethreads">Directive</a></h2>
381 <table class="directive">
382 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de threads inactifs</td></tr>
383 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxSpareThreads <var>nombre</var></code></td></tr>
384 <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>
385 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
386 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
387 <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>
388 </table>
389     <p>C'est le nombre maximum de threads inactifs. Les MPMs utilisent
390     cette directive de différentes manières.</p>
391
392     <p>Pour <code class="module"><a href="../mod/worker.html">worker</a></code>, la définition par défaut est
393     <code>MaxSpareThreads 250</code>. Ce MPM gère les threads inactifs
394     au niveau du serveur. Si le serveur possède trop de threads
395     inactifs, des processus enfants seront arrêtés jusqu'à ce que le
396     nombre de threads inactifs repasse en dessous de cette limite.</p>
397
398     <p>Pour <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
399     <code>MaxSpareThreads 100</code>. Comme ce MPM n'exécute qu'un seul
400     processus, le nombre de processus inactifs est surveillé au
401     niveau du serveur.</p>
402
403     <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de manière similaire à
404     <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
405     valeur par défaut est <code>10</code>.</p>
406
407     <div class="note"><h3>Contraintes</h3>
408       <p>La gamme de valeurs pour <code class="directive">MaxSpareThreads</code>
409       est limitée. Apache httpd corrigera automatiquement cette valeur selon
410       les règles suivantes :</p>
411       <ul>
412         <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>
413
414         <li>Avec
415         <code class="module"><a href="../mod/worker.html">worker</a></code>, <code class="directive">MaxSpareThreads</code>
416         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>
417       </ul>
418     </div>
419
420 <h3>Voir aussi</h3>
421 <ul>
422 <li><code class="directive"><a href="#minsparethreads">MinSpareThreads</a></code></li>
423 <li><code class="directive"><a href="#startservers">StartServers</a></code></li>
424 <li><code class="directive"><a href="../mod/prefork.html#maxspareservers">MaxSpareServers</a></code></li>
425 </ul>
426 </div>
427 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
428 <div class="directive-section"><h2><a name="MinSpareThreads" id="MinSpareThreads">MinSpareThreads</a> <a name="minsparethreads" id="minsparethreads">Directive</a></h2>
429 <table class="directive">
430 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de threads inactifs qui seront disponibles
431 pour pouvoir traiter les pics de requêtes</td></tr>
432 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MinSpareThreads <var>nombre</var></code></td></tr>
433 <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>
434 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
435 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
436 <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>
437 </table>
438     <p>C'est le nombre minimum de threads inactifs pour être en mesure
439     de traiter les pics de requêtes. Les MPMs utilisent cette directive
440     de différentes manières.</p>
441
442     <p>Avec <code class="module"><a href="../mod/worker.html">worker</a></code>, la définition par défaut est
443     <code>MinSpareThreads 75</code>, et le nombre de threads inactifs
444     est surveillé au niveau du serveur. Si le serveur ne possède pas
445     assez de threads inactifs, des processus enfants sont créés jusqu'à
446     ce que le nombre de threads inactifs repasse au dessus de
447     <var>nombre</var>.</p>
448
449     <p>Avec <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
450     <code>MinSpareThreads 10</code> et, comme ce MPM n'exécute qu'un
451     seul processus, le nombre de threads est surveillé au niveau du
452     serveur.</p>
453
454     <p><code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code> fonctionne de manière similaire à
455     <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
456     valeur par défaut est <code>5</code>.</p>
457
458
459 <h3>Voir aussi</h3>
460 <ul>
461 <li><code class="directive"><a href="#maxsparethreads">MaxSpareThreads</a></code></li>
462 <li><code class="directive"><a href="#startservers">StartServers</a></code></li>
463 <li><code class="directive"><a href="../mod/prefork.html#minspareservers">MinSpareServers</a></code></li>
464 </ul>
465 </div>
466 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
467 <div class="directive-section"><h2><a name="PidFile" id="PidFile">PidFile</a> <a name="pidfile" id="pidfile">Directive</a></h2>
468 <table class="directive">
469 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ficher dans lequel le serveur enregistre l'identificateur
470 de processus du démon</td></tr>
471 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PidFile <var>nom fichier</var></code></td></tr>
472 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>PidFile logs/httpd.pid</code></td></tr>
473 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
474 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
475 <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>
476 </table>
477     <p>La directive <code class="directive">PidFile</code> permet de définir le
478     ficher dans lequel le serveur
479     enregistre l'identificateur de processus du démon. Si le chemin du
480     fichier n'est pas absolu, il est considéré comme relatif au chemin
481     défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
482
483     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">
484       PidFile /var/run/apache.pid
485       </pre>
486 </div>
487
488     <p>Il est souvent utile de pouvoir envoyer un signal au
489     serveur afin qu'il ferme et ouvre à nouveau ses journaux
490     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
491     fichier de configuration. Pour ce faire, on envoie un signal SIGHUP
492     (kill -1) à l'identificateur de processus enregistré dans le fichier
493     défini par la directive <code class="directive">PidFile</code>.</p>
494
495     <p>La directive <code class="directive">PidFile</code> fait l'objet des
496     mêmes avertissements que ceux concernant le chemin d'enregistrement
497     des fichiers journaux et la <a href="../misc/security_tips.html#serverroot">sécurité</a>.</p>
498
499     <div class="note"><h3>Note</h3>
500       <p>Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser
501       que le script <code class="program"><a href="../programs/apachectl.html">apachectl</a></code>, ou le script de
502       démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
503       arrêter le serveur.</p>
504     </div>
505
506 </div>
507 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
508 <div class="directive-section"><h2><a name="ReceiveBufferSize" id="ReceiveBufferSize">ReceiveBufferSize</a> <a name="receivebuffersize" id="receivebuffersize">Directive</a></h2>
509 <table class="directive">
510 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en entrée</td></tr>
511 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReceiveBufferSize <var>octets</var></code></td></tr>
512 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ReceiveBufferSize 0</code></td></tr>
513 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
514 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
515 <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>
516 </table>
517     <p>Le serveur va fixer la taille du tampon TCP en entrée au
518     nombre d'octets spécifié.</p>
519
520     <p>Si la directive est définie à <code>0</code>, le serveur va
521     utiliser la valeur par défaut adoptée par le système
522     d'exploitation.</p>
523
524 </div>
525 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
526 <div class="directive-section"><h2><a name="ScoreBoardFile" id="ScoreBoardFile">ScoreBoardFile</a> <a name="scoreboardfile" id="scoreboardfile">Directive</a></h2>
527 <table class="directive">
528 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier où sont stockées les données concernant
529 la coordination des processus enfants</td></tr>
530 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScoreBoardFile <var>chemin fichier</var></code></td></tr>
531 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScoreBoardFile logs/apache_runtime_status</code></td></tr>
532 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
533 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
534 <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>
535 </table>
536     <p>Le serveur HTTP Apache utilise un tableau de bord pour la
537     communication entre le processus parent et les processus enfants.
538     Pour faciliter cette communication, certaines architectures
539     nécessitent un fichier. En l'absence de cette directive, donc si
540     aucun nom de fichier n'est spécifié, Apache httpd tentera tout
541     d'abord de créer un tableau uniquement en mémoire (en utilisant la
542     mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de
543     créer un fichier sur disque (en utilisant la mémoire partagée à base
544     de fichier). Si cette directive est utilisée, Apache httpd créera
545     systématiquement un fichier sur disque.</p>
546
547     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">
548       ScoreBoardFile /var/run/apache_runtime_status
549       </pre>
550 </div>
551
552     <p>Une mémoire partagée sous forme de fichier est utile pour les
553     applications tierces qui nécessitent un accès direct au tableau de
554     bord des processus.</p>
555
556     <p>Si vous utilisez un <code class="directive">ScoreBoardFile</code>, vous
557     pourrez constater une amélioration des performances en le plaçant
558     sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte
559     des mêmes avertissements que ceux concernant le chemin du fichier
560     journal et la <a href="../misc/security_tips.html">sécurité</a>.</p>
561
562 <h3>Voir aussi</h3>
563 <ul>
564 <li><a href="../stopping.html">Arrêter et redémarrer
565 le serveur HTTP Apache</a></li>
566 </ul>
567 </div>
568 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
569 <div class="directive-section"><h2><a name="SendBufferSize" id="SendBufferSize">SendBufferSize</a> <a name="sendbuffersize" id="sendbuffersize">Directive</a></h2>
570 <table class="directive">
571 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon TCP en sortie</td></tr>
572 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SendBufferSize <var>octets</var></code></td></tr>
573 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SendBufferSize 0</code></td></tr>
574 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
575 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
576 <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>
577 </table>
578     <p>Définit la taille du tampon TCP en sortie avec le nombre
579     d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les
580     valeurs par défaut standards du passé des systèmes d'exploitation
581     pour les transmissions à grande vitesse et haute densité (<em>c'est
582     à dire</em> de l'ordre de 100ms comme sur les liaisons rapides
583     transcontinentales).</p>
584
585     <p>Si la directive est définie à <code>0</code>, le serveur va
586     utiliser la valeur par défaut adoptée par le système
587     d'exploitation.</p>
588
589     <p>L'amélioration des performances des connexions à grande vitesse
590     et à temps de latence élevé, peut nécessiter
591     une intervention au niveau de la configuration de votre système
592     d'exploitation.</p>
593
594     <div class="note"><p>Sous certains systèmes d'exploitation, la modification du
595     comportement TCP via une augmentation de la valeur de
596     <code class="directive">SendBufferSize</code> risque de ne pas être
597     perceptible, si la directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> n'est pas définie à OFF.
598     Cette interaction ne s'applique qu'aux fichiers statiques.</p> </div>
599
600 </div>
601 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
602 <div class="directive-section"><h2><a name="ServerLimit" id="ServerLimit">ServerLimit</a> <a name="serverlimit" id="serverlimit">Directive</a></h2>
603 <table class="directive">
604 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite supérieure de la définition du nombre de
605 processus</td></tr>
606 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerLimit <var>nombre</var></code></td></tr>
607 <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>
608 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
609 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
610 <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>
611 </table>
612     <p>Avec le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>, cette directive définit le
613     nombre maximum que l'on peut affecter à la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la
614     durée de vie du processus Apache httpd. Avec le
615     MPM <code class="module"><a href="../mod/worker.html">worker</a></code>, cette directive, en combinaison avec
616     <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, définit le
617     nombre maximum que l'on peut affecter à <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, et ceci pour la durée de
618     vie du processus Apache httpd. Au cours d'un redémarrage, vous pouvez
619     modifier la valeur de la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>, alors que toute
620     tentative de modification de la valeur de la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> sera ignorée.</p>
621
622     <p>Cette directive doit être utilisée avec précaution. Si
623     <code class="directive">ServerLimit</code> est définie à une valeur beaucoup
624     plus grande que nécessaire, de la mémoire partagée supplémentaire
625     sera inutilement allouée. Si à la fois
626     <code class="directive">ServerLimit</code> et <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> possèdent des valeurs
627     supérieures à ce que le système peut supporter, ce dernier peut
628     devenir instable ou Apache httpd peut tout simplement refuser de démarrer.</p>
629
630     <p>Avec le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>, n'utilisez cette directive
631     que si vous devez définir <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code> à une valeur supérieure à
632     256 (valeur par défaut). N'affectez pas à la directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une valeur supérieure à
633     celle que vous avez prévu d'affecter à la directive <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers</a></code>.</p>
634
635     <p>Avec <code class="module"><a href="../mod/worker.html">worker</a></code>, n'utilisez cette directive que si
636     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
637     16 processus serveurs (valeur par défaut). N'affectez pas à la
638     directive <code class="directive"><a href="#serverlimit">ServerLimit</a></code> une
639     valeur supérieure au nombre de processus requis pour la définition
640     des directives <code class="directive"><a href="#maxrequestworkers">MaxRequestWorkers
641     </a></code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>.</p>
642
643     <div class="note"><h3>Note</h3>
644       <p>Il existe une limite de <code>ServerLimit 20000</code> codée en
645       dur dans le serveur (200000 pour le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>).
646       Ceci est censé éviter les effets désastreux que pourrait provoquer
647       une faute de frappe. Pour dépasser cette limite, vous devez
648       modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du
649       mpm et recompiler le serveur.</p>
650     </div>
651
652 <h3>Voir aussi</h3>
653 <ul>
654 <li><a href="../stopping.html">Arrêter et redémarrer
655 le serveur HTTP Apache</a></li>
656 </ul>
657 </div>
658 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
659 <div class="directive-section"><h2><a name="StartServers" id="StartServers">StartServers</a> <a name="startservers" id="startservers">Directive</a></h2>
660 <table class="directive">
661 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de processus enfants du serveur créés au
662 démarrage</td></tr>
663 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartServers <var>nombre</var></code></td></tr>
664 <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>
665 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
666 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
667 <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>
668 </table>
669     <p>La directive <code class="directive">StartServers</code> permet de
670     définir le nombre de processus enfants du serveur créés au
671     démarrage. Comme le nombre de processus est contrôlé dynamiquement
672     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
673     pas nécessaire d'ajuster ce paramètre.</p>
674
675     <p>La valeur par défaut diffère d'un MPM à l'autre. Pour
676     <code class="module"><a href="../mod/worker.html">worker</a></code>, la définition par défaut est
677     <code>StartServers 3</code> ; la valeur par défaut est
678     <code>5</code> pour <code class="module"><a href="../mod/prefork.html">prefork</a></code> et <code>2</code>
679     pour <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>.</p>
680
681 </div>
682 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
683 <div class="directive-section"><h2><a name="StartThreads" id="StartThreads">StartThreads</a> <a name="startthreads" id="startthreads">Directive</a></h2>
684 <table class="directive">
685 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads créés au démarrage</td></tr>
686 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StartThreads <var>nombre</var></code></td></tr>
687 <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>
688 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
689 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
690 <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>
691 </table>
692     <p>C'est le nombre de threads créés au démarrage du serveur. Comme
693     le nombre de threads est contrôlé dynamiquement
694     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
695     pas nécessaire d'ajuster ce paramètre.</p>
696
697     <p>Pour <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, la définition par défaut est
698     <code>StartThreads 50</code> et, comme il n'y a qu'un processus, il
699     s'agit du nombre total de threads créés au démarrage pour servir les
700     requêtes.</p>
701
702 </div>
703 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
704 <div class="directive-section"><h2><a name="ThreadLimit" id="ThreadLimit">ThreadLimit</a> <a name="threadlimit" id="threadlimit">Directive</a></h2>
705 <table class="directive">
706 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de threads maximum que l'on peut définir par
707 processus enfant</td></tr>
708 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadLimit <var>nombre</var></code></td></tr>
709 <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>
710 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
711 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
712 <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>
713 </table>
714     <p>Cette directive permet de définir le nombre maximum que l'on peut
715     affecter à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour la durée de vie
716     du processus Apache httpd. La directive  <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> peut être modifiée
717     au cours d'un redémarrage jusqu'à la valeur de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code>, mais toute tentative
718     de modification de la directive <code class="directive"><a href="#threadlimit">ThreadLimit</a></code> au cours d'un
719     redémarrage sera ignorée.</p>
720
721     <p>L'utilisation de cette directive doit faire l'objet de
722     précautions particulières. Si <code class="directive">ThreadLimit</code> est
723     définie à une valeur très supérieure à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code>, de la mémoire
724     partagée supplémentaire sera inutilement allouée. Si les directives
725     <code class="directive">ThreadLimit</code> et <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> sont définies à des
726     valeurs supérieures à ce que le système peut supporter, ce dernier
727     peut devenir instable, ou Apache httpd peut tout simplement refuser de
728     démarrer. Ne définissez pas cette directive à une valeur supérieure
729     à la valeur maximale que vous pensez affecter à la directive <code class="directive"><a href="#threadsperchild">ThreadsPerChild</a></code> pour le processus
730     Apache httpd en cours d'exécution.</p>
731
732     <p>La valeur par défaut de la directive
733     <code class="directive">ThreadLimit</code> est <code>1920</code> avec
734     <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>64</code> avec les autres
735     MPMs.</p>
736
737     <div class="note"><h3>Note</h3>
738       <p>Il existe une limite de <code>ThreadLimit 20000</code> (ou
739       <code>ThreadLimit 100000</code> avec <code class="module"><a href="../mod/event.html">event</a></code>,
740       <code>ThreadLimit 15000</code> avec <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>)
741       codée en dur dans le serveur. Ceci est censé éviter les effets
742       désastreux que pourrait provoquer une faute de frappe. Pour
743       dépasser cette limite, vous devez modifier la valeur de
744       MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le
745       serveur.</p>
746     </div>
747
748 </div>
749 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
750 <div class="directive-section"><h2><a name="ThreadsPerChild" id="ThreadsPerChild">ThreadsPerChild</a> <a name="threadsperchild" id="threadsperchild">Directive</a></h2>
751 <table class="directive">
752 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de threads créés par chaque processus
753 enfant</td></tr>
754 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadsPerChild <var>nombre</var></code></td></tr>
755 <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>
756 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
757 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
758 <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>
759 </table>
760     <p>Cette directive permet de définir le nombre de threads que va
761     créer chaque processus enfant. Un processus enfant crée ces threads
762     au démarrage et n'en crée plus d'autres par la suite. Si l'on
763     utilise un MPM comme <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code> qui ne lance qu'un
764     processus enfant, ce nombre doit être suffisamment grand pour
765     supporter la charge du serveur. Avec un MPM comme
766     <code class="module"><a href="../mod/worker.html">worker</a></code> qui lance plusieurs processus enfants, c'est
767     le nombre <em>total</em> de threads qui doit être suffisamment grand
768     pour supporter la charge du serveur.</p>
769
770     <p>La valeur par défaut de la directive
771     <code class="directive">ThreadsPerChild</code> est <code>64</code> avec
772     <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, et <code>25</code> avec les autres
773     MPMs.</p>
774
775 </div>
776 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
777 <div class="directive-section"><h2><a name="ThreadStackSize" id="ThreadStackSize">ThreadStackSize</a> <a name="threadstacksize" id="threadstacksize">Directive</a></h2>
778 <table class="directive">
779 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille en octets de la pile qu'utilisent les threads qui
780 traitent les connexions clients</td></tr>
781 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ThreadStackSize <var>taille</var></code></td></tr>
782 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>65536 sous NetWare; varie en fonction des autres systèmes
783 d'exploitation</code></td></tr>
784 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
785 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
786 <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>
787 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les versions 2.1 et supérieures
788 du serveur HTTP Apache</td></tr>
789 </table>
790     <p>La directive <code class="directive">ThreadStackSize</code> permet de
791     définir la taille de la pile (pour les données propres) qu'utilisent
792     les threads qui traitent les connexions clients en faisant appel à
793     des modules. Dans la plupart des cas, la valeur par défaut de la
794     taille de la pile du système d'exploitation convient, mais il existe
795     certaines situations où il peut s'avérer nécessaire de l'ajuster
796     :</p>
797
798     <ul>
799       <li>Sur les plates-formes qui possèdent une valeur par défaut de
800       taille de la pile relativement petite (par exemple HP-UX), Apache
801       httpd peut se crasher si l'on utilise certains modules tiers qui
802       possèdent un quantité de données propres stockées relativement
803       importante. Il se peut que ces mêmes modules fonctionnent
804       correctement sur d'autres plate-formes où la valeur par défaut de
805       la taille de la pile est supérieure. Ce type de crash peut être
806       evité en définissant <code class="directive">ThreadStackSize</code> à une
807       valeur supérieure à la valeur par défaut du système
808       d'exploitation. Ce type d'ajustement n'est nécessaire que si le
809       fournisseur du module tiers en fait mention, ou si le diagnostic
810       d'un crash d'Apache httpd indique que la taille de la pile était trop
811       petite.</li>
812
813       <li>Sur les plates-formes où la taille par défaut de la pile des
814       threads est sensiblement supérieure à la taille nécessaire pour la
815       configuration du serveur web, il est possible de disposer d'un
816       plus grand nombre de threads par processus enfant si la directive
817       <code class="directive">ThreadStackSize</code> est définie à une valeur
818       inférieure à la valeur par défaut du système d'exploitation.
819       Cependant, ce
820       type d'ajustement ne doit être effectué que dans un environnement
821       de test permettant de qualifier le serveur web au maximum de ses
822       possibilités, car il peut arriver, dans de rares cas, que des
823       requêtes nécessitent une taille de pile supérieure pour pouvoir
824       être traitées. La taille minimale requise pour la pile dépend
825       fortement des modules utilisés, mais toute modification dans la
826       configuration du serveur web peut invalider la définition courante
827       de la directive <code class="directive">ThreadStackSize</code>.</li>
828
829       <li>Sous Linux, cette directive ne peut être utilisée que pour
830       augmenter la valeur par defaut de la taille de la pile, car
831       l'appel système sous-jacent utilise cette valeur comme taille de pile
832       <em>minimale</em>. C'est la limite logicielle (souvent élevée)
833       pour <code>ulimit -s</code> (8Mo si aucune limite) qui est
834       utilisée comme taille de pile par défaut.</li>
835     </ul>
836
837     <div class="note">Il est recommandé de ne pas réduire
838     <code class="directive">ThreadStackSize</code>, à moins qu'un grand nombre
839     de threads par processus enfant ne soit nécessaire. Sur certaines
840     plates-formes (y compris Linux), une valeur de 128000 est déjà trop
841     basse et provoque des crashes avec certains modules courants.</div>
842
843 </div>
844 </div>
845 <div class="bottomlang">
846 <p><span>Langues Disponibles: </span><a href="../de/mod/mpm_common.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
847 <a href="../en/mod/mpm_common.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
848 <a href="../fr/mod/mpm_common.html" title="Français">&nbsp;fr&nbsp;</a> |
849 <a href="../ja/mod/mpm_common.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
850 <a href="../tr/mod/mpm_common.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
851 </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>
852 <script type="text/javascript"><!--//--><![CDATA[//><!--
853 var comments_shortname = 'httpd';
854 var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mpm_common.html';
855 (function(w, d) {
856     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
857         d.write('<div id="comments_thread"><\/div>');
858         var s = d.createElement('script');
859         s.type = 'text/javascript';
860         s.async = true;
861         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
862         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
863     }
864     else { 
865         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
866     }
867 })(window, document);
868 //--><!]]></script></div><div id="footer">
869 <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>
870 <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[//><!--
871 if (typeof(prettyPrint) !== 'undefined') {
872     prettyPrint();
873 }
874 //--><!]]></script>
875 </body></html>