]> granicus.if.org Git - apache/commitdiff
XML updates.
authorLucien Gentis <lgentis@apache.org>
Sun, 16 Aug 2015 15:58:03 +0000 (15:58 +0000)
committerLucien Gentis <lgentis@apache.org>
Sun, 16 Aug 2015 15:58:03 +0000 (15:58 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1696151 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/core.xml.fr
docs/manual/mod/mod_log_forensic.xml.fr
docs/manual/mod/mod_proxy.xml.fr
docs/manual/rewrite/flags.xml.fr

index f13a6f0936a2f814d426fef9367f834b697459b1..66d1f0b52f2ca86b79de8dd5a6da9779c82f5a77 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1688698:1695727 (outdated) -->
+<!-- English Revision: 1695727 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -4011,6 +4011,79 @@ serveur HTTP Apache.</compatibility>
 <seealso><directive module="mpm_common">Listen</directive></seealso>
 </directivesynopsis>
 
+<directivesynopsis>
+    <name>Protocols</name>
+    <description>Protocoles disponibles pour un serveur virtuel ou non</description>
+    <syntax>Protocols <var>protocole</var> ...</syntax>
+    <contextlist><context>server config</context><context>virtual host</context></contextlist>
+    <compatibility>Disponible &agrave; partir de la version 2.4.17 du serveur
+    HTTP Apache.</compatibility>
+    
+    <usage>
+        <p>Cette directive permet de sp&eacute;cifier la liste des protocoles
+       support&eacute;s par un serveur virtuel ou non. Cette liste &eacute;num&egrave;re les
+       protocoles qu'un client sera autoris&eacute; &agrave; n&eacute;gocier avec ce
+       serveur.</p>
+        
+        <p>Vous ne devez fournir cette liste que si vous voulez limiter
+       les protocoles disponibles pour le serveur. Par d&eacute;faut, tous les
+       protocoles sont disponibles.</p>
+        
+        <p>Par exemple, si vous ne voulez autoriser que le protocole
+       HTTP/1.1, m&ecirc;me si le protocole HTTP/2 est disponible, utilisez
+       cette directive comme suit :</p>
+        
+        <highlight language="config">
+            Protocols http/1.1
+        </highlight>
+
+        <p>Les protocoles valides sont <code>http/1.1</code> pour les
+       connexions http et https, <code>h2</code> pour les connections
+       https et <code>h2c</code> pour les connexions http. D'autres
+       modules peuvent fournir d'autres protocoles.</p>
+        
+        <p>Sp&eacute;cifier des protocoles non disponibles ou d&eacute;sactiv&eacute;s n'aura
+       aucun effet, et ceux-ci seront simplement ignor&eacute;s.</p>
+        
+        <p>Si des protocoles sont sp&eacute;cifi&eacute;s au niveau du serveur
+       principal, il seront concat&eacute;n&eacute;s &agrave; ceux &eacute;ventuellement d&eacute;finis
+       au niveau des serveurs virtuels. Comme certains protocoles comme
+       HTTP/2 permettent la r&eacute;utilisation des connexions sous certaines
+       conditions, la restriction de l'utilisation des protocoles pour
+       des serveurs virtuels individuels pourra ne pas fonctionner de
+       la mani&egrave;re dont vous vous attendez.</p>
+
+    </usage>
+    <seealso><directive module="core">ProtocolsHonorOrder</directive></seealso>
+</directivesynopsis>
+
+
+<directivesynopsis>
+    <name>ProtocolsHonorOrder</name>
+    <description>Protocoles disponibles pour un serveur virtuel ou non</description>
+    <syntax>ProtocolsHonorOrder On|Off</syntax>
+    <default>ProtocolsHonorOrder Off</default>
+    <contextlist><context>server config</context><context>virtual host</context></contextlist>
+    <compatibility>Disponible &agrave; partir de la version 2.4.17 du serveur
+    HTTP Apache.</compatibility>
+    
+    <usage>
+        <p>Cette directive permet de d&eacute;finir si le serveur doit tenir
+       compte de l'ordre des protocoles d&eacute;finis par la directive
+       <directive>Protocols</directive>.</p>
+        
+        <p>Par d&eacute;faut, un client fournit une liste de protocoles
+       support&eacute;s et le serveur s&eacute;lectionne le premier disponible.</p>
+        
+        <p>Si la directive <directive>ProtocolsHonorOrder</directive>
+       est d&eacute;finie &agrave; <code>on</code>, il n'est pas tenu compte de l'ordre de la liste des
+       protocoles fournie par le client, et seul l'ordre de la liste des
+       protocles d&eacute;finie au niveau du serveur influera la n&eacute;gociation
+       du protocole.</p>
+        
+    </usage>
+    <seealso><directive module="core">Protocols</directive></seealso>
+</directivesynopsis>
 
 <directivesynopsis>
 <name>RLimitCPU</name>
index c8e61144dc003b2b543ccb7c8d6997f42a20c8ac..b30d8c8f87005a0fc42866cc214d80944554d739 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1673947:1693828 (outdated) -->
+<!-- English Revision: 1693828 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -32,8 +32,16 @@ serveur</description>
 <identifier>log_forensic_module</identifier>
 
 <summary>
-    <p>Ce module permet la journalisation l&eacute;gale des requ&ecirc;tes client. La
-    journalisation s'effectuant avant et apr&egrave;s le traitement de la
+    <p>Ce module permet la journalisation l&eacute;gale des requ&ecirc;tes client.</p>
+
+    <p>La cr&eacute;ation du fichier journal correspondant s'effectue via la
+    directive <directive>ForensicLog</directive> comme suit :</p>
+
+    <highlight language="config">
+    ForensicLog logs/forensic_log
+    </highlight>    
+    
+    <p>La journalisation s'effectuant avant et apr&egrave;s le traitement de la
     requ&ecirc;te, le journal l&eacute;gal contient deux lignes pour chaque requ&ecirc;te.
     Le processus de journalisation l&eacute;gale est tr&egrave;s strict, &agrave; savoir
     :</p>
@@ -47,9 +55,16 @@ serveur</description>
     module="mpm_common">CoreDumpDirectory</directive>).</li>
     </ul>
 
-    <p>Pour interpr&eacute;ter les donn&eacute;es du journal l&eacute;gal, vous pouvez vous
+    <p>Pour interpr&eacute;ter les donn&eacute;es du journal
+    l&eacute;gal afin d'identifier les requ&ecirc;tes dont le traitement n'a
+    pas &eacute;t&eacute; men&eacute; &agrave; bien, vous pouvez vous
     aider du script <code>check_forensic</code> qui se trouve dans le
     r&eacute;pertoire support de la distribution.</p>
+
+    <example>
+    check-forensic forensic_log
+    </example>
+
     <note>Note de traduction : le terme "l&eacute;gal" utilis&eacute; dans le pr&eacute;sent document ne sugg&egrave;re aucunement que
     ce module apporte une valeur juridique aux journaux. Il est &agrave; comprendre dans le contexte
     similaire &agrave; ce que l'on trouve en analyse medico-l&eacute;gale. En d'autres termes, la finalit&eacute; de ce module
index ad1acda9f60d61211cf02aa4ef800c8c7ac59ddb..acfeb62e7692f0c32501c5f486ae9b3fc902f808 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1690137:1695913 (outdated) -->
+<!-- English Revision: 1695913 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -237,7 +237,7 @@ ProxyVia On
       
 
       <p>Cette directive va cr&eacute;er un worker associ&eacute; &agrave; l'URL du serveur
-      original <code>http://backend.example.com</code>, et utilisant les
+      original <code>http://backend.example.com</code>, qui utilisera les
       valeurs de timeout donn&eacute;es. Lorsqu'ils sont utilis&eacute;s dans le cadre
       d'un mandataire direct, les workers sont en g&eacute;n&eacute;ral d&eacute;finis via la
       directive <directive module="mod_proxy">ProxySet</directive>,</p>
@@ -668,7 +668,7 @@ dans un contexte de r&eacute;pertoire depuis la version 2.3.3.</compatibility>
 <usage>
     <p>Lorsqu'elle est activ&eacute;e, cette directive va transmettre l'en-t&ecirc;te
     Host: de la requ&ecirc;te entrante vers le serveur mandat&eacute;, au lieu du nom
-    d'h&ocirc;te sp&eacute;cifi&eacute; par la directive <directive>ProxyPass</directive>.</p>
+    d'h&ocirc;te sp&eacute;cifi&eacute; par la directive <directive module="mod_proxy">ProxyPass</directive>.</p>
 
     <p>Cette directive est habituellement d&eacute;finie &agrave; <code>Off</code>.
     Elle est principalement utile dans les configurations particuli&egrave;res
@@ -758,7 +758,7 @@ ProxyRemote ftp http://ftpproxy.mydomain:8080
     HTTP, vers un autre mandataire capable de les traiter.</p>
 
     <p>Cette directive supporte aussi les configurations de mandataire
-    inverse - un serveur web d'arri&egrave;re-plan peut &ecirc;tre int&eacute;gr&eacute; dans
+    inverse ; un serveur web d'arri&egrave;re-plan peut &ecirc;tre int&eacute;gr&eacute; dans
     l'espace d'URL d'un serveur virtuel, m&ecirc;me si ce serveur est cach&eacute;
     par un autre mandataire direct.</p>
 </usage>
@@ -1480,7 +1480,7 @@ ProxyPass "/" "balancer://hotcluster/ "
     utilisent <var>PATH_INFO</var>. Le mot-cl&eacute; optionnel
     <var>nocanon</var> modifie ce comportement et permet de transmettre
     le chemin d'URL sous sa forme brute au serveur d'arri&egrave;re-plan. Notez
-    que ceci peut affecter la s&eacute;curit&eacute; de votre serveur d'arri&egrave;re-plan,
+    que ce mot-cl&eacute; peut affecter la s&eacute;curit&eacute; de votre serveur d'arri&egrave;re-plan,
     car la protection limit&eacute;e contre les attaques &agrave; base d'URL que
     fournit le mandataire est alors supprim&eacute;e.</p>
 
@@ -1654,8 +1654,8 @@ par un serveur mandat&eacute; en inverse</description>
     </p>
 
     <p><var>chemin</var> est le nom d'un chemin virtuel local.
-    <var>url</var> est une URL partielle pour le serveur distant - ils
-    sont utilis&eacute;s de la m&ecirc;me fa&ccedil;on qu'avec la directive <directive
+    <var>url</var> est une URL partielle pour le serveur distant. Ces
+    param&egrave;tres sont utilis&eacute;s de la m&ecirc;me fa&ccedil;on qu'avec la directive <directive
     module="mod_proxy">ProxyPass</directive>.</p>
 
     <p>Supposons par exemple que le serveur local a pour adresse
@@ -1673,7 +1673,7 @@ ProxyPassReverseCookiePath  "/"  "/mirror/foo/"
     requ&ecirc;te mandat&eacute;e pour <code>http://backend.example.com/bar</code>
     (la fonctionnalit&eacute; fournie par <code>ProxyPass</code>). Il va
     aussi s'occuper des redirections que le serveur
-    <code>backend.example.com</code> envoie lorsque
+    <code>backend.example.com</code> envoie lorsque
     <code>http://backend.example.com/bar</code> est redirig&eacute; par
     celui-ci vers <code>http://backend.example.com/quux</code>, Apache
     httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
@@ -1683,8 +1683,9 @@ ProxyPassReverseCookiePath  "/"  "/mirror/foo/"
     module="core">UseCanonicalName</directive>.</p>
 
     <p>Notez que la directive <directive>ProxyPassReverse</directive>
-    peut aussi &ecirc;tre utilis&eacute;e en conjonction avec la fonctionnalit&eacute;
-    pass-through (<code>RewriteRule ...  [P]</code>) du module
+    peut aussi &ecirc;tre utilis&eacute;e en conjonction avec la
+    fonctionnalit&eacute; de mandataire
+    (<code>RewriteRule ...  [P]</code>) du module
     <module>mod_rewrite</module>, car elle ne d&eacute;pend pas d'une directive
     <directive module="mod_proxy">ProxyPass</directive>
     correspondante.</p>
@@ -2208,8 +2209,8 @@ les configurations de mandataires inverses</description>
     <directive>ProxyPassReverseCookiePath</directive>, en leur indiquant
     de remplacer la cha&icirc;ne <code>${nom_var}</code> dans les directives
     de configuration par la valeur de la variable d'environnement
-    <code>nom_var</code> (si l'option <var>interpolate</var> est
-    sp&eacute;cifi&eacute;e).</p>
+    <code>nom_var</code> si l'option <var>interpolate</var> est
+    sp&eacute;cifi&eacute;e.</p>
     <p>Conservez cette directive &agrave; off (pour les performances du
     serveur), sauf si vous en avez r&eacute;ellement besoin.</p>
 </usage>
index 4cb3b6ad5aed1c7cee35ac9b35e64c5b6187eee0..7db59f426f33d2d2f26594b7c999737cd63abbd7 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1" ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1674195:1693963 (outdated) -->
+<!-- English Revision: 1693963 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -153,6 +153,15 @@ suivante :</p>
 [CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly]
 </example>
 
+<p>Si un caract&egrave;re litt&eacute;ral ':' doit &ecirc;tre ins&eacute;rer dans un des champs du
+cookie, une autre syntaxe est disponible. Pour utiliser cette syntaxe
+alternative, le contenu du champ "Name" doit &ecirc;tre pr&eacute;c&eacute;d&eacute; du caract&egrave;re
+';', et les s&eacute;pateurs de champs deviendront des ';'.</p>
+
+<example>
+[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly]
+</example>
+
 <p>Vous devez d&eacute;clarer un nom, une valeur et un domaine pour que
 le cookie puisse &ecirc;tre d&eacute;fini.</p>