-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1425939 -->
<modulesynopsis metafile="mod_xml2enc.xml.meta">
<name>mod_xml2enc</name>
-<description>Support avancé de l'internationalisation et des jeux de
-caractères pour les modules de filtrage basés sur libxml2</description>
+<description>Support avancé de l'internationalisation et des jeux de
+caractères pour les modules de filtrage basés sur libxml2</description>
<status>Base</status>
<sourcefile>mod_xml2enc.c</sourcefile>
<identifier>xml2enc_module</identifier>
Disponible en tant que module tiers dans les versions 2.2.x</compatibility>
<summary>
- <p>Ce module fournit un support avancé de l'internationalisation
+ <p>Ce module fournit un support avancé de l'internationalisation
pour les modules de filtrage supportant les balises (markup-aware)
- comme <module>mod_proxy_html</module>. Il est capable de détecter
- automatiquement l'encodage des données en entrée et de s'assurer
- qu'elle sont trait
ées correctement par l'interpréteur <a
+ comme <module>mod_proxy_html</module>. Il est capable de détecter
+ automatiquement l'encodage des données en entrée et de s'assurer
+ qu'elle sont trait
ées correctement par l'interpréteur <a
href="http://xmlsoft.org/">libxml2</a>, y compris la conversion en
- Unicode (UTF-8) si nécessaire. Il peut aussi convertir les données
- dans l'encodage de votre choix après le traitement des balises, et
- s'assurera que le <var>jeu de caractères</var> approprié sera défini
- dans l'en-tête HTTP <var>Content-Type</var>.</p>
+ Unicode (UTF-8) si nécessaire. Il peut aussi convertir les données
+ dans l'encodage de votre choix après le traitement des balises, et
+ s'assurera que le <var>jeu de caractères</var> approprié sera défini
+ dans l'en-tête HTTP <var>Content-Type</var>.</p>
</summary>
<section id="usage"><title>Utilisation</title>
- <p>Il existe deux scénarios d'utilisation : le cas des modules
- programmés pour travailler avec mod_xml2enc ; et les autres :</p>
+ <p>Il existe deux scénarios d'utilisation : le cas des modules
+ programmés pour travailler avec mod_xml2enc ; et les autres :</p>
<dl>
- <dt>Modules de filtrages programmés pour mod_xml2enc</dt><dd>
+ <dt>Modules de filtrages programmés pour mod_xml2enc</dt><dd>
<p>Les modules comme <module>mod_proxy_html</module> versions 3.1 et
- supérieures utilisent la fonction optionnelle
- <code>xml2enc_charset</code> pour déterminer la valeur de l'argument
- "jeu de caractères" à transmettre à l'interpréteur libxml2, et
+ supérieures utilisent la fonction optionnelle
+ <code>xml2enc_charset</code> pour déterminer la valeur de l'argument
+ "jeu de caractères" à transmettre à l'interpréteur libxml2, et
disposent de la fonction optionnelle <code>xml2enc_filter</code>
- pour effectuer un encodage ultérieur éventuel. L'utilisation de
- mod_xml2enc avec un module préprogrammé à cet effet ne nécessite
+ pour effectuer un encodage ultérieur éventuel. L'utilisation de
+ mod_xml2enc avec un module préprogrammé à cet effet ne nécessite
aucune configuration : ce dernier configurera mod_xml2enc pour vous
- (sachant que vous pouvez tout de même le personnaliser via les
+ (sachant que vous pouvez tout de même le personnaliser via les
directives de configuration ci-dessous).</p>
</dd>
- <dt>Modules de filtrages non programmés pour mod_xml2enc</dt><dd>
- <p>Pour utiliser mod_xml2enc avec un module basé sur libxml2 qui n'a
- pas été explicitement programmé pour mod_xml2enc, vous devrez
- configurer la chaîne de filtrage vous-même. Ainsi, pour utiliser
+ <dt>Modules de filtrages non programmés pour mod_xml2enc</dt><dd>
+ <p>Pour utiliser mod_xml2enc avec un module basé sur libxml2 qui n'a
+ pas été explicitement programmé pour mod_xml2enc, vous devrez
+ configurer la chaîne de filtrage vous-même. Ainsi, pour utiliser
mod_xml2enc avec un filtre <strong>foo</strong> fourni par un module
<strong>mod_foo</strong> et pour
- améliorer le support i18n de ce dernier avec HTML et XML, vous
+ améliorer le support i18n de ce dernier avec HTML et XML, vous
pouvez utiliser les directives suivantes :</p>
<pre><code>
FilterProvider iconv xml2enc Content-Type $text/html
FilterProvider markup foo Content-Type $xml
FilterChain iconv markup
</code></pre>
- <p><strong>mod_foo</strong> supportera alors tout jeu de caractère supporté soit par
+ <p><strong>mod_foo</strong> supportera alors tout jeu de caractère supporté soit par
libxml2, soit par apr_xlate/iconv, soit par les deux.</p>
</dd></dl>
</section>
<section id="api"><title>API de programmation</title>
- <p>Les programmeurs de modules de filtrage basés sur libxml2 sont
- encouragés à les préprogrammer pour mod_xml2enc, afin de fournir un
- support i18n solide aux utilisateurs sans avoir à réinventer la
- roue. L'API de programmation est décrite dans
+ <p>Les programmeurs de modules de filtrage basés sur libxml2 sont
+ encouragés à les préprogrammer pour mod_xml2enc, afin de fournir un
+ support i18n solide aux utilisateurs sans avoir à réinventer la
+ roue. L'API de programmation est décrite dans
<var>mod_xml2enc.h</var>, et <module>mod_proxy_html</module> est un
exemple de son utilisation.</p>
</section>
-<section id="sniffing"><title>Détection et encodage</title>
- <p>A la différence de <module>mod_charset_lite</module>, mod_xml2enc
- est conçu pour travailler avec des données dont l'encodage ne peut
- pas être connu, et donc configuré, à l'avance. Il utilise donc les
- techniques de 'reniflage' suivantes pour détecter le type d'encodage
- des données HTTP :</p>
+<section id="sniffing"><title>Détection et encodage</title>
+ <p>A la différence de <module>mod_charset_lite</module>, mod_xml2enc
+ est conçu pour travailler avec des données dont l'encodage ne peut
+ pas être connu, et donc configuré, à l'avance. Il utilise donc les
+ techniques de 'reniflage' suivantes pour détecter le type d'encodage
+ des données HTTP :</p>
<ol>
- <li>Si l'en-tête HTTP <var>Content-Type</var> contient un
- paramètre <var>charset</var>, c'est ce dernier qui sera utilisé.</li>
- <li>Si les données commancent par une balise XML concernant
- l'ordre des octets (BOM) ou par une déclaration d'encodage XML,
- c'est celle-ci qui sera utilisée.</li>
- <li>Si un type d'encodage est déclaré dans un élément HTML
- <code><META></code>, c'est ce dernier qui sera utilisé.</li>
- <li>Si aucun des éléments précédents n'est trouvé, c'est la
- valeur par défaut définie par la directive
- <directive>xml2EncDefault</directive> qui sera utilisée.</li>
+ <li>Si l'en-tête HTTP <var>Content-Type</var> contient un
+ paramètre <var>charset</var>, c'est ce dernier qui sera utilisé.</li>
+ <li>Si les données commancent par une balise XML concernant
+ l'ordre des octets (BOM) ou par une déclaration d'encodage XML,
+ c'est celle-ci qui sera utilisée.</li>
+ <li>Si un type d'encodage est déclaré dans un élément HTML
+ <code><META></code>, c'est ce dernier qui sera utilisé.</li>
+ <li>Si aucun des éléments précédents n'est trouvé, c'est la
+ valeur par défaut définie par la directive
+ <directive>xml2EncDefault</directive> qui sera utilisée.</li>
</ol>
- <p>Les conditions sont testées dans cet ordre . Dès qu'une règle
- s'applique, elle est utilisée et la détection est terminée.</p>
+ <p>Les conditions sont testées dans cet ordre . Dès qu'une règle
+ s'applique, elle est utilisée et la détection est terminée.</p>
</section>
<section id="output"><title>Codage en sortie</title>
<p><a href="http://xmlsoft.org/">libxml2</a> utilise toujours UTF-8
-(Unicode) en interne, et les modules de filtrage basés sur libxml2
-utiliseront cet encodage en sortie par défaut. mod_xml2enc peut modifier
+(Unicode) en interne, et les modules de filtrage basés sur libxml2
+utiliseront cet encodage en sortie par défaut. mod_xml2enc peut modifier
l'encodage en sortie via l'API, mais il n'y a actuellement aucun moyen de le
configurer directement.</p>
-<p>La modification de l'encodage en sortie ne devrait (du moins en théorie)
-jamais être nécessaire, et est même déconseillée à cause de la charge de
-traitement supplémentaire imposée au serveur par une conversion non
-nécessaire.</p>
+<p>La modification de l'encodage en sortie ne devrait (du moins en théorie)
+jamais être nécessaire, et est même déconseillée à cause de la charge de
+traitement supplémentaire imposée au serveur par une conversion non
+nécessaire.</p>
</section>
-<section id="alias"><title>Codages non supportés</title>
-<p>Si vous travaillez avec des encodages non supportés par aucune des
-méthodes de conversion disponibles sur votre plateforme, vous pouvez
-tout de même leur associer un alias vers un code supporté via la
+<section id="alias"><title>Codages non supportés</title>
+<p>Si vous travaillez avec des encodages non supportés par aucune des
+méthodes de conversion disponibles sur votre plateforme, vous pouvez
+tout de même leur associer un alias vers un code supporté via la
directive <directive>xml2EncAlias</directive>.</p>
</section>
<directivesynopsis>
<name>xml2EncDefault</name>
-<description>Définit un encodage par défaut à utiliser lorsqu'aucune
-information ne peut être <a href="#sniffing">automatiquement détectée</a></description>
+<description>Définit un encodage par défaut à utiliser lorsqu'aucune
+information ne peut être <a href="#sniffing">automatiquement détectée</a></description>
<syntax>xml2EncDefault <var>nom</var></syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<compatibility>Disponible depuis la version 2.4.0 du serveur HTTP Apache
-; disponible depuis un module tiers dans les versions antérieures.</compatibility>
+; disponible depuis un module tiers dans les versions antérieures.</compatibility>
<usage>
- <p>Si vous traitez des données dont l'encodage est connu, mais ne
- contenant aucune information à propos de ce dernier, vous pouvez
- définir une valeur par défaut afin d'aider mod_xml2enc à traiter
- correctement les données. Par exemple, pour définir la valeur par
- défaut Latin1 (<var>iso-8859-1</var> specifiée dans HTTP/1.0),
+ <p>Si vous traitez des données dont l'encodage est connu, mais ne
+ contenant aucune information à propos de ce dernier, vous pouvez
+ définir une valeur par défaut afin d'aider mod_xml2enc à traiter
+ correctement les données. Par exemple, pour définir la valeur par
+ défaut Latin1 (<var>iso-8859-1</var> specifiée dans HTTP/1.0),
utilisez :</p>
<highlight language="config">xml2EncDefault iso-8859-1</highlight>
</usage>
<directivesynopsis>
<name>xml2EncAlias</name>
-<description>Définit des alias pour les valeurs d'encodage</description>
-<syntax>xml2EncAlias <var>jeu-de-caractères alias [alias ...]</var></syntax>
+<description>Définit des alias pour les valeurs d'encodage</description>
+<syntax>xml2EncAlias <var>jeu-de-caractères alias [alias ...]</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
- <p>Cette directive de niveau serveur permet de définir un ou
+ <p>Cette directive de niveau serveur permet de définir un ou
plusieurs alias pour un encodage. Elle permet au support d'encodage de
libxml2 de traiter en interne des encodages non reconnus par libxml2
en utilisant la table de conversion pour un encodage reconnu. Elle
permet d'atteindre deux objectifs : supporter des jeux (ou noms) de
- caractères non reconnus par libxml2 ou iconv, et éviter une
- conversion pour un encodage lorsque cela n'est pas nécessaire.</p>
+ caractères non reconnus par libxml2 ou iconv, et éviter une
+ conversion pour un encodage lorsque cela n'est pas nécessaire.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>xml2StartParse</name>
-<description>Indique à l'interpréteur à partir de quelle balise il doit
+<description>Indique à l'interpréteur à partir de quelle balise il doit
commencer son traitement.</description>
-<syntax>xml2StartParse <var>élément [élément ...]</var></syntax>
+<syntax>xml2StartParse <var>élément [élément ...]</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<usage>
- <p>Cette directive permet de spécifier à partir de quelle balise,
- parmi les éléments spécifiés, l'interpréteur de balise doit
- commencer son traitement. Ccei permet de contourner le problème des
- serveurs d'arrière-plan qui insèrent des éléments non conformes en
- d
ébut de données, ce qui a pour effet de perturber l'interpréteur (<a
+ <p>Cette directive permet de spécifier à partir de quelle balise,
+ parmi les éléments spécifiés, l'interpréteur de balise doit
+ commencer son traitement. Ccei permet de contourner le problème des
+ serveurs d'arrière-plan qui insèrent des éléments non conformes en
+ d
ébut de données, ce qui a pour effet de perturber l'interpréteur (<a
href="http://bahumbug.wordpress.com/2006/10/12/mod_proxy_html-revisited/"
>voir un exemple ici</a>).</p>
- <p>Elle ne doit être utilisée ni pour les documents XML, ni pour les
- documents HTML correctement formatés.</p>
+ <p>Elle ne doit être utilisée ni pour les documents XML, ni pour les
+ documents HTML correctement formatés.</p>
</usage>
</directivesynopsis>
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 420990 -->
<manualpage metafile="module-dict.xml.meta">
- <title>Termes utilisés pour décrire les modules</title>
+ <title>Termes utilisés pour décrire les modules</title>
<summary>
- <p>Ce document d
écrit les termes utilisés pour décrire chaque <a
+ <p>Ce document d
écrit les termes utilisés pour décrire chaque <a
href="./">module</a> Apache.</p>
</summary>
<section id="Description"><title>Description</title>
-<p>Une brève description des fonctions du module.</p>
+<p>Une brève description des fonctions du module.</p>
</section>
<section id="Status"><title>Statut</title>
- <p>Ce terme indique le degré de rapprochement du module par rapport
+ <p>Ce terme indique le degré de rapprochement du module par rapport
au coeur du serveur web Apache ; en d'autres termes, vous pouvez
- être amené à recompiler le serveur pour pouvoir accéder au module et
- à ses fonctionnalités. Les valeurs possibles de cet attribut sont
+ être amené à recompiler le serveur pour pouvoir accéder au module et
+ à ses fonctionnalités. Les valeurs possibles de cet attribut sont
:</p>
<dl>
<dt>MPM</dt>
<dd>Un module dont le statut est "MPM" est un <a
- href="../mpm.html">module Multi-Processus</a>. A la différence des
- autres modules, un seul module MPM peut et doit être utilisé par Apache à
- la fois. Ce type de module est responsable de la répartition et du
- traitement de base des requêtes.</dd>
+ href="../mpm.html">module Multi-Processus</a>. A la différence des
+ autres modules, un seul module MPM peut et doit être utilisé par Apache à
+ la fois. Ce type de module est responsable de la répartition et du
+ traitement de base des requêtes.</dd>
<dt>Base</dt>
- <dd>Un module dont le statut est "Base" est compilé dans le
- serveur et chargé avec ce dernier par défaut ; il est donc
- toujours disponible à moins que vous n'ayez fait en sorte de
+ <dd>Un module dont le statut est "Base" est compilé dans le
+ serveur et chargé avec ce dernier par défaut ; il est donc
+ toujours disponible à moins que vous n'ayez fait en sorte de
supprimer le module de votre configuration.</dd>
<dt>Extension</dt>
- <dd>Un module dont le statut est "Extension" n'est pas compilé et
- chargé dans le serveur par défaut. Pour activer le module et
- accéder à ses fonctionnalités, vous devez modifier la
+ <dd>Un module dont le statut est "Extension" n'est pas compilé et
+ chargé dans le serveur par défaut. Pour activer le module et
+ accéder à ses fonctionnalités, vous devez modifier la
configuration de la compilation du serveur et recompiler
Apache.</dd>
- <dt>Expérimental</dt>
+ <dt>Expérimental</dt>
<dd>Le statut "Experimental" indique que le module fait partie du
- kit Apache, mais que vous devez l'utiliser à vos risques et
- périls. Le module est documenté à des fins d'exhaustivité, et
- n'est pas obligatoirement supporté.</dd>
+ kit Apache, mais que vous devez l'utiliser à vos risques et
+ périls. Le module est documenté à des fins d'exhaustivité, et
+ n'est pas obligatoirement supporté.</dd>
<dt>Externe</dt>
<section id="SourceFile"><title>Fichier source</title>
<p>Il s'agit tout simplement de la liste des noms des fichiers
- source qui contiennent le code du module. C'est aussi le nom utilisé
+ source qui contiennent le code du module. C'est aussi le nom utilisé
par la directive <directive module="core"
type="section">IfModule</directive>.</p>
</section>
<section id="ModuleIdentifier"><title>Identificateur de module</title>
- <p>C'est une chaîne permettant d'identifier le module à utiliser
+ <p>C'est une chaîne permettant d'identifier le module à utiliser
dans la directive <directive module="mod_so">LoadModule</directive>
pour le chargement dynamique des modules. En particulier, c'est le
nom de la variable externe de type module dans le fichier
source.</p>
</section>
-<section id="Compatibility"><title>Compatibilité</title>
+<section id="Compatibility"><title>Compatibilité</title>
<p>Si le module ne faisait pas partie de la distribution originale
- d'Apache version 2, la version à partir de laquelle il est
- disponible est indiquée ici. En outre, si le module n'est disponible
- que sur certaines plates-formes, cela sera mentionné ici.</p>
+ d'Apache version 2, la version à partir de laquelle il est
+ disponible est indiquée ici. En outre, si le module n'est disponible
+ que sur certaines plates-formes, cela sera mentionné ici.</p>
</section>
</manualpage>
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1220529 -->
+<!-- English Revision : 1329361 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<manualpage metafile="index.xml.meta">
<parentdocument href="../"/>
- <title>Notes spécifiques aux différentes plateformes.</title>
+ <title>Notes spécifiques aux différentes plateformes.</title>
<section id="win">
<dt>Utilisation d'Apache</dt>
<dd>
<p>Ce document explique comment installer, configurer et
- exécuter Apache 2.4 sous Microsoft Windows.</p>
+ exécuter Apache 2.4 sous Microsoft Windows.</p>
<p>Voir : <a href="windows.html">Utilisation d'Apache avec Microsoft Windows</a></p>
</dd>
<dl>
<dt>Compilation d'Apache</dt>
<dd>
- <p>Il y a de nombreux points importants à connaître avant de se
+ <p>Il y a de nombreux points importants à connaître avant de se
lancer dans la compilation d'Apache. Ce document en donne la
description.</p>
<section id="unix">
- <title>Systèmes de type Unix</title>
+ <title>Systèmes de type Unix</title>
<dl>
- <dt>Systèmes à base de paquets RPM (Redhat / CentOS / Fedora)</dt>
+ <dt>Systèmes à base de paquets RPM (Redhat / CentOS / Fedora)</dt>
<dd>
<p>Ce document explique comment installer, configurer et
- exécuter Apache 2.4 sur des systèmes qui supportent le format de
+ exécuter Apache 2.4 sur des systèmes qui supportent le format de
paquet RPM.</p>
<p>Voir : <a href="rpm.html">Utilisation d'Apache avec les
- systèmes à base de paquets RPM</a></p>
+ systèmes à base de paquets RPM</a></p>
</dd>
</dl>
<dt>Novell NetWare</dt>
<dd>
<p>Ce document explique comment installer, configurer et
- exécuter Apache 2.4 sous Novell NetWare versions 5.1 et
- supérieures.</p>
+ exécuter Apache 2.4 sous Novell NetWare versions 5.1 et
+ supérieures.</p>
<p>Voir : <a href="netware.html">Utilisation d'Apache avec Novell NetWare</a></p>
</dd>
<dl>
<dt>EBCDIC</dt>
<dd>
- <p>La version 1.3 du serveur HTTP Apache est la première à
- avoir été portée vers une machine de type mainframe (non-ASCII)
- qui utilisait le jeu de caractères EBCDIC comme jeu de
- caractères natif.</p>
+ <p>La version 1.3 du serveur HTTP Apache est la première à
+ avoir été portée vers une machine de type mainframe (non-ASCII)
+ qui utilisait le jeu de caractères EBCDIC comme jeu de
+ caractères natif.</p>
<note type="warning"><strong>Avertissement :</strong>Ce document
- n'a pas fait l'objet d'une mise à jour pour intégrer les
- modifications intervenues à partir de la version 2.4 du serveur
+ n'a pas fait l'objet d'une mise à jour pour intégrer les
+ modifications intervenues à partir de la version 2.4 du serveur
HTTP Apache. Certaines des informations qu'il contient sont
- toujours pertinentes, mais il est conseillé de les utiliser avec
+ toujours pertinentes, mais il est conseillé de les utiliser avec
prudence.</note>
<p>Voir : <a href="ebcdic.html">Le portage d'Apache vers EBCDIC</a></p>
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1562488 -->
-->
<manualpage metafile="netware.xml.meta">
- <parentdocument href="./">Notes spécifiques à un système</parentdocument>
+ <parentdocument href="./">Notes spécifiques à un système</parentdocument>
<title>Utilisation d'Apache avec Novell NetWare</title>
<p>Ce document explique l'installation, la configuration et le
lancement d'Apache 2.0 sous Novell NetWare 6.0 et les versions
- ultérieures. Si vous trouvez une bogue, ou voulez tout simplement
- contribuer de quelque manière que ce soit, utilisez s'il vous plait
+ ultérieures. Si vous trouvez une bogue, ou voulez tout simplement
+ contribuer de quelque manière que ce soit, utilisez s'il vous plait
notre <a href="http://httpd.apache.org/bug_report.html">page des
rapports de bogues.</a></p>
<p>La page des rapports de bogues et la liste de diffusion dev-httpd
- ne doivent pas être utilisées pour poser des questions à propos de
+ ne doivent pas être utilisées pour poser des questions à propos de
la configuration ou du lancement d'Apache. Avant de soumettre un
rapport de bogue ou une question, consultez ce document, la <a
href="http://wiki.apache.org/httpd/FAQ">FAQ</a> ou tout autre sujet de la
- documentation en rapport avec votre problème. Si vous n'avez
- toujours pas résolu votre problème, postez votre question dans le
+ documentation en rapport avec votre problème. Si vous n'avez
+ toujours pas résolu votre problème, postez votre question dans le
newsgroup <a
href="news://developer-forums.novell.com/novell.devsup.webserver">
- novell.devsup.webserver</a>, où de nombreux utilisateurs d'Apache
- sont prêts à répondre à toutes les nouvelles et obscures questions à
+ novell.devsup.webserver</a>, où de nombreux utilisateurs d'Apache
+ sont prêts à répondre à toutes les nouvelles et obscures questions à
propos de l'utilisation d'Apache sous Netware.</p>
- <p>Dans la majeure partie de ce document, vous êtes sensé avoir
- installé Apache à partir d'une distribution binaire. Si vous voulez
- compiler Apache vous-même (par exemple pour aider au développement,
- ou pour rechercher des bogues), reportez-vous à la section traitant
+ <p>Dans la majeure partie de ce document, vous êtes sensé avoir
+ installé Apache à partir d'une distribution binaire. Si vous voulez
+ compiler Apache vous-même (par exemple pour aider au développement,
+ ou pour rechercher des bogues), reportez-vous à la section traitant
de la <a href="#comp">Compilation d'Apache pour Netware</a>
ci-dessous.</p>
<section id="req">
- <title>Prérequis</title>
+ <title>Prérequis</title>
- <p>Apache 2.0 nécessite NetWare 6.0 service pack 3 et supérieurs
- pour fonctionner. Si vous utilisez un service pack antérieur à SP3,
- vous devez installer les derni
ères <a
- href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
+ <p>Apache 2.0 nécessite NetWare 6.0 service pack 3 et supérieurs
+ pour fonctionner. Si vous utilisez un service pack antérieur à SP3,
+ vous devez installer les derni
ères <a
+ href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
Netware pour C (LibC)</a>.</p>
<p>Vous trouverez les service packs Netware <a
href="http://support.novell.com/misc/patlst.htm#nw">ici</a>.</p>
<p>Apache 2.0 pour NetWare peut aussi fonctionner dans un
- environnement NetWare 5.1, à partir du moment où le dernier service
- pack ou la derni
ère version des <a
- href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
- Netware pour C (LibC)</a> ont été installés. <strong>ATTENTION
- :</strong> Apache 2.0 pour NetWare n'a pas été testé dans cet
- environnement car il n'a pas été conçu pour ce dernier.</p>
+ environnement NetWare 5.1, à partir du moment où le dernier service
+ pack ou la derni
ère version des <a
+ href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
+ Netware pour C (LibC)</a> ont été installés. <strong>ATTENTION
+ :</strong> Apache 2.0 pour NetWare n'a pas été testé dans cet
+ environnement car il n'a pas été conçu pour ce dernier.</p>
</section>
<section id="down">
- <title>Téléchargement d'Apache pour NetWare</title>
+ <title>Téléchargement d'Apache pour NetWare</title>
- <p>Les informations à propos de la dernière version
- d'Apache sont disponibles sur le site web d'Apache
à <a
+ <p>Les informations à propos de la dernière version
+ d'Apache sont disponibles sur le site web d'Apache
à <a
href="http://www.apache.org/">http://www.apache.org/</a>. Vous y
- trouverez la version courante, des versions alpha ou bêta-test plus
- récentes, ainsi que des sites miroirs et des sites FTP anonymes. Les
- distributions binaires des dernières versions d'Apache 2.0 pour
+ trouverez la version courante, des versions alpha ou bêta-test plus
+ récentes, ainsi que des sites miroirs et des sites FTP anonymes. Les
+ distributions binaires des dernières versions d'Apache 2.0 pour
NetWare sont disponibles <a
href="http://www.apache.org/dist/httpd/binaries/netware">ici</a>.</p>
<title>Installation d'Apache pour NetWare</title>
<p>Il n'existe pas actuellement de programme d'installation d'Apache
- pour Netware. Si vous installez Apache 2.0 pour NetWare à partir des
+ pour Netware. Si vous installez Apache 2.0 pour NetWare à partir des
sources, vous devrez copier les fichiers sur le serveur
manuellement.</p>
- <p>Suivez ces instructions pour installer Apache sous Netware à
+ <p>Suivez ces instructions pour installer Apache sous Netware à
partir de la distribution binaire (en supposant que vous effectuez
l'installation dans <code>sys:/apache2</code>) :</p>
<ul>
- <li>Décompressez le fichier binaire téléchargé à la racine du
+ <li>Décompressez le fichier binaire téléchargé à la racine du
volume <code>SYS:</code> (vous pouvez cependant l'installer dans
tout volume)</li>
- <li>Editez le fichier <code>httpd.conf</code> et définissez les
+ <li>Editez le fichier <code>httpd.conf</code> et définissez les
directives <directive module="core">ServerRoot</directive> et
<directive module="core">ServerName</directive> avec les valeurs
- correctes des chemins de fichiers qui correspondent à la
+ correctes des chemins de fichiers qui correspondent à la
configuration de votre serveur.</li>
<li>Ajoutez <code>SYS:/APACHE2</code> au chemin de recherche, par
</ul>
<p>Suivez ces instructions pour installer Apache pour Netware
- manuellement à partir de votre propre répertoire de sources (en
+ manuellement à partir de votre propre répertoire de sources (en
supposant que vous effectuez l'installation dans
<code>sys:/apache2</code>) :</p>
<ul>
- <li>Créez un répertoire que vous appellerez <code>Apache2</code>
+ <li>Créez un répertoire que vous appellerez <code>Apache2</code>
dans un volume Netware.</li>
<li>Copiez <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code> dans
<code>SYS:/APACHE2</code>.</li>
- <li>Créez un répertoire que vous appellerez <code>BIN</code> dans
+ <li>Créez un répertoire que vous appellerez <code>BIN</code> dans
<code>SYS:/APACHE2</code>.</li>
<li>Copiez <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>,
<code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>,
<code>ROTLOGS.NLM</code> dans <code>SYS:/APACHE2/BIN</code>.</li>
- <li>Créez un répertoire que vous appellerez <code>CONF</code> dans
+ <li>Créez un répertoire que vous appellerez <code>CONF</code> dans
<code>SYS:/APACHE2</code>.</li>
<li>Copiez le fichier <code>HTTPD-STD.CONF</code> dans le
- répertoire <code>SYS:/APACHE2/CONF</code> et renommez-le en
+ répertoire <code>SYS:/APACHE2/CONF</code> et renommez-le en
<code>HTTPD.CONF</code>.</li>
<li>Copiez les fichiers <code>MIME.TYPES</code>,
- <code>CHARSET.CONV</code> et <code>MAGIC</code> dans le répertoire
+ <code>CHARSET.CONV</code> et <code>MAGIC</code> dans le répertoire
<code>SYS:/APACHE2/CONF</code>.</li>
- <li>Copiez tous les fichiers et sous-répertoires de
+ <li>Copiez tous les fichiers et sous-répertoires de
<code>\HTTPD-2.0\DOCS\ICONS</code> dans
<code>SYS:/APACHE2/ICONS</code>.</li>
- <li>Copiez tous les fichiers et sous-répertoires de
+ <li>Copiez tous les fichiers et sous-répertoires de
<code>\HTTPD-2.0\DOCS\MANUAL</code> dans
<code>SYS:/APACHE2/MANUAL</code>.</li>
- <li>Copiez tous les fichiers et sous-répertoires de
+ <li>Copiez tous les fichiers et sous-répertoires de
<code>\HTTPD-2.0\DOCS\ERROR</code> dans
<code>SYS:/APACHE2/ERROR</code>.</li>
- <li>Copiez tous les fichiers et sous-répertoires de
+ <li>Copiez tous les fichiers et sous-répertoires de
<code>\HTTPD-2.0\DOCS\DOCROOT</code> dans
<code>SYS:/APACHE2/HTDOCS</code>.</li>
- <li>Créez le répertoire <code>SYS:/APACHE2/LOGS</code> sur le
+ <li>Créez le répertoire <code>SYS:/APACHE2/LOGS</code> sur le
serveur.</li>
- <li>Créez le répertoire <code>SYS:/APACHE2/CGI-BIN</code> sur le
+ <li>Créez le répertoire <code>SYS:/APACHE2/CGI-BIN</code> sur le
serveur.</li>
- <li>Créez le répertoire <code>SYS:/APACHE2/MODULES</code> et
- copiez tous les modules nlm dans le répertoire
+ <li>Créez le répertoire <code>SYS:/APACHE2/MODULES</code> et
+ copiez tous les modules nlm dans le répertoire
<code>modules</code>.</li>
<li>Editez le fichier <code>HTTPD.CONF</code>, et recherchez
toutes les marques <code>@@Value@@</code> afin de les remplacer
- par les valeurs appropriées.</li>
+ par les valeurs appropriées.</li>
<li>Ajoutez <code>SYS:/APACHE2</code> au chemin de recherche, par
une commande du style : <example>SEARCH ADD
SYS:\APACHE2</example>.</li>
</ul>
- <p>Outre le volume par défaut <code>SYS</code>, Apache peut être
- installé dans tout autre volume.</p>
+ <p>Outre le volume par défaut <code>SYS</code>, Apache peut être
+ installé dans tout autre volume.</p>
- <p>Au cours du processus d'installation, l'ajout du mot-clé
- "install" à la ligne de commande du makefile va provoquer la
- construction d'une distribution complète sous forme d'un paquetage
- dans le sous-répertoire <code>DIST</code>. Vous pouvez simplement
- installer Apache en copiant la distribution créée précédemment à la
+ <p>Au cours du processus d'installation, l'ajout du mot-clé
+ "install" à la ligne de commande du makefile va provoquer la
+ construction d'une distribution complète sous forme d'un paquetage
+ dans le sous-répertoire <code>DIST</code>. Vous pouvez simplement
+ installer Apache en copiant la distribution créée précédemment à la
racine d'un volume Netware (voir <a href="#comp">Compilation
d'Apache pour NetWare</a> ci-dessous).</p>
<section id="run">
- <title>Exécuter Apache pour NetWare</title>
+ <title>Exécuter Apache pour NetWare</title>
- <p>Pour démarrer Apache, tapez simplement <code>apache</code> dans
+ <p>Pour démarrer Apache, tapez simplement <code>apache</code> dans
la console. Ceci aura pour effet de charger Apache dans l'espace
- d'adressage du système d'exploitation. Si vous préférez charger
- Apache dans un espace d'adressage protégé, vous pouvez spécifier cet
- espace d'adressage à l'aide de l'instruction de chargement suivante
+ d'adressage du système d'exploitation. Si vous préférez charger
+ Apache dans un espace d'adressage protégé, vous pouvez spécifier cet
+ espace d'adressage à l'aide de l'instruction de chargement suivante
:</p>
<example>
</example>
<p>Cette instruction va charger Apache dans un espace d'adressage
- appelé apache2. Il est possible d'exécuter plusieurs instances
- simultanées d'Apache sous Netware, en chargeant chacune d'entre
- elles dans son propre espace d'adressage protégé.</p>
+ appelé apache2. Il est possible d'exécuter plusieurs instances
+ simultanées d'Apache sous Netware, en chargeant chacune d'entre
+ elles dans son propre espace d'adressage protégé.</p>
- <p>Une fois démarré, Apache écoute le port 80 (à moins que vous
- n'ayez modifié la directive <directive
+ <p>Une fois démarré, Apache écoute le port 80 (à moins que vous
+ n'ayez modifié la directive <directive
module="mpm_common">Listen</directive> dans les fichiers de
configuration). Pour vous connecter au serveur et afficher la page
- par défaut, lancez un navigateur et entrez le nom du serveur ou son
+ par défaut, lancez un navigateur et entrez le nom du serveur ou son
adresse IP. Vous devriez voir une page de bienvenue, et un lien vers
le manuel Apache. Si rien ne se produit, ou si vous obtenez un
message d'erreur, consultez le fichier <code>error_log</code> dans
- le répertoire <code>logs</code>.</p>
+ le répertoire <code>logs</code>.</p>
<p>Lorsque votre installation de base fonctionne, vous devez la
- configurer correctement en éditant les fichiers du répertoire
+ configurer correctement en éditant les fichiers du répertoire
<code>conf</code>.</p>
- <p>Pour arrêter une instance d'Apache s'exécutant dans l'espace
- d'adressage du système d'exploitation, entrez simplement dans la
+ <p>Pour arrêter une instance d'Apache s'exécutant dans l'espace
+ d'adressage du système d'exploitation, entrez simplement dans la
console :</p>
<example>
apache2 shutdown
</example>
- <p>Si Apache s'exécute dans un espace d'adressage protégé, spécifiez
- cet espace d'adressage dans l'instruction d'arrêt :</p>
+ <p>Si Apache s'exécute dans un espace d'adressage protégé, spécifiez
+ cet espace d'adressage dans l'instruction d'arrêt :</p>
<example>
unload address space = apache2 apache2
<p>Lorsqu'on travaille avec Apache, il est important de savoir
comment il trouve ses fichiers de configuration. Vous pouvez
- spécifier un fichier de configuration sur la ligne de commande de
- deux manières :</p>
+ spécifier un fichier de configuration sur la ligne de commande de
+ deux manières :</p>
<ul>
- <li><code>-f</code> spécifie un chemin vers un fichier de
+ <li><code>-f</code> spécifie un chemin vers un fichier de
configuration particulier</li>
</ul>
</example>
<p>Dans ces cas, la directive <directive
- module="core">ServerRoot</directive> doit être correctement définie
+ module="core">ServerRoot</directive> doit être correctement définie
dans le fichier de configuration.</p>
- <p>Si vous ne spécifiez pas de nom de fichier de configuration avec
- l'option <code>-f</code>, Apache utilisera le nom de fichier codé en
- dur dans le serveur, en général <code>conf/httpd.conf</code>.
+ <p>Si vous ne spécifiez pas de nom de fichier de configuration avec
+ l'option <code>-f</code>, Apache utilisera le nom de fichier codé en
+ dur dans le serveur, en général <code>conf/httpd.conf</code>.
L'invocation d'Apache avec l'option <code>-V</code> indiquera ce nom
- comme valeur de l'étiquette <code>SERVER_CONFIG_FILE</code>. Apache
- va ensuite déterminer son <directive
+ comme valeur de l'étiquette <code>SERVER_CONFIG_FILE</code>. Apache
+ va ensuite déterminer son <directive
module="core">ServerRoot</directive> en effectuant les tests
suivants, dans cet ordre </p>
<li>L'option de ligne de commande <code>-d</code>.</li>
- <li>Le contenu du répertoire courant.</li>
+ <li>Le contenu du répertoire courant.</li>
- <li>La racine du répertoire d'installation codée en dur dans le
+ <li>La racine du répertoire d'installation codée en dur dans le
serveur.</li>
</ul>
- <p>La racine du répertoire d'installation codée en dur dans le
- serveur est en général <code>sys:/apache2</code>. L'invocation
+ <p>La racine du répertoire d'installation codée en dur dans le
+ serveur est en général <code>sys:/apache2</code>. L'invocation
d'Apache avec l'option <code>-V</code> indiquera ce chemin comme
- valeur de l'étiquette <code>HTTPD_ROOT</code>.</p>
+ valeur de l'étiquette <code>HTTPD_ROOT</code>.</p>
<p>Apache 2.0 pour Netware comporte un jeu d'options de ligne de
commande permettant d'afficher ou de modifier certaines
- caractéristiques de l'instance du serveur web en cours d'exécution.
+ caractéristiques de l'instance du serveur web en cours d'exécution.
Ces options ne sont disponibles que lorsqu'Apache est en cours
- d'exécution. Chacune de ces options doit être précédée du mot-clé
+ d'exécution. Chacune de ces options doit être précédée du mot-clé
<code>APACHE2</code>.</p>
<dl>
<dt>RESTART</dt>
- <dd>Demande à Apache d'arrêter tout worker thread en cours
- d'exécution lorsqu'il devient inactif, de recharger le fichier de
- configuration, et de redémarrer chaque worker thread en fonction
+ <dd>Demande à Apache d'arrêter tout worker thread en cours
+ d'exécution lorsqu'il devient inactif, de recharger le fichier de
+ configuration, et de redémarrer chaque worker thread en fonction
de la nouvelle configuration.</dd>
<dt>VERSION</dt>
- <dd>Affiche des informations à propos de la version de l'instance
- d'Apache en cours d'exécution.</dd>
+ <dd>Affiche des informations à propos de la version de l'instance
+ d'Apache en cours d'exécution.</dd>
<dt>MODULES</dt>
- <dd>Affiche la liste des modules chargés (intégrés et
+ <dd>Affiche la liste des modules chargés (intégrés et
externes). </dd>
<dt>DIRECTIVES</dt>
<dd>Affiche la liste des directives disponibles.</dd>
<dt>SETTINGS</dt>
- <dd>Active ou désactive l'affichage du statut des threads sur la
- console. En cas d'activation, l'état de chaque thread en cours
- d'exécution s'affiche sur l'écran de la console Apache.</dd>
+ <dd>Active ou désactive l'affichage du statut des threads sur la
+ console. En cas d'activation, l'état de chaque thread en cours
+ d'exécution s'affiche sur l'écran de la console Apache.</dd>
<dt>SHUTDOWN</dt>
- <dd>Arrête l'instance du serveur web Apache en cours
- d'exécution.</dd>
+ <dd>Arrête l'instance du serveur web Apache en cours
+ d'exécution.</dd>
<dt>HELP</dt>
- <dd>Décrit chacune des options disponibles au cours de l'exécution
+ <dd>Décrit chacune des options disponibles au cours de l'exécution
d'Apache.</dd>
</dl>
- <p>Par défaut, ces options sont passées à l'instance d'apache
- s'exécutant dans l'espace d'adressage du système d'exploitation.
- Pour passer une option à une instance d'Apache spécifique
- s'exécutant dans un espace d'adressage protégé, ajouter le paramètre
+ <p>Par défaut, ces options sont passées à l'instance d'apache
+ s'exécutant dans l'espace d'adressage du système d'exploitation.
+ Pour passer une option à une instance d'Apache spécifique
+ s'exécutant dans un espace d'adressage protégé, ajouter le paramètre
-p suivi du nom de l'espace d'adressage. Pour plus d'informations,
tapez "apache2 Help" sur la ligne de commande.</p>
<title>Configuration d'Apache pour NetWare</title>
- <p>Apache lit en général ses fichiers de configuration dans le
- répertoire <code>conf</code>. Ces fichiers sont les mêmes que ceux
- de la version Unix, mais quelques directives sont différentes sous
+ <p>Apache lit en général ses fichiers de configuration dans le
+ répertoire <code>conf</code>. Ces fichiers sont les mêmes que ceux
+ de la version Unix, mais quelques directives sont différentes sous
Netware. Voir la <a href="../mod/">Documentation Apache</a> pour
l'ensemble des directives disponibles.</p>
- <p>Les principales différences propres à Apache pour NetWare sont
+ <p>Les principales différences propres à Apache pour NetWare sont
: </p>
<ul>
<li>
<p>Comme Apache pour Netware est une application multithread,
- elle n'utilise pas de processus séparé pour chaque requête,
- comme c'est le cas pour certaines implémentations sous Unix. Il
- n'y a que des threads en cours d'exécution : un thread parent,
+ elle n'utilise pas de processus séparé pour chaque requête,
+ comme c'est le cas pour certaines implémentations sous Unix. Il
+ n'y a que des threads en cours d'exécution : un thread parent,
et plusieurs threads enfants ou worker qui traitent les
- requêtes.</p>
+ requêtes.</p>
- <p>En conséquence, les directives de gestion des "processus"
- sont différentes :</p>
+ <p>En conséquence, les directives de gestion des "processus"
+ sont différentes :</p>
<p><directive
module="mpm_common">MaxConnectionsPerChild</directive> - comme sous
- Unix, cette directive contrôle le nombre maximum de connexions
- qu'un worker thread peut traiter avant de s'arrêter. Avec la
- valeur par défaut <code>MaxConnectionsPerChild 0</code>,
- le thread va pouvoir traiter un nombre illimité de requêtes.
- Cette valeur est recommandée sous Netware, à moins que vous
- n'ayez des raisons particulières de la modifier.</p>
+ Unix, cette directive contrôle le nombre maximum de connexions
+ qu'un worker thread peut traiter avant de s'arrêter. Avec la
+ valeur par défaut <code>MaxConnectionsPerChild 0</code>,
+ le thread va pouvoir traiter un nombre illimité de requêtes.
+ Cette valeur est recommandée sous Netware, à moins que vous
+ n'ayez des raisons particulières de la modifier.</p>
<p><directive module="mpm_common">StartThreads</directive> -
Cette directive indique au serveur le nombre de threads qu'il
- doit lancer au démarrage. Il est recommandé de conserver la
- valeur par défaut <code>StartThreads 50</code>.</p>
+ doit lancer au démarrage. Il est recommandé de conserver la
+ valeur par défaut <code>StartThreads 50</code>.</p>
<p><directive module="mpm_common">MinSpareThreads</directive> -
Cette directive indique au serveur le nombre de worker threads
additionnels qu'il doit lancer si le nombre de threads inactifs
- tombe en dessous de cette valeur. Il est recommandé de conserver la
- valeur par défaut <code>MinSpareThreads 10</code>.</p>
+ tombe en dessous de cette valeur. Il est recommandé de conserver la
+ valeur par défaut <code>MinSpareThreads 10</code>.</p>
<p><directive module="mpm_common">MaxSpareThreads</directive> -
- Cette directive indique au serveur qu'il doit commencer à
- arrêter des worker threads si le nombre de threads inactifs
- passe au dessus de cette valeur. Il est recommandé de conserver
- la valeur par défaut <code>MaxSpareThreads 100</code>.</p>
+ Cette directive indique au serveur qu'il doit commencer à
+ arrêter des worker threads si le nombre de threads inactifs
+ passe au dessus de cette valeur. Il est recommandé de conserver
+ la valeur par défaut <code>MaxSpareThreads 100</code>.</p>
<p><directive module="mpm_netware">MaxThreads</directive> -
Cette directive impose un nombre maximum de worker threads. Il
- est recommandé de conserver la valeur par défaut
+ est recommandé de conserver la valeur par défaut
<code>ThreadsPerChild 250</code>.</p>
<p><directive module="mpm_common">ThreadStackSize</directive> -
- Cette directive indique au serveur la taille de la pile à
- utiliser pour un worker thread individuel. Il est recommandé de
- conserver la valeur par défaut <code>ThreadStackSize
+ Cette directive indique au serveur la taille de la pile à
+ utiliser pour un worker thread individuel. Il est recommandé de
+ conserver la valeur par défaut <code>ThreadStackSize
65536</code>.</p>
</li>
arguments ne doivent pas utiliser des noms de fichiers Unix,
mais des noms de fichiers Netware. Cependant, comme Apache
utilise des noms de style Unix en interne, on doit utiliser des
- slashes et non des antislashes. Il est recommandé de préfixer
+ slashes et non des antislashes. Il est recommandé de préfixer
tous les chemins de fichiers racines par un nom de volume. Si ce
dernier est omis, Apache supposera que le volume est
- <code>SYS:</code>, ce qui n'est pas forcément correct.</p>
+ <code>SYS:</code>, ce qui n'est pas forcément correct.</p>
</li>
<li>
- <p>Apache pour Netware a la possibilité de charger des modules
- en cours d'exécution, sans avoir à recompiler le serveur. Si
- Apache est compilé avec les options par défaut, il va installer
- de nombreux modules optionnels dans le répertoire
+ <p>Apache pour Netware a la possibilité de charger des modules
+ en cours d'exécution, sans avoir à recompiler le serveur. Si
+ Apache est compilé avec les options par défaut, il va installer
+ de nombreux modules optionnels dans le répertoire
<code>\Apache2\modules</code>. Pour les activer, ou en activer
d'autres, on doit utiliser la directive <directive
module="mod_so">LoadModule</directive>. Par exemple, pour
LoadModule status_module modules/status.nlm
</example>
- <p>Des informations
à propos de la <a
- href="../mod/mod_so.html#creating">création de modules
+ <p>Des informations
à propos de la <a
+ href="../mod/mod_so.html#creating">création de modules
chargeables</a> sont aussi disponibles.</p>
</li>
</ul>
<section id="use-add">
- <title>Autres directives spécifiques à Netware :</title>
+ <title>Autres directives spécifiques à Netware :</title>
<ul>
<li><directive module="core">CGIMapExtension</directive> -
- Cette directive associe une extension de fichier CGI à un
- interpréteur de script.</li>
+ Cette directive associe une extension de fichier CGI à un
+ interpréteur de script.</li>
</ul>
<ul>
<li><directive module="mod_nw_ssl">SecureListen</directive> -
Cette directive active le chiffrement SSL pour un port
- spécifique.</li>
+ spécifique.</li>
</ul>
<ul>
<li><directive module="mod_nw_ssl">NWSSLTrustedCerts</directive> -
Cette directive permet d'ajouter des certificats de confiance
- pouvant être utilisés pour créer des connexions sécurisées vers
+ pouvant être utilisés pour créer des connexions sécurisées vers
des serveurs mandataires.</li>
</ul>
<ul>
<li><directive module="mod_nw_ssl">NWSSLUpgradeable</directive> -
Cette directive permet de faire passer en SSL une connexion
- initialisée sur les adresse IP et Port spécifiés.</li>
+ initialisée sur les adresse IP et Port spécifiés.</li>
</ul>
</section>
<title>Compilation d'Apache pour NetWare</title>
- <p>La compilation d'Apache nécessite MetroWerks CodeWarrior 6.x ou
- supérieur. Une fois compilé, Apache peut être installé à la racine
- de tout volume Netware. Le répertoire d'installation par défaut est
+ <p>La compilation d'Apache nécessite MetroWerks CodeWarrior 6.x ou
+ supérieur. Une fois compilé, Apache peut être installé à la racine
+ de tout volume Netware. Le répertoire d'installation par défaut est
<code>sys:/Apache2</code>.</p>
- <p>Avant de démarrer Apache, vous devez remplir le répertoire
+ <p>Avant de démarrer Apache, vous devez remplir le répertoire
<code>conf</code>. Copiez le fichier <code>HTTPD-STD.CONF</code>
- depuis le répertoire <code>conf</code> de la distribution et
+ depuis le répertoire <code>conf</code> de la distribution et
renommez-le en <code>HTTPD.CONF</code>. Editez le fichier
- <code>HTTPD.CONF</code> en recherchant les repères
+ <code>HTTPD.CONF</code> en recherchant les repères
<code>@@Value@@</code>, et remplacez ces derniers par la valeur
- appropriée. Copiez de même les fichiers <code>conf/magic</code> et
+ appropriée. Copiez de même les fichiers <code>conf/magic</code> et
<code>conf/mime.types</code>. Vous pouvez aussi construire une
- distribution complète en ajoutant le mot-clé <code>install</code>
+ distribution complète en ajoutant le mot-clé <code>install</code>
lors de l'invocation des makefiles.</p>
<section id="comp-req">
- <title>Prérequis :</title>
+ <title>Prérequis :</title>
- <p>Les outils de développement suivants sont nécessaires pour la
+ <p>Les outils de développement suivants sont nécessaires pour la
compilation d'Apache pour Netware :</p>
<ul>
- <li>Metrowerks CodeWarrior 6.0 ou sup
érieur avec le <a
+ <li>Metrowerks CodeWarrior 6.0 ou sup
érieur avec le <a
href="http://developer.novell.com/ndk/cwpdk.htm">NetWare PDK
- 3.0</a> ou supérieur.</li>
+ 3.0</a> ou supérieur.</li>
<li>Les <a
- href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
+ href="http://developer.novell.com/ndk/libc.htm">Bibliothèques
Netware pour C (LibC)</a></li>
<li>Les <a
- href="http://developer.novell.com/ndk/cldap.htm">Bibliothèques
+ href="http://developer.novell.com/ndk/cldap.htm">Bibliothèques
LDAP pour C</a></li>
<li>Le <a href="http://www.gzip.org/zlib/">Code source de la
- bibliothèque de compression ZLIB</a></li>
+ bibliothèque de compression ZLIB</a></li>
- <li>L'utilitaire AWK (awk, gawk ou similaire). AWK peut être
- t
éléchargé à <a
+ <li>L'utilitaire AWK (awk, gawk ou similaire). AWK peut être
href="http://developer.novell.com/ndk/apache.htm"
>http://developer.novell.com/ndk/apache.htm</a>.
L'utilitaire doit se trouver dans votre chemin windows et avoir
pour nom <code>awk.exe</code>.</li>
<li>Pour utiliser les makefiles, vous devez disposer de GNU make
- version 3.78.1 (GMake) disponible
à <a
+ version 3.78.1 (GMake) disponible
à <a
href="http://developer.novell.com/ndk/apache.htm"
>http://developer.novell.com/ndk/apache.htm</a>.</li>
</ul>
:</title>
<ul>
- <li>Définissez la variable d'environnement
- <code>NOVELLLIBC</code> avec le chemin des bibliothèques Netware
+ <li>Définissez la variable d'environnement
+ <code>NOVELLLIBC</code> avec le chemin des bibliothèques Netware
pour C SDK ; par exemple : <example>Set
NOVELLLIBC=c:\novell\ndk\libc</example></li>
- <li>Définissez la variable d'environnement
+ <li>Définissez la variable d'environnement
<code>METROWERKS</code> avec le chemin de votre compilateur
Metrowerks CodeWarrior ; par exemple : <example>Set
METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</example>. Si
- vous l'avez installé dans le répertoire par défaut
+ vous l'avez installé dans le répertoire par défaut
<code>C:\Program Files\Metrowerks\CodeWarrior</code>, vous
- n'avez pas besoin de définir cette variable.</li>
+ n'avez pas besoin de définir cette variable.</li>
- <li>Définissez la variable d'environnement <code>LDAPSDK</code>
- avec le chemin des bibliothèques LDAP pour C ; par exemple :
+ <li>Définissez la variable d'environnement <code>LDAPSDK</code>
+ avec le chemin des bibliothèques LDAP pour C ; par exemple :
<example>Set
LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</example></li>
- <li>Définissez la variable d'environnement <code>ZLIBSDK</code>
- avec le chemin du code source de la bibliothèque Zlib ; par
+ <li>Définissez la variable d'environnement <code>ZLIBSDK</code>
+ avec le chemin du code source de la bibliothèque Zlib ; par
exemple : <example>Set ZLIBSDK=D:\NOVELL\zlib</example></li>
- <li>Définissez la variable d'environnement <code>PCRESDK</code>
- avec le chemin d'installation du code source de la bibliothèque
+ <li>Définissez la variable d'environnement <code>PCRESDK</code>
+ avec le chemin d'installation du code source de la bibliothèque
PCRE ; par exemple :
<example>Set PCRESDK=D:\NOVELL\pcre</example>
</li>
- <li>Définissez la variable d'environnement <code>AP_WORK</code>
+ <li>Définissez la variable d'environnement <code>AP_WORK</code>
avec le chemin du code source de <code>httpd</code>.
<example>Set AP_WORK=D:\httpd-2.0.x</example></li>
- <li>Définissez la variable d'environnement <code>APR_WORK</code>
- avec le chemin du code source d'<code>apr</code> ; en général
+ <li>Définissez la variable d'environnement <code>APR_WORK</code>
+ avec le chemin du code source d'<code>apr</code> ; en général
<code>\httpd\srclib\apr</code>, mais le projet APR peut se
- trouver en dehors de la structure des répertoires de httpd.
+ trouver en dehors de la structure des répertoires de httpd.
<example>Set APR_WORK=D:\apr-1.x.x</example></li>
- <li>Définissez la variable d'environnement <code>APU_WORK</code>
+ <li>Définissez la variable d'environnement <code>APU_WORK</code>
avec le chemin du code source d'<code>apr-util</code> ; en
- général <code>\httpd\srclib\apr-util</code>, mais le projet
+ général <code>\httpd\srclib\apr-util</code>, mais le projet
APR-UTIL peut se trouver en dehors de la structure des
- répertoires de httpd. <example>Set
+ répertoires de httpd. <example>Set
APU_WORK=D:\apr-util-1.x.x</example></li>
- <li>Vérifiez que les chemins des utilitaires AWK et GNU make
- (<code>gmake.exe</code>) ont bien été inclus dans la variable
- d'environnement système <code>PATH</code>.</li>
+ <li>Vérifiez que les chemins des utilitaires AWK et GNU make
+ (<code>gmake.exe</code>) ont bien été inclus dans la variable
+ d'environnement système <code>PATH</code>.</li>
- <li>Téléchargez le code source et décompressez-le dans un
- répertoire de votre choix sur votre station de travail.</li>
+ <li>Téléchargez le code source et décompressez-le dans un
+ répertoire de votre choix sur votre station de travail.</li>
- <li>Positionnez-vous dans le répertoire <code>\httpd-2.0</code>
- et compilez les utilitaires précompilés à l'aide de la commande
+ <li>Positionnez-vous dans le répertoire <code>\httpd-2.0</code>
+ et compilez les utilitaires précompilés à l'aide de la commande
"<code>gmake -f nwgnumakefile prebuild</code>". Cette cible va
- créer le répertoire <code>\httpd-2.0\nwprebuild</code>, et y
- copier tous les utilitaires nécessaires au franchissement des
- étapes suivantes de la compilation.</li>
+ créer le répertoire <code>\httpd-2.0\nwprebuild</code>, et y
+ copier tous les utilitaires nécessaires au franchissement des
+ étapes suivantes de la compilation.</li>
<li>Copiez les fichiers
<code>\httpd-2.0\nwprebuild\GENCHARS.nlm</code> et
<code>\httpd-2.0\nwprebuild\DFTABLES.nlm</code> vers le volume
- <code>SYS:</code> d'un serveur Netware et exécutez-les à l'aide
+ <code>SYS:</code> d'un serveur Netware et exécutez-les à l'aide
des commandes suivantes :
<example>
SYS:\genchars > sys:\test_char.h<br />
</li>
<li>Copiez les fichiers <code>test_char.h</code> et
- <code>chartables.c</code> vers le répertoire
- <code>\httpd-2.0\os\netware</code> de la machine où s'effectue
+ <code>chartables.c</code> vers le répertoire
+ <code>\httpd-2.0\os\netware</code> de la machine où s'effectue
la compilation.</li>
- <li>Positionnez-vous dans le répertoire <code>\httpd-2.0</code>
- et compilez Apache à l'aide de la commande "<code>gmake -f
- nwgnumakefile</code>". Vous pouvez créer un répertoire pour la
- distribution en ajoutant le paramètre install à la commande ;
+ <li>Positionnez-vous dans le répertoire <code>\httpd-2.0</code>
+ et compilez Apache à l'aide de la commande "<code>gmake -f
+ nwgnumakefile</code>". Vous pouvez créer un répertoire pour la
+ distribution en ajoutant le paramètre install à la commande ;
par exemple :
<example>gmake -f nwgnumakefile install</example>
</li>
<section id="comp-add">
- <title>Options de make supplémentaires</title>
+ <title>Options de make supplémentaires</title>
<ul>
<li><code>gmake -f nwgnumakefile</code><p>Compile les versions
de distribution de tous les binaires et les copie dans un
- répertoire <code>\release</code>.</p></li>
+ répertoire <code>\release</code>.</p></li>
<li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Compile les versions
- de débogage de tous les binaires et les copie dans un
- répertoire <code>\debug</code>.</p></li>
+ de débogage de tous les binaires et les copie dans un
+ répertoire <code>\debug</code>.</p></li>
- <li><code>gmake -f nwgnumakefile install</code><p>Crée une
- distribution complète d'Apache avec les binaires, la
- documentation et les fichiers support dans un répertoire
+ <li><code>gmake -f nwgnumakefile install</code><p>Crée une
+ distribution complète d'Apache avec les binaires, la
+ documentation et les fichiers support dans un répertoire
<code>\dist\Apache2</code>.</p></li>
<li><code>gmake -f nwgnumakefile prebuild</code><p>Compile tous
- les utilitaires précompilés et les copie dans le répertoire
+ les utilitaires précompilés et les copie dans le répertoire
<code>\nwprebuild</code>.</p></li>
- <li><code>gmake -f nwgnumakefile installdev</code><p>Même effet
- que l'option install, mais en plus, les répertoires
- <code>\lib</code> et <code>\include</code> sont créés dans le
- répertoire de destination, et les en-têtes et fichiers d'import
- y sont copiés.</p></li>
+ <li><code>gmake -f nwgnumakefile installdev</code><p>Même effet
+ que l'option install, mais en plus, les répertoires
+ <code>\lib</code> et <code>\include</code> sont créés dans le
+ répertoire de destination, et les en-têtes et fichiers d'import
+ y sont copiés.</p></li>
<li><code>gmake -f nwgnumakefile clean</code><p>Supprime tous
les fichiers objets et les binaires de la zone de compilation
<code>\release.o</code>, ou <code>\debug.o</code> si
- <code>DEBUG</code> a été défini.</p></li>
+ <code>DEBUG</code> a été défini.</p></li>
- <li><code>gmake -f nwgnumakefile clobber_all</code><p>Même effet
- que clean, mais en plus, le répertoire de la distribution est
- supprimé s'il existe.</p></li>
+ <li><code>gmake -f nwgnumakefile clobber_all</code><p>Même effet
+ que clean, mais en plus, le répertoire de la distribution est
+ supprimé s'il existe.</p></li>
</ul>
</section>
<section id="comp-add-env">
- <title>Variables d'environnement supplémentaires</title>
+ <title>Variables d'environnement supplémentaires</title>
<ul>
- <li>Pour compiler tous les modules expérimentaux, définissez la
+ <li>Pour compiler tous les modules expérimentaux, définissez la
variable d'environnement <code>EXPERIMENTAL</code> :
<example>Set EXPERIMENTAL=1</example>
</li>
<li>Pour compiler Apache en utilisant les sockets de style BSD
- standard, plutôt que Winsock, définissez la variable
+ standard, plutôt que Winsock, définissez la variable
d'environnement <code>USE_STDSOCKETS</code> :
<example>Set USE_STDSOCKETS=1</example>
</li>
<title>Compilation de mod_ssl pour la plate-forme Netware</title>
<p>Pour fournir les services SSL, Apache pour Netware utilise par
- défaut le module intégré <module>mod_nw_ssl</module>. Ce module ne
- fournit que les services SSL implémentés par le système
- d'exploitation Netware lui-même pour gérer tous les chiffrements
- pour un port donné. Cependant, on peut aussi utiliser mod_ssl de
- la même manière que sur les autres plate-formes.</p>
+ défaut le module intégré <module>mod_nw_ssl</module>. Ce module ne
+ fournit que les services SSL implémentés par le système
+ d'exploitation Netware lui-même pour gérer tous les chiffrements
+ pour un port donné. Cependant, on peut aussi utiliser mod_ssl de
+ la même manière que sur les autres plate-formes.</p>
<p>Afin de pouvoir compiler mod_ssl pour la plate-forme Netware,
- les bibliothèques OpenSSL doivent être disponibles. Elles peuvent
- être installées de la manière suivante :</p>
+ les bibliothèques OpenSSL doivent être disponibles. Elles peuvent
+ être installées de la manière suivante :</p>
<ul>
- <li>Téléchargez la dernière distribution du code source
+ <li>Téléchargez la dernière distribution du code source
d'OpenSSL 0.9.8 depuis la page <a
href="http://www.openssl.org/source/">OpenSSL Source</a> (les
- versions 0.9.7 doivent être patchées, et ne sont donc pas
- recommandées).</li>
+ versions 0.9.7 doivent être patchées, et ne sont donc pas
+ recommandées).</li>
<li>Editez le fichier <code>NetWare/set_env.bat</code>, et
- effectuez toutes modifications nécessaires des chemins des
+ effectuez toutes modifications nécessaires des chemins des
outils et utilitaires en fonction de votre environnement de
- développement.</li>
+ développement.</li>
- <li>Exécutez les scripts suivants depuis la racine du
- répertoire des sources d'OpenSSL :
+ <li>Exécutez les scripts suivants depuis la racine du
+ répertoire des sources d'OpenSSL :
<example>
Netware\set_env netware-libc<br />
Netware\build netware-libc
</example>
Pour des raisons de performances, vous devez activer la
- compilation avec le code ASM. T
élécharger NASM depuis le <a
+ compilation avec le code ASM. T
élécharger NASM depuis le <a
href="http://nasm.sourceforge.net/">site SF</a>. Configurez
ensuite OpenSSL pour utiliser le code ASM :
<example>
Netware\build netware-libc nw-nasm enable-mdc2 enable-md5
</example>
Attention : n'utilisez pas l'Assembleur CodeWarrior - il
- produit un code de mauvaise qualité !</li>
+ produit un code de mauvaise qualité !</li>
- <li>Avant de compiler Apache, définissez la variable
+ <li>Avant de compiler Apache, définissez la variable
d'environnement <code>OSSLSDK</code> avec le chemin absolu de
- la racine du répertoire du code source d'openssl, et
- définissez WITH_MOD_SSL à 1.
+ la racine du répertoire du code source d'openssl, et
+ définissez WITH_MOD_SSL à 1.
<example>
Set OSSLSDK=d:\openssl-0.9.8x<br />
Set WITH_MOD_SSL=1
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 805049 -->
-->
<manualpage metafile="perf-hp.xml.meta">
- <parentdocument href="./">Notes spécifiques aux
+ <parentdocument href="./">Notes spécifiques aux
plates-formes</parentdocument>
<title>Mise en oeuvre d'un serveur Web hautes performances sous
Subject: HP-UX tuning tips
</pre>
- <p>Traduction du corps du message cité ci-dessus :</p>
+ <p>Traduction du corps du message cité ci-dessus :</p>
- <p>Voici quelques conseils de personnalisation pour HPUX à ajouter à
+ <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 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.
+ <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
+ 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
+ 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>
+ <code>tcp_hash_size</code> est une quantité sur 32 bits.</p>
- <p>Comment d
éterminer cette valeur ? Examinez la sortie de <a
+ <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 à
+ 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
+ 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
+ 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
+ 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
+ <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
+ "<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>
+ 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
+ <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
+ probablement. Cette modification peut aussi être ajoutée dans le
code source.</p>
- <p>Si l'administrateur s'intéresse au nombre de connexions
+ <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
+ 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>
+ 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>
+ 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>sincèrement ,</p>
<p>rick jones</p>
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1637114 -->
-->
<manualpage metafile="win_compiling.xml.meta">
- <parentdocument href="./">Notes spécifiques à certaines
+ <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
+ <p>Il y a de nombreux points importants à connaître avant de
compiler Le serveur HTTP Apache pour Microsoft Windows. Avant de commencer, lisez le
document <a href="windows.html">Utiliser le serveur HTTP Apache avec Microsoft
Windows</a>.</p>
- <p>httpd peut être compilé sous Windows en utilisant une chaîne de
- compilation basée sur cmake, ou à partir de fichiers projet Visual
- Studio maintenus par les développeurs de httpd. La chaîne de
- compilation basée sur cmake supporte directement davantage de
- versions de Visual Studio, mais possède actuellement des
- fonctionnalités très limitées.</p>
+ <p>httpd peut être compilé sous Windows en utilisant une chaîne de
+ compilation basée sur cmake, ou à partir de fichiers projet Visual
+ Studio maintenus par les développeurs de httpd. La chaîne de
+ compilation basée sur cmake supporte directement davantage de
+ versions de Visual Studio, mais possède actuellement des
+ fonctionnalités très limitées.</p>
</summary>
<section id="requirements">
- <title>Prérequis</title>
+ <title>Prérequis</title>
<p>Pour compiler Apache, l'environnement doit satisfaire aux
conditions suivantes :</p>
<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
+ 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.
+ 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>
+ 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
+ <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
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
+ 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>Microsoft Visual C++ 6.0 (Visual Studio 97) ou supérieur.</p>
- <p>Apache peut être compilé en utilisant l'outil ligne de
+ <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 the <code>PATH</code>,
<code>INCLUDE</code>, <code>LIB</code>, ainsi que d'autres
- variables qui peuvent être définies via le script
+ 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
+ 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>
+ 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
+ <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>
+ 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>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>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
+ .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>
+ 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 />
<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
+ <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
+ <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
+ 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
+ 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
+ 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
+ <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 devez modifier manuellement les fichiers
- .conf installés afin de permettre au serveur de démarrer.
+ .conf installés. Vous devez 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>
+ 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 ->
+ 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>
+ 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 de 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,
+ 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
+ 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
+ <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
+ <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>
+ été vérifié avec la version 1.2.3.</p>
<example>
nmake -f win32\Makefile.msc<br />
</li>
<li>
- <p>[Optionnel] Bibliothèques OpenSSL (pour le module
+ <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 à
+ <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.
+ 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
+ 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
+ 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>
+ pour plus de détails.</note>
- <p>La configuration et la compilation d'OpenSSL nécessite
+ <p>La configuration et la compilation d'OpenSSL nécessite
l'installation de perl.</p>
<p>Pour pouvoir compiler <module>mod_ssl</module> ou le projet
<code>abs.exe</code>, qui devient ab.c avec le support SSL
- activé, vous devez
- t
élécharger OpenSSL à l'adresse <a
+ 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
+ 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 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>
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 pouvoir
+ <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 pouvoir
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
- pouvoir 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>
+ zdll.lib et s'assure que les fichiers .pdb sont générés afin de
+ pouvoir 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
+ <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
+ <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>
+ 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>
+ 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
+ <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>
+ 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
+ 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>
+ <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 id="unixsrcbuild">
- <title>Compilation à partir des sources Unix</title>
+ <title>Compilation à partir des sources Unix</title>
- <p>Le projet du serveur HTTP Apache à pour politique de ne fournir
+ <p>Le projet du serveur HTTP Apache à pour politique de ne fournir
que des sources de type Unix. Les paquets source de type Windows
- disponibles en téléchargement ont été élaborés par des
- contributeurs, et ne seront pas forcément reconduits pour toutes les
- versions. Vous pouvez cependant compiler le serveur sous Windows à
- partir des sources Unix en ajoutant quelques étapes supplémentaires.</p>
+ disponibles en téléchargement ont été élaborés par des
+ contributeurs, et ne seront pas forcément reconduits pour toutes les
+ versions. Vous pouvez cependant compiler le serveur sous Windows à
+ partir des sources Unix en ajoutant quelques étapes supplémentaires.</p>
<ol>
- <li>Téléchargez et ouvrez le tarball source Unix de la dernière
+ <li>Téléchargez et ouvrez le tarball source Unix de la dernière
version du serveur HTTP Apache.</li>
- <li>Téléchargez et ouvrez le tarball source Unix de la dernière
+ <li>Téléchargez et ouvrez le tarball source Unix de la dernière
version de APR, APR-Util et APR-Iconv, et copier l'arborescence
obtenue dans httpd-2.x.x\srclib\apr, httpd-2.x.x\srclib\apr-util
et httpd-2.x.x\srclib\apr-iconv</li>
- <li>Ouvrez la console et placez-vous au niveau du répertoire httpd-2.x.x</li>
- <li>Exécutez l'utilitaire de conversion de fins de ligne</li>
+ <li>Ouvrez la console et placez-vous au niveau du répertoire httpd-2.x.x</li>
+ <li>Exécutez l'utilitaire de conversion de fins de ligne</li>
</ol>
<example>
</example>
<p>Vous pouvez maintenant compiler le serveur via l'environnement de
- développement Visual Studio en utilisant l'IDE. Les compilations
+ développement Visual Studio en utilisant l'IDE. Les compilations
du serveur en ligne de commande ne sont possibles avec des sources
- de type Unix que si vous exportez les fichiers .mak comme indiqué
+ de type Unix que si vous exportez les fichiers .mak comme indiqué
ci-dessous.
</p>
<section id="commandbuild">
- <title>Compilation à partir de la ligne de commandes</title>
+ <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
<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
+ 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>
+ pouvant être fournies lors de la compilation.</p>
</section>
<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,
+ <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>
+ 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
+ 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
+ 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
+ <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>
- <!-- Traduction à revoir -->
+ <!-- Traduction à revoir -->
<note>Il y a une erreur dans la conversion .vcproj des fichiers
- .dsp. devenv.exe interprète mal le drapeau
- /D pour les drapeaux RC contenant de grandes /D'éfinitions entourées
- de guillemets, et contenant elles-mêmes des espaces. Ainsi, la
+ .dsp. devenv.exe interprète mal le drapeau
+ /D pour les drapeaux RC contenant de grandes /D'éfinitions entourées
+ de guillemets, et contenant 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 permettent de transmettre la longue
- description des fichiers de mod_apachemodule.so à leurs compilations
- d'identificateur de version de ressource .rc partagée.</note>
+ 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 permettent de transmettre la longue
+ description des fichiers de mod_apachemodule.so à leurs compilations
+ d'identificateur de version de ressource .rc partagée.</note>
- <!-- Traduction à revoir -->
+ <!-- Traduction à revoir -->
<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
+ 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
+ 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>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
+ fonction des définitions des variables d'environnement
<code>DBD_LIST</code> et <code>DBM_LIST</code>.</p>
</section>
<title>Export des fichiers .mak de la ligne de commandes</title>
- <p>Les fichiers <code>.mak</code> exportés posent plus de problèmes,
+ <p>Les fichiers <code>.mak</code> exportés posent plus 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
+ 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
+ <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
+ chemins absolus en chemins relatifs de façon à ce que la compilation
puisse s'effectuer depuis n'importe quelle position dans
l'arborescence :</p>
perl srclib\apr\build\fixwin32mak.pl
</example>
- <p>Vous devez exécuter cette commande depuis la <em>racine</em> de
+ <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
+ <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
+ <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 à
+ <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
+ <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
+ 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>
<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>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
+ le répertoire <em>rep</em> désiré, utilisez une des commandes
<code>nmake</code> suivantes :</p>
<example>
</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
+ 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>
+<title>Avertissement à propos de la compilation d'Apache à partir de
+l'arborescence de développement</title>
<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
+ 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'exporter pas ensuite vous-même tous les
- fichiers <code>.mak</code> du projet. Ceci n'est pas nécessaire
+ révisés si vous n'exporter 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>
<section id="cmake">
<title>Compilation de httpd avec cmake</title>
- <p>La documentation principale pour ce mécanisme de compilation se trouve
- dans le fichier <code>README.cmake</code> situé dans l'arborescence
- des sources. Consultez ce fichier pour des instructions détaillées.</p>
+ <p>La documentation principale pour ce mécanisme de compilation se trouve
+ dans le fichier <code>README.cmake</code> situé dans l'arborescence
+ des sources. Consultez ce fichier pour des instructions détaillées.</p>
<p>Pour compiler httpd avec cmake, vous devez compiler APR et APR-util
- séparément. Consultez les fichiers <code>README.cmake</code> de ces
+ séparément. Consultez les fichiers <code>README.cmake</code> de ces
projets pour obtenir des instructions.</p>
- <p>Les principales limitations de la compilation basée sur cmake sont
- héritées du projet APR-util et sont énumérées ci-dessous à cause de
+ <p>Les principales limitations de la compilation basée sur cmake sont
+ héritées du projet APR-util et sont énumérées ci-dessous à cause de
leur impact sur httpd :</p>
<ul>
<li>Il n'est pas possible de compiler le projet APR-iconv avec
cmake, et la compilation de APR-util ne peut pas utiliser de projet
- APR-iconv précompilé. A cause de cela, il n'est pas possible
+ APR-iconv précompilé. A cause de cela, il n'est pas possible
d'utiliser <module>mod_charset_lite</module> et probablement
d'autres modules tiers.</li>
<li>La compilation du sous-projet APR-util avec cmake ne supporte
- pas la plupart des bibliothèques optionnelles DBM et DBD utilisées
+ pas la plupart des bibliothèques optionnelles DBM et DBD utilisées
par les fichiers projet Visual Studio inclus. Cela limite les
- serveurs de bases de données d'arrière-plan supportés par de
+ serveurs de bases de données d'arrière-plan supportés par de
nombreux modules tiers ou inclus.</li>
</ul>
projects / apache / commitdiff