2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1705612 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <modulesynopsis metafile="mpm_common.xml.meta">
27 <name>mpm_common</name>
28 <description>Une série de directives implémentées par plusieurs
29 modules multi-processus (MPM)</description>
33 <name>CoreDumpDirectory</name>
34 <description>Le répertoire dans lequel le serveur HTTP Apache va tenter de se
35 positionner avant d'effectuer un vidage mémoire</description>
36 <syntax>CoreDumpDirectory <var>répertoire</var></syntax>
37 <default>Voir ci-dessous pour le répertoire par défaut</default>
38 <contextlist><context>server config</context></contextlist>
39 <modulelist><module>event</module><module>prefork</module>
40 <module>worker</module></modulelist>
43 <p>Cette directive permet de définir le répertoire dans lequel
44 Apache httpd va tenter de se positionner avant d'effectuer un vidage
45 mémoire sur disque.
46 Si votre système d'exploitation est configuré pour créer des
47 fichiers de vidage mémoire dans le répertoire de travail des
48 processus qui se sont crashés,
49 <directive>CoreDumpDirectory</directive> est nécessaire pour
50 définir un répertoire de travail autre que le répertoire par défaut
51 <directive module="core">ServerRoot</directive>, ce répertoire de
52 travail ne devant pas être accessible en écriture par l'utilisateur sous
53 lequel le serveur s'exécute.</p>
55 <p>Si vous avez besoin d'un vidage mémoire pour le débogage, vous
56 pouvez utiliser cette directive pour le placer à un endroit
57 différent. Cette directive n'a aucun effet si votre système
58 d'exploitation n'est pas configuré pour créer des
59 fichiers de vidage mémoire dans le répertoire de travail des
60 processus qui se sont crashés.</p>
62 <note><title>Vidages mémoire sous Linux</title>
63 <p>Si Apache httpd est démarré sous l'utilisateur root puis bascule vers
64 un autre utilisateur, le noyau Linux <em>désactive</em> les
65 vidages mémoire, même si le répertoire est accessible en écriture au
66 processus. Apache httpd (versions 2.0.46 et supérieures) réactive les
67 vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous
68 définissez une directive <directive>CoreDumpDirectory</directive>.</p>
72 <title>Vidages mémoire sous BSD</title>
73 <p>Pour activer le vidage mémoire des exécutables suid sur les
74 systèmes de style BSD (comme FreeBSD), définissez
75 <code>kern.sugid_coredump</code> à 1.
79 <note><title>Signaux spécifiques</title>
80 <p><directive>CoreDumpDirectory</directive> n'est traité qu'à la
81 reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT,
82 SIGSEGV, et SIGBUS.</p>
84 Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un
85 vidage mémoire, mais n'est pas traité par les directives
86 <directive>CoreDumpDirectory</directive> ou
87 <directive>EnableExceptionHook</directive>, si bien que la
88 définition du répertoire d'enregistrement du vidage mémoire est
89 entièrement dévolue au système d'exploitation.</p>
95 <name>EnableExceptionHook</name>
96 <description>Active un hook ("point d'accrochage logiciel") qui exécute des
97 gestionnaires d'exception après un crash</description>
98 <syntax>EnableExceptionHook On|Off</syntax>
99 <default>EnableExceptionHook Off</default>
100 <contextlist><context>server config</context></contextlist>
102 <module>event</module><module>prefork</module>
103 <module>worker</module></modulelist>
106 <p>Pour des raisons de sécurité, cette directive n'est disponible
107 que si la compilation du serveur a été configurée avec l'option
108 <code>--enable-exception-hook</code>. Elle permet d'activer un hook
109 ("point d'accrochage logiciel")
110 qui autorise certains modules externes à effectuer un branchement et
111 accomplir telle ou telle action après le crash d'un processus
114 <p>Deux modules, <code>mod_whatkilledus</code> et
115 <code>mod_backtrace</code> utilisent ce hook. Veuillez vous
116 référer à la <a
117 href="http://people.apache.org/~trawick/exception_hook.html"
118 >page EnableExceptionHook</a> de Jeff Trawick pour plus
119 d'informations à leur sujet.</p>
124 <name>GracefulShutdownTimeout</name>
125 <description>Spécifie le délai maximum après lequel le serveur va
126 s'arrêter dans le cas d'un arrêt "en douceur"</description>
127 <syntax>GracefulShutdownTimeout <var>seconds</var></syntax>
128 <default>GracefulShutdownTimeout 0</default>
129 <contextlist><context>server config</context></contextlist>
130 <modulelist><module>prefork</module><module>worker</module>
131 <module>event</module></modulelist>
132 <compatibility>Disponible dans les versions 2.2 et supérieures</compatibility>
135 <p>La directive <directive>GracefulShutdownTimeout</directive>
136 permet de spécifier le temps, en secondes, pendant lequel le serveur
137 va continuer à fonctionner après avoir reçu un signal
138 "graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement
139 des connexions en cours.</p>
141 <p>Définir cette valeur à zéro signifie au serveur d'attendre
142 jusqu'à ce que toutes les requêtes en cours aient été traitées.</p>
148 <description>Ficher dans lequel le serveur enregistre l'identificateur
149 de processus du démon</description>
150 <syntax>PidFile <var>nom fichier</var></syntax>
151 <default>PidFile logs/httpd.pid</default>
152 <contextlist><context>server config</context></contextlist>
153 <modulelist><module>event</module><module>mpm_winnt</module>
154 <module>mpmt_os2</module><module>prefork</module><module>worker</module>
158 <p>La directive <directive>PidFile</directive> permet de définir le
159 ficher dans lequel le serveur
160 enregistre l'identificateur de processus du démon. Si le chemin du
161 fichier n'est pas absolu, il est considéré comme relatif au chemin
162 défini par la directive <directive
163 module="core">ServerRoot</directive>.</p>
165 <example><title>Exemple</title>
166 <highlight language="config">
167 PidFile /var/run/apache.pid
171 <p>Il est souvent utile de pouvoir envoyer un signal au
172 serveur afin qu'il ferme et ouvre à nouveau ses journaux
173 d'<directive module="core">erreur</directive> et de <directive
174 module="mod_log_config">transfert</directive>, et recharge son
175 fichier de configuration. Pour ce faire, on envoie un signal SIGHUP
176 (kill -1) à l'identificateur de processus enregistré dans le fichier
177 défini par la directive <directive>PidFile</directive>.</p>
179 <p>La directive <directive>PidFile</directive> fait l'objet des
180 mêmes avertissements que ceux concernant le chemin d'enregistrement
181 des fichiers journaux et la <a
182 href="../misc/security_tips.html#serverroot">sécurité</a>.</p>
184 <note><title>Note</title>
185 <p>Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser
186 que le script <program>apachectl</program>, ou le script de
187 démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
188 arrêter le serveur.</p>
195 <description>Les adresses IP et ports sur lesquels le serveur écoute</description>
196 <syntax>Listen [<var>adresse IP</var>:]<var>numéro port</var>
197 [<var>protocole</var>]</syntax>
198 <contextlist><context>server config</context></contextlist>
199 <modulelist><module>mpm_netware</module><module>mpm_winnt</module>
200 <module>mpmt_os2</module>
201 <module>prefork</module><module>worker</module>
202 <module>event</module>
204 <compatibility>L'argument <var>protocole</var> est supporté depuis la version
205 2.1.5</compatibility>
208 <p>La directive <directive>Listen</directive> permet de signifier à
209 Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par
210 défaut, le serveur répond aux requêtes en provenance de toutes les
211 interfaces réseau. La directive <directive>Listen</directive> est
212 dorénavant requise, et si elle est absente du fichier de
213 configuration, le serveur refusera de démarrer. Ceci constitue un
214 changement par rapport aux versions précédentes d'Apache httpd.</p>
216 <p>La directive <directive>Listen</directive> signifie au serveur de
217 n'accepter les requêtes entrantes que vers le port ou le couple
218 adresse-port spécifié. Si seulement un port est spécifié, le serveur
219 se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP
220 et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur
221 l'interface réseau correspondant à l'adresse IP.</p>
223 <p>On peut utiliser autant de directives
224 <directive>Listen</directive> que nécessaire pour spécifier
225 plusieurs adresses et/ou ports à écouter. Le serveur répondra aux
226 requêtes vers tous les adresses et ports spécifiés.</p>
228 <p>Par exemple, pour que le serveur accepte les connexions sur les
229 ports 80 et 8000, utilisez :</p>
231 <highlight language="config">
236 <p>Pour que le serveur accepte les connexions sur deux interfaces et
237 ports particuliers, spécifiez :</p>
239 <highlight language="config">
240 Listen 192.170.2.1:80
241 Listen 192.170.2.5:8000
244 <p>Les adressee IPv6 doivent être entourées de crochets, comme dans
245 l'exemple suivant :</p>
247 <highlight language="config">
248 Listen [2001:db8::a00:20ff:fea7:ccea]:80
251 <p>L'argument optionnel <var>protocole</var> n'est pas nécessaire
252 dans la plupart des configurations. S'il est absent,
253 <code>https</code> est la valeur par défaut pour le port 443 et
254 <code>http</code> l'est pour tous les autres ports. L'argument
255 protocole sert à déterminer quel module doit traiter une requête, et
256 à appliquer des optimisations spécifiques à certains protocoles à
257 l'aide de la directive <directive
258 module="core">AcceptFilter</directive>.</p>
260 <p>La spécification d'un protocole n'est nécessaire que si vous
261 utilisez des ports non standards. Par exemple, pour configurer un
262 site en <code>https</code> sur le port 8443 :</p>
264 <highlight language="config">
265 Listen 192.170.2.1:8443 https
268 <note><title>Condition d'erreur</title>
269 Plusieurs directives <directive>Listen</directive> pour les mêmes
270 adresse IP/port vont provoquer l'envoi d'un message d'erreur
271 <code>Address already in use</code>.
275 <seealso><a href="../dns-caveats.html">Problèmes avec DNS</a></seealso>
276 <seealso><a href="../bind.html">Définition des adresses et ports
277 qu'utilise le serveur HTTP Apache</a></seealso>
279 href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Autre
280 discussion à propos du message d'erreur <code>Address already in
281 use</code>, citant d'autres causes possibles.</a></seealso>
285 <name>ListenCoresBucketsRatio</name>
286 <description>Rapport entre le nombre de coeurs de processeur activés et
287 le nombre de segments d'écoute</description>
288 <syntax>ListenCoresBucketsRatio <var>ratio</var></syntax>
289 <default>ListenCoresBucketsRatio 0 (disabled)</default>
290 <contextlist><context>server config</context></contextlist>
292 <module>event</module>
293 <module>prefork</module>
294 <module>worker</module></modulelist>
295 <compatibility>Disponible à partir de la version 2.4.13 du serveur HTTP
296 Apache, avec un noyau supportant l'option de socket
297 <code>SO_REUSEPORT</code>, et distribuant uniformément les nouvelles
298 connexions aux sockets d'écoute des processus (ou threads) qui
299 l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas
300 l'implémentation courante de <code>SO_REUSEPORT</code> par les
301 plateformes de type BSD.</compatibility>
304 <p>Vous pouvez utiliser la directive
305 <directive>ListenCoresBucketsRatio</directive> pour spécifier un
306 <var>ratio</var> entre le nombre de coeurs de CPU activés et le
307 nombre de segments d'écoute (listeners' buckets) souhaités ; le
308 serveur HTTP Apache va alors créer<code>num_cpu_cores / ratio</code>
309 segments d'écoute, chacun contenant son propre socket d'écoute
310 <directive>Listen</directive> sur le ou les mêmes ports ; chaque
311 processus enfant sera associé à un seul segment d'écoute (avec une
312 distribution de type round-robin des segments à la création des
313 processus enfants).</p>
315 <p>La directive <directive>ListenCoresBucketsRatio</directive> peut
316 améliorer le support de la montée en charge lorsque l'arrivée de
317 nouvelles connexions est/devient un goulot d'étranglement. Le test
318 de cette fonctionnalité avec des machines possédant un nombre de
319 coeurs de CPU important a permit de constater une amélioration des
320 performances significative et des temps de réponse plus courts.</p>
322 <p>Pour que cette fonctionnalité soit activée, le nombre de coeurs
323 de CPU doit être égal au moins au double du <var>ratio</var>
324 spécifié. Si vous spécifiez la valeur recommandée pour
325 <var>ratio</var>, à savoir <code>8</code>, le nombre minimum de
326 coeurs de processeurs disponibles sera alors de <code>16</code>.</p>
331 <name>ListenBackLog</name>
332 <description>Longueur maximale de la liste d'attente des
333 connexions</description>
334 <syntax>ListenBacklog <var>backlog</var></syntax>
335 <default>ListenBacklog 511</default>
336 <contextlist><context>server config</context></contextlist>
338 <module>event</module>
339 <module>mpm_netware</module><module>mpm_winnt</module>
340 <module>mpmt_os2</module><module>prefork</module>
341 <module>worker</module></modulelist>
344 <p>La longueur maximale de la liste d'attente des connexions. En
345 général, aucune modification n'est nécessaire, ni même souhaitable ;
346 cependant, sur certains systèmes, il peut être nécessaire
347 d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en
348 masse de requêtes SYN pour saturer le serveur). Voir le paramètre
349 backlog de l'appel système <code>listen(2)</code>.</p>
351 <p>En fait, l'argument backlog sera souvent limité à une valeur
352 inférieure en fonction du système d'exploitation. Notez aussi que de
353 nombreux systèmes d'exploitation ne tiennent pas vraiment compte de
354 la valeur spécifiée pour l'argument backlog, mais s'en inspirent
355 seulement (et choisissent en général une valeur supérieure).</p>
360 <name>MaxRequestWorkers</name>
361 <description>Nombre maximum de connexions pouvant être traitées
362 simultanément</description>
363 <syntax>MaxRequestWorkers <var>nombre</var></syntax>
364 <default>Voir ci-dessous pour plus de détails</default>
365 <contextlist><context>server config</context></contextlist>
366 <modulelist><module>event</module><module>prefork</module>
367 <module>worker</module>
371 <p>La directive <directive>MaxRequestWorkers</directive> permet de fixer le
372 nombre maximum de requêtes pouvant être traitées simultanément.
373 Si la limite <directive>MaxRequestWorkers</directive> est atteinte, toute
374 tentative de connexion sera normalement mise dans une file
375 d'attente, et ceci jusqu'à un certain nombre dépendant de la
376 directive <directive module="mpm_common">ListenBacklog</directive>.
377 Lorsqu'un processus enfant se libèrera suite à la fin du traitement
378 d'une requête, la connexion en attente pourra être traitée à son
381 <p>Pour les serveurs non threadés (<em>c'est à dire</em> utilisant
382 <module>prefork</module>), la directive
383 <directive>MaxRequestWorkers</directive> définit alors le nombre maximum de
384 processus enfants qui pourront être lancés simultanément pour
385 traiter les requêtes. La valeur par défaut est <code>256</code> ; si
386 vous l'augmentez, vous devez aussi augmenter la valeur de la
388 module="mpm_common">ServerLimit</directive>.</p>
390 <p>Pour les serveur threadés et hybrides (utilisant <em>par
391 exemple</em> <module>event</module> ou <module>worker</module>),
392 <directive>MaxRequestWorkers</directive> définit alors le nombre total de
393 threads qui seront disponibles pour servir les clients. Dans le
394 cas des MPMs hybrides, la valeur par défaut est <code>16</code>
395 (directive <directive
396 module="mpm_common">ServerLimit</directive>) multiplié par la valeur
397 <code>25</code> (directive <directive module="mpm_common"
398 >ThreadsPerChild</directive>). Par conséquent, pour affecter à la
399 directive <directive>MaxRequestWorkers</directive> une valeur qui requiert
400 plus de 16 processus, vous devez aussi augmenter la valeur de la
401 directive <directive module="mpm_common"
402 >ServerLimit</directive>.</p>
404 <p>Le nom de la directive <directive>MaxRequestWorkers</directive>
405 était <directive>MaxClients</directive> avant la version 2.3.13. Cet
406 ancien nom est encore supporté.</p>
411 <name>MaxMemFree</name>
412 <description>Quantité maximale de mémoire que l'allocateur principal est
413 autorisé à conserver sans appeler <code>free()</code></description>
414 <syntax>MaxMemFree <var>KOctets</var></syntax>
415 <default>MaxMemFree 2048</default>
416 <contextlist><context>server config</context></contextlist>
417 <modulelist><module>event</module><module>mpm_netware</module>
418 <module>prefork</module><module>worker</module><module>mpm_winnt</module>
422 <p>La directive <directive>MaxMemFree</directive> permet de définir
423 le nombre maximum de KOctets libres que tout allocateur est
424 autorisé à conserver sans appeler <code>free()</code>. Dans les MPMs
425 threadés, chaque thread possède son propre allocateur. Si elle est
426 définie à 0, la quantité de mémoire libre que peut conserver un
427 allocateur est illimitée.</p>
432 <name>MaxConnectionsPerChild</name>
433 <description>Limite le nombre de connexions qu'un processus enfant va
434 traiter au cours de son fonctionnement</description>
435 <syntax>MaxConnectionsPerChild <var>number</var></syntax>
436 <default>MaxConnectionsPerChild 0</default>
437 <contextlist><context>server config</context></contextlist>
438 <modulelist><module>event</module><module>mpm_netware</module>
439 <module>mpm_winnt</module><module>mpmt_os2</module>
440 <module>prefork</module><module>worker</module></modulelist>
441 <compatibility>Disponible depuis la version 2.3.9 du serveur HTTP
442 Apache. L'ancien nom <code>MaxRequestsPerChild</code> est encore
443 supporté.</compatibility>
446 <p>La directive <directive>MaxConnectionsPerChild</directive> permet de
447 définir le nombre maximum de connexions qu'un processus enfant va
448 pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
449 <directive>MaxConnectionsPerChild</directive> connexions, le processus
450 enfant est arrêté. Si <directive>MaxConnectionsPerChild</directive> est
451 définie à <code>0</code>, il n'y a plus aucune limite sur le nombre
452 de connexions que le processus pourra traiter.</p>
454 <p>Définir <directive>MaxConnectionsPerChild</directive> à une valeur
455 non nulle limite la quantité de mémoire qu'un processus peut
456 consommer à cause de fuites (accidentelles) de mémoire.</p>
462 <name>MaxSpareThreads</name>
463 <description>Nombre maximum de threads inactifs</description>
464 <syntax>MaxSpareThreads <var>nombre</var></syntax>
465 <default>Voir ci-dessous pour plus de détails</default>
466 <contextlist><context>server config</context></contextlist>
467 <modulelist><module>event</module><module>mpm_netware</module>
468 <module>mpmt_os2</module><module>worker</module></modulelist>
471 <p>C'est le nombre maximum de threads inactifs. Les MPMs utilisent
472 cette directive de différentes manières.</p>
474 <p>Pour <module>worker</module>, la définition par défaut est
475 <code>MaxSpareThreads 250</code>. Ce MPM gère les threads inactifs
476 au niveau du serveur. Si le serveur possède trop de threads
477 inactifs, des processus enfants seront arrêtés jusqu'à ce que le
478 nombre de threads inactifs repasse en dessous de cette limite.</p>
480 <p>Pour <module>mpm_netware</module>, la définition par défaut est
481 <code>MaxSpareThreads 100</code>. Comme ce MPM n'exécute qu'un seul
482 processus, le nombre de processus inactifs est surveillé au
483 niveau du serveur.</p>
485 <p><module>mpmt_os2</module> fonctionne de manière similaire à
486 <module>mpm_netware</module>. Pour <module>mpmt_os2</module>, la
487 valeur par défaut est <code>10</code>.</p>
489 <note><title>Contraintes</title>
490 <p>La gamme de valeurs pour <directive>MaxSpareThreads</directive>
491 est limitée. Apache httpd corrigera automatiquement cette valeur selon
492 les règles suivantes :</p>
494 <li>Avec <module>mpm_netware</module>, <directive
495 >MaxSpareThreads</directive> doit être supérieure à <directive
496 module="mpm_common">MinSpareThreads</directive>.</li>
499 <module>worker</module>, <directive>MaxSpareThreads</directive>
500 doit être supérieure ou égale à la somme de <directive
501 module="mpm_common">MinSpareThreads</directive> et <directive
502 module="mpm_common">ThreadsPerChild</directive>.</li>
506 <seealso><directive module="mpm_common">MinSpareThreads</directive></seealso>
507 <seealso><directive module="mpm_common">StartServers</directive></seealso>
508 <seealso><directive module="prefork">MaxSpareServers</directive></seealso>
512 <name>MinSpareThreads</name>
513 <description>Nombre minimum de threads inactifs qui seront disponibles
514 pour pouvoir traiter les pics de requêtes</description>
515 <syntax>MinSpareThreads <var>nombre</var></syntax>
516 <default>Voir ci-dessous pour plus de détails</default>
517 <contextlist><context>server config</context></contextlist>
518 <modulelist><module>event</module><module>mpm_netware</module>
519 <module>mpmt_os2</module><module>worker</module></modulelist>
522 <p>C'est le nombre minimum de threads inactifs pour être en mesure
523 de traiter les pics de requêtes. Les MPMs utilisent cette directive
524 de différentes manières.</p>
526 <p>Avec <module>worker</module>, la définition par défaut est
527 <code>MinSpareThreads 75</code>, et le nombre de threads inactifs
528 est surveillé au niveau du serveur. Si le serveur ne possède pas
529 assez de threads inactifs, des processus enfants sont créés jusqu'à
530 ce que le nombre de threads inactifs repasse au dessus de
531 <var>nombre</var>.</p>
533 <p>Avec <module>mpm_netware</module>, la définition par défaut est
534 <code>MinSpareThreads 10</code> et, comme ce MPM n'exécute qu'un
535 seul processus, le nombre de threads est surveillé au niveau du
538 <p><module>mpmt_os2</module> fonctionne de manière similaire à
539 <module>mpm_netware</module>. Pour <module>mpmt_os2</module>, la
540 valeur par défaut est <code>5</code>.</p>
543 <seealso><directive module="mpm_common">MaxSpareThreads</directive></seealso>
544 <seealso><directive module="mpm_common">StartServers</directive></seealso>
545 <seealso><directive module="prefork">MinSpareServers</directive></seealso>
549 <name>ScoreBoardFile</name>
550 <description>Chemin du fichier où sont stockées les données concernant
551 la coordination des processus enfants</description>
552 <syntax>ScoreBoardFile <var>chemin fichier</var></syntax>
553 <default>ScoreBoardFile logs/apache_runtime_status</default>
554 <contextlist><context>server config</context></contextlist>
555 <modulelist><module>event</module><module>mpm_winnt</module>
556 <module>prefork</module><module>worker</module></modulelist>
559 <p>Le serveur HTTP Apache utilise un tableau de bord pour la
560 communication entre le processus parent et les processus enfants.
561 Pour faciliter cette communication, certaines architectures
562 nécessitent un fichier. En l'absence de cette directive, donc si
563 aucun nom de fichier n'est spécifié, Apache httpd tentera tout
564 d'abord de créer un tableau uniquement en mémoire (en utilisant la
565 mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de
566 créer un fichier sur disque (en utilisant la mémoire partagée à base
567 de fichier). Si cette directive est utilisée, Apache httpd créera
568 systématiquement un fichier sur disque.</p>
570 <example><title>Exemple</title>
571 <highlight language="config">
572 ScoreBoardFile /var/run/apache_runtime_status
576 <p>Une mémoire partagée sous forme de fichier est utile pour les
577 applications tierces qui nécessitent un accès direct au tableau de
578 bord des processus.</p>
580 <p>Si vous utilisez un <directive>ScoreBoardFile</directive>, vous
581 pourrez constater une amélioration des performances en le plaçant
582 sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte
583 des mêmes avertissements que ceux concernant le chemin du fichier
585 href="../misc/security_tips.html">sécurité</a>.</p>
587 <seealso><a href="../stopping.html">Arrêter et redémarrer
588 le serveur HTTP Apache</a></seealso>
592 <name>ReceiveBufferSize</name>
593 <description>Taille du tampon TCP en entrée</description>
594 <syntax>ReceiveBufferSize <var>octets</var></syntax>
595 <default>ReceiveBufferSize 0</default>
596 <contextlist><context>server config</context></contextlist>
597 <modulelist><module>event</module><module>mpm_netware</module>
598 <module>mpm_winnt</module><module>mpmt_os2</module><module>prefork</module>
599 <module>worker</module></modulelist>
602 <p>Le serveur va fixer la taille du tampon TCP en entrée au
603 nombre d'octets spécifié.</p>
605 <p>Si la directive est définie à <code>0</code>, le serveur va
606 utiliser la valeur par défaut adoptée par le système
612 <name>SendBufferSize</name>
613 <description>Taille du tampon TCP en sortie</description>
614 <syntax>SendBufferSize <var>octets</var></syntax>
615 <default>SendBufferSize 0</default>
616 <contextlist><context>server config</context></contextlist>
617 <modulelist><module>event</module><module>mpm_netware</module>
618 <module>mpm_winnt</module><module>mpmt_os2</module><module>prefork</module>
619 <module>worker</module></modulelist>
622 <p>Définit la taille du tampon TCP en sortie avec le nombre
623 d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les
624 valeurs par défaut standards du passé des systèmes d'exploitation
625 pour les transmissions à grande vitesse et haute densité (<em>c'est
626 à dire</em> de l'ordre de 100ms comme sur les liaisons rapides
627 transcontinentales).</p>
629 <p>Si la directive est définie à <code>0</code>, le serveur va
630 utiliser la valeur par défaut adoptée par le système
633 <p>L'amélioration des performances des connexions à grande vitesse
634 et à temps de latence élevé, peut nécessiter
635 une intervention au niveau de la configuration de votre système
638 <note><p>Sous certains systèmes d'exploitation, la modification du
639 comportement TCP via une augmentation de la valeur de
640 <directive>SendBufferSize</directive> risque de ne pas être
641 perceptible, si la directive <directive
642 module="core">EnableSendfile</directive> n'est pas définie à OFF.
643 Cette interaction ne s'applique qu'aux fichiers statiques.</p> </note>
648 <name>ServerLimit</name>
649 <description>Limite supérieure de la définition du nombre de
650 processus</description>
651 <syntax>ServerLimit <var>nombre</var></syntax>
652 <default>Voir ci-dessous pour plus de détails</default>
653 <contextlist><context>server config</context></contextlist>
654 <modulelist><module>event</module><module>prefork</module>
655 <module>worker</module></modulelist>
658 <p>Avec le MPM <module>prefork</module>, cette directive définit le
659 nombre maximum que l'on peut affecter à la directive <directive
660 module="mpm_common">MaxRequestWorkers</directive>, et ceci pour la
661 durée de vie du processus Apache httpd. Avec le
662 MPM <module>worker</module>, cette directive, en combinaison avec
663 <directive module="mpm_common">ThreadLimit</directive>, définit le
664 nombre maximum que l'on peut affecter à <directive
665 module="mpm_common">MaxRequestWorkers</directive>, et ceci pour la durée de
666 vie du processus Apache httpd. Au cours d'un redémarrage, vous pouvez
667 modifier la valeur de la directive <directive
668 module="mpm_common">MaxRequestWorkers</directive>, alors que toute
669 tentative de modification de la valeur de la directive <directive
670 module="mpm_common">ServerLimit</directive> sera ignorée.</p>
672 <p>Cette directive doit être utilisée avec précaution. Si
673 <directive>ServerLimit</directive> est définie à une valeur beaucoup
674 plus grande que nécessaire, de la mémoire partagée supplémentaire
675 sera inutilement allouée. Si à la fois
676 <directive>ServerLimit</directive> et <directive
677 module="mpm_common">MaxRequestWorkers</directive> possèdent des valeurs
678 supérieures à ce que le système peut supporter, ce dernier peut
679 devenir instable ou Apache httpd peut tout simplement refuser de démarrer.</p>
681 <p>Avec le MPM <module>prefork</module>, n'utilisez cette directive
682 que si vous devez définir <directive
683 module="mpm_common">MaxRequestWorkers</directive> à une valeur supérieure à
684 256 (valeur par défaut). N'affectez pas à la directive <directive
685 module="mpm_common">ServerLimit</directive> une valeur supérieure à
686 celle que vous avez prévu d'affecter à la directive <directive
687 module="mpm_common">MaxRequestWorkers</directive>.</p>
689 <p>Avec <module>worker</module>, n'utilisez cette directive que si
690 la définition de vos directives <directive
691 module="mpm_common">MaxRequestWorkers</directive> et <directive
692 module="mpm_common">ThreadsPerChild</directive> nécessitent plus de
693 16 processus serveurs (valeur par défaut). N'affectez pas à la
694 directive <directive module="mpm_common">ServerLimit</directive> une
695 valeur supérieure au nombre de processus requis pour la définition
696 des directives <directive module="mpm_common">MaxRequestWorkers
697 </directive> et <directive
698 module="mpm_common">ThreadsPerChild</directive>.</p>
700 <note><title>Note</title>
701 <p>Il existe une limite de <code>ServerLimit 20000</code> codée en
702 dur dans le serveur (200000 pour le MPM <module>prefork</module>).
703 Ceci est censé éviter les effets désastreux que pourrait provoquer
704 une faute de frappe. Pour dépasser cette limite, vous devez
705 modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du
706 mpm et recompiler le serveur.</p>
709 <seealso><a href="../stopping.html">Arrêter et redémarrer
710 le serveur HTTP Apache</a></seealso>
714 <name>StartServers</name>
715 <description>Nombre de processus enfants du serveur créés au
716 démarrage</description>
717 <syntax>StartServers <var>nombre</var></syntax>
718 <default>Voir ci-dessous pour plus de détails</default>
719 <contextlist><context>server config</context></contextlist>
720 <modulelist><module>event</module><module>mpmt_os2</module>
721 <module>prefork</module><module>worker</module>
725 <p>La directive <directive>StartServers</directive> permet de
726 définir le nombre de processus enfants du serveur créés au
727 démarrage. Comme le nombre de processus est contrôlé dynamiquement
728 en fonction de la charge (voir <directive
729 module="mpm_common">MinSpareThreads</directive>, <directive
730 module="mpm_common">MaxSpareThreads</directive>, <directive
731 module="prefork">MinSpareServers</directive>, <directive
732 module="prefork">MaxSpareServers</directive>), il n'est en général
733 pas nécessaire d'ajuster ce paramètre.</p>
735 <p>La valeur par défaut diffère d'un MPM à l'autre. Pour
736 <module>worker</module>, la définition par défaut est
737 <code>StartServers 3</code> ; la valeur par défaut est
738 <code>5</code> pour <module>prefork</module> et <code>2</code>
739 pour <module>mpmt_os2</module>.</p>
744 <name>StartThreads</name>
745 <description>Nombre de threads créés au démarrage</description>
746 <syntax>StartThreads <var>nombre</var></syntax>
747 <default>Voir ci-dessous pour plus de détails</default>
748 <contextlist><context>server config</context></contextlist>
749 <modulelist><module>mpm_netware</module></modulelist>
752 <p>C'est le nombre de threads créés au démarrage du serveur. Comme
753 le nombre de threads est contrôlé dynamiquement
754 en fonction de la charge (voir <directive
755 module="mpm_common">MinSpareThreads</directive>, <directive
756 module="mpm_common">MaxSpareThreads</directive>, <directive
757 module="prefork">MinSpareServers</directive>, <directive
758 module="prefork">MaxSpareServers</directive>), il n'est en général
759 pas nécessaire d'ajuster ce paramètre.</p>
761 <p>Pour <module>mpm_netware</module>, la définition par défaut est
762 <code>StartThreads 50</code> et, comme il n'y a qu'un processus, il
763 s'agit du nombre total de threads créés au démarrage pour servir les
769 <name>ThreadLimit</name>
770 <description>Le nombre de threads maximum que l'on peut définir par
771 processus enfant</description>
772 <syntax>ThreadLimit <var>nombre</var></syntax>
773 <default>Voir ci-dessous pour plus de détails</default>
774 <contextlist><context>server config</context></contextlist>
775 <modulelist><module>event</module><module>mpm_winnt</module>
776 <module>worker</module></modulelist>
779 <p>Cette directive permet de définir le nombre maximum que l'on peut
780 affecter à la directive <directive
781 module="mpm_common">ThreadsPerChild</directive> pour la durée de vie
782 du processus Apache httpd. La directive <directive
783 module="mpm_common">ThreadsPerChild</directive> peut être modifiée
784 au cours d'un redémarrage jusqu'à la valeur de la directive <directive
785 module="mpm_common">ThreadLimit</directive>, mais toute tentative
786 de modification de la directive <directive
787 module="mpm_common">ThreadLimit</directive> au cours d'un
788 redémarrage sera ignorée.</p>
790 <p>L'utilisation de cette directive doit faire l'objet de
791 précautions particulières. Si <directive>ThreadLimit</directive> est
792 définie à une valeur très supérieure à la directive <directive
793 module="mpm_common">ThreadsPerChild</directive>, de la mémoire
794 partagée supplémentaire sera inutilement allouée. Si les directives
795 <directive>ThreadLimit</directive> et <directive
796 module="mpm_common">ThreadsPerChild</directive> sont définies à des
797 valeurs supérieures à ce que le système peut supporter, ce dernier
798 peut devenir instable, ou Apache httpd peut tout simplement refuser de
799 démarrer. Ne définissez pas cette directive à une valeur supérieure
800 à la valeur maximale que vous pensez affecter à la directive <directive
801 module="mpm_common">ThreadsPerChild</directive> pour le processus
802 Apache httpd en cours d'exécution.</p>
804 <p>La valeur par défaut de la directive
805 <directive>ThreadLimit</directive> est <code>1920</code> avec
806 <module>mpm_winnt</module>, et <code>64</code> avec les autres
809 <note><title>Note</title>
810 <p>Il existe une limite de <code>ThreadLimit 20000</code> (ou
811 <code>ThreadLimit 100000</code> avec <module>event</module>,
812 <code>ThreadLimit 15000</code> avec <module>mpm_winnt</module>)
813 codée en dur dans le serveur. Ceci est censé éviter les effets
814 désastreux que pourrait provoquer une faute de frappe. Pour
815 dépasser cette limite, vous devez modifier la valeur de
816 MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le
823 <name>ThreadsPerChild</name>
824 <description>Nombre de threads créés par chaque processus
826 <syntax>ThreadsPerChild <var>nombre</var></syntax>
827 <default>Voir ci-dessous pour plus de détails</default>
828 <contextlist><context>server config</context></contextlist>
829 <modulelist><module>event</module><module>mpm_winnt</module>
830 <module>worker</module></modulelist>
833 <p>Cette directive permet de définir le nombre de threads que va
834 créer chaque processus enfant. Un processus enfant crée ces threads
835 au démarrage et n'en crée plus d'autres par la suite. Si l'on
836 utilise un MPM comme <module>mpm_winnt</module> qui ne lance qu'un
837 processus enfant, ce nombre doit être suffisamment grand pour
838 supporter la charge du serveur. Avec un MPM comme
839 <module>worker</module> qui lance plusieurs processus enfants, c'est
840 le nombre <em>total</em> de threads qui doit être suffisamment grand
841 pour supporter la charge du serveur.</p>
843 <p>La valeur par défaut de la directive
844 <directive>ThreadsPerChild</directive> est <code>64</code> avec
845 <module>mpm_winnt</module>, et <code>25</code> avec les autres
851 <name>ThreadStackSize</name>
852 <description>La taille en octets de la pile qu'utilisent les threads qui
853 traitent les connexions clients</description>
854 <syntax>ThreadStackSize <var>taille</var></syntax>
855 <default>65536 sous NetWare; varie en fonction des autres systèmes
856 d'exploitation</default>
857 <contextlist><context>server config</context></contextlist>
858 <modulelist><module>event</module><module>mpm_netware</module>
859 <module>mpmt_os2</module><module>mpm_winnt</module><module>worker</module>
860 <module>event</module>
862 <compatibility>Disponible dans les versions 2.1 et supérieures
863 du serveur HTTP Apache</compatibility>
866 <p>La directive <directive>ThreadStackSize</directive> permet de
867 définir la taille de la pile (pour les données propres) qu'utilisent
868 les threads qui traitent les connexions clients en faisant appel à
869 des modules. Dans la plupart des cas, la valeur par défaut de la
870 taille de la pile du système d'exploitation convient, mais il existe
871 certaines situations où il peut s'avérer nécessaire de l'ajuster
875 <li>Sur les plates-formes qui possèdent une valeur par défaut de
876 taille de la pile relativement petite (par exemple HP-UX), Apache
877 httpd peut se crasher si l'on utilise certains modules tiers qui
878 possèdent un quantité de données propres stockées relativement
879 importante. Il se peut que ces mêmes modules fonctionnent
880 correctement sur d'autres plate-formes où la valeur par défaut de
881 la taille de la pile est supérieure. Ce type de crash peut être
882 evité en définissant <directive>ThreadStackSize</directive> à une
883 valeur supérieure à la valeur par défaut du système
884 d'exploitation. Ce type d'ajustement n'est nécessaire que si le
885 fournisseur du module tiers en fait mention, ou si le diagnostic
886 d'un crash d'Apache httpd indique que la taille de la pile était trop
889 <li>Sur les plates-formes où la taille par défaut de la pile des
890 threads est sensiblement supérieure à la taille nécessaire pour la
891 configuration du serveur web, il est possible de disposer d'un
892 plus grand nombre de threads par processus enfant si la directive
893 <directive>ThreadStackSize</directive> est définie à une valeur
894 inférieure à la valeur par défaut du système d'exploitation.
896 type d'ajustement ne doit être effectué que dans un environnement
897 de test permettant de qualifier le serveur web au maximum de ses
898 possibilités, car il peut arriver, dans de rares cas, que des
899 requêtes nécessitent une taille de pile supérieure pour pouvoir
900 être traitées. La taille minimale requise pour la pile dépend
901 fortement des modules utilisés, mais toute modification dans la
902 configuration du serveur web peut invalider la définition courante
903 de la directive <directive>ThreadStackSize</directive>.</li>
905 <li>Sous Linux, cette directive ne peut être utilisée que pour
906 augmenter la valeur par defaut de la taille de la pile, car
907 l'appel système sous-jacent utilise cette valeur comme taille de pile
908 <em>minimale</em>. C'est la limite logicielle (souvent élevée)
909 pour <code>ulimit -s</code> (8Mo si aucune limite) qui est
910 utilisée comme taille de pile par défaut.</li>
913 <note>Il est recommandé de ne pas réduire
914 <directive>ThreadStackSize</directive>, à moins qu'un grand nombre
915 de threads par processus enfant ne soit nécessaire. Sur certaines
916 plates-formes (y compris Linux), une valeur de 128000 est déjà trop
917 basse et provoque des crashes avec certains modules courants.</note>