You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2016/06/18 14:03:17 UTC
svn commit: r1749038 - in /httpd/httpd/branches/2.4.x/docs/manual/mod:
mod_ssl.xml.fr mpm_common.xml.fr
Author: lgentis
Date: Sat Jun 18 14:03:17 2016
New Revision: 1749038
URL: http://svn.apache.org/viewvc?rev=1749038&view=rev
Log:
XML updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ssl.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ssl.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ssl.xml.fr?rev=1749038&r1=1749037&r2=1749038&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ssl.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_ssl.xml.fr Sat Jun 18 14:03:17 2016
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1747069:1748338 (outdated) -->
+<!-- English Revision: 1748338 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -1401,10 +1401,12 @@ SSLCARevocationFile
<directivesynopsis>
<name>SSLCARevocationCheck</name>
<description>Active la vérification des révocations basée sur les CRL</description>
-<syntax>SSLCARevocationCheck chain|leaf|none</syntax>
+<syntax>SSLCARevocationCheck chain|leaf|none <em>flag</em>s</syntax>
<default>SSLCARevocationCheck none</default>
<contextlist><context>server config</context>
<context>virtual host</context></contextlist>
+<compatibility>Le drapeau optionnel <em>flag</em>s est disponible à partir de la
+version 2.5-dev du serveur HTTP Apache</compatibility>
<usage>
<p>
@@ -1417,27 +1419,35 @@ recommandée), les vérifications CR
certificats de la chaîne, alors que la valeur <code>leaf</code> limite
la vérification au certificat hors chaîne (la feuille).
</p>
-<note>
-<title>Lorsque la directive est définie à <code>chain</code> ou
-<code>leaf</code>, les CRLs doivent être disponibles pour que la
-validation réussisse</title>
+<p><em>flag</em>s peut prendre comme valeurs </p>
+<ul>
+<li><code>no_crl_for_cert_ok</code>
<p>
Avant la version 2.3.15, les vérifications CRL dans mod_ssl
réussissaient même si aucune CRL n'était trouvée dans les chemins
définis par les directives <directive
module="mod_ssl">SSLCARevocationFile</directive> ou <directive
-module="mod_ssl">SSLCARevocationPath</directive>. Le comportement a
-changé avec l'introduction de cette directive : lorsque la vérification
-est activée, les CRLs <em>doivent</em> être présentes pour que la
+module="mod_ssl">SSLCARevocationPath</directive>.</p>
+<p>Le comportement a
+changé avec l'introduction de la directive
+<directive>SSLCARevocationFile</directive> : par défaut avec
+<code>chain</code> ou <code>leaf</code>, les CRLs <em>doivent</em> être présentes pour que la
validation réussisse ; dans le cas contraire, elle échouera avec une
-erreur <code>"CRL introuvable"</code>.
-</p>
-</note>
+erreur <code>"unable to get certificate CRL"</code>.</p>
+<p>La valeur <code>no_crl_for_cert_ok</code> du drapeau <em>flag</em> permet de
+retrouver le comportement précédent.</p>
+</li>
+</ul>
<example><title>Exemple</title>
<highlight language="config">
SSLCARevocationCheck chain
</highlight>
</example>
+<example><title>Compatibilité avec la branche 2.2</title>
+<highlight language="config">
+SSLCARevocationCheck chain no_crl_for_cert_ok
+</highlight>
+</example>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.xml.fr?rev=1749038&r1=1749037&r2=1749038&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mpm_common.xml.fr Sat Jun 18 14:03:17 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1707631 -->
+<!-- English Revision: 1748951 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,76 +25,76 @@
<modulesynopsis metafile="mpm_common.xml.meta">
<name>mpm_common</name>
-<description>Une série de directives implémentées par plusieurs
+<description>Une série de directives implémentées par plusieurs
modules multi-processus (MPM)</description>
<status>MPM</status>
<directivesynopsis>
<name>CoreDumpDirectory</name>
-<description>Le répertoire dans lequel le serveur HTTP Apache va tenter de se
-positionner avant d'effectuer un vidage mémoire</description>
-<syntax>CoreDumpDirectory <var>répertoire</var></syntax>
-<default>Voir ci-dessous pour le répertoire par défaut</default>
+<description>Le répertoire dans lequel le serveur HTTP Apache va tenter de se
+positionner avant d'effectuer un vidage mémoire</description>
+<syntax>CoreDumpDirectory <var>répertoire</var></syntax>
+<default>Voir ci-dessous pour le répertoire par défaut</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module></modulelist>
<usage>
- <p>Cette directive permet de définir le répertoire dans lequel
+ <p>Cette directive permet de définir le répertoire dans lequel
Apache httpd va tenter de se positionner avant d'effectuer un vidage
- mémoire sur disque.
- Si votre système d'exploitation est configuré pour créer des
- fichiers de vidage mémoire dans le répertoire de travail des
- processus qui se sont crashés,
- <directive>CoreDumpDirectory</directive> est nécessaire pour
- définir un répertoire de travail autre que le répertoire par défaut
- <directive module="core">ServerRoot</directive>, ce répertoire de
- travail ne devant pas être accessible en écriture par l'utilisateur sous
- lequel le serveur s'exécute.</p>
-
- <p>Si vous avez besoin d'un vidage mémoire pour le débogage, vous
- pouvez utiliser cette directive pour le placer à un endroit
- différent. Cette directive n'a aucun effet si votre système
- d'exploitation n'est pas configuré pour créer des
- fichiers de vidage mémoire dans le répertoire de travail des
- processus qui se sont crashés.</p>
-
- <note><title>Vidages mémoire sous Linux</title>
- <p>Si Apache httpd est démarré sous l'utilisateur root puis bascule vers
- un autre utilisateur, le noyau Linux <em>désactive</em> les
- vidages mémoire, même si le répertoire est accessible en écriture au
- processus. Apache httpd (versions 2.0.46 et supérieures) réactive les
- vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous
- définissez une directive <directive>CoreDumpDirectory</directive>.</p>
+ mémoire sur disque.
+ Si votre système d'exploitation est configuré pour créer des
+ fichiers de vidage mémoire dans le répertoire de travail des
+ processus qui se sont crashés,
+ <directive>CoreDumpDirectory</directive> est nécessaire pour
+ définir un répertoire de travail autre que le répertoire par défaut
+ <directive module="core">ServerRoot</directive>, ce répertoire de
+ travail ne devant pas être accessible en écriture par l'utilisateur sous
+ lequel le serveur s'exécute.</p>
+
+ <p>Si vous avez besoin d'un vidage mémoire pour le débogage, vous
+ pouvez utiliser cette directive pour le placer à un endroit
+ différent. Cette directive n'a aucun effet si votre système
+ d'exploitation n'est pas configuré pour créer des
+ fichiers de vidage mémoire dans le répertoire de travail des
+ processus qui se sont crashés.</p>
+
+ <note><title>Vidages mémoire sous Linux</title>
+ <p>Si Apache httpd est démarré sous l'utilisateur root puis bascule vers
+ un autre utilisateur, le noyau Linux <em>désactive</em> les
+ vidages mémoire, même si le répertoire est accessible en écriture au
+ processus. Apache httpd (versions 2.0.46 et supérieures) réactive les
+ vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous
+ définissez une directive <directive>CoreDumpDirectory</directive>.</p>
</note>
<note>
- <title>Vidages mémoire sous BSD</title>
- <p>Pour activer le vidage mémoire des exécutables suid sur les
- systèmes de style BSD (comme FreeBSD), définissez
- <code>kern.sugid_coredump</code> à 1.
+ <title>Vidages mémoire sous BSD</title>
+ <p>Pour activer le vidage mémoire des exécutables suid sur les
+ systèmes de style BSD (comme FreeBSD), définissez
+ <code>kern.sugid_coredump</code> à 1.
</p>
</note>
- <note><title>Signaux spécifiques</title>
- <p><directive>CoreDumpDirectory</directive> n'est traité qu'à la
+ <note><title>Signaux spécifiques</title>
+ <p><directive>CoreDumpDirectory</directive> n'est traité qu'à la
reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT,
SIGSEGV, et SIGBUS.</p>
<p>
- Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un
- vidage mémoire, mais n'est pas traité par les directives
+ Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un
+ vidage mémoire, mais n'est pas traité par les directives
<directive>CoreDumpDirectory</directive> ou
<directive>EnableExceptionHook</directive>, si bien que la
- définition du répertoire d'enregistrement du vidage mémoire est
- entièrement dévolue au système d'exploitation.</p>
+ définition du répertoire d'enregistrement du vidage mémoire est
+ entièrement dévolue au système d'exploitation.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>EnableExceptionHook</name>
-<description>Active un hook ("point d'accrochage logiciel") qui exécute des
-gestionnaires d'exception après un crash</description>
+<description>Active un hook ("point d'accrochage logiciel") qui exécute des
+gestionnaires d'exception après un crash</description>
<syntax>EnableExceptionHook On|Off</syntax>
<default>EnableExceptionHook Off</default>
<contextlist><context>server config</context></contextlist>
@@ -103,50 +103,50 @@ gestionnaires d'exception après u
<module>prefork</module></modulelist>
<usage>
- <p>Pour des raisons de sécurité, cette directive n'est disponible
- que si la compilation du serveur a été configurée avec l'option
+ <p>Pour des raisons de sécurité, cette directive n'est disponible
+ que si la compilation du serveur a été configurée avec l'option
<code>--enable-exception-hook</code>. Elle permet d'activer un hook
("point d'accrochage logiciel")
- qui autorise certains modules externes à effectuer un branchement et
- accomplir telle ou telle action après le crash d'un processus
+ qui autorise certains modules externes à effectuer un branchement et
+ accomplir telle ou telle action après le crash d'un processus
enfant.</p>
<p>Deux modules, <code>mod_whatkilledus</code> et
<code>mod_backtrace</code> utilisent ce hook. Veuillez vous
- référer à la <a
+ référer à la <a
href="http://people.apache.org/~trawick/exception_hook.html"
>page EnableExceptionHook</a> de Jeff Trawick pour plus
- d'informations à leur sujet.</p>
+ d'informations à leur sujet.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>GracefulShutdownTimeout</name>
-<description>Spécifie le délai maximum après lequel le serveur va
-s'arrêter dans le cas d'un arrêt "en douceur"</description>
+<description>Spécifie le délai maximum après lequel le serveur va
+s'arrêter dans le cas d'un arrêt "en douceur"</description>
<syntax>GracefulShutdownTimeout <var>seconds</var></syntax>
<default>GracefulShutdownTimeout 0</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module></modulelist>
-<compatibility>Disponible dans les versions 2.2 et supérieures</compatibility>
+<compatibility>Disponible dans les versions 2.2 et supérieures</compatibility>
<usage>
<p>La directive <directive>GracefulShutdownTimeout</directive>
- permet de spécifier le temps, en secondes, pendant lequel le serveur
- va continuer à fonctionner après avoir reçu un signal
- "graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement
+ permet de spécifier le temps, en secondes, pendant lequel le serveur
+ va continuer à fonctionner après avoir reçu un signal
+ "graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement
des connexions en cours.</p>
- <p>Définir cette valeur à zéro signifie au serveur d'attendre
- jusqu'à ce que toutes les requêtes en cours aient été traitées.</p>
+ <p>Définir cette valeur à zéro signifie au serveur d'attendre
+ jusqu'à ce que toutes les requêtes en cours aient été traitées.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>PidFile</name>
<description>Ficher dans lequel le serveur enregistre l'identificateur
-de processus du démon</description>
+de processus du démon</description>
<syntax>PidFile <var>nom fichier</var></syntax>
<default>PidFile logs/httpd.pid</default>
<contextlist><context>server config</context></contextlist>
@@ -156,11 +156,11 @@ de processus du démon</descriptio
</modulelist>
<usage>
- <p>La directive <directive>PidFile</directive> permet de définir le
+ <p>La directive <directive>PidFile</directive> permet de définir le
ficher dans lequel le serveur
- enregistre l'identificateur de processus du démon. Si le chemin du
- fichier n'est pas absolu, il est considéré comme relatif au chemin
- défini par la directive <directive
+ enregistre l'identificateur de processus du démon. Si le chemin du
+ fichier n'est pas absolu, il est considéré comme relatif au chemin
+ défini par la directive <directive
module="core">ServerRoot</directive>.</p>
<example><title>Exemple</title>
@@ -170,60 +170,60 @@ de processus du démon</descriptio
</example>
<p>Il est souvent utile de pouvoir envoyer un signal au
- serveur afin qu'il ferme et ouvre à nouveau ses journaux
+ serveur afin qu'il ferme et ouvre à nouveau ses journaux
d'<directive module="core">erreur</directive> et de <directive
module="mod_log_config">transfert</directive>, et recharge son
fichier de configuration. Pour ce faire, on envoie un signal SIGHUP
- (kill -1) à l'identificateur de processus enregistré dans le fichier
- défini par la directive <directive>PidFile</directive>.</p>
+ (kill -1) à l'identificateur de processus enregistré dans le fichier
+ défini par la directive <directive>PidFile</directive>.</p>
<p>La directive <directive>PidFile</directive> fait l'objet des
- mêmes avertissements que ceux concernant le chemin d'enregistrement
+ mêmes avertissements que ceux concernant le chemin d'enregistrement
des fichiers journaux et la <a
- href="../misc/security_tips.html#serverroot">sécurité</a>.</p>
+ href="../misc/security_tips.html#serverroot">sécurité</a>.</p>
<note><title>Note</title>
<p>Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser
que le script <program>apachectl</program>, ou le script de
- démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
- arrêter le serveur.</p>
+ démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
+ arrêter le serveur.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>Listen</name>
-<description>Les adresses IP et ports sur lesquels le serveur écoute</description>
-<syntax>Listen [<var>adresse IP</var>:]<var>numéro port</var>
+<description>Les adresses IP et ports sur lesquels le serveur écoute</description>
+<syntax>Listen [<var>adresse IP</var>:]<var>numéro port</var>
[<var>protocole</var>]</syntax>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module><module>mpm_winnt</module>
<module>mpm_netware</module><module>mpmt_os2</module>
</modulelist>
-<compatibility>L'argument <var>protocole</var> est supporté depuis la version
+<compatibility>L'argument <var>protocole</var> est supporté depuis la version
2.1.5</compatibility>
<usage>
- <p>La directive <directive>Listen</directive> permet de signifier à
- Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par
- défaut, le serveur répond aux requêtes en provenance de toutes les
- interfaces réseau. La directive <directive>Listen</directive> est
- dorénavant requise, et si elle est absente du fichier de
- configuration, le serveur refusera de démarrer. Ceci constitue un
- changement par rapport aux versions précédentes d'Apache httpd.</p>
+ <p>La directive <directive>Listen</directive> permet de signifier à
+ Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par
+ défaut, le serveur répond aux requêtes en provenance de toutes les
+ interfaces réseau. La directive <directive>Listen</directive> est
+ dorénavant requise, et si elle est absente du fichier de
+ configuration, le serveur refusera de démarrer. Ceci constitue un
+ changement par rapport aux versions précédentes d'Apache httpd.</p>
<p>La directive <directive>Listen</directive> signifie au serveur de
- n'accepter les requêtes entrantes que vers le port ou le couple
- adresse-port spécifié. Si seulement un port est spécifié, le serveur
- se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP
- et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur
- l'interface réseau correspondant à l'adresse IP.</p>
+ n'accepter les requêtes entrantes que vers le port ou le couple
+ adresse-port spécifié. Si seulement un port est spécifié, le serveur
+ se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP
+ et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur
+ l'interface réseau correspondant à l'adresse IP.</p>
<p>On peut utiliser autant de directives
- <directive>Listen</directive> que nécessaire pour spécifier
- plusieurs adresses et/ou ports à écouter. Le serveur répondra aux
- requêtes vers tous les adresses et ports spécifiés.</p>
+ <directive>Listen</directive> que nécessaire pour spécifier
+ plusieurs adresses et/ou ports à écouter. Le serveur répondra aux
+ requêtes vers tous les adresses et ports spécifiés.</p>
<p>Par exemple, pour que le serveur accepte les connexions sur les
ports 80 et 8000, utilisez :</p>
@@ -234,30 +234,30 @@ Listen 8000
</highlight>
<p>Pour que le serveur accepte les connexions sur deux interfaces et
- ports particuliers, spécifiez :</p>
+ ports particuliers, spécifiez :</p>
<highlight language="config">
Listen 192.170.2.1:80
Listen 192.170.2.5:8000
</highlight>
- <p>Les adressee IPv6 doivent être entourées de crochets, comme dans
+ <p>Les adressee IPv6 doivent être entourées de crochets, comme dans
l'exemple suivant :</p>
<highlight language="config">
Listen [2001:db8::a00:20ff:fea7:ccea]:80
</highlight>
- <p>L'argument optionnel <var>protocole</var> n'est pas nécessaire
+ <p>L'argument optionnel <var>protocole</var> n'est pas nécessaire
dans la plupart des configurations. S'il est absent,
- <code>https</code> est la valeur par défaut pour le port 443 et
+ <code>https</code> est la valeur par défaut pour le port 443 et
<code>http</code> l'est pour tous les autres ports. L'argument
- protocole sert à déterminer quel module doit traiter une requête, et
- à appliquer des optimisations spécifiques à certains protocoles à
+ protocole sert à déterminer quel module doit traiter une requête, et
+ à appliquer des optimisations spécifiques à certains protocoles à
l'aide de la directive <directive
module="core">AcceptFilter</directive>.</p>
- <p>La spécification d'un protocole n'est nécessaire que si vous
+ <p>La spécification d'un protocole n'est nécessaire que si vous
utilisez des ports non standards. Par exemple, pour configurer un
site en <code>https</code> sur le port 8443 :</p>
@@ -266,63 +266,74 @@ Listen 192.170.2.5:8000
</highlight>
<note><title>Condition d'erreur</title>
- Plusieurs directives <directive>Listen</directive> pour les mêmes
+ Plusieurs directives <directive>Listen</directive> pour les mêmes
adresse IP/port vont provoquer l'envoi d'un message d'erreur
<code>Address already in use</code>.
</note>
</usage>
-<seealso><a href="../dns-caveats.html">Problèmes avec DNS</a></seealso>
-<seealso><a href="../bind.html">Définition des adresses et ports
+<seealso><a href="../dns-caveats.html">Problèmes avec DNS</a></seealso>
+<seealso><a href="../bind.html">Définition des adresses et ports
qu'utilise le serveur HTTP Apache</a></seealso>
<seealso><a
href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Autre
-discussion à propos du message d'erreur <code>Address already in
+discussion à propos du message d'erreur <code>Address already in
use</code>, citant d'autres causes possibles.</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ListenCoresBucketsRatio</name>
-<description>Rapport entre le nombre de coeurs de processeur activés et
-le nombre de segments d'écoute</description>
+<description>Rapport entre le nombre de coeurs de processeur activés et
+le nombre de segments d'écoute</description>
<syntax>ListenCoresBucketsRatio <var>ratio</var></syntax>
<default>ListenCoresBucketsRatio 0 (disabled)</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module>
</modulelist>
-<compatibility>Disponible à partir de la version 2.4.13 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.13 du serveur HTTP
Apache, avec un noyau supportant l'option de socket
-<code>SO_REUSEPORT</code>, et distribuant uniformément les nouvelles
-connexions aux sockets d'écoute des processus (ou threads) qui
-l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas
-l'implémentation courante de <code>SO_REUSEPORT</code> par les
+<code>SO_REUSEPORT</code>, et distribuant uniformément les nouvelles
+connexions aux sockets d'écoute des processus (ou threads) qui
+l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas
+l'implémentation courante de <code>SO_REUSEPORT</code> par les
plateformes de type BSD.</compatibility>
<usage>
<p>Vous pouvez utiliser la directive
- <directive>ListenCoresBucketsRatio</directive> pour spécifier un
- <var>ratio</var> entre le nombre de coeurs de CPU activés et le
- nombre de segments d'écoute (listeners' buckets) souhaités ; le
- serveur HTTP Apache va alors créer<code>num_cpu_cores / ratio</code>
- segments d'écoute, chacun contenant son propre socket d'écoute
- <directive>Listen</directive> sur le ou les mêmes ports ; chaque
- processus enfant sera associé à un seul segment d'écoute (avec une
- distribution de type round-robin des segments à la création des
+ <directive>ListenCoresBucketsRatio</directive> pour spécifier un
+ <var>ratio</var> entre le nombre de coeurs de CPU activés et le
+ nombre de segments d'écoute (listeners' buckets) souhaités ; le
+ serveur HTTP Apache va alors créer<code>num_cpu_cores / ratio</code>
+ segments d'écoute, chacun contenant son propre socket d'écoute
+ <directive>Listen</directive> sur le ou les mêmes ports ; chaque
+ processus enfant sera associé à un seul segment d'écoute (avec une
+ distribution de type round-robin des segments à la création des
processus enfants).</p>
+ <note><title>Définition du terme coeur de CPU activé ("online")</title>
+ <p>Sous Linux et BSD, un coeur de CPU peut être activé ou désactivé si <a
+ href="https://www.kernel.org/doc/Documentation/cpu-hotplug.txt">Hotplug</a>
+ a été configuré ; la directive
+ <directive>ListenCoresBucketsRatio</directive> doit donc tenir compte de ce
+ paramètre pour calculer le nombre de segments d'écoute à créer.</p>
+ </note>
+
<p>La directive <directive>ListenCoresBucketsRatio</directive> peut
- améliorer le support de la montée en charge lorsque l'arrivée de
- nouvelles connexions est/devient un goulot d'étranglement. Le test
- de cette fonctionnalité avec des machines possédant un nombre de
- coeurs de CPU important a permit de constater une amélioration des
- performances significative et des temps de réponse plus courts.</p>
-
- <p>Pour que cette fonctionnalité soit activée, le nombre de coeurs
- de CPU doit être égal au moins au double du <var>ratio</var>
- spécifié. Si vous spécifiez la valeur recommandée pour
- <var>ratio</var>, à savoir <code>8</code>, le nombre minimum de
- coeurs de processeurs disponibles sera alors de <code>16</code>.</p>
+ améliorer le support de la montée en charge lorsque l'arrivée de
+ nouvelles connexions est/devient un goulot d'étranglement. Le test
+ de cette fonctionnalité avec des machines possédant un nombre de
+ coeurs de CPU important a permit de constater une amélioration des
+ performances significative et des temps de réponse plus courts.</p>
+
+ <p>Pour que cette fonctionnalité soit activée, le nombre de coeurs
+ de CPU doit être égal au moins au double du <var>ratio</var>
+ spécifié. Si vous spécifiez la valeur recommandée pour
+ <var>ratio</var>, à savoir <code>8</code>, le nombre minimum de
+ coeurs de processeurs disponibles sera alors de <code>16</code>. La valeur
+ optimale de <var>ratio</var> permettant d'obtenir des performances maximales
+ doit être calculée pour chaque système cible, en testant plusieurs valeurs
+ et en observant les résultats.</p>
</usage>
</directivesynopsis>
@@ -340,26 +351,26 @@ connexions</description>
<usage>
<p>La longueur maximale de la liste d'attente des connexions. En
- général, aucune modification n'est nécessaire, ni même souhaitable ;
- cependant, sur certains systèmes, il peut être nécessaire
+ général, aucune modification n'est nécessaire, ni même souhaitable ;
+ cependant, sur certains systèmes, il peut être nécessaire
d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en
- masse de requêtes SYN pour saturer le serveur). Voir le paramètre
- backlog de l'appel système <code>listen(2)</code>.</p>
+ masse de requêtes SYN pour saturer le serveur). Voir le paramètre
+ backlog de l'appel système <code>listen(2)</code>.</p>
- <p>En fait, l'argument backlog sera souvent limité à une valeur
- inférieure en fonction du système d'exploitation. Notez aussi que de
- nombreux systèmes d'exploitation ne tiennent pas vraiment compte de
- la valeur spécifiée pour l'argument backlog, mais s'en inspirent
- seulement (et choisissent en général une valeur supérieure).</p>
+ <p>En fait, l'argument backlog sera souvent limité à une valeur
+ inférieure en fonction du système d'exploitation. Notez aussi que de
+ nombreux systèmes d'exploitation ne tiennent pas vraiment compte de
+ la valeur spécifiée pour l'argument backlog, mais s'en inspirent
+ seulement (et choisissent en général une valeur supérieure).</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MaxRequestWorkers</name>
-<description>Nombre maximum de connexions pouvant être traitées
-simultanément</description>
+<description>Nombre maximum de connexions pouvant être traitées
+simultanément</description>
<syntax>MaxRequestWorkers <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module>
@@ -367,48 +378,48 @@ simultanément</description>
<usage>
<p>La directive <directive>MaxRequestWorkers</directive> permet de fixer le
- nombre maximum de requêtes pouvant être traitées simultanément.
+ nombre maximum de requêtes pouvant être traitées simultanément.
Si la limite <directive>MaxRequestWorkers</directive> est atteinte, toute
tentative de connexion sera normalement mise dans une file
- d'attente, et ceci jusqu'à un certain nombre dépendant de la
+ d'attente, et ceci jusqu'à un certain nombre dépendant de la
directive <directive module="mpm_common">ListenBacklog</directive>.
- Lorsqu'un processus enfant se libèrera suite à la fin du traitement
- d'une requête, la connexion en attente pourra être traitée à son
+ Lorsqu'un processus enfant se libèrera suite à la fin du traitement
+ d'une requête, la connexion en attente pourra être traitée à son
tour.</p>
- <p>Pour les serveurs non threadés (<em>c'est à dire</em> utilisant
+ <p>Pour les serveurs non threadés (<em>c'est à dire</em> utilisant
<module>prefork</module>), la directive
- <directive>MaxRequestWorkers</directive> définit alors le nombre maximum de
- processus enfants qui pourront être lancés simultanément pour
- traiter les requêtes. La valeur par défaut est <code>256</code> ; si
+ <directive>MaxRequestWorkers</directive> définit alors le nombre maximum de
+ processus enfants qui pourront être lancés simultanément pour
+ traiter les requêtes. La valeur par défaut est <code>256</code> ; si
vous l'augmentez, vous devez aussi augmenter la valeur de la
directive <directive
module="mpm_common">ServerLimit</directive>.</p>
- <p>Pour les serveur threadés et hybrides (utilisant <em>par
+ <p>Pour les serveur threadés et hybrides (utilisant <em>par
exemple</em> <module>event</module> ou <module>worker</module>),
- <directive>MaxRequestWorkers</directive> définit alors le nombre total de
+ <directive>MaxRequestWorkers</directive> définit alors le nombre total de
threads qui seront disponibles pour servir les clients. Dans le
- cas des MPMs hybrides, la valeur par défaut est <code>16</code>
+ cas des MPMs hybrides, la valeur par défaut est <code>16</code>
(directive <directive
- module="mpm_common">ServerLimit</directive>) multiplié par la valeur
+ module="mpm_common">ServerLimit</directive>) multiplié par la valeur
<code>25</code> (directive <directive module="mpm_common"
- >ThreadsPerChild</directive>). Par conséquent, pour affecter à la
+ >ThreadsPerChild</directive>). Par conséquent, pour affecter à la
directive <directive>MaxRequestWorkers</directive> une valeur qui requiert
plus de 16 processus, vous devez aussi augmenter la valeur de la
directive <directive module="mpm_common"
>ServerLimit</directive>.</p>
<p>Le nom de la directive <directive>MaxRequestWorkers</directive>
- était <directive>MaxClients</directive> avant la version 2.3.13. Cet
- ancien nom est encore supporté.</p>
+ était <directive>MaxClients</directive> avant la version 2.3.13. Cet
+ ancien nom est encore supporté.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MaxMemFree</name>
-<description>Quantité maximale de mémoire que l'allocateur principal est
-autorisé à conserver sans appeler <code>free()</code></description>
+<description>Quantité maximale de mémoire que l'allocateur principal est
+autorisé à conserver sans appeler <code>free()</code></description>
<syntax>MaxMemFree <var>KOctets</var></syntax>
<default>MaxMemFree 2048</default>
<contextlist><context>server config</context></contextlist>
@@ -418,12 +429,12 @@ autorisé à conserver sans
</modulelist>
<usage>
- <p>La directive <directive>MaxMemFree</directive> permet de définir
+ <p>La directive <directive>MaxMemFree</directive> permet de définir
le nombre maximum de KOctets libres que tout allocateur est
- autorisé à conserver sans appeler <code>free()</code>. Dans les MPMs
- threadés, chaque thread possède son propre allocateur. Si elle est
- définie à 0, la quantité de mémoire libre que peut conserver un
- allocateur est illimitée.</p>
+ autorisé à conserver sans appeler <code>free()</code>. Dans les MPMs
+ threadés, chaque thread possède son propre allocateur. Si elle est
+ définie à 0, la quantité de mémoire libre que peut conserver un
+ allocateur est illimitée.</p>
</usage>
</directivesynopsis>
@@ -440,20 +451,20 @@ traiter au cours de son fonctionnement</
</modulelist>
<compatibility>Disponible depuis la version 2.3.9 du serveur HTTP
Apache. L'ancien nom <code>MaxRequestsPerChild</code> est encore
-supporté.</compatibility>
+supporté.</compatibility>
<usage>
<p>La directive <directive>MaxConnectionsPerChild</directive> permet de
- définir le nombre maximum de connexions qu'un processus enfant va
- pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
+ définir le nombre maximum de connexions qu'un processus enfant va
+ pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
<directive>MaxConnectionsPerChild</directive> connexions, le processus
- enfant est arrêté. Si <directive>MaxConnectionsPerChild</directive> est
- définie à <code>0</code>, il n'y a plus aucune limite sur le nombre
+ enfant est arrêté. Si <directive>MaxConnectionsPerChild</directive> est
+ définie à <code>0</code>, il n'y a plus aucune limite sur le nombre
de connexions que le processus pourra traiter.</p>
- <p>Définir <directive>MaxConnectionsPerChild</directive> à une valeur
- non nulle limite la quantité de mémoire qu'un processus peut
- consommer à cause de fuites (accidentelles) de mémoire.</p>
+ <p>Définir <directive>MaxConnectionsPerChild</directive> à une valeur
+ non nulle limite la quantité de mémoire qu'un processus peut
+ consommer à cause de fuites (accidentelles) de mémoire.</p>
</usage>
</directivesynopsis>
@@ -462,7 +473,7 @@ supporté.</compatibility>
<name>MaxSpareThreads</name>
<description>Nombre maximum de threads inactifs</description>
<syntax>MaxSpareThreads <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>mpm_netware</module><module>mpmt_os2</module>
@@ -470,35 +481,35 @@ supporté.</compatibility>
<usage>
<p>C'est le nombre maximum de threads inactifs. Les MPMs utilisent
- cette directive de différentes manières.</p>
+ cette directive de différentes manières.</p>
- <p>Pour <module>worker</module> et <module>event</module>, la définition par défaut est
- <code>MaxSpareThreads 250</code>. Ce MPM gère les threads inactifs
- au niveau du serveur. Si le serveur possède trop de threads
- inactifs, des processus enfants seront arrêtés jusqu'à ce que le
+ <p>Pour <module>worker</module> et <module>event</module>, la définition par défaut est
+ <code>MaxSpareThreads 250</code>. Ce MPM gère les threads inactifs
+ au niveau du serveur. Si le serveur possède trop de threads
+ inactifs, des processus enfants seront arrêtés jusqu'à ce que le
nombre de threads inactifs repasse en dessous de cette limite.</p>
- <p>Pour <module>mpm_netware</module>, la définition par défaut est
- <code>MaxSpareThreads 100</code>. Comme ce MPM n'exécute qu'un seul
- processus, le nombre de processus inactifs est surveillé au
+ <p>Pour <module>mpm_netware</module>, la définition par défaut est
+ <code>MaxSpareThreads 100</code>. Comme ce MPM n'exécute qu'un seul
+ processus, le nombre de processus inactifs est surveillé au
niveau du serveur.</p>
- <p><module>mpmt_os2</module> fonctionne de manière similaire à
+ <p><module>mpmt_os2</module> fonctionne de manière similaire à
<module>mpm_netware</module>. Pour <module>mpmt_os2</module>, la
- valeur par défaut est <code>10</code>.</p>
+ valeur par défaut est <code>10</code>.</p>
<note><title>Contraintes</title>
<p>La gamme de valeurs pour <directive>MaxSpareThreads</directive>
- est limitée. Apache httpd corrigera automatiquement cette valeur selon
- les règles suivantes :</p>
+ est limitée. Apache httpd corrigera automatiquement cette valeur selon
+ les règles suivantes :</p>
<ul>
<li>Avec <module>mpm_netware</module>, <directive
- >MaxSpareThreads</directive> doit être supérieure à <directive
+ >MaxSpareThreads</directive> doit être supérieure à <directive
module="mpm_common">MinSpareThreads</directive>.</li>
<li>Avec
<module>worker</module> et <module>event</module>, <directive>MaxSpareThreads</directive>
- doit être supérieure ou égale à la somme de <directive
+ doit être supérieure ou égale à la somme de <directive
module="mpm_common">MinSpareThreads</directive> et <directive
module="mpm_common">ThreadsPerChild</directive>.</li>
</ul>
@@ -512,34 +523,34 @@ supporté.</compatibility>
<directivesynopsis>
<name>MinSpareThreads</name>
<description>Nombre minimum de threads inactifs qui seront disponibles
-pour pouvoir traiter les pics de requêtes</description>
+pour pouvoir traiter les pics de requêtes</description>
<syntax>MinSpareThreads <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>mpm_netware</module><module>mpmt_os2</module>
</modulelist>
<usage>
- <p>C'est le nombre minimum de threads inactifs pour être en mesure
- de traiter les pics de requêtes. Les MPMs utilisent cette directive
- de différentes manières.</p>
+ <p>C'est le nombre minimum de threads inactifs pour être en mesure
+ de traiter les pics de requêtes. Les MPMs utilisent cette directive
+ de différentes manières.</p>
- <p>Avec <module>worker</module> et <module>event</module>, la définition par défaut est
+ <p>Avec <module>worker</module> et <module>event</module>, la définition par défaut est
<code>MinSpareThreads 75</code>, et le nombre de threads inactifs
- est surveillé au niveau du serveur. Si le serveur ne possède pas
- assez de threads inactifs, des processus enfants sont créés jusqu'à
+ est surveillé au niveau du serveur. Si le serveur ne possède pas
+ assez de threads inactifs, des processus enfants sont créés jusqu'à
ce que le nombre de threads inactifs repasse au dessus de
<var>nombre</var>.</p>
- <p>Avec <module>mpm_netware</module>, la définition par défaut est
- <code>MinSpareThreads 10</code> et, comme ce MPM n'exécute qu'un
- seul processus, le nombre de threads est surveillé au niveau du
+ <p>Avec <module>mpm_netware</module>, la définition par défaut est
+ <code>MinSpareThreads 10</code> et, comme ce MPM n'exécute qu'un
+ seul processus, le nombre de threads est surveillé au niveau du
serveur.</p>
- <p><module>mpmt_os2</module> fonctionne de manière similaire à
+ <p><module>mpmt_os2</module> fonctionne de manière similaire à
<module>mpm_netware</module>. Pour <module>mpmt_os2</module>, la
- valeur par défaut est <code>5</code>.</p>
+ valeur par défaut est <code>5</code>.</p>
</usage>
<seealso><directive module="mpm_common">MaxSpareThreads</directive></seealso>
@@ -549,7 +560,7 @@ pour pouvoir traiter les pics de requ&ec
<directivesynopsis>
<name>ScoreBoardFile</name>
-<description>Chemin du fichier où sont stockées les données concernant
+<description>Chemin du fichier où sont stockées les données concernant
la coordination des processus enfants</description>
<syntax>ScoreBoardFile <var>chemin fichier</var></syntax>
<default>ScoreBoardFile logs/apache_runtime_status</default>
@@ -562,13 +573,13 @@ la coordination des processus enfants</d
<p>Le serveur HTTP Apache utilise un tableau de bord pour la
communication entre le processus parent et les processus enfants.
Pour faciliter cette communication, certaines architectures
- nécessitent un fichier. En l'absence de cette directive, donc si
- aucun nom de fichier n'est spécifié, Apache httpd tentera tout
- d'abord de créer un tableau uniquement en mémoire (en utilisant la
- mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de
- créer un fichier sur disque (en utilisant la mémoire partagée à base
- de fichier). Si cette directive est utilisée, Apache httpd créera
- systématiquement un fichier sur disque.</p>
+ nécessitent un fichier. En l'absence de cette directive, donc si
+ aucun nom de fichier n'est spécifié, Apache httpd tentera tout
+ d'abord de créer un tableau uniquement en mémoire (en utilisant la
+ mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de
+ créer un fichier sur disque (en utilisant la mémoire partagée à base
+ de fichier). Si cette directive est utilisée, Apache httpd créera
+ systématiquement un fichier sur disque.</p>
<example><title>Exemple</title>
<highlight language="config">
@@ -576,24 +587,24 @@ la coordination des processus enfants</d
</highlight>
</example>
- <p>Une mémoire partagée sous forme de fichier est utile pour les
- applications tierces qui nécessitent un accès direct au tableau de
+ <p>Une mémoire partagée sous forme de fichier est utile pour les
+ applications tierces qui nécessitent un accès direct au tableau de
bord des processus.</p>
<p>Si vous utilisez un <directive>ScoreBoardFile</directive>, vous
- pourrez constater une amélioration des performances en le plaçant
+ pourrez constater une amélioration des performances en le plaçant
sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte
- des mêmes avertissements que ceux concernant le chemin du fichier
+ des mêmes avertissements que ceux concernant le chemin du fichier
journal et la <a
- href="../misc/security_tips.html">sécurité</a>.</p>
+ href="../misc/security_tips.html">sécurité</a>.</p>
</usage>
-<seealso><a href="../stopping.html">Arrêter et redémarrer
+<seealso><a href="../stopping.html">Arrêter et redémarrer
le serveur HTTP Apache</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ReceiveBufferSize</name>
-<description>Taille du tampon TCP en entrée</description>
+<description>Taille du tampon TCP en entrée</description>
<syntax>ReceiveBufferSize <var>octets</var></syntax>
<default>ReceiveBufferSize 0</default>
<contextlist><context>server config</context></contextlist>
@@ -603,11 +614,11 @@ le serveur HTTP Apache</a></seealso>
</modulelist>
<usage>
- <p>Le serveur va fixer la taille du tampon TCP en entrée au
- nombre d'octets spécifié.</p>
+ <p>Le serveur va fixer la taille du tampon TCP en entrée au
+ nombre d'octets spécifié.</p>
- <p>Si la directive est définie à <code>0</code>, le serveur va
- utiliser la valeur par défaut adoptée par le système
+ <p>Si la directive est définie à <code>0</code>, le serveur va
+ utiliser la valeur par défaut adoptée par le système
d'exploitation.</p>
</usage>
</directivesynopsis>
@@ -624,104 +635,104 @@ le serveur HTTP Apache</a></seealso>
</modulelist>
<usage>
- <p>Définit la taille du tampon TCP en sortie avec le nombre
- d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les
- valeurs par défaut standards du passé des systèmes d'exploitation
- pour les transmissions à grande vitesse et haute densité (<em>c'est
- à dire</em> de l'ordre de 100ms comme sur les liaisons rapides
+ <p>Définit la taille du tampon TCP en sortie avec le nombre
+ d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les
+ valeurs par défaut standards du passé des systèmes d'exploitation
+ pour les transmissions à grande vitesse et haute densité (<em>c'est
+ à dire</em> de l'ordre de 100ms comme sur les liaisons rapides
transcontinentales).</p>
- <p>Si la directive est définie à <code>0</code>, le serveur va
- utiliser la valeur par défaut adoptée par le système
+ <p>Si la directive est définie à <code>0</code>, le serveur va
+ utiliser la valeur par défaut adoptée par le système
d'exploitation.</p>
- <p>L'amélioration des performances des connexions à grande vitesse
- et à temps de latence élevé, peut nécessiter
- une intervention au niveau de la configuration de votre système
+ <p>L'amélioration des performances des connexions à grande vitesse
+ et à temps de latence élevé, peut nécessiter
+ une intervention au niveau de la configuration de votre système
d'exploitation.</p>
- <note><p>Sous certains systèmes d'exploitation, la modification du
+ <note><p>Sous certains systèmes d'exploitation, la modification du
comportement TCP via une augmentation de la valeur de
- <directive>SendBufferSize</directive> risque de ne pas être
+ <directive>SendBufferSize</directive> risque de ne pas être
perceptible, si la directive <directive
- module="core">EnableSendfile</directive> n'est pas définie à OFF.
+ module="core">EnableSendfile</directive> n'est pas définie à OFF.
Cette interaction ne s'applique qu'aux fichiers statiques.</p> </note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ServerLimit</name>
-<description>Limite supérieure de la définition du nombre de
+<description>Limite supérieure de la définition du nombre de
processus</description>
<syntax>ServerLimit <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module>
</modulelist>
<usage>
- <p>Avec le MPM <module>prefork</module>, cette directive définit le
- nombre maximum que l'on peut affecter à la directive <directive
+ <p>Avec le MPM <module>prefork</module>, cette directive définit le
+ nombre maximum que l'on peut affecter à la directive <directive
module="mpm_common">MaxRequestWorkers</directive>, et ceci pour la
- durée de vie du processus Apache httpd. Avec les
+ durée de vie du processus Apache httpd. Avec les
MPMs <module>worker</module> et <module>event</module>, cette directive, en combinaison avec
- <directive module="mpm_common">ThreadLimit</directive>, définit le
- nombre maximum que l'on peut affecter à <directive
- module="mpm_common">MaxRequestWorkers</directive>, et ceci pour la durée de
- vie du processus Apache httpd. Au cours d'un redémarrage, vous pouvez
+ <directive module="mpm_common">ThreadLimit</directive>, définit le
+ nombre maximum que l'on peut affecter à <directive
+ module="mpm_common">MaxRequestWorkers</directive>, et ceci pour la durée de
+ vie du processus Apache httpd. Au cours d'un redémarrage, vous pouvez
modifier la valeur de la directive <directive
module="mpm_common">MaxRequestWorkers</directive>, alors que toute
tentative de modification de la valeur de la directive <directive
- module="mpm_common">ServerLimit</directive> sera ignorée.</p>
+ module="mpm_common">ServerLimit</directive> sera ignorée.</p>
- <p>Cette directive doit être utilisée avec précaution. Si
- <directive>ServerLimit</directive> est définie à une valeur beaucoup
- plus grande que nécessaire, de la mémoire partagée supplémentaire
- sera inutilement allouée. Si à la fois
+ <p>Cette directive doit être utilisée avec précaution. Si
+ <directive>ServerLimit</directive> est définie à une valeur beaucoup
+ plus grande que nécessaire, de la mémoire partagée supplémentaire
+ sera inutilement allouée. Si à la fois
<directive>ServerLimit</directive> et <directive
- module="mpm_common">MaxRequestWorkers</directive> possèdent des valeurs
- supérieures à ce que le système peut supporter, ce dernier peut
- devenir instable ou Apache httpd peut tout simplement refuser de démarrer.</p>
+ module="mpm_common">MaxRequestWorkers</directive> possèdent des valeurs
+ supérieures à ce que le système peut supporter, ce dernier peut
+ devenir instable ou Apache httpd peut tout simplement refuser de démarrer.</p>
<p>Avec les MPMs <module>prefork</module> et <module>event</module>, n'utilisez cette directive
- que si vous devez définir <directive
- module="mpm_common">MaxRequestWorkers</directive> à une valeur supérieure à
- 256 (valeur par défaut). N'affectez pas à la directive <directive
- module="mpm_common">ServerLimit</directive> une valeur supérieure à
- celle que vous avez prévu d'affecter à la directive <directive
+ que si vous devez définir <directive
+ module="mpm_common">MaxRequestWorkers</directive> à une valeur supérieure à
+ 256 (valeur par défaut). N'affectez pas à la directive <directive
+ module="mpm_common">ServerLimit</directive> une valeur supérieure à
+ celle que vous avez prévu d'affecter à la directive <directive
module="mpm_common">MaxRequestWorkers</directive>.</p>
<p>Avec <module>worker</module>, n'utilisez cette directive que si
- la définition de vos directives <directive
+ la définition de vos directives <directive
module="mpm_common">MaxRequestWorkers</directive> et <directive
- module="mpm_common">ThreadsPerChild</directive> nécessitent plus de
- 16 processus serveurs (valeur par défaut). N'affectez pas à la
+ module="mpm_common">ThreadsPerChild</directive> nécessitent plus de
+ 16 processus serveurs (valeur par défaut). N'affectez pas à la
directive <directive module="mpm_common">ServerLimit</directive> une
- valeur supérieure au nombre de processus requis pour la définition
+ valeur supérieure au nombre de processus requis pour la définition
des directives <directive module="mpm_common">MaxRequestWorkers
</directive> et <directive
module="mpm_common">ThreadsPerChild</directive>.</p>
<note><title>Note</title>
- <p>Il existe une limite de <code>ServerLimit 20000</code> codée en
+ <p>Il existe une limite de <code>ServerLimit 20000</code> codée en
dur dans le serveur (200000 pour le MPM <module>prefork</module>).
- Ceci est censé éviter les effets désastreux que pourrait provoquer
- une faute de frappe. Pour dépasser cette limite, vous devez
+ Ceci est censé éviter les effets désastreux que pourrait provoquer
+ une faute de frappe. Pour dépasser cette limite, vous devez
modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du
mpm et recompiler le serveur.</p>
</note>
</usage>
-<seealso><a href="../stopping.html">Arrêter et redémarrer
+<seealso><a href="../stopping.html">Arrêter et redémarrer
le serveur HTTP Apache</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>StartServers</name>
-<description>Nombre de processus enfants du serveur créés au
-démarrage</description>
+<description>Nombre de processus enfants du serveur créés au
+démarrage</description>
<syntax>StartServers <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>prefork</module><module>mpmt_os2</module>
@@ -729,18 +740,18 @@ démarrage</description>
<usage>
<p>La directive <directive>StartServers</directive> permet de
- définir le nombre de processus enfants du serveur créés au
- démarrage. Comme le nombre de processus est contrôlé dynamiquement
+ définir le nombre de processus enfants du serveur créés au
+ démarrage. Comme le nombre de processus est contrôlé dynamiquement
en fonction de la charge (voir <directive
module="mpm_common">MinSpareThreads</directive>, <directive
module="mpm_common">MaxSpareThreads</directive>, <directive
module="prefork">MinSpareServers</directive>, <directive
- module="prefork">MaxSpareServers</directive>), il n'est en général
- pas nécessaire d'ajuster ce paramètre.</p>
+ module="prefork">MaxSpareServers</directive>), il n'est en général
+ pas nécessaire d'ajuster ce paramètre.</p>
- <p>La valeur par défaut diffère d'un MPM à l'autre. Pour
- <module>worker</module> et <module>event</module>, la définition par défaut est
- <code>StartServers 3</code> ; la valeur par défaut est
+ <p>La valeur par défaut diffère d'un MPM à l'autre. Pour
+ <module>worker</module> et <module>event</module>, la définition par défaut est
+ <code>StartServers 3</code> ; la valeur par défaut est
<code>5</code> pour <module>prefork</module> et <code>2</code>
pour <module>mpmt_os2</module>.</p>
</usage>
@@ -748,67 +759,67 @@ démarrage</description>
<directivesynopsis>
<name>StartThreads</name>
-<description>Nombre de threads créés au démarrage</description>
+<description>Nombre de threads créés au démarrage</description>
<syntax>StartThreads <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>mpm_netware</module></modulelist>
<usage>
- <p>C'est le nombre de threads créés au démarrage du serveur. Comme
- le nombre de threads est contrôlé dynamiquement
+ <p>C'est le nombre de threads créés au démarrage du serveur. Comme
+ le nombre de threads est contrôlé dynamiquement
en fonction de la charge (voir <directive
module="mpm_common">MinSpareThreads</directive>, <directive
module="mpm_common">MaxSpareThreads</directive>, <directive
module="prefork">MinSpareServers</directive>, <directive
- module="prefork">MaxSpareServers</directive>), il n'est en général
- pas nécessaire d'ajuster ce paramètre.</p>
+ module="prefork">MaxSpareServers</directive>), il n'est en général
+ pas nécessaire d'ajuster ce paramètre.</p>
- <p>Pour <module>mpm_netware</module>, la définition par défaut est
+ <p>Pour <module>mpm_netware</module>, la définition par défaut est
<code>StartThreads 50</code> et, comme il n'y a qu'un processus, il
- s'agit du nombre total de threads créés au démarrage pour servir les
- requêtes.</p>
+ s'agit du nombre total de threads créés au démarrage pour servir les
+ requêtes.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ThreadLimit</name>
-<description>Le nombre de threads maximum que l'on peut définir par
+<description>Le nombre de threads maximum que l'on peut définir par
processus enfant</description>
<syntax>ThreadLimit <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>mpm_winnt</module>
</modulelist>
<usage>
- <p>Cette directive permet de définir le nombre maximum que l'on peut
- affecter à la directive <directive
- module="mpm_common">ThreadsPerChild</directive> pour la durée de vie
+ <p>Cette directive permet de définir le nombre maximum que l'on peut
+ affecter à la directive <directive
+ module="mpm_common">ThreadsPerChild</directive> pour la durée de vie
du processus Apache httpd. La directive <directive
- module="mpm_common">ThreadsPerChild</directive> peut être modifiée
- au cours d'un redémarrage jusqu'à la valeur de la directive <directive
+ module="mpm_common">ThreadsPerChild</directive> peut être modifiée
+ au cours d'un redémarrage jusqu'à la valeur de la directive <directive
module="mpm_common">ThreadLimit</directive>, mais toute tentative
de modification de la directive <directive
module="mpm_common">ThreadLimit</directive> au cours d'un
- redémarrage sera ignorée.</p>
+ redémarrage sera ignorée.</p>
<p>L'utilisation de cette directive doit faire l'objet de
- précautions particulières. Si <directive>ThreadLimit</directive> est
- définie à une valeur très supérieure à la directive <directive
- module="mpm_common">ThreadsPerChild</directive>, de la mémoire
- partagée supplémentaire sera inutilement allouée. Si les directives
+ précautions particulières. Si <directive>ThreadLimit</directive> est
+ définie à une valeur très supérieure à la directive <directive
+ module="mpm_common">ThreadsPerChild</directive>, de la mémoire
+ partagée supplémentaire sera inutilement allouée. Si les directives
<directive>ThreadLimit</directive> et <directive
- module="mpm_common">ThreadsPerChild</directive> sont définies à des
- valeurs supérieures à ce que le système peut supporter, ce dernier
+ module="mpm_common">ThreadsPerChild</directive> sont définies à des
+ valeurs supérieures à ce que le système peut supporter, ce dernier
peut devenir instable, ou Apache httpd peut tout simplement refuser de
- démarrer. Ne définissez pas cette directive à une valeur supérieure
- à la valeur maximale que vous pensez affecter à la directive <directive
+ démarrer. Ne définissez pas cette directive à une valeur supérieure
+ à la valeur maximale que vous pensez affecter à la directive <directive
module="mpm_common">ThreadsPerChild</directive> pour le processus
- Apache httpd en cours d'exécution.</p>
+ Apache httpd en cours d'exécution.</p>
- <p>La valeur par défaut de la directive
+ <p>La valeur par défaut de la directive
<directive>ThreadLimit</directive> est <code>1920</code> avec
<module>mpm_winnt</module>, et <code>64</code> avec les autres
MPMs.</p>
@@ -817,9 +828,9 @@ processus enfant</description>
<p>Il existe une limite de <code>ThreadLimit 20000</code> (ou
<code>ThreadLimit 100000</code> avec <module>event</module>,
<code>ThreadLimit 15000</code> avec <module>mpm_winnt</module>)
- codée en dur dans le serveur. Ceci est censé éviter les effets
- désastreux que pourrait provoquer une faute de frappe. Pour
- dépasser cette limite, vous devez modifier la valeur de
+ codée en dur dans le serveur. Ceci est censé éviter les effets
+ désastreux que pourrait provoquer une faute de frappe. Pour
+ dépasser cette limite, vous devez modifier la valeur de
MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le
serveur.</p>
</note>
@@ -828,27 +839,27 @@ processus enfant</description>
<directivesynopsis>
<name>ThreadsPerChild</name>
-<description>Nombre de threads créés par chaque processus
+<description>Nombre de threads créés par chaque processus
enfant</description>
<syntax>ThreadsPerChild <var>nombre</var></syntax>
-<default>Voir ci-dessous pour plus de détails</default>
+<default>Voir ci-dessous pour plus de détails</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>mpm_winnt</module>
</modulelist>
<usage>
- <p>Cette directive permet de définir le nombre de threads que va
- créer chaque processus enfant. Un processus enfant crée ces threads
- au démarrage et n'en crée plus d'autres par la suite. Si l'on
+ <p>Cette directive permet de définir le nombre de threads que va
+ créer chaque processus enfant. Un processus enfant crée ces threads
+ au démarrage et n'en crée plus d'autres par la suite. Si l'on
utilise un MPM comme <module>mpm_winnt</module> qui ne lance qu'un
- processus enfant, ce nombre doit être suffisamment grand pour
+ processus enfant, ce nombre doit être suffisamment grand pour
supporter la charge du serveur. Avec un MPM comme
<module>worker</module> qui lance plusieurs processus enfants, c'est
- le nombre <em>total</em> de threads qui doit être suffisamment grand
+ le nombre <em>total</em> de threads qui doit être suffisamment grand
pour supporter la charge du serveur.</p>
- <p>La valeur par défaut de la directive
+ <p>La valeur par défaut de la directive
<directive>ThreadsPerChild</directive> est <code>64</code> avec
<module>mpm_winnt</module>, et <code>25</code> avec les autres
MPMs.</p>
@@ -860,68 +871,68 @@ enfant</description>
<description>La taille en octets de la pile qu'utilisent les threads qui
traitent les connexions clients</description>
<syntax>ThreadStackSize <var>taille</var></syntax>
-<default>65536 sous NetWare; varie en fonction des autres systèmes
+<default>65536 sous NetWare; varie en fonction des autres systèmes
d'exploitation</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>event</module><module>worker</module>
<module>mpm_winnt</module><module>mpm_netware</module>
<module>mpmt_os2</module>
</modulelist>
-<compatibility>Disponible dans les versions 2.1 et supérieures
+<compatibility>Disponible dans les versions 2.1 et supérieures
du serveur HTTP Apache</compatibility>
<usage>
<p>La directive <directive>ThreadStackSize</directive> permet de
- définir la taille de la pile (pour les données propres) qu'utilisent
- les threads qui traitent les connexions clients en faisant appel à
- des modules. Dans la plupart des cas, la valeur par défaut de la
- taille de la pile du système d'exploitation convient, mais il existe
- certaines situations où il peut s'avérer nécessaire de l'ajuster
+ définir la taille de la pile (pour les données propres) qu'utilisent
+ les threads qui traitent les connexions clients en faisant appel à
+ des modules. Dans la plupart des cas, la valeur par défaut de la
+ taille de la pile du système d'exploitation convient, mais il existe
+ certaines situations où il peut s'avérer nécessaire de l'ajuster
:</p>
<ul>
- <li>Sur les plates-formes qui possèdent une valeur par défaut de
+ <li>Sur les plates-formes qui possèdent une valeur par défaut de
taille de la pile relativement petite (par exemple HP-UX), Apache
httpd peut se crasher si l'on utilise certains modules tiers qui
- possèdent un quantité de données propres stockées relativement
- importante. Il se peut que ces mêmes modules fonctionnent
- correctement sur d'autres plate-formes où la valeur par défaut de
- la taille de la pile est supérieure. Ce type de crash peut être
- evité en définissant <directive>ThreadStackSize</directive> à une
- valeur supérieure à la valeur par défaut du système
- d'exploitation. Ce type d'ajustement n'est nécessaire que si le
+ possèdent un quantité de données propres stockées relativement
+ importante. Il se peut que ces mêmes modules fonctionnent
+ correctement sur d'autres plate-formes où la valeur par défaut de
+ la taille de la pile est supérieure. Ce type de crash peut être
+ evité en définissant <directive>ThreadStackSize</directive> à une
+ valeur supérieure à la valeur par défaut du système
+ d'exploitation. Ce type d'ajustement n'est nécessaire que si le
fournisseur du module tiers en fait mention, ou si le diagnostic
- d'un crash d'Apache httpd indique que la taille de la pile était trop
+ d'un crash d'Apache httpd indique que la taille de la pile était trop
petite.</li>
- <li>Sur les plates-formes où la taille par défaut de la pile des
- threads est sensiblement supérieure à la taille nécessaire pour la
+ <li>Sur les plates-formes où la taille par défaut de la pile des
+ threads est sensiblement supérieure à la taille nécessaire pour la
configuration du serveur web, il est possible de disposer d'un
plus grand nombre de threads par processus enfant si la directive
- <directive>ThreadStackSize</directive> est définie à une valeur
- inférieure à la valeur par défaut du système d'exploitation.
+ <directive>ThreadStackSize</directive> est définie à une valeur
+ inférieure à la valeur par défaut du système d'exploitation.
Cependant, ce
- type d'ajustement ne doit être effectué que dans un environnement
+ type d'ajustement ne doit être effectué que dans un environnement
de test permettant de qualifier le serveur web au maximum de ses
- possibilités, car il peut arriver, dans de rares cas, que des
- requêtes nécessitent une taille de pile supérieure pour pouvoir
- être traitées. La taille minimale requise pour la pile dépend
- fortement des modules utilisés, mais toute modification dans la
- configuration du serveur web peut invalider la définition courante
+ possibilités, car il peut arriver, dans de rares cas, que des
+ requêtes nécessitent une taille de pile supérieure pour pouvoir
+ être traitées. La taille minimale requise pour la pile dépend
+ fortement des modules utilisés, mais toute modification dans la
+ configuration du serveur web peut invalider la définition courante
de la directive <directive>ThreadStackSize</directive>.</li>
- <li>Sous Linux, cette directive ne peut être utilisée que pour
+ <li>Sous Linux, cette directive ne peut être utilisée que pour
augmenter la valeur par defaut de la taille de la pile, car
- l'appel système sous-jacent utilise cette valeur comme taille de pile
- <em>minimale</em>. C'est la limite logicielle (souvent élevée)
+ l'appel système sous-jacent utilise cette valeur comme taille de pile
+ <em>minimale</em>. C'est la limite logicielle (souvent élevée)
pour <code>ulimit -s</code> (8Mo si aucune limite) qui est
- utilisée comme taille de pile par défaut.</li>
+ utilisée comme taille de pile par défaut.</li>
</ul>
- <note>Il est recommandé de ne pas réduire
- <directive>ThreadStackSize</directive>, à moins qu'un grand nombre
- de threads par processus enfant ne soit nécessaire. Sur certaines
- plates-formes (y compris Linux), une valeur de 128000 est déjà trop
+ <note>Il est recommandé de ne pas réduire
+ <directive>ThreadStackSize</directive>, à moins qu'un grand nombre
+ de threads par processus enfant ne soit nécessaire. Sur certaines
+ plates-formes (y compris Linux), une valeur de 128000 est déjà trop
basse et provoque des crashes avec certains modules courants.</note>
</usage>
</directivesynopsis>