<?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
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>
<?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 -->
<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 à
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