You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2009/10/17 00:49:19 UTC
svn commit: r826124 [5/5] - /httpd/httpd/trunk/docs/manual/mod/
Added: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,301 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 784558 -->
+<!-- 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_remoteip.xml.meta">
+
+<name>mod_remoteip</name>
+<description>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.
+</description>
+
+<status>Base</status>
+<sourcefile>mod_remoteip.c</sourcefile>
+<identifier>remoteip_module</identifier>
+
+<summary>
+ <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
+ <directive>RemoteIPHeader</directive>.</p>
+
+ <p>Une fois remplacée comme indiqué, cette adresse IP apparente est
+ utilisée pour les fonctionnalités <directive module="mod_authz_host"
+ type="section">Require host</directive> et <directive
+ module="mod_authz_host" type="section">Require ip</directive> de
+ <module>mod_authz_host</module> ; elle est aussi affichée par
+ <module>mod_status</module>, et enregistrée via les directives
+ <code>%a</code> et <code>%h</code> du module
+ <module>mod_log_config</module>. Elle permet aussi d'identifier la
+ machine en essayant de lui attribuer une identité inetd via le
+ module <module>mod_ident</module> et en fonction de la configuration
+ de la directive <directive
+ module="mod_ident">IdentityCheck</directive>.</p>
+
+ <note type="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.</note>
+</summary>
+
+<seealso><module>mod_authz_host</module></seealso>
+<seealso><module>mod_status</module></seealso>
+<seealso><module>mod_log_config</module></seealso>
+<seealso><module>mod_ident</module></seealso>
+
+<section id="processing"><title>Traitement des adresses distantes</title>
+
+ <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
+ <module>mod_log_config</module> 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 <directive>RemoteIPProxiesHeader</directive>.</p>
+
+ <note><title>Adresses IPv4 converties au format IPv6</title>
+ Avec httpd, d'une manière générale, toute adresse IPv4 convertie au
+ format IPv6 est enregistrée sous sa forme IPv4.</note>
+
+ <note><title>Adresses internes (privées)</title>
+ 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)
+ <directive>RemoteIPInternalProxy</directive> sont enregistrés.</note>
+
+</section>
+
+<directivesynopsis>
+<name>RemoteIPHeader</name>
+<description>Définit le champ d'en-tête qui contiendra les adresses IP
+du client</description>
+<syntax>RemoteIPHeader <var>en-tête</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPHeader</directive> indique à
+ <module>mod_remoteip</module> 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
+ <directive>RemoteIPInternalProxy</directive> et
+ <directive>RemoteIPTrustedProxy</directive>. Si ces deux dernières
+ directives ne sont pas utilisées, <module>mod_remoteip</module>
+ traitera tout hôte présentant une valeur d'IP
+ <directive>RemoteIPHeader</directive> comme hôte de confiance.</p>
+
+ <example><title>Exemple à usage interne (répartiteur de
+ charge)</title>
+ RemoteIPHeader X-Client-IP
+ </example>
+
+ <example><title>Exemple dans le cas d'un mandataire</title>
+ RemoteIPHeader X-Forwarded-For
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RemoteIPInternalProxy</name>
+<description>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</description>
+<syntax>RemoteIPInternalProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPInternalProxy</directive> 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
+ <directive>RemoteIPTrustedProxy</directive>, 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>
+
+ <example><title>Exemple à usage interne (répartiteur de
+ charge)</title>
+ RemoteIPHeader X-Client-IP<br/>
+ RemoteIPTrustedProxy 10.0.2.0/24<br/>
+ RemoteIPTrustedProxy passerelle.domaine-local
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RemoteIPInternalProxyList</name>
+<description>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</description>
+<syntax>RemoteIPInternalProxyList <var>nom-fichier</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPInternalProxyList</directive>
+ 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
+ <directive>RemoteIPInternalProxy</directive>.</p>
+
+ <example><title>Exemple à usage interne (répartiteur de
+ charge)</title>
+ RemoteIPHeader X-Client-IP<br/>
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+ </example>
+
+ <example><title>contenu de conf/mandataires-de-confiance.lst</title>
+ # 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
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RemoteIPProxiesHeader</name>
+<description>Déclare le champ d'en-tête qui contiendra toutes les
+adresses IP intermédiaires</description>
+<syntax>RemoteIPProxiesHeader <var>Nom_en-tête</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPProxiesHeader</directive> permet
+ de spécifier l'en-tête dans lequel <module>mod_remoteip</module> 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
+ <directive>RemoteIPTrustedProxy</directive> sont enregistrées dans
+ cet en-tête, alors que toute adresse intermédiaire
+ <directive>RemoteIPInternalProxy</directive> est omise.</p>
+
+ <example><title>Exemple</title>
+ RemoteIPHeader X-Forwarded-For<br/>
+ RemoteIPProxiesHeader X-Forwarded-By
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RemoteIPTrustedProxy</name>
+<description>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</description>
+<syntax>RemoteIPTrustedProxy
+<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPTrustedProxy</directive> 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
+ <directive>RemoteIPInternalProxy</directive>, 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
+ <directive>RemoteIPHeader</directive>.</p>
+
+ <example><title>Exemple d'adresse de confiance (répartiteur de
+ charge</title>
+ RemoteIPHeader X-Forwarded-For<br/>
+ RemoteIPTrustedProxy 10.0.2.16/28<br/>
+ RemoteIPTrustedProxy proxy.example.com
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RemoteIPTrustedProxyList</name>
+<description>Déclare les adresses IP intranet clients comme dignes de
+confiance pour présenter la valeur RemoteIPHeader</description>
+<syntax>RemoteIPTrustedProxyList <var>nom-fichier</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context></contextlist>
+
+<usage>
+ <p>La directive <directive>RemoteIPTrustedProxyList</directive>
+ 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
+ <directive>RemoteIPTrustedProxy</directive>.</p>
+
+ <example><title>Exemple d'adresse de confiance (répartiteur de
+ charge</title>
+ RemoteIPHeader X-Forwarded-For<br/>
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst
+ </example>
+
+ <example><title>conf/mandataires-de-confiance.lst contents</title>
+ # Mandataires externes identifiés<br/>
+ 192.0.2.16/28 #groupe wap phone de mandataires<br/>
+ proxy.isp.example.com #un FAI bien connu
+ </example>
+</usage>
+</directivesynopsis>
+
+
+</modulesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,5 +8,6 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
</variants>
</metafile>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.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_so.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: mod_so.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.html.en Fri Oct 16 22:49:14 2009
@@ -22,6 +22,7 @@
<div id="preamble"><h1>Apache Module mod_so</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/mod/mod_so.html" title="English"> en </a> |
+<a href="../fr/mod/mod_so.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
@@ -183,6 +184,7 @@
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_so.html" title="English"> en </a> |
+<a href="../fr/mod/mod_so.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
Added: httpd/httpd/trunk/docs/manual/mod/mod_so.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,206 @@
+<?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_so - 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="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_so</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_so.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Chargement de modules ou de code exécutable au cours du
+démarrage ou du redémarrage 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>so_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_so.c</td></tr>
+<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, c'est un module de base (toujours
+inclus)</td></tr></table>
+<h3>Sommaire</h3>
+
+
+ <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être
+ utilisé pour charger des modules dans Apache en cours d'exécution
+ grâce au mécanisme des <a href="../dso.html">Dynamic Shared Object ou Objets Partagés
+ Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une
+ recompilation.</p>
+
+ <p>Sous Unix, le code chargé provient en général de fichiers objet
+ partagés possèdant en général l'extension <code>.so</code>, alors
+ que sous Windows, l'extension peut être soit <code>.so</code>, soit
+ <code>.dll</code>.</p>
+
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Les modules Apache 1.3 ne peuvent pas être utilisés directement
+ avec Apache 2.0 - ils doivent être modifiés pour pouvoir être
+ chargés dynamiquement ou compilés dans Apache 2.0.</p>
+ </div>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#loadfile">LoadFile</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#loadmodule">LoadModule</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#windows">Création de modules chargeables pour
+Windows</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="windows" id="windows">Création de modules chargeables pour
+Windows</a></h2>
+
+ <div class="note"><h3>Note</h3>
+ <p>Le format des noms de modules pour Windows a été modifié avec
+ Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du
+ style "mod_foo.so".</p>
+
+ <p>Bien que mod_so puisse encore charger des modules possèdant un
+ nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la
+ nouvelle convention de nommage ; si vous modifiez votre module
+ chargeable pour la version 2.0, veuillez aussi modifier son nom pour
+ respecter cette nouvelle convention.</p></div>
+
+ <p>Les API des modules Apache sous Unix et Windows sont identiques.
+ Alors que certains modules s'appuient sur certains
+ aspects de l'architecture Unix non présents dans Windows, et ne
+ fonctionneront donc pas sur cette dernière plate-forme, de nombreux
+ modules fonctionnent sous Windows avec peu ou pas de modification
+ par rapport à leur version Unix.</p>
+
+ <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de
+ deux manières. Sous Unix, il peut être compilé dans le serveur.
+ Comme Apache pour Windows ne dispose pas du programme
+ <code>Configure</code> propre à Apache pour Unix, le fichier source
+ du module doit être ajouté au fichier projet Apache de base, et ses
+ symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p>
+
+ <p>La seconde méthode consiste à compiler le module en tant que DLL,
+ à savoir une bibliothèque partagée qui pourra être chargée dans le
+ serveur en cours d'exécution via la directive
+ <code><code class="directive">LoadModule</code></code>. Ces modules DLL
+ peuvent être distribués et exécutés sur toute installation d'Apache
+ pour Windows, sans avoir à recompiler le serveur.</p>
+
+ <p>Pour créer un module DLL, il est nécessaire d'apporter une légère
+ modification à son fichier source : l'enregistrement du module doit
+ être exporté depuis la DLL (qui sera elle-même créée plus tard ;
+ voir plus loin). Pour ce faire, ajoutez la macro
+ <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers
+ d'en-têtes d'Apache) à la définition de l'enregistrement de votre
+ module. Par exemple, si votre module est déclaré comme suit :</p>
+
+<div class="example"><p><code>
+ module foo_module;
+</code></p></div>
+
+ <p>Remplacez cette ligne par :</p>
+<div class="example"><p><code>
+ module AP_MODULE_DECLARE_DATA foo_module;
+</code></p></div>
+
+ <p>Notez que cette macro ne sera prise en compte que sous Windows,
+ si bien que le module poura être utilisé sans changement sous Unix,
+ si besoin est. Alternativement, si vous êtes familier avec les
+ fichiers <code>.DEF</code>, vous pouvez les utiliser pour exporter
+ l'enregistrement du module.</p>
+
+ <p>Maintenant, nous sommes prêts à créer une DLL contenant notre
+ module. Il va falloir pour cela la lier avec la bibliothèque
+ d'export libhttpd.lib qui a été créée au cours de la compilation de
+ la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi
+ nécessaire de modifier la configuration du compilateur pour
+ s'assurer que les fichiers d'en-têtes d'Apache seront correctement
+ localisés. Vous trouverez cette bibliothèque à la racine du
+ répertoire des modules de votre serveur. Il est souhaitable
+ d'utiliser un fichier de module .dsp existant dans l'arborescence
+ afin de s'assurer que l'environnement de compilation est
+ correctement configuré, mais vous pouvez aussi comparer les options
+ de compilation et d'édition de liens à votre fichier .dsp.</p>
+
+ <p>Ceci devrait créer une version DLL de votre module. Il vous
+ suffit maintenant de l'enregistrer dans le répertoire
+ <code>modules</code> à la racine de votre serveur, et d'utiliser la
+ directive <code class="directive">LoadModule</code> pour la charger.</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="LoadFile" id="LoadFile">LoadFile</a> <a name="loadfile" id="loadfile">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison du fichier objet ou de la bibliothèque
+spécifié</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</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_so</td></tr>
+</table>
+
+ <p>La directive LoadFile permet de lier le fichier objet ou la
+ bibliothèque spécifié au serveur lors du démarrage ou du redémarrage
+ de ce dernier ; ceci permet d'ajouter tout code additionnel
+ nécessaire au fonctionnement d'un module.
+ <em>nom-fichier</em> est soit un chemin absolu, soit un chemin
+ relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</p>
+
+ <p>Par exemple:</p>
+
+ <div class="example"><p><code>LoadFile libexec/libxmlparse.so</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="LoadModule" id="LoadModule">LoadModule</a> <a name="loadmodule" id="loadmodule">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison avec le serveur du fichier objet ou de la
+bibliothèque spécifié, et ajout de ce dernier à la liste des modules
+actifs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadModule <em>module nom-fichier</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</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_so</td></tr>
+</table>
+ <p>La directive LoadModule permet de lier le fichier objet ou la
+ bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la
+ structure de module nommée <em>module</em> à la liste des modules
+ actifs. <em>module</em> est le nom de la variable externe de type
+ <code>module</code> dans le fichier, et est référencé comme <a href="module-dict.html#ModuleIdentifier">Identificateur de
+ module</a> dans la documentation des modules. Exemple :</p>
+
+ <div class="example"><p><code>
+ LoadModule status_module modules/mod_status.so
+ </code></p></div>
+
+ <p>charge le module spécifié depuis le sous-répertoire des modules
+ situé à la racine du serveur.</p>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_so.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </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_so.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,190 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 420990 -->
+<!-- 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_so.xml.meta">
+
+<name>mod_so</name>
+<description>Chargement de modules ou de code exécutable au cours du
+démarrage ou du redémarrage du serveur</description>
+<status>Extension</status>
+<sourcefile>mod_so.c</sourcefile>
+<identifier>so_module</identifier>
+<compatibility>Sous Windows, c'est un module de base (toujours
+inclus)</compatibility>
+
+<summary>
+
+ <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être
+ utilisé pour charger des modules dans Apache en cours d'exécution
+ grâce au mécanisme des <a
+ href="../dso.html">Dynamic Shared Object ou Objets Partagés
+ Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une
+ recompilation.</p>
+
+ <p>Sous Unix, le code chargé provient en général de fichiers objet
+ partagés possèdant en général l'extension <code>.so</code>, alors
+ que sous Windows, l'extension peut être soit <code>.so</code>, soit
+ <code>.dll</code>.</p>
+
+ <note type="warning"><title>Avertissement</title>
+ <p>Les modules Apache 1.3 ne peuvent pas être utilisés directement
+ avec Apache 2.0 - ils doivent être modifiés pour pouvoir être
+ chargés dynamiquement ou compilés dans Apache 2.0.</p>
+ </note>
+</summary>
+
+<section id="windows"><title>Création de modules chargeables pour
+Windows</title>
+
+ <note><title>Note</title>
+ <p>Le format des noms de modules pour Windows a été modifié avec
+ Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du
+ style "mod_foo.so".</p>
+
+ <p>Bien que mod_so puisse encore charger des modules possèdant un
+ nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la
+ nouvelle convention de nommage ; si vous modifiez votre module
+ chargeable pour la version 2.0, veuillez aussi modifier son nom pour
+ respecter cette nouvelle convention.</p></note>
+
+ <p>Les API des modules Apache sous Unix et Windows sont identiques.
+ Alors que certains modules s'appuient sur certains
+ aspects de l'architecture Unix non présents dans Windows, et ne
+ fonctionneront donc pas sur cette dernière plate-forme, de nombreux
+ modules fonctionnent sous Windows avec peu ou pas de modification
+ par rapport à leur version Unix.</p>
+
+ <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de
+ deux manières. Sous Unix, il peut être compilé dans le serveur.
+ Comme Apache pour Windows ne dispose pas du programme
+ <code>Configure</code> propre à Apache pour Unix, le fichier source
+ du module doit être ajouté au fichier projet Apache de base, et ses
+ symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p>
+
+ <p>La seconde méthode consiste à compiler le module en tant que DLL,
+ à savoir une bibliothèque partagée qui pourra être chargée dans le
+ serveur en cours d'exécution via la directive
+ <code><directive>LoadModule</directive></code>. Ces modules DLL
+ peuvent être distribués et exécutés sur toute installation d'Apache
+ pour Windows, sans avoir à recompiler le serveur.</p>
+
+ <p>Pour créer un module DLL, il est nécessaire d'apporter une légère
+ modification à son fichier source : l'enregistrement du module doit
+ être exporté depuis la DLL (qui sera elle-même créée plus tard ;
+ voir plus loin). Pour ce faire, ajoutez la macro
+ <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers
+ d'en-têtes d'Apache) à la définition de l'enregistrement de votre
+ module. Par exemple, si votre module est déclaré comme suit :</p>
+
+<example>
+ module foo_module;
+</example>
+
+ <p>Remplacez cette ligne par :</p>
+<example>
+ module AP_MODULE_DECLARE_DATA foo_module;
+</example>
+
+ <p>Notez que cette macro ne sera prise en compte que sous Windows,
+ si bien que le module poura être utilisé sans changement sous Unix,
+ si besoin est. Alternativement, si vous êtes familier avec les
+ fichiers <code>.DEF</code>, vous pouvez les utiliser pour exporter
+ l'enregistrement du module.</p>
+
+ <p>Maintenant, nous sommes prêts à créer une DLL contenant notre
+ module. Il va falloir pour cela la lier avec la bibliothèque
+ d'export libhttpd.lib qui a été créée au cours de la compilation de
+ la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi
+ nécessaire de modifier la configuration du compilateur pour
+ s'assurer que les fichiers d'en-têtes d'Apache seront correctement
+ localisés. Vous trouverez cette bibliothèque à la racine du
+ répertoire des modules de votre serveur. Il est souhaitable
+ d'utiliser un fichier de module .dsp existant dans l'arborescence
+ afin de s'assurer que l'environnement de compilation est
+ correctement configuré, mais vous pouvez aussi comparer les options
+ de compilation et d'édition de liens à votre fichier .dsp.</p>
+
+ <p>Ceci devrait créer une version DLL de votre module. Il vous
+ suffit maintenant de l'enregistrer dans le répertoire
+ <code>modules</code> à la racine de votre serveur, et d'utiliser la
+ directive <directive>LoadModule</directive> pour la charger.</p>
+
+</section>
+
+<directivesynopsis>
+<name>LoadFile</name>
+<description>Liaison du fichier objet ou de la bibliothèque
+spécifié</description>
+<syntax>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</syntax>
+<contextlist>
+<context>server config</context>
+</contextlist>
+
+<usage>
+
+ <p>La directive LoadFile permet de lier le fichier objet ou la
+ bibliothèque spécifié au serveur lors du démarrage ou du redémarrage
+ de ce dernier ; ceci permet d'ajouter tout code additionnel
+ nécessaire au fonctionnement d'un module.
+ <em>nom-fichier</em> est soit un chemin absolu, soit un chemin
+ relatif au répertoire défini par la directive <a
+ href="core.html#serverroot">ServerRoot</a>.</p>
+
+ <p>Par exemple:</p>
+
+ <example>LoadFile libexec/libxmlparse.so</example>
+
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>LoadModule</name>
+<description>Liaison avec le serveur du fichier objet ou de la
+bibliothèque spécifié, et ajout de ce dernier à la liste des modules
+actifs</description>
+<syntax>LoadModule <em>module nom-fichier</em></syntax>
+<contextlist>
+<context>server config</context>
+</contextlist>
+
+<usage>
+ <p>La directive LoadModule permet de lier le fichier objet ou la
+ bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la
+ structure de module nommée <em>module</em> à la liste des modules
+ actifs. <em>module</em> est le nom de la variable externe de type
+ <code>module</code> dans le fichier, et est référencé comme <a
+ href="module-dict.html#ModuleIdentifier">Identificateur de
+ module</a> dans la documentation des modules. Exemple :</p>
+
+ <example>
+ LoadModule status_module modules/mod_status.so
+ </example>
+
+ <p>charge le module spécifié depuis le sous-répertoire des modules
+ situé à la racine du serveur.</p>
+</usage>
+
+</directivesynopsis>
+</modulesynopsis>
+
Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.meta Fri Oct 16 22:49:14 2009
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant>ja</variant>
<variant>ko</variant>
<variant>tr</variant>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_status.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.html?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_status.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_status.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_status.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: mod_status.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
Modified: httpd/httpd/trunk/docs/manual/mod/mod_status.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.html.en?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_status.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_status.html.en Fri Oct 16 22:49:14 2009
@@ -22,6 +22,7 @@
<div id="preamble"><h1>Apache Module mod_status</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/mod/mod_status.html" title="English"> en </a> |
+<a href="../fr/mod/mod_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
@@ -192,6 +193,7 @@
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_status.html" title="English"> en </a> |
+<a href="../fr/mod/mod_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
Added: httpd/httpd/trunk/docs/manual/mod/mod_status.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.html.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_status.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_status.html.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,208 @@
+<?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_status - 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="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_status</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_status.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des informations sur les performances et l'activité
+du serveur</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>status_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_status.c</td></tr></table>
+<h3>Sommaire</h3>
+
+ <p>Le module Status permet à un administrateur de déterminer le
+ niveau de performances de son serveur. Les statistiques instantanées
+ du serveur sont présentées dans une page HTML sous une forme
+ aisément lisible. Si nécessaire, cette page peut être configurée
+ pour être automatiquement actualisée (sous réserve de
+ compatibilité du navigateur). Une autre page fournit l'état
+ instantané du serveur sous la forme d'une simple liste lisible par
+ une machine.</p>
+
+ <p>Les détails fournis sont :</p>
+
+ <ul>
+ <li>Le nombre de processus servant les requêtes</li>
+
+ <li>Le nombre de processus inactifs</li>
+
+ <li>L'état de chaque processus, le nombre de requêtes qu'il a
+ traitées et le nombre total d'octets qu'il a servis (*)</li>
+
+ <li>Le nombre total d'accès effectués et d'octets servis (*)</li>
+
+ <li>Le moment où le serveur a été démarré/redémarré et le temps
+ écoulé depuis</li>
+
+ <li>Les valeurs moyennes du nombre de requêtes par seconde, du
+ nombre d'octets servis par seconde et du nombre d'octets par
+ requête (*)</li>
+
+ <li>Le pourcentage CPU instantané utilisé par chaque processus et
+ par Apache tout entier (*)</li>
+
+ <li>Les hôtes et requêtes actuellement en cours de traitement
+ (*)</li>
+ </ul>
+
+ <p>Les lignes se terminant par "(*)" ne sont disponibles que si la
+ directive <code class="directive"><a href="#extendedstatus">ExtendedStatus</a></code>
+ est définie à <code>On</code>.</p>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation du rapport d'état</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#autoupdate">Actualisation automatique</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#machinereadable">Fichier d'état lisible par une machine</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="enable" id="enable">Activation du rapport d'état</a></h2>
+
+
+ <p>Pour n'activer les rapports d'état que pour les navigateurs
+ appartenent au domaine exemple.com, ajoutez ces lignes à votre
+ fichier de configuration <code>httpd.conf</code> :</p>
+<div class="example"><p><code>
+ <Location /etat-serveur><br />
+ SetHandler server-status<br />
+<br />
+ Order Deny,Allow<br />
+ Deny from all<br />
+ Allow from .exemple.com<br />
+ </Location>
+</code></p></div>
+
+ <p>Il est alors possible d'obtenir les statistiques du serveur en
+ utilisant un navigateur web et en accédant à la page
+ <code>http://votre.serveur/etat-serveur</code>.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="autoupdate" id="autoupdate">Actualisation automatique</a></h2>
+
+
+ <p>Vous pouvez faire en sorte que cette page d'état s'actualise
+ elle-même automatiquement si votre navigateur supporte "refresh".
+ Pour ce faire, accédez à la page
+ <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que
+ cette dernière soit actualisée toutes les N secondes.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="machinereadable" id="machinereadable">Fichier d'état lisible par une machine</a></h2>
+
+
+ <p>La page <code>http://votre.serveur/etat-serveur?auto</code>
+ permet d'obtenir une version du fichier d'état lisible par une
+ machine. Ceci s'avère intéressant dans le cadre d'une exécution
+ automatique : voir le programme en Perl
+ <code>log_server_status</code>situé dans le répertoire
+ <code>/support</code> de la distribution d'Apache.</p>
+
+ <div class="note">
+ <strong>Veuillez noter que si <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a été
+ compilé dans le serveur, son gestionnaire sera disponible dans
+ <em>tous</em> les fichiers de configuration, y compris les
+ fichiers de configuration de <em>niveau répertoire</em> (par
+ exemple <code>.htaccess</code>), ce qui peut avoir des
+ répercutions quant à la sécurité de votre site.</strong>
+ </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="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'état étendues pour chaque
+requête</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtendedStatus Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</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_status</td></tr>
+</table>
+ <p>Cette directive s'applique au serveur dans son ensemble, et ne
+ peut pas être activée/désactivée pour un serveur virtuel
+ particulier. Notez que l'extraction des informations d'état étendues
+ peut ralentir le serveur.</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="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si mod_status affiche les 63 premiers caractères
+d'une requête ou les 63 derniers, en supposant que la requête
+elle-même possède plus de 63 caractères.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SeeRequestTail Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</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_status</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.7
+d'Apache.</td></tr>
+</table>
+ <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la
+ véritable requête en cours de traitement. Pour des raisons
+ historiques, seuls 63 caractères de la requête sont réellement
+ stockés à des fins d'affichage. Cette directive permet de déterminer
+ si ce sont les 63 premiers caractères qui seront stockés (c'est le
+ comportement par défaut et celui des versions antérieures à 2.2.7),
+ ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que
+ si la taille de la requête est de 64 caractères ou plus.</p>
+
+ <p>Si Apache traite la requête <code>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code>
+ , l'affichage de la requête par mod_status se présentera comme suit :
+ </p>
+
+ <table class="bordered">
+ <tr>
+ <th>Off (défaut)</th>
+ <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td>
+ </tr>
+ <tr>
+ <th>On</th>
+ <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td>
+ </tr>
+ </table>
+
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_status.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </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_status.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr?rev=826124&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr Fri Oct 16 22:49:14 2009
@@ -0,0 +1,189 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 779139 -->
+<!-- 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_status.xml.meta">
+
+<name>mod_status</name>
+<description>Fournit des informations sur les performances et l'activité
+du serveur</description>
+<status>Base</status>
+<sourcefile>mod_status.c</sourcefile>
+<identifier>status_module</identifier>
+
+
+<summary>
+ <p>Le module Status permet à un administrateur de déterminer le
+ niveau de performances de son serveur. Les statistiques instantanées
+ du serveur sont présentées dans une page HTML sous une forme
+ aisément lisible. Si nécessaire, cette page peut être configurée
+ pour être automatiquement actualisée (sous réserve de
+ compatibilité du navigateur). Une autre page fournit l'état
+ instantané du serveur sous la forme d'une simple liste lisible par
+ une machine.</p>
+
+ <p>Les détails fournis sont :</p>
+
+ <ul>
+ <li>Le nombre de processus servant les requêtes</li>
+
+ <li>Le nombre de processus inactifs</li>
+
+ <li>L'état de chaque processus, le nombre de requêtes qu'il a
+ traitées et le nombre total d'octets qu'il a servis (*)</li>
+
+ <li>Le nombre total d'accès effectués et d'octets servis (*)</li>
+
+ <li>Le moment où le serveur a été démarré/redémarré et le temps
+ écoulé depuis</li>
+
+ <li>Les valeurs moyennes du nombre de requêtes par seconde, du
+ nombre d'octets servis par seconde et du nombre d'octets par
+ requête (*)</li>
+
+ <li>Le pourcentage CPU instantané utilisé par chaque processus et
+ par Apache tout entier (*)</li>
+
+ <li>Les hôtes et requêtes actuellement en cours de traitement
+ (*)</li>
+ </ul>
+
+ <p>Les lignes se terminant par "(*)" ne sont disponibles que si la
+ directive <directive module="mod_status">ExtendedStatus</directive>
+ est définie à <code>On</code>.</p>
+</summary>
+
+<section id="enable">
+ <title>Activation du rapport d'état</title>
+
+ <p>Pour n'activer les rapports d'état que pour les navigateurs
+ appartenent au domaine exemple.com, ajoutez ces lignes à votre
+ fichier de configuration <code>httpd.conf</code> :</p>
+<example>
+ <Location /etat-serveur><br />
+ SetHandler server-status<br />
+<br />
+ Order Deny,Allow<br />
+ Deny from all<br />
+ Allow from .exemple.com<br />
+ </Location>
+</example>
+
+ <p>Il est alors possible d'obtenir les statistiques du serveur en
+ utilisant un navigateur web et en accédant à la page
+ <code>http://votre.serveur/etat-serveur</code>.</p>
+</section>
+
+<section id="autoupdate">
+
+ <title>Actualisation automatique</title>
+ <p>Vous pouvez faire en sorte que cette page d'état s'actualise
+ elle-même automatiquement si votre navigateur supporte "refresh".
+ Pour ce faire, accédez à la page
+ <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que
+ cette dernière soit actualisée toutes les N secondes.</p>
+
+</section>
+
+<section id="machinereadable">
+
+ <title>Fichier d'état lisible par une machine</title>
+ <p>La page <code>http://votre.serveur/etat-serveur?auto</code>
+ permet d'obtenir une version du fichier d'état lisible par une
+ machine. Ceci s'avère intéressant dans le cadre d'une exécution
+ automatique : voir le programme en Perl
+ <code>log_server_status</code>situé dans le répertoire
+ <code>/support</code> de la distribution d'Apache.</p>
+
+ <note>
+ <strong>Veuillez noter que si <module>mod_status</module> a été
+ compilé dans le serveur, son gestionnaire sera disponible dans
+ <em>tous</em> les fichiers de configuration, y compris les
+ fichiers de configuration de <em>niveau répertoire</em> (par
+ exemple <code>.htaccess</code>), ce qui peut avoir des
+ répercutions quant à la sécurité de votre site.</strong>
+ </note>
+
+</section>
+
+<directivesynopsis>
+
+<name>ExtendedStatus</name>
+<description>Extrait des informations d'état étendues pour chaque
+requête</description>
+<syntax>ExtendedStatus On|Off</syntax>
+<default>ExtendedStatus Off</default>
+<contextlist><context>server config</context></contextlist>
+
+<usage>
+ <p>Cette directive s'applique au serveur dans son ensemble, et ne
+ peut pas être activée/désactivée pour un serveur virtuel
+ particulier. Notez que l'extraction des informations d'état étendues
+ peut ralentir le serveur.</p>
+</usage>
+
+</directivesynopsis>
+<directivesynopsis>
+
+<name>SeeRequestTail</name>
+<description>Détermine si mod_status affiche les 63 premiers caractères
+d'une requête ou les 63 derniers, en supposant que la requête
+elle-même possède plus de 63 caractères.</description>
+<syntax>SeeRequestTail On|Off</syntax>
+<default>SeeRequestTail Off</default>
+<contextlist><context>server config</context></contextlist>
+<compatibility>Disponible depuis la version 2.2.7
+d'Apache.</compatibility>
+
+<usage>
+ <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la
+ véritable requête en cours de traitement. Pour des raisons
+ historiques, seuls 63 caractères de la requête sont réellement
+ stockés à des fins d'affichage. Cette directive permet de déterminer
+ si ce sont les 63 premiers caractères qui seront stockés (c'est le
+ comportement par défaut et celui des versions antérieures à 2.2.7),
+ ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que
+ si la taille de la requête est de 64 caractères ou plus.</p>
+
+ <p>Si Apache traite la requête <code
+ >GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code>
+ , l'affichage de la requête par mod_status se présentera comme suit :
+ </p>
+
+ <table border="1">
+ <tr>
+ <th>Off (défaut)</th>
+ <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td>
+ </tr>
+ <tr>
+ <th>On</th>
+ <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td>
+ </tr>
+ </table>
+
+</usage>
+
+</directivesynopsis>
+
+</modulesynopsis>
+
Modified: httpd/httpd/trunk/docs/manual/mod/mod_status.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.xml.meta?rev=826124&r1=826123&r2=826124&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_status.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_status.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>
<variant>tr</variant>