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 2013/03/17 23:04:32 UTC
svn commit: r1457571 [2/2] -
/httpd/httpd/branches/2.4.x/docs/manual/platform/
Added: httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.html.fr?rev=1457571&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.html.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.html.fr Sun Mar 17 22:04:31 2013
@@ -0,0 +1,143 @@
+<?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>Mise en oeuvre d'un serveur Web hautes performances sous
+ HPUX - 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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page" class="no-sidebar"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/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.4</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.4</a> > <a href="./">Notes spécifiques aux
+ plates-formes</a></div><div id="page-content"><div id="preamble"><h1>Mise en oeuvre d'un serveur Web hautes performances sous
+ HPUX</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/platform/perf-hp.html" title="Français"> fr </a> |
+<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+
+
+<pre>
+Date: Wed, 05 Nov 1997 16:59:34 -0800
+From: Rick Jones <<a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>>
+Reply-To: <a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>
+Organization: Network Performance
+Subject: HP-UX tuning tips
+</pre>
+
+ <p>Traduction du corps du message cité ci-dessus :</p>
+
+ <p>Voici quelques conseils de personnalisation pour HPUX à ajouter à
+ la page de personnalisation.</p>
+
+ <p>Pour HP-UX 9.X: mettre à jour vers la version 10.20<br />
+ Pour HP-UX 10.[00|01|10]: mettre à jour vers la version 10.20</p>
+
+ <p>Pour HP-UX 10.20:</p>
+
+ <p>Installez le dernier patch cumulatif à propos du transport ARPA.
+ Ceci va vous permettre de configurer la taille de la table de
+ hashage de recherche de connexion TCP. La valeur par défaut est 256
+ conteneurs et doit être une puissance de deux. À cet effet, utilisez
+ adb pour modifier l'image *disque* du noyau. Le nom de la variable
+ est <code>tcp_hash_size</code>. Notez qu'il est impératif d'utiliser
+ "<code>W</code>" pour spécifier une quantité sur 32 bits, et non
+ "<code>w</code>" qui indique une valeur sur 16 bits, lors de la
+ modification de l'image disque car la variable
+ <code>tcp_hash_size</code> est une quantité sur 32 bits.</p>
+
+ <p>Comment déterminer cette valeur ? Examinez la sortie de <a href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist">ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a>, et
+ comptez le nombre total de connexions TCP existant sur le système.
+ Il est en général souhaitable que ce nombre divisé par la taille de
+ la table de hashage soit raisonnablement petit, disons inférieur à
+ 10. Les administrateurs peuvent consulter le document SPECweb96 de
+ HP pour quelques réglages courants. On peut les trouver à <a href="http://www.specbench.org/">http://www.specbench.org/</a>. Si
+ un système HP-UX traite 1000 connexions SPECweb96 par seconde, une
+ valeur de temps <code>TIME_WAIT</code> de 60 secondes permettrait le
+ suivi de 60000 connexions TCP.</p>
+
+ <p>Les administrateurs peuvent tester la profondeur de leur file
+ d'attente d'écoute avec <a href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq">ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>.</p>
+
+ <p>Si Apache s'exécute sur un système à base de PA-8000, il est
+ conseillé de modifier l'exécutable Apache avec la commande chatr
+ afin d'utiliser une page de grande taille. La commande sera du style
+ "<code>chatr +pi L <BINARY></code>". Le GID de l'exécutable en
+ cours de fonctionnement doit posséder le privilège
+ <code>MLOCK</code>. Pour assigner ce privilège <code>MLOCK</code>,
+ consultez <code>Setprivgrp(1m)</code>. La modification peut être
+ validée en exécutant Glance et en examinant les portions de mémoire
+ du/des serveur(s) afin de s'assurer qu'elles montrent une fraction
+ non triviale du segment de texte verrouillé.</p>
+
+ <p>Si Apache s'exécute sur un système MP (multi-processeurs), il est
+ conseillé d'écrire un petit programme qui utilise
+ <code>mpctl()</code> et permettant d'associer les processus aux
+ processeurs. Un simple algorithme <code>pid % numcpu</code> suffira
+ probablement. Cette modification peut aussi être ajoutée dans le
+ code source.</p>
+
+ <p>Si l'administrateur s'intéresse au nombre de connexions
+ <code>FIN_WAIT_2</code>, il peut utiliser nettune pour diminuer la
+ valeur de <code>tcp_keepstart</code>. Il devra cependant être
+ prudent - surtout ne pas diminuer cette valeur en dessous de, disons
+ deux à quatre minutes. Si <code>tcp_hash_size</code> a été défini,
+ il est probablement approprié de laisser les connexions
+ <code>FIN_WAIT_2</code> prendre plus de temps à expirer (peut-être
+ même la valeur par défaut de deux heures) - elles n'auront en
+ général pas un grand impact sur les performances.</p>
+
+ <p>On peut ajouter d'autres choses au code de base, mais elles
+ feront peut-être l'objet d'un autre email. N'hésitez pas à m'envoyer
+ un message si vous êtes intéressé.</p>
+
+ <p>sincèrement ,</p>
+
+ <p>rick jones</p>
+
+ <p><a href="http://www.netperf.org/netperf/">http://www.netperf.org/netperf/</a></p>
+
+ </div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/platform/perf-hp.html" title="Français"> fr </a> |
+<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/perf-hp.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2013 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.fr?rev=1457571&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.fr Sun Mar 17 22:04:31 2013
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 805049 -->
+<!-- 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.
+-->
+
+<manualpage metafile="perf-hp.xml.meta">
+ <parentdocument href="./">Notes spécifiques aux
+ plates-formes</parentdocument>
+
+ <title>Mise en oeuvre d'un serveur Web hautes performances sous
+ HPUX</title>
+
+ <summary>
+
+<pre>
+Date: Wed, 05 Nov 1997 16:59:34 -0800
+From: Rick Jones <<a
+href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>>
+Reply-To: <a href="mailto:raj@cup.hp.com"
+>raj@cup.hp.com</a>
+Organization: Network Performance
+Subject: HP-UX tuning tips
+</pre>
+
+ <p>Traduction du corps du message cité ci-dessus :</p>
+
+ <p>Voici quelques conseils de personnalisation pour HPUX à ajouter à
+ la page de personnalisation.</p>
+
+ <p>Pour HP-UX 9.X: mettre à jour vers la version 10.20<br />
+ Pour HP-UX 10.[00|01|10]: mettre à jour vers la version 10.20</p>
+
+ <p>Pour HP-UX 10.20:</p>
+
+ <p>Installez le dernier patch cumulatif à propos du transport ARPA.
+ Ceci va vous permettre de configurer la taille de la table de
+ hashage de recherche de connexion TCP. La valeur par défaut est 256
+ conteneurs et doit être une puissance de deux. À cet effet, utilisez
+ adb pour modifier l'image *disque* du noyau. Le nom de la variable
+ est <code>tcp_hash_size</code>. Notez qu'il est impératif d'utiliser
+ "<code>W</code>" pour spécifier une quantité sur 32 bits, et non
+ "<code>w</code>" qui indique une valeur sur 16 bits, lors de la
+ modification de l'image disque car la variable
+ <code>tcp_hash_size</code> est une quantité sur 32 bits.</p>
+
+ <p>Comment déterminer cette valeur ? Examinez la sortie de <a
+ href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist"
+ >ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a>, et
+ comptez le nombre total de connexions TCP existant sur le système.
+ Il est en général souhaitable que ce nombre divisé par la taille de
+ la table de hashage soit raisonnablement petit, disons inférieur à
+ 10. Les administrateurs peuvent consulter le document SPECweb96 de
+ HP pour quelques réglages courants. On peut les trouver à <a
+ href="http://www.specbench.org/">http://www.specbench.org/</a>. Si
+ un système HP-UX traite 1000 connexions SPECweb96 par seconde, une
+ valeur de temps <code>TIME_WAIT</code> de 60 secondes permettrait le
+ suivi de 60000 connexions TCP.</p>
+
+ <p>Les administrateurs peuvent tester la profondeur de leur file
+ d'attente d'écoute avec <a
+ href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq"
+ >ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>.</p>
+
+ <p>Si Apache s'exécute sur un système à base de PA-8000, il est
+ conseillé de modifier l'exécutable Apache avec la commande chatr
+ afin d'utiliser une page de grande taille. La commande sera du style
+ "<code>chatr +pi L <BINARY></code>". Le GID de l'exécutable en
+ cours de fonctionnement doit posséder le privilège
+ <code>MLOCK</code>. Pour assigner ce privilège <code>MLOCK</code>,
+ consultez <code>Setprivgrp(1m)</code>. La modification peut être
+ validée en exécutant Glance et en examinant les portions de mémoire
+ du/des serveur(s) afin de s'assurer qu'elles montrent une fraction
+ non triviale du segment de texte verrouillé.</p>
+
+ <p>Si Apache s'exécute sur un système MP (multi-processeurs), il est
+ conseillé d'écrire un petit programme qui utilise
+ <code>mpctl()</code> et permettant d'associer les processus aux
+ processeurs. Un simple algorithme <code>pid % numcpu</code> suffira
+ probablement. Cette modification peut aussi être ajoutée dans le
+ code source.</p>
+
+ <p>Si l'administrateur s'intéresse au nombre de connexions
+ <code>FIN_WAIT_2</code>, il peut utiliser nettune pour diminuer la
+ valeur de <code>tcp_keepstart</code>. Il devra cependant être
+ prudent - surtout ne pas diminuer cette valeur en dessous de, disons
+ deux à quatre minutes. Si <code>tcp_hash_size</code> a été défini,
+ il est probablement approprié de laisser les connexions
+ <code>FIN_WAIT_2</code> prendre plus de temps à expirer (peut-être
+ même la valeur par défaut de deux heures) - elles n'auront en
+ général pas un grand impact sur les performances.</p>
+
+ <p>On peut ajouter d'autres choses au code de base, mais elles
+ feront peut-être l'objet d'un autre email. N'hésitez pas à m'envoyer
+ un message si vous êtes intéressé.</p>
+
+ <p>sincèrement ,</p>
+
+ <p>rick jones</p>
+
+ <p><a href="http://www.netperf.org/netperf/"
+ >http://www.netperf.org/netperf/</a></p>
+
+ </summary>
+
+</manualpage>
+
+
Modified: httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.meta?rev=1457571&r1=1457570&r2=1457571&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/perf-hp.xml.meta Sun Mar 17 22:04:31 2013
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ko</variant>
</variants>
</metafile>
Modified: httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html?rev=1457571&r1=1457570&r2=1457571&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html Sun Mar 17 22:04:31 2013
@@ -4,6 +4,10 @@ URI: win_compiling.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: win_compiling.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: win_compiling.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
Added: httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html.fr?rev=1457571&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.html.fr Sun Mar 17 22:04:31 2013
@@ -0,0 +1,506 @@
+<?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>Compiler Apache pour Microsoft Windows - 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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/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.4</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.4</a> > <a href="./">Notes spécifiques à certaines
+ plates-formes</a></div><div id="page-content"><div id="preamble"><h1>Compiler Apache pour Microsoft Windows</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/platform/win_compiling.html" title="Français"> fr </a> |
+<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+
+
+ <p>Il y a de nombreux points importants à connaître avant de
+ compiler Apache pour Microsoft Windows. Avant de commencer, lisez le
+ document <a href="windows.html">Utiliser Apache avec Microsoft
+ Windows</a>.</p>
+
+ </div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">Prérequis</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#commandbuild">Compilation à partir de la ligne de commandes</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#workspacebuild">Compilation depuis l'espace de travail IDE de Developer
+ Studio</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#exportingmakfiles">Export des fichiers .mak de la ligne de commandes</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#installation">Installation</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#projectcomponents-warn">Avertissement à propos de la compilation d'Apache à partir de
+l'arborescence de développement</a></li>
+</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</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="requirements" id="requirements">Prérequis</a></h2>
+
+
+
+ <p>Pour compiler Apache, l'environnement doit satisfaire aux
+ conditions suivantes :</p>
+
+ <ul>
+ <li>
+ <p>Espace disque</p>
+
+ <p>Assurez-vous de disposer d'un minimum de 200 Mo d'espace
+ disque disponible. Après l'installation, Apache occupe environ
+ 80 Mo d'espace disque, plus l'espace réservé aux journaux et au
+ cache, la taille de ces derniers pouvant augmenter rapidement.
+ Les besoins réels en espace disque dépendent étroitement de la
+ configuration choisie et des bibliothèques ou modules tiers
+ installés, en particulier lorsqu'OpenSSL est mis en oeuvre.
+ Comme de nombreux fichiers sont au format texte et donc
+ facilement compressibles, l'utilisation de la compression du
+ système de fichiers NTFS divise ces besoins par deux.</p>
+ </li>
+
+ <li>
+ <p>Correctifs requis</p>
+
+ <p>Le binaire httpd est compilé à l'aide de nombreux correctifs
+ appliqués aux paquets tiers, ce qui permet de s'assurer que le
+ code fourni est bien compilable et déboguable. Ces correctifs
+ sont disponibles à <a href="http://www.apache.org/dist/httpd/binaries/win32/patches_applied/">http://www.apache.org/dist/httpd/binaries/win32/patches_applied/</a>,
+ et il est recommandé de les appliquer afin d'obtenir un
+ résultat identique aux binaires "officiels" distribués par
+ l'ASF.</p>
+ </li>
+
+ <li>
+ <p>Microsoft Visual C++ 6.0 (Visual Studio 97) ou supérieur.</p>
+
+ <p>Apache peut être compilé en utilisant l'outil ligne de
+ commande, ou depuis l'espace de travail IDE Visual Studio. Pour
+ la compilation depuis la ligne de commandes, l'environnement
+ doit comporter les variables <code>PATH</code>,
+ <code>INCLUDE</code>, <code>LIB</code>, ainsi que d'autres
+ variables qui peuvent être définies via le script
+ <code>vcvars32.bat</code> :</p>
+
+ <div class="note">Vous pouvez vous procurer le paquet du Processeur Visual
+ Studio pour votre ancienne version de Visual Studio, ou une
+ version complète (et non Express) d'une édition plus récente de
+ Visual Studio pour l'assembleur ml.exe. Ceci vous permettra, si
+ vous le souhaitez, de compiler OpenSSL en utilisant une
+ implémentation du code d'assemblage plus efficace.</div>
+
+ <div class="note">Seule la chaîne d'outils de compilation de Microsoft est
+ supportée de manière suivie par les contributeurs actifs à httpd.
+ Bien que le projet accepte régulièrement des correctifs pour
+ s'assurer que MinGW et d'autre outils de compilation
+ fonctionnent, ou même pour les améliorer, ils ne sont pas
+ maintenus de manière suivie et sont même souvent hors d'état
+ de fonctionner à certains stades du développement normal.</div>
+ </li>
+
+ <li>
+ <p>Le SDK de la plate-forme Windows mis à jour, février 2003 ou
+ plus récent.</p>
+
+ <p>Un SDK approprié pour la plate-forme Windows est inclus par
+ défaut dans les versions complètes (et non Express/lite) de
+ Visual C++ 7.1 (Visual Studio 2002) et supérieures ; les
+ utilisateurs peuvent ignorer ces étapes, à moins qu'ils aient
+ choisi d'utiliser une version plus récente ou différente du SDK.</p>
+
+ <p>Pour pouvoir utiliser Visual C++ 6.0 or 7.0 (Studio 2000
+ .NET), l'environnement du SDK de la plate-forme doit être préparé en utilisant le
+ script <code>setenv.bat</code> (installé par le SDK de la plate-forme) avant de
+ lancer la compilation en ligne de commande ou l'interface GUI
+ msdev/devenv. L'installation du SDK de la plate-forme pour les
+ versions Express de Visual Studio (2003 et supérieures) devrait
+ ajuster l'environnement par défaut de manière appropriée.</p>
+
+ <div class="example"><p><code>
+ "c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"<br />
+ "c:\Program Files\Platform SDK\setenv.bat"
+ </code></p></div>
+
+
+ </li>
+
+ <li>
+ <p>Perl et awk</p>
+
+ <p>De nombreuses étapes recommandées ici nécessitent un
+ interpréteur perl durant le processus de préparation de la
+ compilation.</p>
+
+ <p>Pour installer Apache à partir du système de compilation, de
+ nombreux fichiers sont modifiés via l'utilitaire
+ <code>awk.exe</code>. awk effectue la modification des fichiers
+ au moment de l'installation ; il a été choisi car il nécessite
+ un téléchargement de petite taille (par rapport à Perl ou
+ WSH/VB). Le site de Brian Kernighan <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/">http://www.cs.princeton.edu/~bwk/btl.mirror/</a> propose un
+ binaire précompilé pour Win32, <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe">http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe</a>, que
+ vous devez enregistrer sous le nom <code>awk.exe</code> (plutôt
+ que <code>awk95.exe</code>).</p>
+
+ <div class="note">Si awk.exe n'est pas trouvé, la cible install du fichier
+ Makefile.win n'effectuera aucune substitution dans les fichiers
+ .conf installés. Vous devrez alors modifier manuellement les fichiers
+ .conf installés afin de permettre au serveur de démarrer.
+ Recherchez et remplacez toutes les balises "@token@" par une
+ valeur appropriée.</div>
+
+ <div class="note">L'IDE Visual Studio ne trouvera le chemin de
+ <code>awk.exe</code> que dans la variable PATH, ou dans le
+ chemin des exécutables spécifié par l'option de menu Tools ->
+ Options -> (Projects ->) Directories. Assurez-vous
+ qu'awk.exe est bien dans votre chemin système.</div>
+
+ <div class="note">Notez aussi, si vous utilisez les outils Cygwin (<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>), que
+ l'utilitaire awk se nomme <code>gawk.exe</code> et que le
+ fichier <code>awk.exe</code> est en fait un lien symbolique vers
+ le fichier <code>gawk.exe</code>. Le shell de commandes Windows
+ ne reconnaît pas les liens symboliques, et par conséquent la
+ compilation d'InstallBin échouera. Pour contourner le problème,
+ vous pouvez supprimer le lien <code>awk.exe</code> de
+ l'installation de Cygwin, et copier <code>gawk.exe</code> vers
+ <code>awk.exe</code>. Notez aussi que les portages cygwin/mingw
+ de gawk 3.0.x étaient bogués ; veuillez par conséquent effectuer
+ une mise à jour vers la version 3.1.x avant l'utilisation de
+ tout portage de gawk.</div>
+ </li>
+
+ <li>
+ <p>[Optionnel] bibliothèque zlib (pour le module
+ <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>)</p>
+
+ <p>Zlib doit être installée dans un sous-répertoire du
+ répertoire <code>srclib</code> et nommé <code>zlib</code>. Elle
+ doit être compilée directement à cette place. Zlib est
+ disponible à l'adresse <a href="http://www.zlib.net/">http://www.zlib.net/</a> -- le
+ fonctionnement correct du module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> a
+ été vérifié avec la version 1.2.3.</p>
+
+ <div class="example"><p><code>
+ nmake -f win32\Makefile.msc<br />
+ nmake -f win32\Makefile.msc test
+ </code></p></div>
+ </li>
+
+ <li>
+ <p>[Optionnel] Bibliothèques OpenSSL (pour le module
+ <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> et <code>ab.exe</code> avec le support
+ ssl)</p>
+
+ <div class="note">La bibliothèque OpenSSL est un logiciel de chiffrement. Le
+ pays dans lequel vous résidez peut imposer des restrictions à
+ l'importation, la possession, l'utilisation, et/ou la
+ réexportation vers un autre pays des logiciels de chiffrement.
+ AVANT d'utiliser tout logiciel de chiffrement, veuillez
+ consulter la législation de votre pays, les règles et politiques
+ d'importation, de possession, ou d'utilisation, et de
+ réexportation des logiciels de chiffrement, afin de déterminer
+ si vous en avez le droit. Voir <a href="http://www.wassenaar.org/">http://www.wassenaar.org/</a>
+ pour plus de détails.</div>
+
+ <p>La configuration et la compilation d'OpenSSL nécessite
+ l'installation de perl.</p>
+
+ <p>Pour compiler <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ou le projet
+ <code>abs.exe</code>, qui n'est autre que ab.c avec le support SSL
+ activé, vous devez télécharger OpenSSL à l'adresse <a href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>,
+ et l'installer dans un sous-répertoire du répertoire
+ <code>srclib</code> que vous nommerez <code>openssl</code>. Afin
+ de préparer OpenSSL à la liaison avec le module Apache mod_ssl
+ ou abs.exe, et désactiver les fonctionnalités d'Openssl grévées
+ de brevets, vous pouvez utiliser la commande de compilation
+ suivante :</p>
+
+ <div class="example"><p><code>
+ perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32
+ -Ipath/to/srclib/zlib -Lpath/to/srclib/zlib<br />
+ ms\do_masm.bat<br />
+ nmake -f ms\ntdll.mak
+ </code></p></div>
+
+ <div class="note">Il est déconseillé d'utiliser zlib-dynamic, car la charge
+ de la décompression des flux SSL est alors transférée à la
+ première requête qui doit charger la dll zlib. Notez que le
+ correctif proposé active le drapeau -L afin de
+ fonctionner avec les compilations Windows, corrige le nom de
+ zdll.lib et s'assure que les fichiers .pdb sont générés afin de
+ résoudre les problèmes. Si l'assembleur n'est pas
+ installé, vous devez ajouter no-asm ci-dessus et utiliser le
+ script ms\do_ms.bat à la place de ms\do_masm.bat.</div>
+ </li>
+
+ <li>
+ <p>[Optionnel] Bibliothèques de bases de données (pour
+<code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> et <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>)</p>
+
+ <p>La bibliothèque apr-util fournit un accès aux fonctionnalités
+ clients dbm (base de données à base de clés) et dbd (base de
+ données à base de requêtes) au serveur httpd et à certains de
+ ses modules, comme les modules d'authentification et
+ d'autorisation. Les fournisseurs sdbm dbm et odbc dbd sont
+ compilés automatiquement.</p>
+
+ <p>Le support dbd inclut le paquet instantclient Oracle, MySQL,
+ PostgreSQL et sqlite. Par exemple, pour les compiler tous,
+ définissez LIB de façon à inclure le chemin des bibliothèques,
+ INCLUDE de façon à inclure le chemin des en-têtes, et PATH de
+ façon à inclure le chemin des dll et bin de chacun des quatre
+ SDK, et définissez la variable d'environnement DBD_LIST de façon
+ à indiquer au processus de compilation quels SDKs pilotes
+ clients du sont correctement installés ; par exemple :</p>
+
+ <div class="example"><p><code>
+ set DBD_LIST=sqlite3 pgsql oracle mysql
+ </code></p></div>
+
+ <p>De manière similaire, le support dbm peut être étendu avec
+ DBM_LIST pour compiler un fournisseur Berkeley DB (db) et/ou un
+ fournisseur gdbm, en configurant tout d'abord de la même manière
+ LIB, INCLUDE et PATH afin de s'assurer que les bibliothèques et
+ en-têtes de la bibliothèque client sont bien disponibles.</p>
+
+ <div class="example"><p><code>
+ set DBM_LIST=db gdbm
+ </code></p></div>
+
+ <div class="note">En fonction du choix des distributions de bases de
+ données, il peut s'avérer nécessaire de modifier le nom des
+ cibles de l'édition de liens (par exemple gdbm.lib à la place de
+ libgdb.lib) listées dans les fichiers .dsp/.mak des répertoires
+ srclib\apr-util\dbd ou ...\dbm correspondants.</div>
+
+ <p>Voir le fichier README-win32.txt pour plus d'informations à
+ propos de l'obtention des différents SDKs pilotes de bases de
+ données.</p>
+ </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="commandbuild" id="commandbuild">Compilation à partir de la ligne de commandes</a></h2>
+
+
+
+ <p><code>Makefile.win</code> est le makefile principal ou racine
+ d'Apache. Pour compiler Apache sous Windows, utilisez simplement une
+ des commandes suivantes pour compiler la version
+ <code>release</code> ou <code>debug</code> :</p>
+
+ <div class="example"><p><code>
+ nmake /f Makefile.win _apacher<br /><br />
+ nmake /f Makefile.win _apached
+ </code></p></div>
+
+
+ <p>Ces deux commandes effectuent la compilation d'Apache. Cependant,
+ avec la deuxième, les fichiers résultants ne seront pas optimisés,
+ ce qui va faciliter l'examen pas à pas du code pour trouver des
+ bogues et résoudre les problèmes.</p>
+
+ <p>Vous pouvez indiquer vos choix en matière de fournisseurs dbd et
+ dbm à l'aide des variables (d'environnement) additionnelles de make
+ DBD_LIST et DBM_LIST ; voir les commentaires à propos des
+ [Optionnel] Bibliothèques de bases de données ci-dessus. Consultez
+ les commentaires initiaux dans Makefile.win pour plus d'options
+ pouvant être fournies lors de la compilation.</p>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="workspacebuild" id="workspacebuild">Compilation depuis l'espace de travail IDE de Developer
+ Studio</a></h2>
+
+
+
+ <p>Apache peut aussi être compilé depuis l'environnement de
+ développement Visual Studio de VC++. Pour simplifier ce processus,
+ l'espace de travail Visual Studio <code>Apache.dsw</code> est
+ fourni. Cet espace de travail expose la liste complète des projets
+ <code>.dsp</code> actifs nécessaires à l'installation binaire
+ complète d'Apache. Il inclut les dépendances entre projets afin que
+ ces derniers soient compilés selon l'ordre approprié.</p>
+
+ <p>Ouvrez l'espace de travail <code>Apache.dsw</code>, et
+ sélectionnez <code>InstallBin</code> (compilation
+ <code>Release</code> ou <code>Debug</code>, selon vos souhaits)
+ comme Active Project. <code>InstallBin</code> provoque la
+ compilation de tous les projets concernés, puis invoque
+ <code>Makefile.win</code> pour installer les exécutables et dlls
+ compilés. Vous pouvez modifier la valeur de <code>INSTDIR=</code>
+ via la configuration de <code>InstallBin</code>, onglet Général,
+ entrée ligne de commandes de compilation. La valeur par défaut de
+ <code>INSTDIR</code> est le répertoire <code>/Apache2</code>. Si
+ vous désirez effectuer un test de compilation (sans installation),
+ sélectionnez le projet <code>BuildBin</code>.</p>
+
+ <p>Les fichiers projets <code>.dsp</code> sont distribués au format
+ Visual Studio 6.0 (98). Visual C++ 5.0 (97) les reconnaît. Les
+ utilisateurs de Visual Studio 2002 (.NET) et versions supérieures
+ doivent convertir <code>Apache.dsw</code> et les fichiers
+ <code>.dsp</code> en un projet <code>Apache.sln</code>, ainsi que
+ les fichiers <code>.msproj</code> ; assurez-vous de reconvertir le
+ fichier <code>.msproj</code> si l'un des fichiers source
+ <code>.dsp</code> est modifié ! Cette opération est vraiment très
+ simple, il suffit de réouvrir <code>Apache.dsw</code> dans l'IDE
+ VC++ 7.0 et de le reconvertir.</p>
+
+ <div class="note">Il y a un problème au niveau de la conversion .vcproj des fichiers
+ .dsp. devenv.exe interprète mal le drapeau
+ /D pour les drapeaux RC contenant de longues /D'efines,
+ si ces dernières contiennent elles-mêmes des espaces. Ainsi, la
+ commande :
+ <div class="example"><p><code>
+ perl srclib\apr\build\cvtdsp.pl -2005
+ </code></p></div>
+ va convertir les drapeaux /D pour les drapeaux RC afin d'utiliser
+ une syntaxe alternative, interprétable ; malheureusement, cette
+ syntaxe n'est pas supportée par Visual Studio 97 ou ses fichiers
+ .mak exportés. Ces drapeaux /D transmettent la longue
+ description des fichiers de mod_apachemodule.so à leurs compilations
+ d'identificateur de version de ressource .rc partagée.</div>
+
+
+ <p>Les utilisateurs de Visual Studio 2002 (.NET) et versions
+ supérieures doivent aussi utiliser
+ la boîte de dialogue Configuration Manager du menu Build pour
+ décocher les deux versions <code>Debug</code> et
+ <code>Release</code> des modules <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
+ et <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> pour <code>abs</code>. Ces modules
+ sont compilés
+ en invoquant <code>nmake</code> ou directement l'IDE avec la cible
+ <code>BinBuild</code> pour compiler ces modules de manière
+ conditionnelle si les sous-répertoires de <code>srclib</code>
+ <code>openssl</code> et/ou <code>zlib</code> existent, et en
+ fonction des définitions des variables d'environnement
+ <code>DBD_LIST</code> et <code>DBM_LIST</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="exportingmakfiles" id="exportingmakfiles">Export des fichiers .mak de la ligne de commandes</a></h2>
+
+
+
+
+ <p>Les fichiers <code>.mak</code> exportés posent beaucoup de problèmes,
+ mais les utilisateurs de Visual C++ 5.0 en ont besoin pour compiler
+ <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, abs (<code class="program"><a href="../programs/ab.html">ab</a></code> avec support
+ SSL) et/ou <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Les fichiers .mak
+ supportent aussi un choix plus large de distributions de chaînes
+ d'outils C++, comme Visual Studio Express.</p>
+
+ <p>Vous devez tout d'abord compiler tous les projets afin de créer
+ toutes les cibles dynamiques auto-générées, de façon à ce que les
+ dépendances puissent être interprétées correctement. Compilez
+ l'ensemble du projet depuis l'IDE Visual Studio 6.0 (98), en
+ utilisant la cible <code>BuildAll</code>, puis utilisez le menu de
+ projet Export pour tous les makefiles (en cochant "with
+ dependencies"). Utilisez la commande suivante pour transformer les
+ chemins absolus en chemins relatifs de façon à ce que la compilation
+ puisse s'effectuer depuis n'importe quelle position dans
+ l'arborescence :</p>
+
+ <div class="example"><p><code>
+ perl srclib\apr\build\fixwin32mak.pl
+ </code></p></div>
+
+ <p>Vous devez exécuter cette commande depuis la <em>racine</em> de
+ l'arborescence des sources de httpd. Tout fichier projet
+ <code>.mak</code> et <code>.dep</code> du répertoire courant et de
+ ses sous-répertoires sera corrigé, et les repères de temps ajustés
+ en fonction des <code>.dsp</code>.</p>
+
+ <p>Vérifiez toujours le SDK de la plate-forme ou autres chemins
+ fichiers locaux, spécifiques à la machine dans les fichiers
+ <code>.mak</code> et <code>.dep</code> générés. Le répertoire
+ <code>DevStudio\Common\MSDev98\bin\</code> (VC6) contient un fichier
+ <code>sysincl.dat</code> qui énumère toutes les exceptions. Mettez à
+ jour ce fichier (en particulier les chemins avec slashes et
+ anti-slashes, tels que <code>sys/time.h</code> et
+ <code>sys\time.h</code>) de façon à ignorer ces nouvelles
+ dépendances. Inclure les chemins d'installation locale dans un
+ fichier <code>.mak</code> distribué fera échouer la
+ compilation.</p>
+
+ <p>Si vous soumettez un patch qui modifie les fichiers projet, nous
+ devons valider la modification de ces fichiers projet au format
+ Visual Studio 6.0. Les modifications doivent êtres simples, avec un
+ minimum de drapeaux de compilation et d'édition de liens qui
+ pourront être reconnus par tous les environnements Visual
+ Studio.</p>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="installation" id="installation">Installation</a></h2>
+
+
+
+
+ <p>Une fois compilé, Apache doit être installé dans le répertoire
+ racine du serveur. La valeur par défaut est le répertoire
+ <code>\Apache2</code>, sur le même disque.</p>
+
+ <p>Pour compiler et installer automatiquement tous les fichiers dans
+ le répertoire <em>rep</em> désiré, utilisez une des commandes
+ <code>nmake</code> suivantes :</p>
+
+ <div class="example"><p><code>
+ nmake /f Makefile.win installr INSTDIR=<em>dir</em><br />
+ nmake /f Makefile.win installd INSTDIR=<em>dir</em>
+ </code></p></div>
+
+ <p>L'argument <em>rep</em> de <code>INSTDIR</code> permet de
+ spécifier le répertoire d'installation ; il peut être omis si Apache
+ doit être installé dans <code>\Apache22</code> (du lecteur de disque
+ courant.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="projectcomponents-warn" id="projectcomponents-warn">Avertissement à propos de la compilation d'Apache à partir de
+l'arborescence de développement</a></h2>
+
+
+
+
+
+ </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/platform/win_compiling.html" title="Français"> fr </a> |
+<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/win_compiling.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2013 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.fr?rev=1457571&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.fr Sun Mar 17 22:04:31 2013
@@ -0,0 +1,490 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1174747 -->
+<!-- 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.
+-->
+
+<manualpage metafile="win_compiling.xml.meta">
+ <parentdocument href="./">Notes spécifiques à certaines
+ plates-formes</parentdocument>
+
+ <title>Compiler Apache pour Microsoft Windows</title>
+
+ <summary>
+
+ <p>Il y a de nombreux points importants à connaître avant de
+ compiler Apache pour Microsoft Windows. Avant de commencer, lisez le
+ document <a href="windows.html">Utiliser Apache avec Microsoft
+ Windows</a>.</p>
+
+ </summary>
+
+ <section id="requirements">
+
+ <title>Prérequis</title>
+
+ <p>Pour compiler Apache, l'environnement doit satisfaire aux
+ conditions suivantes :</p>
+
+ <ul>
+ <li>
+ <p>Espace disque</p>
+
+ <p>Assurez-vous de disposer d'un minimum de 200 Mo d'espace
+ disque disponible. Après l'installation, Apache occupe environ
+ 80 Mo d'espace disque, plus l'espace réservé aux journaux et au
+ cache, la taille de ces derniers pouvant augmenter rapidement.
+ Les besoins réels en espace disque dépendent étroitement de la
+ configuration choisie et des bibliothèques ou modules tiers
+ installés, en particulier lorsqu'OpenSSL est mis en oeuvre.
+ Comme de nombreux fichiers sont au format texte et donc
+ facilement compressibles, l'utilisation de la compression du
+ système de fichiers NTFS divise ces besoins par deux.</p>
+ </li>
+
+ <li>
+ <p>Correctifs requis</p>
+
+ <p>Le binaire httpd est compilé à l'aide de nombreux correctifs
+ appliqués aux paquets tiers, ce qui permet de s'assurer que le
+ code fourni est bien compilable et déboguable. Ces correctifs
+ sont disponibles à <a
+ href="http://www.apache.org/dist/httpd/binaries/win32/patches_applied/"
+ >http://www.apache.org/dist/httpd/binaries/win32/patches_applied/</a>,
+ et il est recommandé de les appliquer afin d'obtenir un
+ résultat identique aux binaires "officiels" distribués par
+ l'ASF.</p>
+ </li>
+
+ <li>
+ <p>Microsoft Visual C++ 6.0 (Visual Studio 97) ou supérieur.</p>
+
+ <p>Apache peut être compilé en utilisant l'outil ligne de
+ commande, ou depuis l'espace de travail IDE Visual Studio. Pour
+ la compilation depuis la ligne de commandes, l'environnement
+ doit comporter les variables <code>PATH</code>,
+ <code>INCLUDE</code>, <code>LIB</code>, ainsi que d'autres
+ variables qui peuvent être définies via le script
+ <code>vcvars32.bat</code> :</p>
+
+ <note>Vous pouvez vous procurer le paquet du Processeur Visual
+ Studio pour votre ancienne version de Visual Studio, ou une
+ version complète (et non Express) d'une édition plus récente de
+ Visual Studio pour l'assembleur ml.exe. Ceci vous permettra, si
+ vous le souhaitez, de compiler OpenSSL en utilisant une
+ implémentation du code d'assemblage plus efficace.</note>
+
+ <note>Seule la chaîne d'outils de compilation de Microsoft est
+ supportée de manière suivie par les contributeurs actifs à httpd.
+ Bien que le projet accepte régulièrement des correctifs pour
+ s'assurer que MinGW et d'autre outils de compilation
+ fonctionnent, ou même pour les améliorer, ils ne sont pas
+ maintenus de manière suivie et sont même souvent hors d'état
+ de fonctionner à certains stades du développement normal.</note>
+ </li>
+
+ <li>
+ <p>Le SDK de la plate-forme Windows mis à jour, février 2003 ou
+ plus récent.</p>
+
+ <p>Un SDK approprié pour la plate-forme Windows est inclus par
+ défaut dans les versions complètes (et non Express/lite) de
+ Visual C++ 7.1 (Visual Studio 2002) et supérieures ; les
+ utilisateurs peuvent ignorer ces étapes, à moins qu'ils aient
+ choisi d'utiliser une version plus récente ou différente du SDK.</p>
+
+ <p>Pour pouvoir utiliser Visual C++ 6.0 or 7.0 (Studio 2000
+ .NET), l'environnement du SDK de la plate-forme doit être préparé en utilisant le
+ script <code>setenv.bat</code> (installé par le SDK de la plate-forme) avant de
+ lancer la compilation en ligne de commande ou l'interface GUI
+ msdev/devenv. L'installation du SDK de la plate-forme pour les
+ versions Express de Visual Studio (2003 et supérieures) devrait
+ ajuster l'environnement par défaut de manière appropriée.</p>
+
+ <example>
+ "c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"<br />
+ "c:\Program Files\Platform SDK\setenv.bat"
+ </example>
+
+
+ </li>
+
+ <li>
+ <p>Perl et awk</p>
+
+ <p>De nombreuses étapes recommandées ici nécessitent un
+ interpréteur perl durant le processus de préparation de la
+ compilation.</p>
+
+ <p>Pour installer Apache à partir du système de compilation, de
+ nombreux fichiers sont modifiés via l'utilitaire
+ <code>awk.exe</code>. awk effectue la modification des fichiers
+ au moment de l'installation ; il a été choisi car il nécessite
+ un téléchargement de petite taille (par rapport à Perl ou
+ WSH/VB). Le site de Brian Kernighan <a
+ href="http://www.cs.princeton.edu/~bwk/btl.mirror/"
+ >http://www.cs.princeton.edu/~bwk/btl.mirror/</a> propose un
+ binaire précompilé pour Win32, <a
+ href="http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe"
+ >http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe</a>, que
+ vous devez enregistrer sous le nom <code>awk.exe</code> (plutôt
+ que <code>awk95.exe</code>).</p>
+
+ <note>Si awk.exe n'est pas trouvé, la cible install du fichier
+ Makefile.win n'effectuera aucune substitution dans les fichiers
+ .conf installés. Vous devrez alors modifier manuellement les fichiers
+ .conf installés afin de permettre au serveur de démarrer.
+ Recherchez et remplacez toutes les balises "@token@" par une
+ valeur appropriée.</note>
+
+ <note>L'IDE Visual Studio ne trouvera le chemin de
+ <code>awk.exe</code> que dans la variable PATH, ou dans le
+ chemin des exécutables spécifié par l'option de menu Tools ->
+ Options -> (Projects ->) Directories. Assurez-vous
+ qu'awk.exe est bien dans votre chemin système.</note>
+
+ <note>Notez aussi, si vous utilisez les outils Cygwin (<a
+ href="http://www.cygwin.com/">http://www.cygwin.com/</a>), que
+ l'utilitaire awk se nomme <code>gawk.exe</code> et que le
+ fichier <code>awk.exe</code> est en fait un lien symbolique vers
+ le fichier <code>gawk.exe</code>. Le shell de commandes Windows
+ ne reconnaît pas les liens symboliques, et par conséquent la
+ compilation d'InstallBin échouera. Pour contourner le problème,
+ vous pouvez supprimer le lien <code>awk.exe</code> de
+ l'installation de Cygwin, et copier <code>gawk.exe</code> vers
+ <code>awk.exe</code>. Notez aussi que les portages cygwin/mingw
+ de gawk 3.0.x étaient bogués ; veuillez par conséquent effectuer
+ une mise à jour vers la version 3.1.x avant l'utilisation de
+ tout portage de gawk.</note>
+ </li>
+
+ <li>
+ <p>[Optionnel] bibliothèque zlib (pour le module
+ <module>mod_deflate</module>)</p>
+
+ <p>Zlib doit être installée dans un sous-répertoire du
+ répertoire <code>srclib</code> et nommé <code>zlib</code>. Elle
+ doit être compilée directement à cette place. Zlib est
+ disponible à l'adresse <a
+ href="http://www.zlib.net/">http://www.zlib.net/</a> -- le
+ fonctionnement correct du module <module>mod_deflate</module> a
+ été vérifié avec la version 1.2.3.</p>
+
+ <example>
+ nmake -f win32\Makefile.msc<br />
+ nmake -f win32\Makefile.msc test
+ </example>
+ </li>
+
+ <li>
+ <p>[Optionnel] Bibliothèques OpenSSL (pour le module
+ <module>mod_ssl</module> et <code>ab.exe</code> avec le support
+ ssl)</p>
+
+ <note>La bibliothèque OpenSSL est un logiciel de chiffrement. Le
+ pays dans lequel vous résidez peut imposer des restrictions à
+ l'importation, la possession, l'utilisation, et/ou la
+ réexportation vers un autre pays des logiciels de chiffrement.
+ AVANT d'utiliser tout logiciel de chiffrement, veuillez
+ consulter la législation de votre pays, les règles et politiques
+ d'importation, de possession, ou d'utilisation, et de
+ réexportation des logiciels de chiffrement, afin de déterminer
+ si vous en avez le droit. Voir <a
+ href="http://www.wassenaar.org/">http://www.wassenaar.org/</a>
+ pour plus de détails.</note>
+
+ <p>La configuration et la compilation d'OpenSSL nécessite
+ l'installation de perl.</p>
+
+ <p>Pour compiler <module>mod_ssl</module> ou le projet
+ <code>abs.exe</code>, qui n'est autre que ab.c avec le support SSL
+ activé, vous devez télécharger OpenSSL à l'adresse <a
+ href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>,
+ et l'installer dans un sous-répertoire du répertoire
+ <code>srclib</code> que vous nommerez <code>openssl</code>. Afin
+ de préparer OpenSSL à la liaison avec le module Apache mod_ssl
+ ou abs.exe, et désactiver les fonctionnalités d'Openssl grévées
+ de brevets, vous pouvez utiliser la commande de compilation
+ suivante :</p>
+
+ <example>
+ perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32
+ -Ipath/to/srclib/zlib -Lpath/to/srclib/zlib<br />
+ ms\do_masm.bat<br />
+ nmake -f ms\ntdll.mak
+ </example>
+
+ <note>Il est déconseillé d'utiliser zlib-dynamic, car la charge
+ de la décompression des flux SSL est alors transférée à la
+ première requête qui doit charger la dll zlib. Notez que le
+ correctif proposé active le drapeau -L afin de
+ fonctionner avec les compilations Windows, corrige le nom de
+ zdll.lib et s'assure que les fichiers .pdb sont générés afin de
+ résoudre les problèmes. Si l'assembleur n'est pas
+ installé, vous devez ajouter no-asm ci-dessus et utiliser le
+ script ms\do_ms.bat à la place de ms\do_masm.bat.</note>
+ </li>
+
+ <li>
+ <p>[Optionnel] Bibliothèques de bases de données (pour
+<module>mod_dbd</module> et <module>mod_authn_dbm</module>)</p>
+
+ <p>La bibliothèque apr-util fournit un accès aux fonctionnalités
+ clients dbm (base de données à base de clés) et dbd (base de
+ données à base de requêtes) au serveur httpd et à certains de
+ ses modules, comme les modules d'authentification et
+ d'autorisation. Les fournisseurs sdbm dbm et odbc dbd sont
+ compilés automatiquement.</p>
+
+ <p>Le support dbd inclut le paquet instantclient Oracle, MySQL,
+ PostgreSQL et sqlite. Par exemple, pour les compiler tous,
+ définissez LIB de façon à inclure le chemin des bibliothèques,
+ INCLUDE de façon à inclure le chemin des en-têtes, et PATH de
+ façon à inclure le chemin des dll et bin de chacun des quatre
+ SDK, et définissez la variable d'environnement DBD_LIST de façon
+ à indiquer au processus de compilation quels SDKs pilotes
+ clients du sont correctement installés ; par exemple :</p>
+
+ <example>
+ set DBD_LIST=sqlite3 pgsql oracle mysql
+ </example>
+
+ <p>De manière similaire, le support dbm peut être étendu avec
+ DBM_LIST pour compiler un fournisseur Berkeley DB (db) et/ou un
+ fournisseur gdbm, en configurant tout d'abord de la même manière
+ LIB, INCLUDE et PATH afin de s'assurer que les bibliothèques et
+ en-têtes de la bibliothèque client sont bien disponibles.</p>
+
+ <example>
+ set DBM_LIST=db gdbm
+ </example>
+
+ <note>En fonction du choix des distributions de bases de
+ données, il peut s'avérer nécessaire de modifier le nom des
+ cibles de l'édition de liens (par exemple gdbm.lib à la place de
+ libgdb.lib) listées dans les fichiers .dsp/.mak des répertoires
+ srclib\apr-util\dbd ou ...\dbm correspondants.</note>
+
+ <p>Voir le fichier README-win32.txt pour plus d'informations à
+ propos de l'obtention des différents SDKs pilotes de bases de
+ données.</p>
+ </li>
+
+ </ul>
+
+ </section>
+
+ <section id="commandbuild">
+
+ <title>Compilation à partir de la ligne de commandes</title>
+
+ <p><code>Makefile.win</code> est le makefile principal ou racine
+ d'Apache. Pour compiler Apache sous Windows, utilisez simplement une
+ des commandes suivantes pour compiler la version
+ <code>release</code> ou <code>debug</code> :</p>
+
+ <example>
+ nmake /f Makefile.win _apacher<br /><br />
+ nmake /f Makefile.win _apached
+ </example>
+
+
+ <p>Ces deux commandes effectuent la compilation d'Apache. Cependant,
+ avec la deuxième, les fichiers résultants ne seront pas optimisés,
+ ce qui va faciliter l'examen pas à pas du code pour trouver des
+ bogues et résoudre les problèmes.</p>
+
+ <p>Vous pouvez indiquer vos choix en matière de fournisseurs dbd et
+ dbm à l'aide des variables (d'environnement) additionnelles de make
+ DBD_LIST et DBM_LIST ; voir les commentaires à propos des
+ [Optionnel] Bibliothèques de bases de données ci-dessus. Consultez
+ les commentaires initiaux dans Makefile.win pour plus d'options
+ pouvant être fournies lors de la compilation.</p>
+
+ </section>
+
+ <section id="workspacebuild">
+
+ <title>Compilation depuis l'espace de travail IDE de Developer
+ Studio</title>
+
+ <p>Apache peut aussi être compilé depuis l'environnement de
+ développement Visual Studio de VC++. Pour simplifier ce processus,
+ l'espace de travail Visual Studio <code>Apache.dsw</code> est
+ fourni. Cet espace de travail expose la liste complète des projets
+ <code>.dsp</code> actifs nécessaires à l'installation binaire
+ complète d'Apache. Il inclut les dépendances entre projets afin que
+ ces derniers soient compilés selon l'ordre approprié.</p>
+
+ <p>Ouvrez l'espace de travail <code>Apache.dsw</code>, et
+ sélectionnez <code>InstallBin</code> (compilation
+ <code>Release</code> ou <code>Debug</code>, selon vos souhaits)
+ comme Active Project. <code>InstallBin</code> provoque la
+ compilation de tous les projets concernés, puis invoque
+ <code>Makefile.win</code> pour installer les exécutables et dlls
+ compilés. Vous pouvez modifier la valeur de <code>INSTDIR=</code>
+ via la configuration de <code>InstallBin</code>, onglet Général,
+ entrée ligne de commandes de compilation. La valeur par défaut de
+ <code>INSTDIR</code> est le répertoire <code>/Apache2</code>. Si
+ vous désirez effectuer un test de compilation (sans installation),
+ sélectionnez le projet <code>BuildBin</code>.</p>
+
+ <p>Les fichiers projets <code>.dsp</code> sont distribués au format
+ Visual Studio 6.0 (98). Visual C++ 5.0 (97) les reconnaît. Les
+ utilisateurs de Visual Studio 2002 (.NET) et versions supérieures
+ doivent convertir <code>Apache.dsw</code> et les fichiers
+ <code>.dsp</code> en un projet <code>Apache.sln</code>, ainsi que
+ les fichiers <code>.msproj</code> ; assurez-vous de reconvertir le
+ fichier <code>.msproj</code> si l'un des fichiers source
+ <code>.dsp</code> est modifié ! Cette opération est vraiment très
+ simple, il suffit de réouvrir <code>Apache.dsw</code> dans l'IDE
+ VC++ 7.0 et de le reconvertir.</p>
+
+ <note>Il y a un problème au niveau de la conversion .vcproj des fichiers
+ .dsp. devenv.exe interprète mal le drapeau
+ /D pour les drapeaux RC contenant de longues /D'efines,
+ si ces dernières contiennent elles-mêmes des espaces. Ainsi, la
+ commande :
+ <example>
+ perl srclib\apr\build\cvtdsp.pl -2005
+ </example>
+ va convertir les drapeaux /D pour les drapeaux RC afin d'utiliser
+ une syntaxe alternative, interprétable ; malheureusement, cette
+ syntaxe n'est pas supportée par Visual Studio 97 ou ses fichiers
+ .mak exportés. Ces drapeaux /D transmettent la longue
+ description des fichiers de mod_apachemodule.so à leurs compilations
+ d'identificateur de version de ressource .rc partagée.</note>
+
+
+ <p>Les utilisateurs de Visual Studio 2002 (.NET) et versions
+ supérieures doivent aussi utiliser
+ la boîte de dialogue Configuration Manager du menu Build pour
+ décocher les deux versions <code>Debug</code> et
+ <code>Release</code> des modules <module>mod_ssl</module>
+ et <module>mod_deflate</module> pour <code>abs</code>. Ces modules
+ sont compilés
+ en invoquant <code>nmake</code> ou directement l'IDE avec la cible
+ <code>BinBuild</code> pour compiler ces modules de manière
+ conditionnelle si les sous-répertoires de <code>srclib</code>
+ <code>openssl</code> et/ou <code>zlib</code> existent, et en
+ fonction des définitions des variables d'environnement
+ <code>DBD_LIST</code> et <code>DBM_LIST</code>.</p>
+
+ </section>
+
+ <section id="exportingmakfiles">
+
+ <title>Export des fichiers .mak de la ligne de commandes</title>
+
+
+ <p>Les fichiers <code>.mak</code> exportés posent beaucoup de problèmes,
+ mais les utilisateurs de Visual C++ 5.0 en ont besoin pour compiler
+ <module>mod_ssl</module>, abs (<program>ab</program> avec support
+ SSL) et/ou <module>mod_deflate</module>. Les fichiers .mak
+ supportent aussi un choix plus large de distributions de chaînes
+ d'outils C++, comme Visual Studio Express.</p>
+
+ <p>Vous devez tout d'abord compiler tous les projets afin de créer
+ toutes les cibles dynamiques auto-générées, de façon à ce que les
+ dépendances puissent être interprétées correctement. Compilez
+ l'ensemble du projet depuis l'IDE Visual Studio 6.0 (98), en
+ utilisant la cible <code>BuildAll</code>, puis utilisez le menu de
+ projet Export pour tous les makefiles (en cochant "with
+ dependencies"). Utilisez la commande suivante pour transformer les
+ chemins absolus en chemins relatifs de façon à ce que la compilation
+ puisse s'effectuer depuis n'importe quelle position dans
+ l'arborescence :</p>
+
+ <example>
+ perl srclib\apr\build\fixwin32mak.pl
+ </example>
+
+ <p>Vous devez exécuter cette commande depuis la <em>racine</em> de
+ l'arborescence des sources de httpd. Tout fichier projet
+ <code>.mak</code> et <code>.dep</code> du répertoire courant et de
+ ses sous-répertoires sera corrigé, et les repères de temps ajustés
+ en fonction des <code>.dsp</code>.</p>
+
+ <p>Vérifiez toujours le SDK de la plate-forme ou autres chemins
+ fichiers locaux, spécifiques à la machine dans les fichiers
+ <code>.mak</code> et <code>.dep</code> générés. Le répertoire
+ <code>DevStudio\Common\MSDev98\bin\</code> (VC6) contient un fichier
+ <code>sysincl.dat</code> qui énumère toutes les exceptions. Mettez à
+ jour ce fichier (en particulier les chemins avec slashes et
+ anti-slashes, tels que <code>sys/time.h</code> et
+ <code>sys\time.h</code>) de façon à ignorer ces nouvelles
+ dépendances. Inclure les chemins d'installation locale dans un
+ fichier <code>.mak</code> distribué fera échouer la
+ compilation.</p>
+
+ <p>Si vous soumettez un patch qui modifie les fichiers projet, nous
+ devons valider la modification de ces fichiers projet au format
+ Visual Studio 6.0. Les modifications doivent êtres simples, avec un
+ minimum de drapeaux de compilation et d'édition de liens qui
+ pourront être reconnus par tous les environnements Visual
+ Studio.</p>
+
+ </section>
+
+ <section id="installation">
+
+
+ <title>Installation</title>
+
+ <p>Une fois compilé, Apache doit être installé dans le répertoire
+ racine du serveur. La valeur par défaut est le répertoire
+ <code>\Apache2</code>, sur le même disque.</p>
+
+ <p>Pour compiler et installer automatiquement tous les fichiers dans
+ le répertoire <em>rep</em> désiré, utilisez une des commandes
+ <code>nmake</code> suivantes :</p>
+
+ <example>
+ nmake /f Makefile.win installr INSTDIR=<em>dir</em><br />
+ nmake /f Makefile.win installd INSTDIR=<em>dir</em>
+ </example>
+
+ <p>L'argument <em>rep</em> de <code>INSTDIR</code> permet de
+ spécifier le répertoire d'installation ; il peut être omis si Apache
+ doit être installé dans <code>\Apache22</code> (du lecteur de disque
+ courant.</p>
+
+</section>
+
+<section id="projectcomponents-warn">
+
+<title>Avertissement à propos de la compilation d'Apache à partir de
+l'arborescence de développement</title>
+
+
+
+ </section>
+ <note>Notez que seuls les fichiers <code>.dsp</code> sont
+ maintenus d'une distribution <code>release</code> à l'autre. Les
+ fichiers <code>.mak</code> ne sont PAS régénérés, suite à
+ l'énorme perte de temps des relecteurs. Vous ne
+ pouvez donc pas utiliser les commandes <code>NMAKE</code>
+ ci-dessus pour compiler des fichiers de projet <code>.dsp</code>
+ révisés si vous n'exportez pas ensuite vous-même tous les
+ fichiers <code>.mak</code> du projet. Ceci n'est pas nécessaire
+ si vous effectuez la compilation depuis l'environnement
+ Microsoft Developer Studio.</note>
+</manualpage>
Modified: httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.meta?rev=1457571&r1=1457570&r2=1457571&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/win_compiling.xml.meta Sun Mar 17 22:04:31 2013
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ko</variant>
</variants>
</metafile>