Commit 71726c85 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

Conversion to UTF-8. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1780934 13f79535-47bb-0310-9956-ffa450edef68
parent d59ab9f4

docs/manual/programs/apxs.xml.fr

+108 −108
Original line number Diff line number Diff line 
<?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 : 1494953 -->
@@ -30,28 +30,28 @@ 
<summary>

    <p><code>apxs</code> est un utilitaire permettant de compiler et

    d'installer des modules en tant qu'extensions du serveur HTTP

    Apache. A cet effet, un objet dynamique partag&eacute; (DSO) est compil&eacute; &agrave;

    Apache. A cet effet, un objet dynamique partagé (DSO) est compilé à

    partir d'un ou plusieurs <var>fichiers</var> sources ou objets et

    peut &ecirc;tre charg&eacute; pendant l'ex&eacute;cution du serveur Apache via la

    peut être chargé pendant l'exécution du serveur Apache via la

    directive <directive module="mod_so">LoadModule</directive> du

    module <module>mod_so</module>.</p>



    <p>Pour pouvoir utiliser ce m&eacute;canisme d'extensions, votre

    plate-forme doit supporter la fonctionnalit&eacute; DSO, et votre binaire

    <program>httpd</program> Apache doit &ecirc;tre compil&eacute; avec le module

    <p>Pour pouvoir utiliser ce mécanisme d'extensions, votre

    plate-forme doit supporter la fonctionnalité DSO, et votre binaire

    <program>httpd</program> Apache doit être compilé avec le module

    <module>mod_so</module>. Si ce n'est pas le cas, l'utilitaire

    <code>apxs</code> vous le signalera. Vous pouvez aussi v&eacute;rifier

    vous-m&ecirc;me ces pr&eacute;requis en ex&eacute;cutant manuellement la commande :</p>

    <code>apxs</code> vous le signalera. Vous pouvez aussi vérifier

    vous-même ces prérequis en exécutant manuellement la commande :</p>



    <example>

      $ httpd -l

    </example>



    <p>Le module <module>mod_so</module> doit faire partie de la liste

    des modules affich&eacute;e. Si ces pr&eacute;requis sont pr&eacute;sents, vous pouvez

    facilement &eacute;tendre les fonctionnalit&eacute;s de votre serveur Apache en

    installant vos propres modules &agrave; l'aide de l'utilitaire

    <code>apxs</code>, via le m&eacute;canisme DSO :</p>

    des modules affichée. Si ces prérequis sont présents, vous pouvez

    facilement étendre les fonctionnalités de votre serveur Apache en

    installant vos propres modules à l'aide de l'utilitaire

    <code>apxs</code>, via le mécanisme DSO :</p>



    <example>

      $ apxs -i -a -c mod_foo.c<br />
@@ -67,22 +67,22 @@ 
      $ _

    </example>



    <p>Les arguments <var>fichiers</var> peuvent correspondre &agrave; un

    fichier source C (.c), un fichier objet (.o) ou m&ecirc;me une archive de

    biblioth&egrave;ques (.a). L'utilitaire <code>apxs</code> reconna&icirc;t

    <p>Les arguments <var>fichiers</var> peuvent correspondre à un

    fichier source C (.c), un fichier objet (.o) ou même une archive de

    bibliothèques (.a). L'utilitaire <code>apxs</code> reconnaît

    automatiquement ces extensions et utilise automatiquement les

    fichiers source C pour la compilation, et les fichiers objets et

    archives pour l'&eacute;dition de liens. Cependant, si vous utilisez des

    fichiers objets pr&eacute;compil&eacute;s, assurez-vous que leur code soit

    ind&eacute;pendant de la position (PIC), afin de pouvoir les utiliser avec

    un objet partag&eacute; charg&eacute; dynamiquement. Avec GCC, par exemple, il

    archives pour l'édition de liens. Cependant, si vous utilisez des

    fichiers objets précompilés, assurez-vous que leur code soit

    indépendant de la position (PIC), afin de pouvoir les utiliser avec

    un objet partagé chargé dynamiquement. Avec GCC, par exemple, il

    vous suffit de toujours utiliser l'option de compilation

    <code>-fpic</code>. Pour les autres compilateurs C, consultez leur

    page de manuel, ou v&eacute;rifiez les drapeaux qu'<code>apxs</code>

    page de manuel, ou vérifiez les drapeaux qu'<code>apxs</code>

    utilise pour compiler les fichiers objets.</p>



    <p>Pour plus de d&eacute;tails &agrave; propos du support DSO dans Apache, lire la

    documentation du module <module>mod_so</module>, ou m&ecirc;me, consultez

    <p>Pour plus de détails à propos du support DSO dans Apache, lire la

    documentation du module <module>mod_so</module>, ou même, consultez

    le fichier source <code>src/modules/standard/mod_so.c</code>.</p>

</summary>

<seealso><program>apachectl</program></seealso>
@@ -96,15 +96,15 @@ 
    <p><code><strong>apxs</strong> -<strong>q</strong>

    [ -<strong>v</strong> ]

    [ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]

    <var>requ&ecirc;te</var> ...</code></p>

    <var>requête</var> ...</code></p>



    <p><code><strong>apxs</strong> -<strong>c</strong>

    [ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]

    [ -<strong>o</strong> <var>fichier-dso</var> ]

    [ -<strong>I</strong> <var>r&eacute;pertoire-inc</var> ]

    [ -<strong>I</strong> <var>répertoire-inc</var> ]

    [ -<strong>D</strong> <var>nom</var>=<var>valeur</var> ]

    [ -<strong>L</strong> <var>r&eacute;pertoire-lib</var> ]

    [ -<strong>l</strong> <var>nom-biblioth&egrave;que</var> ]

    [ -<strong>L</strong> <var>répertoire-lib</var> ]

    [ -<strong>l</strong> <var>nom-bibliothèque</var> ]

    [ -<strong>Wc,</strong><var>options-compilation</var> ]

    [ -<strong>Wl,</strong><var>options-edition-liens</var> ]

    <var>fichiers</var> ...</code></p>
@@ -128,36 +128,36 @@ 
    <section id="options.common"><title>Options courantes</title>

      <dl>

      <dt><code>-n <var>nom-module</var></code></dt>

      <dd>D&eacute;finit explicitement le nom du module pour les options

      <code>-i</code> (install) et <code>-g</code> (g&eacute;n&eacute;ration de

      mod&egrave;les). Utilisez cette option pour sp&eacute;cifier de mani&egrave;re

      <dd>Définit explicitement le nom du module pour les options

      <code>-i</code> (install) et <code>-g</code> (génération de

      modèles). Utilisez cette option pour spécifier de manière

      explicite le nom du module. Pour l'option <code>-g</code>, cette

      option est n&eacute;cessaire ; pour l'option <code>-i</code>,

      l'utilitaire <code>apxs</code> tente de d&eacute;terminer le nom du

      module &agrave; partir des sources, ou (&agrave; d&eacute;faut) en le d&eacute;duisant du nom

      option est nécessaire ; pour l'option <code>-i</code>,

      l'utilitaire <code>apxs</code> tente de déterminer le nom du

      module à partir des sources, ou (à défaut) en le déduisant du nom

      de fichier.</dd>

      </dl>

    </section>



    <section id="options.query"><title>Options de requ&ecirc;te</title>

    <section id="options.query"><title>Options de requête</title>

      <dl>

      <dt><code>-q</code></dt>

      <dd>Effectue une requ&ecirc;te &agrave; propos des variables et de

      l'environnement utilis&eacute;s pour compiler <code>httpd</code>.

      Lorsqu'elle est invoqu&eacute;e sans param&egrave;tre <var>requ&ecirc;te</var>, cette

      <dd>Effectue une requête à propos des variables et de

      l'environnement utilisés pour compiler <code>httpd</code>.

      Lorsqu'elle est invoquée sans paramètre <var>requête</var>, cette

      option affiche toutes les variables connues, ainsi que leurs

      valeurs. Le param&egrave;tre optionnel <code>-v</code> formate la liste

      affich&eacute;e.

      valeurs. Le paramètre optionnel <code>-v</code> formate la liste

      affichée.



      <p>Utilisez cette option pour d&eacute;terminer manuellement les options

      utilis&eacute;es pour compiler le binaire <code>httpd</code> qui chargera

      <p>Utilisez cette option pour déterminer manuellement les options

      utilisées pour compiler le binaire <code>httpd</code> qui chargera

      votre module. Ajoutez par exemple</p>

      <example>

        INC=-I`apxs -q INCLUDEDIR`

      </example>



      <p>dans vos propres Makefiles si vous devez acc&eacute;der manuellement

      aux fichiers d'en-t&ecirc;tes C d'Apache.</p></dd>

      <p>dans vos propres Makefiles si vous devez accéder manuellement

      aux fichiers d'en-têtes C d'Apache.</p></dd>

      </dl>

    </section>
@@ -165,20 +165,20 @@ 
      <dl>

      <dt><code>-S <var>nom</var>=<var>valeur</var></code></dt>

      <dd>Cette option permet de modifier la configuration d'apxs

      d&eacute;crite ci-dessus.</dd>

      décrite ci-dessus.</dd>

      </dl>

    </section>



    <section id="options.template"><title>Option de g&eacute;n&eacute;ration des

    mod&egrave;les</title>

    <section id="options.template"><title>Option de génération des

    modèles</title>

      <dl>

      <dt><code>-g</code></dt>

      <dd>Cette option permet de g&eacute;n&eacute;rer un sous-r&eacute;pertoire

      <dd>Cette option permet de générer un sous-répertoire

      <var>nom</var> (voir option <code>-n</code>) contenant deux

      fichiers : le premier fichier est un exemple de fichier source de

      module nomm&eacute; <code>mod_<var>nom</var>.c</code> que l'on peut

      utiliser comme mod&egrave;le pour cr&eacute;er ses propres modules, ou comme

      point de d&eacute;part pour se familiariser avec le m&eacute;canisme apxs ; le

      module nommé <code>mod_<var>nom</var>.c</code> que l'on peut

      utiliser comme modèle pour créer ses propres modules, ou comme

      point de départ pour se familiariser avec le mécanisme apxs ; le

      second fichier est le <code>Makefile</code> correspondant

      facilitant la compilation et l'installation de ce module.</dd>

      </dl>
@@ -186,62 +186,62 @@ 
    <section id="options.dso"><title>Options de compilation DSO</title>

      <dl>

      <dt><code>-c</code></dt>

      <dd>Cette option indique une op&eacute;ration de compilation. Tout

      d'abord, les fichiers sources (.c) sp&eacute;cifi&eacute;s par

      <var>fichiers</var> sont compil&eacute;s en fichiers objets

      correspondants (.o), puis un objet dynamiquement partag&eacute;

      <var>fichier-dso</var> est compil&eacute; via une &eacute;dition de liens de ces

      <dd>Cette option indique une opération de compilation. Tout

      d'abord, les fichiers sources (.c) spécifiés par

      <var>fichiers</var> sont compilés en fichiers objets

      correspondants (.o), puis un objet dynamiquement partagé

      <var>fichier-dso</var> est compilé via une édition de liens de ces

      fichiers objets avec les autres fichiers objets (.o and .a)

      sp&eacute;cifi&eacute;s par <var>fichiers</var>. Si l'option <code>-o</code>

      n'est pas sp&eacute;cifi&eacute;e, le nom du fichier r&eacute;sultant est d&eacute;duit du

      premier nom de fichier sp&eacute;cifi&eacute; par <var>fichiers</var>, et ainsi

      prend en g&eacute;n&eacute;ral pour valeur par d&eacute;faut

      spécifiés par <var>fichiers</var>. Si l'option <code>-o</code>

      n'est pas spécifiée, le nom du fichier résultant est déduit du

      premier nom de fichier spécifié par <var>fichiers</var>, et ainsi

      prend en général pour valeur par défaut

      <code>mod_<var>nom</var>.so</code>.</dd>



      <dt><code>-o <var>fichier-dso</var></code></dt>

      <dd>Sp&eacute;cifie de mani&egrave;re explicite le nom de fichier de l'objet

      partag&eacute; dynamiquement cr&eacute;&eacute;. Sans cette option, et si le nom ne

      peut pas &ecirc;tre d&eacute;duit de la liste <var>fichiers</var>, c'est le nom

      par d&eacute;faut <code>mod_unknown.so</code> qui sera utilis&eacute;.</dd>

      <dd>Spécifie de manière explicite le nom de fichier de l'objet

      partagé dynamiquement créé. Sans cette option, et si le nom ne

      peut pas être déduit de la liste <var>fichiers</var>, c'est le nom

      par défaut <code>mod_unknown.so</code> qui sera utilisé.</dd>



      <dt><code>-D <var>nom</var>=<var>valeur</var></code></dt>

      <dd>Cette option est transmise directement &agrave; la commande de

      <dd>Cette option est transmise directement à la commande de

      compilation. Vous pouvez l'utiliser pour ajouter vos propres

      d&eacute;finitions au processus de compilation. </dd>

      définitions au processus de compilation. </dd>



      <dt><code>-I <var>r&eacute;pertoire-inc</var></code></dt>

      <dd>Cette option est transmise directement &agrave; la commande de

      <dt><code>-I <var>répertoire-inc</var></code></dt>

      <dd>Cette option est transmise directement à la commande de

      compilation. Vous pouvez l'utiliser pour ajouter vos propres

      chemins de recherche des r&eacute;pertoires <code>include</code> au processus de

      chemins de recherche des répertoires <code>include</code> au processus de

      compilation.</dd>



      <dt><code>-L <var>r&eacute;pertoire-lib</var></code></dt>

      <dd>Cette option est transmise directement &agrave; la commande d'&eacute;dition

      <dt><code>-L <var>répertoire-lib</var></code></dt>

      <dd>Cette option est transmise directement à la commande d'édition

      de liens. Vous pouvez l'utiliser pour ajouter vos propres

      chemins de recherche des r&eacute;pertoires de biblioth&egrave;ques au processus

      chemins de recherche des répertoires de bibliothèques au processus

      de compilation.</dd>



      <dt><code>-l <var>nom-biblioth&egrave;que</var></code></dt>

      <dd>Cette option est transmise directement &agrave; la commande d'&eacute;dition

      <dt><code>-l <var>nom-bibliothèque</var></code></dt>

      <dd>Cette option est transmise directement à la commande d'édition

      de liens. Vous pouvez l'utiliser pour ajouter vos propres

      biblioth&egrave;ques &agrave; rechercher au processus de compilation.</dd>

      bibliothèques à rechercher au processus de compilation.</dd>



      <dt><code>-Wc,<var>options-compilation</var></code></dt>

      <dd>Cette option transmet les <var>options-compilation</var> en

      tant qu'options suppl&eacute;mentaires &agrave; la commande <code>libtool

      tant qu'options supplémentaires à la commande <code>libtool

      --mode=compile</code>. Vous pouvez l'utiliser pour ajouter des

      options locales sp&eacute;cifiques au compilateur.</dd>

      options locales spécifiques au compilateur.</dd>



      <dt><code>-Wl,<var>options-edition-liens</var></code></dt>

      <dd>Cette option transmet les <var>options-edition-liens</var> en

      tant qu'options suppl&eacute;mentaires &agrave; la commande <code>libtool

      tant qu'options supplémentaires à la commande <code>libtool

      --mode=link</code>. Vous pouvez l'utiliser pour ajouter des

      options locales sp&eacute;cifiques &agrave; l'&eacute;diteur de liens.</dd>

      options locales spécifiques à l'éditeur de liens.</dd>

      

      <dt><code>-p</code></dt>

      <dd>Avec cette option, apxs effectue l'&eacute;dition de liens avec les

      biblioth&egrave;ques apr/apr-util. Elle permet de compiler les programmes

      helper qui utilisent les biblioth&egrave;ques apr/apr-util.</dd>

      <dd>Avec cette option, apxs effectue l'édition de liens avec les

      bibliothèques apr/apr-util. Elle permet de compiler les programmes

      helper qui utilisent les bibliothèques apr/apr-util.</dd>

      </dl>

    </section>
@@ -249,39 +249,39 @@ 
    <title>Options d'installation et de configuration DSO</title>

      <dl>

      <dt><code>-i</code></dt>

      <dd>Cette option indique une op&eacute;ration d'installation et installe

      un ou plusieurs objets dynamiquement partag&eacute;s dans le r&eacute;pertoire

      <dd>Cette option indique une opération d'installation et installe

      un ou plusieurs objets dynamiquement partagés dans le répertoire

      <var>modules</var> du serveur.</dd>



      <dt><code>-a</code></dt>

      <dd>Cette option active le module en ajoutant automatiquement une

      directive <directive module="mod_so">LoadModule</directive>

      correspondante au fichier de configuration d'Apache

      <code>httpd.conf</code>, ou en l'activant s'il existe d&eacute;j&agrave;.</dd>

      <code>httpd.conf</code>, ou en l'activant s'il existe déjà.</dd>



      <dt><code>-A</code></dt>

      <dd>Identique &agrave; l'option <code>-a</code>, &agrave; la diff&eacute;rence que la

      directive <directive module="mod_so">LoadModule</directive> cr&eacute;&eacute;e

      est pr&eacute;fix&eacute;e par un caract&egrave;re di&egrave;se (<code>#</code>) ; le module

      est ainsi pr&eacute;par&eacute; pour une activation ult&eacute;rieure, mais est

      d&eacute;sactiv&eacute; dans un premier temps.</dd>

      <dd>Identique à l'option <code>-a</code>, à la différence que la

      directive <directive module="mod_so">LoadModule</directive> créée

      est préfixée par un caractère dièse (<code>#</code>) ; le module

      est ainsi préparé pour une activation ultérieure, mais est

      désactivé dans un premier temps.</dd>



      <dt><code>-e</code></dt>

      <dd>Cette option indique une op&eacute;ration d'&eacute;dition de liens et peut

      &ecirc;tre utilis&eacute;e avec les options <code>-a</code> et <code>-A</code>

      de la m&ecirc;me mani&egrave;re qu'au cours de l'op&eacute;ration d'installation pour

      &eacute;diter le fichier de configuration d'Apache

      <dd>Cette option indique une opération d'édition de liens et peut

      être utilisée avec les options <code>-a</code> et <code>-A</code>

      de la même manière qu'au cours de l'opération d'installation pour

      éditer le fichier de configuration d'Apache

      <code>httpd.conf</code>, sans toutefois installer le module.</dd>

      </dl>

    </section>

</section>



<section id="examples"><title>Exemples</title>

    <p>Supposons que vous disposiez d'un module Apache nomm&eacute;

    <code>mod_foo.c</code> et destin&eacute; &agrave; &eacute;tendre les fonctionnalit&eacute;s du

    <p>Supposons que vous disposiez d'un module Apache nommé

    <code>mod_foo.c</code> et destiné à étendre les fonctionnalités du

    serveur. Pour ce faire, vous devez tout d'abord compiler le fichier

    source C en un objet partag&eacute; pouvant &ecirc;tre charg&eacute; dans le serveur

    Apache &agrave; l'ex&eacute;cution, via la commande suivante :</p>

    source C en un objet partagé pouvant être chargé dans le serveur

    Apache à l'exécution, via la commande suivante :</p>



    <example>

      $ apxs -c mod_foo.c<br />
@@ -290,13 +290,13 @@ 
      $ _

    </example>



    <p>Vous devez ensuite v&eacute;rifier la configuration d'Apache en vous

    <p>Vous devez ensuite vérifier la configuration d'Apache en vous

    assurant qu'une directive <directive

    module="mod_so">LoadModule</directive> est bien pr&eacute;sente pour

    charger cet objet partag&eacute;. Pour simplifier cette &eacute;tape,

    <code>apxs</code> propose une m&eacute;thode automatique d'installation de

    l'objet partag&eacute; dans son r&eacute;pertoire "modules", et de mise &agrave; jour du

    fichier <code>httpd.conf</code> en cons&eacute;quence. Pour b&eacute;n&eacute;ficier de

    module="mod_so">LoadModule</directive> est bien présente pour

    charger cet objet partagé. Pour simplifier cette étape,

    <code>apxs</code> propose une méthode automatique d'installation de

    l'objet partagé dans son répertoire "modules", et de mise à jour du

    fichier <code>httpd.conf</code> en conséquence. Pour bénéficier de

    cette automatisation, utilisez la commande suivante :</p>



    <example>
@@ -315,16 +315,16 @@ 
      LoadModule foo_module modules/mod_foo.so

    </example>



    <p>est alors ajout&eacute;e au fichier de configuration si ce n'est pas

    d&eacute;j&agrave; fait. Si vous voulez que le module soit d&eacute;sactiv&eacute; par d&eacute;faut,

    <p>est alors ajoutée au fichier de configuration si ce n'est pas

    déjà fait. Si vous voulez que le module soit désactivé par défaut,

    utilisez l'option <code>-A</code> comme suit :</p>



    <example>

      $ apxs -i -A mod_foo.c

    </example>



    <p>Pour un test rapide du m&eacute;canisme apxs, vous pouvez cr&eacute;er un

    exemple de mod&egrave;le de module Apache, ainsi que le Makefile

    <p>Pour un test rapide du mécanisme apxs, vous pouvez créer un

    exemple de modèle de module Apache, ainsi que le Makefile

    correspondant via :</p>



    <example>
@@ -337,8 +337,8 @@ 
      $ _

    </example>



    <p>Vous pouvez ensuite compiler imm&eacute;diatement ce module exemple en

    objet partag&eacute; et le charger dans le serveur Apache :</p>

    <p>Vous pouvez ensuite compiler immédiatement ce module exemple en

    objet partagé et le charger dans le serveur Apache :</p>



    <example>

      $ cd foo<br />

docs/manual/programs/dbmmanage.xml.fr

+71 −71

File changed.

Preview size limit exceeded, changes collapsed.

docs/manual/programs/fcgistarter.xml.fr

+5 −5
Original line number Diff line number Diff line 
<?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 : 1469400 -->
@@ -25,7 +25,7 @@ 
<manualpage metafile="fcgistarter.xml.meta">

<parentdocument href="./">Programmes</parentdocument>



<title>fcgistarter - D&eacute;marrer un programme FastCGI</title>

<title>fcgistarter - Démarrer un programme FastCGI</title>



<summary>

    <p></p>
@@ -34,7 +34,7 @@ 
<seealso><module>mod_proxy_fcgi</module></seealso>



<section id="note"><title>Note</title>

      <p>Ne fonctionne actuellement que sur les syst&egrave;mes de type Unix.</p>

      <p>Ne fonctionne actuellement que sur les systèmes de type Unix.</p>

</section>



<section id="synopsis"><title>Syntaxe</title>
@@ -52,10 +52,10 @@ 
    <dd>Le programme FastCGI</dd>



    <dt><code>-p <var>port</var></code></dt>

    <dd>Port sur lequel le programme va se mettre en &eacute;coute</dd>

    <dd>Port sur lequel le programme va se mettre en écoute</dd>



    <dt><code>-i <var>interface</var></code></dt>

    <dd>Interface sur laquelle le programme va se mettre en &eacute;coute</dd>

    <dd>Interface sur laquelle le programme va se mettre en écoute</dd>



    <dt><code>-N <var>nombre</var></code></dt>

    <dd>Nombre d'instances du programme</dd>

docs/manual/programs/htcacheclean.xml.fr

+79 −79

File changed.

Preview size limit exceeded, changes collapsed.

docs/manual/programs/htdbm.xml.fr

+101 −101

File changed.

Preview size limit exceeded, changes collapsed.