]> git.ipfire.org Git - thirdparty/apache/httpd.git/commitdiff
fr doc XML files updates.
authorLucien Gentis <lgentis@apache.org>
Sat, 25 Apr 2020 15:37:20 +0000 (15:37 +0000)
committerLucien Gentis <lgentis@apache.org>
Sat, 25 Apr 2020 15:37:20 +0000 (15:37 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1876986 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/configuring.xml.fr
docs/manual/mod/mpm_common.xml.fr

index 4b89d36717c3f86af693eef27f30c09eeebbb4dd..9393580ca492b9b9bd0f912b4228bf0f600e7426 100644 (file)
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1673947 -->
+<!-- English Revision: 1876835 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -94,16 +94,25 @@ le Serveur HTTP Apache.</p>
     définies via la directive <directive
     module="core">Define</directive> peuvent être utilisées dans le
     fichier de configuration en utilisant la syntaxe
-    <code>${VAR}</code>. Si "VAR" est le nom d'une variable valide, la
+    <code>${VAR}</code>.<br />
+    Si "VAR" est le nom d'une variable valide, la
     valeur de la variable est alors substituée à la chaîne
     <code>${VAR}</code>, et le processus de lecture du fichier de
     configuration continue comme si la chaîne correspondant à la valeur
-    de la variable s'y était trouvée littéralement. Les variables définies
+    de la variable s'y était trouvée littéralement.<br />
+    Les variables définies
     via la directive <directive module="core">Define</directive>
-    l'emportent sur les autres variables d'environnement du shell. Si la
-    variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code>
-    n'est pas modifiée, et un avertissement est enregistré dans le
-    journal. Le caractère ":" est interdit dans les noms de variables
+    l'emportent sur les autres variables d'environnement du shell.<br />
+    Si la variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code> n'est
+    pas modifiée, et un avertissement est enregistré dans le journal. Si par
+    contre une valeur par défaut existe, on peut utiliser la forme
+    conditionnelle <code>${VAR?=une valeur par défaut}</code>. Notez qu'une
+    variable <strong>définie</strong> vide ne se verra pas attribuer la valeur
+    par défaut et qu'une valeur par défaut vide comme dans <code>${VAR?=}</code>
+    est une substitution valide (qui génère une valeur vide si "VAR" n'est pas
+    définie, mais aucun avertissement).<br />
+    
+    Le caractère ":" est interdit dans les noms de variables
     afin d'éviter tout conflit avec la syntaxe de la directive <directive
     module="mod_rewrite">RewriteMap</directive>.</p>
 
index f789b7a6921439feafbc7ff769d4e818f9cf2501..8bea0e0b275f7fee1cfb2d7eb47d6c0a159b4448 100644 (file)
@@ -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: 1874496 -->
+<!-- English Revision: 1876865 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -204,13 +204,14 @@ de processus du démon</description>
 <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>
-[<var>protocole</var>]</syntax>
+<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var> [<var>protocol</var>] [options=<var>flag</var>[,<var>flag..</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 optionnel <code>options=</code> est disponible à
+partir de la version 2.5.1 du serveur HTTP Apache.</compatibility>
 
 <usage>
     <p>La directive <directive>Listen</directive> permet de signifier à
@@ -282,6 +283,23 @@ Listen 192.170.2.5:8000
       Listen 192.170.2.1:8443 https
     </highlight>
 
+    <p>L'argument optionnel <var>options=flag,flag...</var> permet de spécifier
+    certaines options du socket pour le port d'écoute. Non nécessaires pour la
+    plupart des configurations, ces options doivent être utilisées avec
+    prudence. La disponibilité des différents drapeaux dépend du système
+    d'exploitation. En voici la liste :</p>
+
+    <ul>
+      <li><code>freebind</code>: l'option de socket <code>IP_FREEBIND</code> est
+      activée ; elle permet de définir une directive Listen pour une adresse qui
+      n'est pas (encore) valide dans le système (disponible sous Linux
+      seulement).</li>
+
+      <li><code>reuseport</code>: l'option de socket <code>SO_REUSEPORT</code>
+      est activée ; elle permet de définir une directive Listen pour un port
+      déjà utilisé par un autre processus.</li>
+    </ul>
+
     <note><title>Condition d'erreur</title>
       Plusieurs directives <directive>Listen</directive> pour les mêmes
       adresse IP/port vont provoquer l'envoi d'un message d'erreur