httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gry...@apache.org
Subject svn commit: r826124 [4/5] - /httpd/httpd/trunk/docs/manual/mod/
Date Fri, 16 Oct 2009 22:49:19 GMT
Added: httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,202 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>mod_info - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_info</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du
+serveur</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table>
+<h3>Sommaire</h3>
+
+    <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes
+    suivantes à votre fichier <code>httpd.conf</code>.</p>
+
+    <div class="example"><p><code>
+      &lt;Location /infos-serveur&gt;<br />
+      <span class="indent">
+        SetHandler server-info<br />
+      </span>
+      &lt;/Location&gt;
+    </code></p></div>
+
+    <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> à
+    l'intérieur de la section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> afin de restreindre l'accès aux
+    informations de configuration de votre serveur :</p>
+
+    <div class="example"><p><code>
+      &lt;Location /infos-serveur&gt;<br />
+      <span class="indent">
+        SetHandler server-info<br />
+        Order deny,allow<br />
+        Deny from all<br />
+        Allow from votre-entreprise.com<br />
+      </span>
+      &lt;/Location&gt;
+    </code></p></div>
+
+    <p>Une fois cette configuration effectuée, les informations du
+    serveur sont disponibles à l'adresse
+    <code>http://votre-serveur.com/infos-serveur</code>.</p>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2>
+    <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa
+    fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
+    fichiers de configuration, y compris les fichiers de configuration
+    des répertoires (par exemple <code>.htaccess</code>). Ceci peut
+    avoir des répercutions en matière de sécurité pour votre site.</p>
+
+    <p>En particulier, l'utilisation de ce module peut conduire à la
+    divulgation d'informations sensibles à partir des directives de
+    configuration d'autres modules Apache comme des chemins systèmes,
+    des couples nom d'utilisateur/mot de passe, des noms de bases de
+    données, etc... C'est pourquoi ce module ne doit être utilisé
+    <strong>que</strong> dans un environnement sous contrôle et toujours
+    avec les plus grandes précautions.</p>
+
+    <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour
+    restreindre l'accès aux informations de configuration de votre
+    serveur.</p>
+
+    <div class="example"><h3>Contrôle d'accès</h3><p><code>
+      &lt;Location /infos-serveur&gt;<br />
+      <span class="indent">
+        SetHandler server-info<br />
+        Order allow,deny<br />
+        # Autorisation d'accès depuis le serveur lui-même<br />
+        Allow from 127.0.0.1<br />
+        # Autorisation d'accès depuis une station de travail du réseau
+	# local<br />
+        Allow from 192.168.1.17<br />
+      </span>
+      &lt;/Location&gt;
+    </code></p></div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2>
+    <p>Par défaut, les informations affichées comprennent une liste de
+    tous les modules activés, et pour chaque module, une description des
+    directives qu'il accepte, les branchements (hooks) qu'il
+    implémente, ainsi que les directives concernées dans la
+    configuration courante.</p>
+
+    <p>Il est possible d'afficher d'autres vues de la configuration en
+    ajoutant un argument à la requête <code>infos-serveur</code>. Par
+    exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
+    affichera toutes les directives de configuration.</p>
+
+    <dl>
+        <dt><code>?&lt;module-name&gt;</code></dt>
+            <dd>Uniquement les informations relatives au module
+	    spécifié</dd>
+        <dt><code>?config</code></dt>
+            <dd>Uniquement les directives de configuration, non triées
+	    par module</dd>
+        <dt><code>?hooks</code></dt>
+            <dd>Uniquement la liste des branchements (hooks)
+	    auxquels le module est attaché</dd>
+        <dt><code>?list</code></dt>
+            <dd>Une simple liste des modules activés</dd>
+        <dt><code>?server</code></dt>
+            <dd>Uniquement des informations de base sur le serveur</dd>
+    </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="limitations" id="limitations">Limitations connues</a></h2>
+    <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de
+    la configuration interprétée, et non du fichier de configuration
+    original. La manière dont l'arbre de configuration interprété est
+    créé induit quelques limitations :</p>
+    <ul>
+      <li>Les directives qui sont traitées immédiatement sans être
+      enregistrées dans l'arbre de configuration interprété ne sont pas
+      prises en compte. Celles-ci comprennent <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> et <code class="directive"><a href="../mod/mod_so.html#loadfile">LoadFile</a></code>.</li>
+      <li>Les directives qui contrôlent le fichier de configuration
+      lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>,
+      <code class="directive"><a href="../mod/core.html#&lt;ifmodule&gt;">&lt;IfModule&gt;</a></code> et
+      <code class="directive"><a href="../mod/core.html#&lt;ifdefine&gt;">&lt;IfDefine&gt;</a></code> ne sont pas
+      prises en compte, mais les directives de configuration incluses le
+      sont.</li>
+      <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
+      considéré comme une fonctionnalité).</li>
+      <li>Les directives de configuration des fichiers
+      <code>.htaccess</code> ne sont pas prises en compte (car elles ne
+      font pas partie de la configuration permanente du serveur).</li>
+      <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code> sont affichées
+      normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de
+      déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#&lt;/directory&gt;">&lt;/Directory&gt;</a></code>.</li>
+      <li>Les directives générées par des modules tiers comme
+      <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
+      prises en compte.</li>
+    </ul>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
+module affichées par le gestionnaire server-info</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>nom-module</var> <var>chaîne</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 1.3 d'Apache</td></tr>
+</table>
+    <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
+    en tant qu'<strong>Information supplémentaire</strong> interprétée
+    en HTML pour le module <var>nom-module</var>. Exemple :</p>
+
+    <div class="example"><p><code>
+      AddModuleInfo mod_deflate.c 'Voir &lt;a \<br />
+      <span class="indent">
+        href="http://www.apache.org/docs/trunk/mod/mod_deflate.html"&gt;\<br />
+        http://www.apache.org/docs/trunk/mod/mod_deflate.html&lt;/a&gt;'
+      </span>
+    </code></p></div>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file

Added: httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,188 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 804977 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<modulesynopsis metafile="mod_info.xml.meta">
+
+<name>mod_info</name>
+<description>Affiche une pr&eacute;sentation compl&egrave;te de la configuration du
+serveur</description>
+<status>Extension</status>
+<sourcefile>mod_info.c</sourcefile>
+<identifier>info_module</identifier>
+
+<summary>
+    <p>Pour activer <module>mod_info</module>, ajoutez les lignes
+    suivantes &agrave; votre fichier <code>httpd.conf</code>.</p>
+
+    <example>
+      &lt;Location /infos-serveur&gt;<br />
+      <indent>
+        SetHandler server-info<br />
+      </indent>
+      &lt;/Location&gt;
+    </example>
+
+    <p>Il est recommand&eacute; d'utiliser <module>mod_access</module> &agrave;
+    l'int&eacute;rieur de la section <directive type="section"
+    module="core">Location</directive> afin de restreindre l'acc&egrave;s aux
+    informations de configuration de votre serveur :</p>
+
+    <example>
+      &lt;Location /infos-serveur&gt;<br />
+      <indent>
+        SetHandler server-info<br />
+        Order deny,allow<br />
+        Deny from all<br />
+        Allow from votre-entreprise.com<br />
+      </indent>
+      &lt;/Location&gt;
+    </example>
+
+    <p>Une fois cette configuration effectu&eacute;e, les informations du
+    serveur sont disponibles &agrave; l'adresse
+    <code>http://votre-serveur.com/infos-serveur</code>.</p>
+</summary>
+
+<section id="security"><title>Probl&egrave;mes li&eacute;s &agrave; la s&eacute;curit&eacute;</title>
+    <p>Une fois <module>mod_info</module> charg&eacute; dans le serveur, sa
+    fonctionnalit&eacute; de gestionnaire est disponible dans <em>tous</em> les
+    fichiers de configuration, y compris les fichiers de configuration
+    des r&eacute;pertoires (par exemple <code>.htaccess</code>). Ceci peut
+    avoir des r&eacute;percutions en mati&egrave;re de s&eacute;curit&eacute; pour votre site.</p>
+
+    <p>En particulier, l'utilisation de ce module peut conduire &agrave; la
+    divulgation d'informations sensibles &agrave; partir des directives de
+    configuration d'autres modules Apache comme des chemins syst&egrave;mes,
+    des couples nom d'utilisateur/mot de passe, des noms de bases de
+    donn&eacute;es, etc... C'est pourquoi ce module ne doit &ecirc;tre utilis&eacute;
+    <strong>que</strong> dans un environnement sous contr&ocirc;le et toujours
+    avec les plus grandes pr&eacute;cautions.</p>
+
+    <p>Il est recommand&eacute; d'utiliser <module>mod_authz_host</module> pour
+    restreindre l'acc&egrave;s aux informations de configuration de votre
+    serveur.</p>
+
+    <example><title>Contr&ocirc;le d'acc&egrave;s</title>
+      &lt;Location /infos-serveur&gt;<br />
+      <indent>
+        SetHandler server-info<br />
+        Order allow,deny<br />
+        # Autorisation d'acc&egrave;s depuis le serveur lui-m&ecirc;me<br />
+        Allow from 127.0.0.1<br />
+        # Autorisation d'acc&egrave;s depuis une station de travail du r&eacute;seau
+	# local<br />
+        Allow from 192.168.1.17<br />
+      </indent>
+      &lt;/Location&gt;
+    </example>
+</section>
+
+<section id="queries"><title>Filtrage des informations affich&eacute;es</title>
+    <p>Par d&eacute;faut, les informations affich&eacute;es comprennent une liste de
+    tous les modules activ&eacute;s, et pour chaque module, une description des
+    directives qu'il accepte, les branchements (hooks) qu'il
+    impl&eacute;mente, ainsi que les directives concern&eacute;es dans la
+    configuration courante.</p>
+
+    <p>Il est possible d'afficher d'autres vues de la configuration en
+    ajoutant un argument &agrave; la requ&ecirc;te <code>infos-serveur</code>. Par
+    exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
+    affichera toutes les directives de configuration.</p>
+
+    <dl>
+        <dt><code>?&lt;module-name&gt;</code></dt>
+            <dd>Uniquement les informations relatives au module
+	    sp&eacute;cifi&eacute;</dd>
+        <dt><code>?config</code></dt>
+            <dd>Uniquement les directives de configuration, non tri&eacute;es
+	    par module</dd>
+        <dt><code>?hooks</code></dt>
+            <dd>Uniquement la liste des branchements (hooks)
+	    auxquels le module est attach&eacute;</dd>
+        <dt><code>?list</code></dt>
+            <dd>Une simple liste des modules activ&eacute;s</dd>
+        <dt><code>?server</code></dt>
+            <dd>Uniquement des informations de base sur le serveur</dd>
+    </dl>
+</section>
+
+<section id="limitations"><title>Limitations connues</title>
+    <p><module>mod_info</module> tire ses informations de
+    la configuration interpr&eacute;t&eacute;e, et non du fichier de configuration
+    original. La mani&egrave;re dont l'arbre de configuration interpr&eacute;t&eacute; est
+    cr&eacute;&eacute; induit quelques limitations :</p>
+    <ul>
+      <li>Les directives qui sont trait&eacute;es imm&eacute;diatement sans &ecirc;tre
+      enregistr&eacute;es dans l'arbre de configuration interpr&eacute;t&eacute; ne sont pas
+      prises en compte. Celles-ci comprennent <directive
+      module="core">ServerRoot</directive>, <directive
+      module="mod_so">LoadModule</directive> et <directive
+      module="mod_so">LoadFile</directive>.</li>
+      <li>Les directives qui contr&ocirc;lent le fichier de configuration
+      lui-m&ecirc;me, comme <directive module="core">Include</directive>,
+      <directive module="core">&lt;IfModule&gt;</directive> et
+      <directive module="core">&lt;IfDefine&gt;</directive> ne sont pas
+      prises en compte, mais les directives de configuration incluses le
+      sont.</li>
+      <li>Les commentaires ne sont pas pris en compte (Ce qui peut &ecirc;tre
+      consid&eacute;r&eacute; comme une fonctionnalit&eacute;).</li>
+      <li>Les directives de configuration des fichiers
+      <code>.htaccess</code> ne sont pas prises en compte (car elles ne
+      font pas partie de la configuration permanente du serveur).</li>
+      <li>Les directives de conteneur comme <directive
+      module="core">&lt;Directory&gt;</directive> sont affich&eacute;es
+      normalement, mais <module>mod_info</module> est incapable de
+      d&eacute;terminer le num&eacute;ro de ligne de la balise fermante <directive
+      module="core">&lt;/Directory&gt;</directive>.</li>
+      <li>Les directives g&eacute;n&eacute;r&eacute;es par des modules tiers comme
+      <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas &ecirc;tre
+      prises en compte.</li>
+    </ul>
+</section>
+
+<directivesynopsis>
+<name>AddModuleInfo</name>
+<description>Ajoute des donn&eacute;es suppl&eacute;mentaires aux informations de
+module affich&eacute;es par le gestionnaire server-info</description>
+<syntax>AddModuleInfo <var>nom-module</var> <var>cha&icirc;ne</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+<compatibility>Disponible depuis la version 1.3 d'Apache</compatibility>
+
+<usage>
+    <p>Cette directive permet d'afficher le contenu de <var>cha&icirc;ne</var>
+    en tant qu'<strong>Information suppl&eacute;mentaire</strong> interpr&eacute;t&eacute;e
+    en HTML pour le module <var>nom-module</var>. Exemple :</p>
+
+    <example>
+      AddModuleInfo mod_deflate.c 'Voir &lt;a \<br />
+      <indent>
+        href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\<br />
+        http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
+      </indent>
+    </example>
+</usage>
+
+</directivesynopsis>
+</modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_info.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html Fri Oct 16 22:49:14 2009
@@ -4,6 +4,10 @@
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: mod_negotiation.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: mod_negotiation.html.ja.utf8
 Content-Language: ja
 Content-type: text/html; charset=UTF-8

Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.en Fri Oct 16 22:49:14 2009
@@ -22,6 +22,7 @@
 <div id="preamble"><h1>Apache Module mod_negotiation</h1>
 <div class="toplang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
 </div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides for <a href="../content-negotiation.html">content negotiation</a></td></tr>
@@ -300,6 +301,7 @@
 </div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
 </div><div id="footer">
 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>

Added: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,325 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>mod_negotiation - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_negotiation</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_negotiation.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Effectue la <a href="../content-negotiation.html">négociation de
+contenu</a></td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>negotiation_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_negotiation.c</td></tr></table>
+<h3>Sommaire</h3>
+
+    <p>La négociation de contenu, ou plus précisément la sélection de
+    contenu, est la sélection parmi plusieurs documents disponibles, du
+    document qui "colle" au plus près des possibilités du client. Pour y
+    parvenir, deux méthodes sont employées.</p>
+
+    <ul>
+      <li>Une table de correspondances de types (un fichier associé au
+      gestionnaire <code>type-map</code>) qui contient une liste
+      explicite des fichiers contenant les différentes variantes.</li>
+
+      <li>Une recherche multivues (Multiviews) (activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), où le
+      serveur effectue une recherche de correspondance de modèle de nom
+      de fichier implicite, et fait son choix parmi les résultats.</li>
+    </ul>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#forcelanguagepriority">ForceLanguagePriority</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#languagepriority">LanguagePriority</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#typemaps">Tables de correspondances de types</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#multiviews">Multivues</a></li>
+</ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
+<li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li>
+<li><a href="../content-negotiation.html">Négociation de
+contenu</a></li>
+<li><a href="../env.html">Variables d'environnement</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="typemaps" id="typemaps">Tables de correspondances de types</a></h2>
+    <p>Une table de correspondances de types possède un format similaire
+    à celui des en-têtes de messagerie RFC822. Elle contient des
+    descriptions de documents séparées par des lignes vides, toute ligne
+    commençant par un dièse ('#') étant considérée comme un
+    commentaire. Une description de document comporte plusieurs
+    enregistrements d'en-têtes ; chaque enregistrement peut être réparti
+    sur plusieurs lignes à condition que les lignes supplémentaires
+    commencent par un ou plusieurs espaces. Lors du traitement, les
+    espaces de début de ligne seront supprimés et les lignes
+    concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui
+    se termine toujours par un caractère "deux-points" ':', suivi d'une
+    valeur. Les espaces sont autorisés entre le nom d'en-tête et sa
+    valeur, ainsi qu'entre les différents éléments de la valeur. Les
+    en-têtes autorisés sont :</p>
+
+    <dl>
+      <dt><code>Content-Encoding:</code></dt>
+      <dd>Le codage du fichier. Apache ne reconnaît que les codages
+      définis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus
+      les codages <code>x-compress</code> pour les fichiers compressés
+      avec compress, et <code>x-gzip</code> pour les fichiers compressés
+      avec gzip. Le préfixe <code>x-</code> est ignoré lors des
+      comparaisons de codages.</dd>
+
+      <dt><code>Content-Language:</code></dt>
+      <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de
+      langage Internet standard (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par
+      exemple, <code>en</code> correspond à l'anglais. Si la variante
+      contient plusieurs langages, ils sont séparés par des
+      virgules.</dd>
+
+      <dt><code>Content-Length:</code></dt>
+      <dd>La taille du fichier en octets. Si cet en-tête n'est pas
+      présent, c'est la taille réelle du fichier qui est utilisée.</dd>
+
+      <dt><code>Content-Type:</code></dt>
+
+      <dd>
+        Le <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type MIME</a> du document
+	avec des paramètres optionnels. Les paramètres sont séparés du
+	type de médium ainsi qu'entre eux par un point-virgule, et
+	possèdent la syntaxe <code>nom=valeur</code>. Les paramètres
+	courants sont :
+
+        <dl>
+          <dt><code>level</code></dt>
+          <dd>un entier spécifiant la version du type de média. Pour
+	  <code>text/html</code>, la valeur par défaut est 2, sinon
+	  0.</dd>
+
+          <dt><code>qs</code></dt>
+          <dd>un nombre en virgule flottante de 0.0 à 1.0, indiquant la
+	  "qualité" relative de la variante courante par rapport aux
+	  autres variantes disponibles, indépendamment des possibilités
+	  du client. Par exemple, un fichier jpeg est en général une
+	  source de qualité supérieure à un fichier ascii s'il est censé
+	  représenter une image. Cependant, si la ressource représentée
+	  est une image ascii, un fichier ascii possèdera une qualité
+	  supérieure à un fichier jpeg. Toutes les valeurs de
+	  <code>qs</code> sont donc spécifiques à une certaine
+	  ressource.</dd>
+        </dl>
+
+        <div class="example"><h3>Exemple</h3><p><code>
+          Content-Type: image/jpeg; qs=0.8
+        </code></p></div>
+      </dd>
+
+      <dt><code>URI:</code></dt>
+      <dd>l'URI du fichier contenant la variante (du type de médium
+      donné, codé selon le codage de contenu donné). Cet URI est
+      considéré comme relatif au fichier de correspondances ; il doit
+      être situé sur le même serveur (!), et doit faire référence au
+      fichier auquel le client se verrait accorder l'accès s'il était
+      requis directement.</dd>
+
+      <dt><code>Body:</code></dt>
+      <dd>une nouveauté d'Apache 2.0 : le contenu réel de la ressource
+      peut être inclus dans la table de correspondances en utilisant
+      l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un
+      délimiteur pour le contenu du corps. Les lignes suivantes du
+      fichier de correspondances de types seront alors considérées comme
+      parties du corps de la ressource jusqu'à ce que le délimiteur soit
+      détecté.
+
+      <div class="example"><h3>Exemple:</h3><p><code>
+        Body:----xyz----<br />
+        &lt;html&gt;<br />
+        &lt;body&gt;<br />
+        &lt;p&gt;Contenu de la page.&lt;/p&gt;<br />
+        &lt;/body&gt;<br />
+        &lt;/html&gt;<br />
+        ----xyz----
+      </code></p></div>
+      </dd>
+    </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="multiviews" id="multiviews">Multivues</a></h2>
+    <p>Une recherche Multivues est activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le
+    serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et
+    si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt
+    le répertoire à la recherche de tous les fichiers de nom
+    <code>foo.*</code>, et simule véritablement une correspondance de
+    type qui nomme tous ces fichiers en leur assignant les mêmes type
+    de média et codage de contenu qu'ils auraient eus si le client avait
+    requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
+    fichier qui correspond le mieux au profile du client, puis renvoie
+    le document.</p>
+
+    <p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> définit si Apache doit
+    prendre en compte les fichiers qui ne comportent pas de métadonnées
+    de négociation de contenu lors du choix du fichier à servir.</p>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet la mise en cache au niveau des serveurs mandataires
+des documents dont le contenu a été négocié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheNegotiatedDocs On|Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheNegotiatedDocs Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La syntaxe a été modifiée dans la version
+2.0.</td></tr>
+</table>
+    <p>Si elle est définie à "on", cette directive permet la mise en
+    cache au niveau des serveurs mandataires des documents dont le
+    contenu a été négocié. Le processus de mise en cache sera alors plus
+    efficace, mais des clients se trouvant derrière le mandataire
+    seront alors susceptibles de se voir servir des versions de
+    documents qui ne correspondent pas forcément à leurs attentes.</p>
+
+    <p>Cette directive ne s'applique qu'aux requêtes en provenance de
+    navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de
+    la mise en cache des documents au contenu négocié, et cette
+    directive n'a aucun effet sur les réponses aux requêtes
+    HTTP/1.1.</p>
+
+    <p>Avant la version 2.0, la directive
+    <code class="directive">CacheNegotiatedDocs</code> n'acceptait aucun
+    argument ; la seule présence de la directive suffisait à la définir
+    à "on".</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a> <a name="forcelanguagepriority" id="forcelanguagepriority">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si un document acceptable unique
+n'est pas trouvé</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ForceLanguagePriority Prefer</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.30</td></tr>
+</table>
+    <p>La directive <code class="directive">ForceLanguagePriority</code> utilise
+    le langage défini par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> pour terminer
+    la négociation lorsque le serveur n'est pas en mesure de trouver une
+    solution satisfaisante unique.</p>
+
+    <p><code>ForceLanguagePriority Prefer</code> utilise la directive
+    <code>LanguagePriority</code> pour servir le résultat d'un choix
+    unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES),
+    lorsque que plusieurs choix équivalents sont disponibles. Par
+    exemple, avec les deux directives ci-dessous, si l'en-tête
+    <code>Accept-Language</code> de l'utilisateur assigne à
+    <code>en</code> et <code>de</code> une qualité de <code>.500</code>
+    (les deux langages sont également acceptables), alors c'est la
+    première variante acceptable de langue <code>en</code> qui sera
+    servie.</p>
+
+    <div class="example"><p><code>
+      LanguagePriority en fr de<br />
+      ForceLanguagePriority Prefer
+    </code></p></div>
+
+    <p><code>ForceLanguagePriority Fallback</code> utilise la directive
+    <code class="directive"><a href="#languagepriority">LanguagePriority</a></code>
+    pour servir un résultat valide, au lieu de renvoyer un résultat HTTP
+    406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
+    l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne
+    que les réponses de langage <code>es</code>, et si aucune variante
+    dans cette langue n'est trouvée, c'est la première variante de la
+    liste définie par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> qui sera servie.</p>
+
+    <div class="example"><p><code>
+      LanguagePriority en fr de<br />
+      ForceLanguagePriority Fallback
+    </code></p></div>
+
+    <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
+    peuvent être spécifiées, de façon à ce que la variante servie soit
+    la première variante qui convient définie par la directive
+    <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> si
+    plusieurs variantes sont également acceptables, ou le premier
+    document disponible si aucune variante ne convient à la liste de
+    langages acceptables fournie par le client.</p>
+
+<h3>Voir aussi</h3>
+<ul>
+<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
+</ul>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="LanguagePriority" id="LanguagePriority">LanguagePriority</a> <a name="languagepriority" id="languagepriority">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'ordre de priorité des variantes de langages pour les
+cas où le client n'a pas formulé de préférences</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>]
+...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
+</table>
+    <p>La directive <code class="directive">LanguagePriority</code> permet de
+    définir, au cours du traitement d'une requête Multivues, l'ordre de
+    priorité des variantes de langages pour les cas
+    où le client n'a pas formulé de préférences. La liste énumère les
+    <var>langages-MIME</var> dans un ordre de préférences
+    décroissantes.</p>
+
+    <div class="example"><h3>Exemple:</h3><p><code>
+      LanguagePriority en fr de
+    </code></p></div>
+
+    <p>Dans le cas d'une requête pour <code>foo.html</code>, si
+    <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
+    le client n'a pas formulé de préférences, c'est le fichier
+    <code>foo.html.fr</code> qui sera renvoyé.</p>
+
+    <p>Notez que cette directive n'a d'effet que si le 'meilleur'
+    langage n'a pas pu être déterminé d'une autre manière ou si la
+    valeur de la directive  <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> est
+    différente de <code>None</code>. En général, c'est le client qui
+    détermine le langage préféré, non le serveur.</p>
+
+<h3>Voir aussi</h3>
+<ul>
+<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
+</ul>
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_negotiation.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file

Added: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,307 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 774533 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<modulesynopsis metafile="mod_negotiation.xml.meta">
+
+<name>mod_negotiation</name>
+<description>Effectue la <a
+href="../content-negotiation.html">n&eacute;gociation de
+contenu</a></description>
+<status>Base</status>
+<sourcefile>mod_negotiation.c</sourcefile>
+<identifier>negotiation_module</identifier>
+
+<summary>
+    <p>La n&eacute;gociation de contenu, ou plus pr&eacute;cis&eacute;ment la s&eacute;lection de
+    contenu, est la s&eacute;lection parmi plusieurs documents disponibles, du
+    document qui "colle" au plus pr&egrave;s des possibilit&eacute;s du client. Pour y
+    parvenir, deux m&eacute;thodes sont employ&eacute;es.</p>
+
+    <ul>
+      <li>Une table de correspondances de types (un fichier associ&eacute; au
+      gestionnaire <code>type-map</code>) qui contient une liste
+      explicite des fichiers contenant les diff&eacute;rentes variantes.</li>
+
+      <li>Une recherche multivues (Multiviews) (activ&eacute;e par l'<directive
+      module="core">Options</directive> <code>Multiviews</code>), o&ugrave; le
+      serveur effectue une recherche de correspondance de mod&egrave;le de nom
+      de fichier implicite, et fait son choix parmi les r&eacute;sultats.</li>
+    </ul>
+</summary>
+<seealso><directive module="core">Options</directive></seealso>
+<seealso><module>mod_mime</module></seealso>
+<seealso><a href="../content-negotiation.html">N&eacute;gociation de
+contenu</a></seealso>
+<seealso><a href="../env.html">Variables d'environnement</a></seealso>
+
+<section id="typemaps"><title>Tables de correspondances de types</title>
+    <p>Une table de correspondances de types poss&egrave;de un format similaire
+    &agrave; celui des en-t&ecirc;tes de messagerie RFC822. Elle contient des
+    descriptions de documents s&eacute;par&eacute;es par des lignes vides, toute ligne
+    commen&ccedil;ant par un di&egrave;se ('#') &eacute;tant consid&eacute;r&eacute;e comme un
+    commentaire. Une description de document comporte plusieurs
+    enregistrements d'en-t&ecirc;tes ; chaque enregistrement peut &ecirc;tre r&eacute;parti
+    sur plusieurs lignes &agrave; condition que les lignes suppl&eacute;mentaires
+    commencent par un ou plusieurs espaces. Lors du traitement, les
+    espaces de d&eacute;but de ligne seront supprim&eacute;s et les lignes
+    concat&eacute;n&eacute;es. L'enregistrement d'un en-t&ecirc;te comprend un mot-cl&eacute; qui
+    se termine toujours par un caract&egrave;re "deux-points" ':', suivi d'une
+    valeur. Les espaces sont autoris&eacute;s entre le nom d'en-t&ecirc;te et sa
+    valeur, ainsi qu'entre les diff&eacute;rents &eacute;l&eacute;ments de la valeur. Les
+    en-t&ecirc;tes autoris&eacute;s sont :</p>
+
+    <dl>
+      <dt><code>Content-Encoding:</code></dt>
+      <dd>Le codage du fichier. Apache ne reconna&icirc;t que les codages
+      d&eacute;finis par une directive <directive
+      module="mod_mime">AddEncoding</directive>. Sont normalement inclus
+      les codages <code>x-compress</code> pour les fichiers compress&eacute;s
+      avec compress, et <code>x-gzip</code> pour les fichiers compress&eacute;s
+      avec gzip. Le pr&eacute;fixe <code>x-</code> est ignor&eacute; lors des
+      comparaisons de codages.</dd>
+
+      <dt><code>Content-Language:</code></dt>
+      <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de
+      langage Internet standard (<a
+      href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par
+      exemple, <code>en</code> correspond &agrave; l'anglais. Si la variante
+      contient plusieurs langages, ils sont s&eacute;par&eacute;s par des
+      virgules.</dd>
+
+      <dt><code>Content-Length:</code></dt>
+      <dd>La taille du fichier en octets. Si cet en-t&ecirc;te n'est pas
+      pr&eacute;sent, c'est la taille r&eacute;elle du fichier qui est utilis&eacute;e.</dd>
+
+      <dt><code>Content-Type:</code></dt>
+
+      <dd>
+        Le <glossary ref="mime-type">type MIME</glossary> du document
+	avec des param&egrave;tres optionnels. Les param&egrave;tres sont s&eacute;par&eacute;s du
+	type de m&eacute;dium ainsi qu'entre eux par un point-virgule, et
+	poss&egrave;dent la syntaxe <code>nom=valeur</code>. Les param&egrave;tres
+	courants sont :
+
+        <dl>
+          <dt><code>level</code></dt>
+          <dd>un entier sp&eacute;cifiant la version du type de m&eacute;dia. Pour
+	  <code>text/html</code>, la valeur par d&eacute;faut est 2, sinon
+	  0.</dd>
+
+          <dt><code>qs</code></dt>
+          <dd>un nombre en virgule flottante de 0.0 &agrave; 1.0, indiquant la
+	  "qualit&eacute;" relative de la variante courante par rapport aux
+	  autres variantes disponibles, ind&eacute;pendamment des possibilit&eacute;s
+	  du client. Par exemple, un fichier jpeg est en g&eacute;n&eacute;ral une
+	  source de qualit&eacute; sup&eacute;rieure &agrave; un fichier ascii s'il est cens&eacute;
+	  repr&eacute;senter une image. Cependant, si la ressource repr&eacute;sent&eacute;e
+	  est une image ascii, un fichier ascii poss&egrave;dera une qualit&eacute;
+	  sup&eacute;rieure &agrave; un fichier jpeg. Toutes les valeurs de
+	  <code>qs</code> sont donc sp&eacute;cifiques &agrave; une certaine
+	  ressource.</dd>
+        </dl>
+
+        <example><title>Exemple</title>
+          Content-Type: image/jpeg; qs=0.8
+        </example>
+      </dd>
+
+      <dt><code>URI:</code></dt>
+      <dd>l'URI du fichier contenant la variante (du type de m&eacute;dium
+      donn&eacute;, cod&eacute; selon le codage de contenu donn&eacute;). Cet URI est
+      consid&eacute;r&eacute; comme relatif au fichier de correspondances ; il doit
+      &ecirc;tre situ&eacute; sur le m&ecirc;me serveur (!), et doit faire r&eacute;f&eacute;rence au
+      fichier auquel le client se verrait accorder l'acc&egrave;s s'il &eacute;tait
+      requis directement.</dd>
+
+      <dt><code>Body:</code></dt>
+      <dd>une nouveaut&eacute; d'Apache 2.0 : le contenu r&eacute;el de la ressource
+      peut &ecirc;tre inclus dans la table de correspondances en utilisant
+      l'en-t&ecirc;te Body. Cet en-t&ecirc;te doit contenir une cha&icirc;ne d&eacute;signant un
+      d&eacute;limiteur pour le contenu du corps. Les lignes suivantes du
+      fichier de correspondances de types seront alors consid&eacute;r&eacute;es comme
+      parties du corps de la ressource jusqu'&agrave; ce que le d&eacute;limiteur soit
+      d&eacute;tect&eacute;.
+
+      <example><title>Exemple:</title>
+        Body:----xyz----<br />
+        &lt;html&gt;<br />
+        &lt;body&gt;<br />
+        &lt;p&gt;Contenu de la page.&lt;/p&gt;<br />
+        &lt;/body&gt;<br />
+        &lt;/html&gt;<br />
+        ----xyz----
+      </example>
+      </dd>
+    </dl>
+</section>
+
+<section id="multiviews"><title>Multivues</title>
+    <p>Une recherche Multivues est activ&eacute;e par l'<directive
+    module="core">Options</directive> <code>Multiviews</code>. Si le
+    serveur re&ccedil;oit une requ&ecirc;te pour <code>/un/r&eacute;pertoire/foo</code>, et
+    si <code>/un/r&eacute;pertoire/foo</code> n'existe pas, le serveur parcourt
+    le r&eacute;pertoire &agrave; la recherche de tous les fichiers de nom
+    <code>foo.*</code>, et simule v&eacute;ritablement une correspondance de
+    type qui nomme tous ces fichiers en leur assignant les m&ecirc;mes type
+    de m&eacute;dia et codage de contenu qu'ils auraient eus si le client avait
+    requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
+    fichier qui correspond le mieux au profile du client, puis renvoie
+    le document.</p>
+
+    <p>La directive <directive
+    module="mod_mime">MultiviewsMatch</directive> d&eacute;finit si Apache doit
+    prendre en compte les fichiers qui ne comportent pas de m&eacute;tadonn&eacute;es
+    de n&eacute;gociation de contenu lors du choix du fichier &agrave; servir.</p>
+</section>
+
+<directivesynopsis>
+<name>CacheNegotiatedDocs</name>
+<description>Permet la mise en cache au niveau des serveurs mandataires
+des documents dont le contenu a &eacute;t&eacute; n&eacute;goci&eacute;</description>
+<syntax>CacheNegotiatedDocs On|Off</syntax>
+<default>CacheNegotiatedDocs Off</default>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+<compatibility>La syntaxe a &eacute;t&eacute; modifi&eacute;e dans la version
+2.0.</compatibility>
+
+<usage>
+    <p>Si elle est d&eacute;finie &agrave; "on", cette directive permet la mise en
+    cache au niveau des serveurs mandataires des documents dont le
+    contenu a &eacute;t&eacute; n&eacute;goci&eacute;. Le processus de mise en cache sera alors plus
+    efficace, mais des clients se trouvant derri&egrave;re le mandataire
+    seront alors susceptibles de se voir servir des versions de
+    documents qui ne correspondent pas forc&eacute;ment &agrave; leurs attentes.</p>
+
+    <p>Cette directive ne s'applique qu'aux requ&ecirc;tes en provenance de
+    navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contr&ocirc;le de
+    la mise en cache des documents au contenu n&eacute;goci&eacute;, et cette
+    directive n'a aucun effet sur les r&eacute;ponses aux requ&ecirc;tes
+    HTTP/1.1.</p>
+
+    <p>Avant la version 2.0, la directive
+    <directive>CacheNegotiatedDocs</directive> n'acceptait aucun
+    argument ; la seule pr&eacute;sence de la directive suffisait &agrave; la d&eacute;finir
+    &agrave; "on".</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ForceLanguagePriority</name>
+<description>Action &agrave; entreprendre si un document acceptable unique
+n'est pas trouv&eacute;</description>
+<syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax>
+<default>ForceLanguagePriority Prefer</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>FileInfo</override>
+<compatibility>Disponible depuis la version 2.0.30</compatibility>
+
+<usage>
+    <p>La directive <directive>ForceLanguagePriority</directive> utilise
+    le langage d&eacute;fini par la directive <directive
+    module="mod_negotiation">LanguagePriority</directive> pour terminer
+    la n&eacute;gociation lorsque le serveur n'est pas en mesure de trouver une
+    solution satisfaisante unique.</p>
+
+    <p><code>ForceLanguagePriority Prefer</code> utilise la directive
+    <code>LanguagePriority</code> pour servir le r&eacute;sultat d'un choix
+    unique, au lieu de renvoyer un r&eacute;sultat HTTP 300 (MULTIPLE CHOICES),
+    lorsque que plusieurs choix &eacute;quivalents sont disponibles. Par
+    exemple, avec les deux directives ci-dessous, si l'en-t&ecirc;te
+    <code>Accept-Language</code> de l'utilisateur assigne &agrave;
+    <code>en</code> et <code>de</code> une qualit&eacute; de <code>.500</code>
+    (les deux langages sont &eacute;galement acceptables), alors c'est la
+    premi&egrave;re variante acceptable de langue <code>en</code> qui sera
+    servie.</p>
+
+    <example>
+      LanguagePriority en fr de<br />
+      ForceLanguagePriority Prefer
+    </example>
+
+    <p><code>ForceLanguagePriority Fallback</code> utilise la directive
+    <directive module="mod_negotiation">LanguagePriority</directive>
+    pour servir un r&eacute;sultat valide, au lieu de renvoyer un r&eacute;sultat HTTP
+    406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
+    l'en-t&ecirc;te <code>Accept-Language</code> de l'utilisateur ne mentionne
+    que les r&eacute;ponses de langage <code>es</code>, et si aucune variante
+    dans cette langue n'est trouv&eacute;e, c'est la premi&egrave;re variante de la
+    liste d&eacute;finie par la directive <directive module="mod_negotiation"
+    >LanguagePriority</directive> qui sera servie.</p>
+
+    <example>
+      LanguagePriority en fr de<br />
+      ForceLanguagePriority Fallback
+    </example>
+
+    <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
+    peuvent &ecirc;tre sp&eacute;cifi&eacute;es, de fa&ccedil;on &agrave; ce que la variante servie soit
+    la premi&egrave;re variante qui convient d&eacute;finie par la directive
+    <directive module="mod_negotiation">LanguagePriority</directive> si
+    plusieurs variantes sont &eacute;galement acceptables, ou le premier
+    document disponible si aucune variante ne convient &agrave; la liste de
+    langages acceptables fournie par le client.</p>
+</usage>
+<seealso><directive module="mod_mime">AddLanguage</directive></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>LanguagePriority</name>
+<description>L'ordre de priorit&eacute; des variantes de langages pour les
+cas o&ugrave; le client n'a pas formul&eacute; de pr&eacute;f&eacute;rences</description>
+<syntax>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>]
+...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>FileInfo</override>
+
+<usage>
+    <p>La directive <directive>LanguagePriority</directive> permet de
+    d&eacute;finir, au cours du traitement d'une requ&ecirc;te Multivues, l'ordre de
+    priorit&eacute; des variantes de langages pour les cas
+    o&ugrave; le client n'a pas formul&eacute; de pr&eacute;f&eacute;rences. La liste &eacute;num&egrave;re les
+    <var>langages-MIME</var> dans un ordre de pr&eacute;f&eacute;rences
+    d&eacute;croissantes.</p>
+
+    <example><title>Exemple:</title>
+      LanguagePriority en fr de
+    </example>
+
+    <p>Dans le cas d'une requ&ecirc;te pour <code>foo.html</code>, si
+    <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
+    le client n'a pas formul&eacute; de pr&eacute;f&eacute;rences, c'est le fichier
+    <code>foo.html.fr</code> qui sera renvoy&eacute;.</p>
+
+    <p>Notez que cette directive n'a d'effet que si le 'meilleur'
+    langage n'a pas pu &ecirc;tre d&eacute;termin&eacute; d'une autre mani&egrave;re ou si la
+    valeur de la directive  <directive
+    module="mod_negotiation">ForceLanguagePriority</directive> est
+    diff&eacute;rente de <code>None</code>. En g&eacute;n&eacute;ral, c'est le client qui
+    d&eacute;termine le langage pr&eacute;f&eacute;r&eacute;, non le serveur.</p>
+</usage>
+<seealso><directive module="mod_mime">AddLanguage</directive></seealso>
+</directivesynopsis>
+
+</modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_negotiation.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
   </variants>
 </metafile>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html Fri Oct 16 22:49:14 2009
@@ -3,3 +3,7 @@
 URI: mod_remoteip.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
+
+URI: mod_remoteip.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1

Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.en Fri Oct 16 22:49:14 2009
@@ -21,7 +21,8 @@
 <div id="page-content">
 <div id="preamble"><h1>Apache Module mod_remoteip</h1>
 <div class="toplang">
-<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
 </div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Replaces the apparent client remote IP address and hostname 
 for the request with the IP address list presented by a proxies or a load 
@@ -271,7 +272,8 @@
 </div>
 </div>
 <div class="bottomlang">
-<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
 </div><div id="footer">
 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>

Added: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,322 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>mod_remoteip - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_remoteip</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_remoteip.html" title="Français">&nbsp;fr&nbsp;</a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP et le nom d'hôte apparents du client
+pour la requête par l'adresse IP présentée par un mandataire ou un
+répartiteur de charge via les en-têtes de la requête.
+</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>remoteip_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_remoteip.c</td></tr></table>
+<h3>Sommaire</h3>
+
+    <p>Ce module permet de traiter l'hôte distant qui a initié la
+    requête en tant qu'hôte distant original du point de vue de httpd à
+    des fins d'autorisation et de connexion, même si cet hôte distant se
+    trouve derrière un répartiteur de charge, un serveur frontal, ou un
+    serveur mandataire.</p>
+
+    <p>Le module remplace les adresse IP et nom d'hôte apparents
+    distants (du client) pour la requête par l'adresse IP indiquée dans
+    l'en-tête de requête configuré via la directive
+    <code class="directive">RemoteIPHeader</code>.</p>
+
+    <p>Une fois remplacée comme indiqué, cette adresse IP apparente est
+    utilisée pour les fonctionnalités <code class="directive"><a href="../mod/mod_authz_host.html#require host">&lt;Require host&gt;</a></code> et <code class="directive"><a href="../mod/mod_authz_host.html#require ip">&lt;Require ip&gt;</a></code> de
+    <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affichée par
+    <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistrée via les directives
+    <code>%a</code> et <code>%h</code> du module
+    <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. Elle permet aussi d'identifier la
+    machine en essayant de lui attribuer une identité inetd via le
+    module <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> et en fonction de la configuration
+    de la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>.</p>
+
+    <div class="warning">Il est essentiel de n'activer cette
+    fonctionnalité que pour les requêtes en provenance des serveurs
+    intermédiaires (mandataires, etc...) auxquels le serveur peut faire
+    confiance, car il est trivial pour le client distant d'usurper
+    l'identité d'un autre client.</div>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipheader">RemoteIPHeader</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#processing">Traitement des adresses distantes</a></li>
+</ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
+<li><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></li>
+<li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
+<li><code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="processing" id="processing">Traitement des adresses distantes</a></h2>
+
+    <p>Apache identifie le client par la valeur remote_ip de la
+    connexion, et de cette valeur découlent les valeurs remote_host et
+    remote_logname de la connexion. Ces champs jouent un rôle
+    dans l'authentification, l'autorisation et la connexion, ainsi que
+    dans d'autres traitements effectués par d'autres modules
+    chargeables.</p>
+
+    <p>mod_remoteip remplace la véritable remote_ip par la remote_ip
+    indiquée par exemple par un mandataire chaque fois que le serveur
+    effectue une évaluation du client, et réinitialise les valeurs de
+    remote_host et remote_logname afin de déclencher une nouvelle
+    requête dns ou ident sur l'adresse IP distante.</p>
+
+    <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP
+    distantes séparées par des virgules, celles-ci sont traitées de la
+    droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP
+    distante courante n'est pas digne de confiance pour présenter
+    l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de
+    façon à ne contenir que cette liste d'adresses non confirmées, ou
+    bien, si toutes les adresses IP sont dignes de confiance, cet
+    en-tête est tout bonnement supprimé de la requête.</p>
+
+    <p>Lors du remplacement de l'adresse IP distante, le module stocke
+    la liste des hôtes intermédiaires dans un mémo
+    remoteip-proxy-ip-list, que l'on peut faire enregistrer par
+    <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> en utilisant le symbole de format
+    <code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit
+    stocker ceci dans un en-tête additionnel, la même valeur peut aussi
+    être enregistrée sous la forme d'un en-tête en utilisant la
+    directive <code class="directive">RemoteIPProxiesHeader</code>.</p>
+
+    <div class="note"><h3>Adresses IPv4 converties au format IPv6</h3>
+    Avec httpd, d'une manière générale, toute adresse IPv4 convertie au
+    format IPv6 est enregistrée sous sa forme IPv4.</div>
+
+    <div class="note"><h3>Adresses internes (privées)</h3>
+    Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16,
+    169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc
+    public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque
+    des mandataires internes (intranet)
+    <code class="directive">RemoteIPInternalProxy</code> sont enregistrés.</div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a> <a name="remoteipheader" id="remoteipheader">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le champ d'en-tête qui contiendra les adresses IP
+du client</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPHeader</code> indique à
+    <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> de traiter la valeur de
+    l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme
+    une liste d'adresses IP clients intermédiaires, en fonction de la
+    configuration des directives
+    <code class="directive">RemoteIPInternalProxy</code> et
+    <code class="directive">RemoteIPTrustedProxy</code>. Si ces deux dernières
+    directives ne sont pas utilisées, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
+    traitera tout hôte présentant une valeur d'IP
+    <code class="directive">RemoteIPHeader</code> comme hôte de confiance.</p>
+
+    <div class="example"><h3>Exemple à usage interne (répartiteur de
+    charge)</h3><p><code>
+        RemoteIPHeader X-Client-IP
+    </code></p></div>
+
+    <div class="example"><h3>Exemple dans le cas d'un mandataire</h3><p><code>
+        RemoteIPHeader X-Forwarded-For
+    </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a> <a name="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPInternalProxy</code> permet
+    d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles
+    on peut faire confiance pour présenter une valeur RemoteIPHeader
+    valide de l'adresse IP du client. A la différence de la directive
+    <code class="directive">RemoteIPTrustedProxy</code>, toute adresse IP
+    présentée dans cet en-tête, y comprises les adresses intranet
+    privées, sont considérées comme dignes de confiance lorsqu'elles
+    sont indiquées par ces mandataires.</p>
+
+    <div class="example"><h3>Exemple à usage interne (répartiteur de
+    charge)</h3><p><code>
+        RemoteIPHeader X-Client-IP<br />
+        RemoteIPTrustedProxy 10.0.2.0/24<br />
+        RemoteIPTrustedProxy passerelle.domaine-local
+    </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a> <a name="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPInternalProxyList</code>
+    permet de spécifier un fichier parcouru au démarrage du serveur pour
+    construire une liste d'adresses (ou blocs d'adresses), auxquelles
+    on peut faire confiance pour présenter une valeur RemoteIPHeader
+    valide de l'adresse IP du client.</p>
+
+    <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+    sinon, toutes les lignes séparées par un caractère <code>nouvelle
+    ligne</code> ou
+    tous les éléments d'une ligne séparés par un espace sont traités de
+    la même façon qu'avec la directive
+    <code class="directive">RemoteIPInternalProxy</code>.</p>
+
+    <div class="example"><h3>Exemple à usage interne (répartiteur de
+    charge)</h3><p><code>
+        RemoteIPHeader X-Client-IP<br />
+        RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+    </code></p></div>
+
+    <div class="example"><h3>contenu de conf/mandataires-de-confiance.lst</h3><p><code>
+         # Nos mandataires internes de confiance<br />
+         10.0.2.0/24         # Tout le monde dans le groupe de test<br />
+         passerelle.domaine-local # Le frontal répartiteur de charge
+    </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a> <a name="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare le champ d'en-tête qui contiendra toutes les
+adresses IP intermédiaires</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>Nom_en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPProxiesHeader</code> permet
+    de spécifier l'en-tête dans lequel <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> va
+    collecter une liste de toutes les adresses IP clients intermédiaires
+    auxquelles on pourra faire confiance pour résoudre la véritable
+    adresse IP distante. Notez que les adresses intermédiaires
+    <code class="directive">RemoteIPTrustedProxy</code> sont enregistrées dans
+    cet en-tête, alors que toute adresse intermédiaire
+    <code class="directive">RemoteIPInternalProxy</code> est omise.</p>
+
+    <div class="example"><h3>Exemple</h3><p><code>
+        RemoteIPHeader X-Forwarded-For<br />
+        RemoteIPProxiesHeader X-Forwarded-By
+    </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a> <a name="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPTrustedProxy</code> permet
+    d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles
+    on peut faire confiance pour présenter une valeur RemoteIPHeader
+    valide de l'adresse IP du client. A la différence de la directive
+    <code class="directive">RemoteIPInternalProxy</code>, toutes les adresses IP
+    intranet ou privées indiquées par de tels mandataires, y compris les
+    blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
+    (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
+    dignes de confiance en tant qu'adresses IP distantes, et se situent
+    à gauche dans le contenu de l'en-tête
+    <code class="directive">RemoteIPHeader</code>.</p>
+
+    <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+    charge</h3><p><code>
+        RemoteIPHeader X-Forwarded-For<br />
+        RemoteIPTrustedProxy 10.0.2.16/28<br />
+        RemoteIPTrustedProxy proxy.example.com
+    </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a> <a name="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
+</table>
+    <p>La directive <code class="directive">RemoteIPTrustedProxyList</code>
+    permet de spécifier un fichier parcouru au démarrage du serveur pour
+    construire une liste d'adresses (ou blocs d'adresses), auxquelles
+    on peut faire confiance pour présenter une valeur RemoteIPHeader
+    valide de l'adresse IP du client.</p>
+
+    <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
+    sinon, toutes les lignes séparées par un caractère nouvelle ligne ou
+    tous les éléments d'une ligne séparés par un espace sont traités de
+    la même façon qu'avec la directive
+    <code class="directive">RemoteIPTrustedProxy</code>.</p>
+
+    <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
+    charge</h3><p><code>
+        RemoteIPHeader X-Forwarded-For<br />
+        RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+    </code></p></div>
+
+    <div class="example"><h3>conf/mandataires-de-confiance.lst contents</h3><p><code>
+       # Mandataires externes identifiés<br />
+       192.0.2.16/28         #groupe wap phone de mandataires<br />
+       proxy.isp.example.com #un FAI bien connu
+    </code></p></div>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_remoteip.html" title="Français">&nbsp;fr&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file



Mime
View raw message