Commit 4d5d5a30 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML updates.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1770560 13f79535-47bb-0310-9956-ffa450edef68
parent 4820cc2e
Loading
Loading
Loading
Loading
+33 −33
Original line number Diff line number Diff line
<?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: 1673563 -->
@@ -25,7 +25,7 @@
<modulesynopsis metafile="mod_log_debug.xml.meta">

<name>mod_log_debug</name>
<description>Journalisation suppl&eacute;mentaire &agrave; des fins de d&eacute;bogage</description>
<description>Journalisation supplémentaire à des fins de débogage</description>
<status>Experimental</status>
<sourcefile>mod_log_debug.c</sourcefile>
<identifier>log_debug_module</identifier>
@@ -35,7 +35,7 @@

    <ol>
      <li>
        Enregistre un message apr&egrave;s le traitement d'une requ&ecirc;te pour
        Enregistre un message après le traitement d'une requête pour
	/foo/* :

        <highlight language="config">
@@ -46,23 +46,23 @@
      </li>

      <li>
        Enregistre un message si une requ&ecirc;te pour /foo/* est trait&eacute;e
	dans une sous-requ&ecirc;te :
        Enregistre un message si une requête pour /foo/* est traitée
	dans une sous-requête :
        <highlight language="config">
&lt;Location "/foo/"&gt;
&nbsp;&nbsp;LogMessage "subrequest to /foo/" hook=type_checker expr=%{IS_SUBREQ}
&lt;/Location&gt;
        </highlight>

        Le branchement (hook) par d&eacute;faut log_transaction n'est pas
	ex&eacute;cut&eacute; pour les sous-requ&ecirc;tes ; nous devons donc en utiliser un
        Le branchement (hook) par défaut log_transaction n'est pas
	exécuté pour les sous-requêtes ; nous devons donc en utiliser un
	autre.
      </li>


      <li>
        Enregistre un message si un client IPv6 est &agrave; l'origine d'un
	d&eacute;passement de d&eacute;lai pour une requ&ecirc;te :
        Enregistre un message si un client IPv6 est à l'origine d'un
	dépassement de délai pour une requête :
        <highlight language="config">
            LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} &amp;&amp; %{REQUEST_STATUS} = 408"
        </highlight>
@@ -71,16 +71,16 @@
      </li>

      <li>
        Enregistre la valeur de la variable d'environnement de requ&ecirc;te
	"X-Foo" &agrave; chaque &eacute;tape du traitement :
        Enregistre la valeur de la variable d'environnement de requête
	"X-Foo" à chaque étape du traitement :
        <highlight language="config">
&lt;Location "/"&gt;
&nbsp;&nbsp;LogMessage "%{reqenv:X-Foo}" hook=all
&lt;/Location&gt;
        </highlight>
        En association avec les rep&egrave;res de temps en microsecondes du journal des erreurs,
	<code>hook=all</code> permet aussi de d&eacute;terminer la dur&eacute;e d'ex&eacute;cution des
	diff&eacute;rentes phases du traitement de la requ&ecirc;te.
        En association avec les repères de temps en microsecondes du journal des erreurs,
	<code>hook=all</code> permet aussi de déterminer la durée d'exécution des
	différentes phases du traitement de la requête.
      </li>

    </ol>
@@ -88,27 +88,27 @@

<directivesynopsis>
<name>LogMessage</name>
<description>Enregistre des messages personnalis&eacute;s dans le journal des
<description>Enregistre des messages personnalisés dans le journal des
erreurs</description>
<syntax>LogMessage <var>message</var>
[hook=<var>hook</var>] [expr=<var>expression</var>]
</syntax>
<default>Non d&eacute;fini</default>
<default>Non défini</default>
<contextlist><context>directory</context>
</contextlist>

<usage>
    <p>Cette directive permet d'enregistrer un message personnalis&eacute; dans
    <p>Cette directive permet d'enregistrer un message personnalisé dans
    le journal des erreurs. Ce message peut utiliser des variables et
    des fonctions dans la <a href="../expr.html">syntaxe ap_expr</a>.
    D'&eacute;ventuelles r&eacute;f&eacute;rences &agrave; des en-t&ecirc;tes HTTP dans l'expression
    rationnelle n'entra&icirc;neront pas l'ajout des noms d'en-t&ecirc;te
    correspondants &agrave; l'en-t&ecirc;te Vary.
    Les messages sont enregistr&eacute;s au loglevel info.</p>
    D'éventuelles références à des en-têtes HTTP dans l'expression
    rationnelle n'entraîneront pas l'ajout des noms d'en-tête
    correspondants à l'en-tête Vary.
    Les messages sont enregistrés au loglevel info.</p>

    <p>Le branchement (hook) pr&eacute;cise la phase du traitement de la
    requ&ecirc;te avant laquelle le message sera enregistr&eacute;. Les branchements
    suivants sont support&eacute;s :</p>
    <p>Le branchement (hook) précise la phase du traitement de la
    requête avant laquelle le message sera enregistré. Les branchements
    suivants sont supportés :</p>

    <table border="1" style="zebra">
    <columnspec><column width="1"/></columnspec>
@@ -127,18 +127,18 @@ erreurs</description>
    <tr><td><code>log_transaction</code></td></tr>
    </table>

    <p>Le branchement par d&eacute;faut est <code>log_transaction</code>. La
    valeur sp&eacute;ciale <code>all</code> est &eacute;galement support&eacute;e ; dans ce cas,
    le message sera enregistr&eacute; &agrave; chaque phase. Tous les branchements ne
    sont pas ex&eacute;cut&eacute;s pour chaque requ&ecirc;te.</p>
    <p>Le branchement par défaut est <code>log_transaction</code>. La
    valeur spéciale <code>all</code> est également supportée ; dans ce cas,
    le message sera enregistré à chaque phase. Tous les branchements ne
    sont pas exécutés pour chaque requête.</p>

    <p>L'expression optionnelle permet de restreindre l'enregistrement
    du message en fonction d'une certaine condition. La syntaxe de
    l'expression est d&eacute;crite dans la <a
    href="../expr.html">documentation ap_expr</a>. D'&eacute;ventuelles
    r&eacute;f&eacute;rences &agrave; des en-t&ecirc;tes HTTP dans l'expression
    rationnelle n'entra&icirc;neront pas l'ajout des noms d'en-t&ecirc;te
    correspondants &agrave; l'en-t&ecirc;te Vary.</p>
    l'expression est décrite dans la <a
    href="../expr.html">documentation ap_expr</a>. D'éventuelles
    références à des en-têtes HTTP dans l'expression
    rationnelle n'entraîneront pas l'ajout des noms d'en-tête
    correspondants à l'en-tête Vary.</p>

</usage>

+28 −28
Original line number Diff line number Diff line
<?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: 1684312 -->
@@ -25,31 +25,31 @@
<modulesynopsis metafile="mod_logio.xml.meta">

<name>mod_logio</name>
<description>Journalisation des octets en entr&eacute;e et en sortie pour
chaque requ&ecirc;te</description>
<description>Journalisation des octets en entrée et en sortie pour
chaque requête</description>
<status>Extension</status>
<sourcefile>mod_logio.c</sourcefile>
<identifier>logio_module</identifier>

<summary>

    <p>Ce module permet d'enregistrer le nombre d'octets re&ccedil;us et
    envoy&eacute;s pour chaque requ&ecirc;te. Ce nombre refl&egrave;te le nombre r&eacute;el
    d'octets transmis sur le r&eacute;seau, et prend en compte les en-t&ecirc;tes et
    corps des requ&ecirc;tes et des r&eacute;ponses. Le d&eacute;compte est effectu&eacute; avant
    SSL/TLS en entr&eacute;e et apr&egrave;s SSL/TLS en sortie, si bien que le
    r&eacute;sultat refl&egrave;tera toute modification introduite par le
    <p>Ce module permet d'enregistrer le nombre d'octets reçus et
    envoyés pour chaque requête. Ce nombre reflète le nombre réel
    d'octets transmis sur le réseau, et prend en compte les en-têtes et
    corps des requêtes et des réponses. Le décompte est effectué avant
    SSL/TLS en entrée et après SSL/TLS en sortie, si bien que le
    résultat reflètera toute modification introduite par le
    chiffrement.</p>

    <p>Pour fonctionner, ce module requiert le chargement du module
    <module>mod_log_config</module>.</p>

    <note>Lorsqu'on utilise les connexions persistantes avec SSL, le
    suppl&eacute;ment de trafic induit par la n&eacute;gociation SSL est enregistr&eacute;
    dans le d&eacute;compte des octets transmis dans le cadre de la premi&egrave;re
    requ&ecirc;te de la connexion. Lors d'une ren&eacute;gociation SSL au niveau d'un
    r&eacute;pertoire, le d&eacute;compte d'octets est associ&eacute; &agrave; la
    requ&ecirc;te qui a d&eacute;clench&eacute; la ren&eacute;gociation.</note>
    supplément de trafic induit par la négociation SSL est enregistré
    dans le décompte des octets transmis dans le cadre de la première
    requête de la connexion. Lors d'une renégociation SSL au niveau d'un
    répertoire, le décompte d'octets est associé à la
    requête qui a déclenché la renégociation.</note>

</summary>

@@ -58,29 +58,29 @@ chaque requ&ecirc;te</description>
d'Apache</a></seealso>

<section id="formats">
<title>Formats de journaux personnalis&eacute;s</title>
<title>Formats de journaux personnalisés</title>

    <p>Ce module introduit trois nouvelles directives de journalisation.
    Les caract&eacute;ristiques de la requ&ecirc;te en elle-m&ecirc;me sont journalis&eacute;es en
    ins&eacute;rant des directives "<code>%</code>" dans la cha&icirc;ne de format,
    qui seront remplac&eacute;es comme suit dans le fichier journal :</p>
    Les caractéristiques de la requête en elle-même sont journalisées en
    insérant des directives "<code>%</code>" dans la chaîne de format,
    qui seront remplacées comme suit dans le fichier journal :</p>

    <table border="1" style="zebra">
    <tr><th>Cha&icirc;ne&nbsp;de&nbsp;Format</th>
    <tr><th>Chaîne&nbsp;de&nbsp;Format</th>
        <th>Description</th></tr>

    <tr><td><code>%I</code></td>
        <td>Octets re&ccedil;us, en-t&ecirc;tes et corps de requ&ecirc;te inclus ; ne peut
	pas &ecirc;tre nul.</td></tr>
        <td>Octets reçus, en-têtes et corps de requête inclus ; ne peut
	pas être nul.</td></tr>

    <tr><td><code>%O</code></td>
        <td>Octets envoy&eacute;s, en-t&ecirc;tes inclus ; ne peut
	pas &ecirc;tre nul.</td></tr>
        <td>Octets envoyés, en-têtes inclus ; ne peut
	pas être nul.</td></tr>

    <tr><td><code>%S</code></td>
	<td>Nombre d'octets transmis (en &eacute;mission et r&eacute;ception), y
	compris corps et en-t&ecirc;tes de requ&ecirc;te. Ce nombre ne peut pas &ecirc;tre
	nul, et il correspond &agrave; la combinaison des formats %I et %O.<br />
	<td>Nombre d'octets transmis (en émission et réception), y
	compris corps et en-têtes de requête. Ce nombre ne peut pas être
	nul, et il correspond à la combinaison des formats %I et %O.<br />
	Disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr>

    <tr><td><code>%^FB</code></td>
@@ -92,10 +92,10 @@ d'Apache</a></seealso>
        </td></tr>	
    </table>

    <p>En g&eacute;n&eacute;ral, cette fonctionnalit&eacute; s'utilise comme suit :</p>
    <p>En général, cette fonctionnalité s'utilise comme suit :</p>

    <dl>
      <dt>Format de journal d'entr&eacute;es/sorties combin&eacute; :</dt>
      <dt>Format de journal d'entrées/sorties combiné :</dt>
      <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
      \"%{User-agent}i\" %I %O"</code></dd>
    </dl>
+401 −401

File changed.

Preview size limit exceeded, changes collapsed.