httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject svn commit: r1527200 - in /httpd/httpd/trunk/docs/manual: mod/core.xml.fr mod/mod_authnz_ldap.xml.fr mod/mod_macro.xml.fr ssl/ssl_intro.xml.fr
Date Sat, 28 Sep 2013 15:22:23 GMT
Author: lgentis
Date: Sat Sep 28 15:22:23 2013
New Revision: 1527200

URL: http://svn.apache.org/r1527200
Log:
Updates.

Modified:
    httpd/httpd/trunk/docs/manual/mod/core.xml.fr
    httpd/httpd/trunk/docs/manual/mod/mod_authnz_ldap.xml.fr
    httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr
    httpd/httpd/trunk/docs/manual/ssl/ssl_intro.xml.fr

Modified: httpd/httpd/trunk/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml.fr?rev=1527200&r1=1527199&r2=1527200&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml.fr Sat Sep 28 15:22:23 2013
@@ -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 : 1438838 -->
+<!-- English Revision : 1525597 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -170,7 +170,7 @@ nom de chemin en fin de requ&ecirc;te.</
     href="../handler.html">gestionnaire</a> responsable de la requ&ecirc;te.
     Le gestionnaire de base pour les fichiers normaux rejette par d&eacute;faut
     les requ&ecirc;tes avec <code>PATH_INFO</code>. Les gestionnaires qui
-    servent des scripts, comme <a
+    servent des scripts, comme<a
     href="mod_cgi.html">cgi-script</a> et <a
     href="mod_isapi.html">isapi-handler</a>, acceptent en g&eacute;n&eacute;ral
par
     d&eacute;faut les requ&ecirc;tes avec <code>PATH_INFO</code>.</dd>
@@ -1422,7 +1422,8 @@ host</context>
 
     <p>L'utilisation de <code>syslog</code> &agrave; la place d'un
nom de
     fichier active la journalisation via syslogd(8) si le syst&egrave;me le
-    supporte. Le dispositif syslog par d&eacute;faut est <code>local7</code>,
+    supporte et si <module>mod_syslog</module> a &eacute;t&eacute; charg&eacute;.
Le
+    dispositif syslog par d&eacute;faut est <code>local7</code>,
     mais vous pouvez le modifier &agrave; l'aide de la syntaxe
     <code>syslog:<var>facility</var></code>, o&ugrave; <var>facility</var>
peut
     &ecirc;tre remplac&eacute; par un des noms habituellement document&eacute;s
dans la page
@@ -1432,6 +1433,10 @@ host</context>
 
     <highlight language="config">ErrorLog syslog:user</highlight>
 
+    <p>Des modules additionnels peuvent impl&eacute;menter leur propre
+    fournisseur ErrorLog. La syntaxe est similaire &agrave; l'exemple
+    <code>syslog</code> ci-dessus.</p>
+
     <p>SECURITE : Voir le document <a
     href="../misc/security_tips.html#serverroot">conseils &agrave; propos de
     s&eacute;curit&eacute;</a> pour des d&eacute;tails sur les raisons
pour lesquelles votre

Modified: httpd/httpd/trunk/docs/manual/mod/mod_authnz_ldap.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_authnz_ldap.xml.fr?rev=1527200&r1=1527199&r2=1527200&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_authnz_ldap.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_authnz_ldap.xml.fr Sat Sep 28 15:22:23 2013
@@ -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 : 1510426 -->
+<!-- English Revision : 1525866 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -1206,12 +1206,13 @@ appartenance &agrave; un groupe</descrip
 maximale prise en compte avant l'abandon de la recherche de
 l'utilisateur.</description>
 <syntax>AuthLDAPMaxSubGroupDepth <var>Nombre</var></syntax>
-<default>AuthLDAPMaxSubGroupDepth 10</default>
+<default>AuthLDAPMaxSubGroupDepth 0</default>
 <contextlist><context>directory</context><context>.htaccess</context>
 </contextlist>
 <override>AuthConfig</override>
 <compatibility>Disponible &agrave; partir de la version 2.3.0 du serveur HTTP
-Apache</compatibility>
+Apache ; la valeur par d&eacute;faut &eacute;tait 10 dans les versions 2.4.x et les
+premi&egrave;res versions 2.5</compatibility>
 
 <usage>
    <p>Lorsque cette directive est d&eacute;finie &agrave; une valeur <code>X</code>
@@ -1223,6 +1224,17 @@ Apache</compatibility>
    d'imbrication maximale <code>X</code> sp&eacute;cifi&eacute;e par
la directive.</p>
    <p>Se r&eacute;f&eacute;rer &agrave; la section <a href="#reqgroup"><code>Require
    ldap-group</code></a> pour un exemple plus d&eacute;taill&eacute;.</p>
+
+   <note><title>Performances dans le cas des groupes imbriqu&eacute;s</title>
+   <p>Lorsque les directives
+   <directive>AuthLDAPSubGroupAttribute</directive> et
+   <directive>AuthLDAPGroupAttribute</directive> se recouvrent (comme
+   c'est le cas par d&eacute;faut et requis par les sch&eacute;mas LDAP courants),
la
+   recherche de sous-groupes au sein de grands groupes peut &ecirc;tre tr&egrave;s
+   longue. Si vos groupes sont tr&egrave;s grands et non imbriqu&eacute;s, d&eacute;finissez
+   la directive <directive>AuthLDAPMaxSubGroupDepth</directive> &agrave;
0.</p>
+   </note>
+
 </usage>
 </directivesynopsis>
 

Modified: httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr?rev=1527200&r1=1527199&r2=1527200&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr Sat Sep 28 15:22:23 2013
@@ -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: 1524240:1525479 (outdated) -->
+<!-- English Revision: 1525479 -->
 <!-- French translation: Fabien Coelho -->
 <!-- Updated by Lucien Gentis -->
 
@@ -33,81 +33,105 @@ de configuration Apache.</description>
 
 <summary>
 
-    <p>Ce module permet de d&eacute;finir et d'utiliser des macros dans les fichiers
-    de configuration Apache. Ces macros peuvent avoir des param&egrave;tres qui sont
-    expans&eacute;s &agrave; l'utilisation (les param&egrave;tres sont remplac&eacute;s
par la valeur
-    pass&eacute;e en argument), et le r&eacute;sultat de la substitution est trait&eacute;
-    normalement.</p>
-</summary>
+    <p>Ce module permet d'utiliser des macros dans les fichiers de
+    configuration &agrave; l'ex&eacute;cution du serveur HTTP Apache afin de faciliter
+    la cr&eacute;ation de nombreux blocs de configuration similaires. Quand le
+    serveur d&eacute;marre, les macros sont ex&eacute;cut&eacute;es avec les
param&egrave;tres
+    fournis, et le r&eacute;sultat obtenu est trait&eacute; au m&ecirc;me titre
que le reste
+    du fichier de configuration.</p>
 
-<section id="features"><title>Caract&eacute;ristiques</title>
+</summary>
 
-    <p>D&eacute;finition d'une macro :</p>
-    <ul>
-    <li> dans une section &lt;Macro&gt; au style conforme &agrave; la
-         syntaxe des fichiers de configuration Apache.</li>
-    <li> l'utilisateur choisit le nom de la macro et de ses param&egrave;tres.</li>
-    <li> les noms de macro sont insensibles &agrave; la casse, comme les directives
Apache.</li>
-    <li> les noms de param&egrave;tres sont par contre sensibles &agrave; la
casse.</li>
-    <li> les param&egrave;tres d'une macro doivent avoir des noms distincts.</li>
-    <li> il y a une erreur si un param&egrave;tre a un nom vide.</li>
-    <li> la red&eacute;finition d'une macro g&eacute;n&egrave;re un avertissement.</li>
-    <li> des d&eacute;finitions de macros peuvent &ecirc;tre imbriqu&eacute;es
les unes dans les autres... (mais dans quel but ?)</li>
-    <li> les param&egrave;tres inutilis&eacute;s g&eacute;n&egrave;rent
un avertissement.</li>
-    <li> les noms de param&egrave;tre en pr&eacute;fixe les uns des autres
g&eacute;n&egrave;rent un avertissement.</li>
-    <li> les noms de param&egrave;tre non pr&eacute;fix&eacute;s par un
des caract&egrave;res '<code>$%@</code>' g&eacute;n&egrave;rent un
-         avertissement pour encourager cette bonne pratique.</li>
-    <li> les diff&eacute;rents pr&eacute;fixes propos&eacute;s permettent
de g&eacute;rer les interactions
-         avec d'autres directives comme <directive module="core">Define</directive>.</li>
-    <li> un conseil : il peut &ecirc;tre utile d'ajouter des accolades autour du
nom d'un
-         param&egrave;tre, par exemple <code>${foo}</code>, de mani&egrave;re
&agrave; ce que le
-         param&egrave;tre puisse &ecirc;tre utilis&eacute; entour&eacute;
de caract&egrave;res,
-         par exemple <code>bla${foo}bla</code>.</li>
-    <li> g&eacute;n&egrave;re un avertissement si le contenu de la macro est
vide.</li>
-    <li> g&eacute;n&egrave;re un avertissement si le syst&egrave;me d&eacute;tecte
que les sections &agrave; l'int&eacute;rieur
-         d'une macro ne sont pas correctement imbriqu&eacute;es.</li>
-    <li> la port&eacute;e lexicale des param&egrave;tres d'une macro est restreinte
au texte
-         de la macro elle-m&ecirc;me... en particulier elle n'est pas propag&eacute;e
aux inclusions.</li>
-    <li> il n'y a pas de contrainte sur le contenu d'une macro.
-         <p>Cela signifie que vous pouvez mettre une section perl ou n'importe
-         quoi d'autre dans une macro. Il n'y a pas d'autre contrainte sur la
-         structure lexicale et syntaxique de la macro (guillemets, espaces...)
-         que d'attendre une s&eacute;quence de ligne avec &eacute;ventuellement des
-         continuations.</p></li>
-    </ul>
-
-    <p>Utilisation d'une macro:</p>
-    <ul>
-    <li> le nombre d'arguments doit &ecirc;tre coh&eacute;rent avec la d&eacute;finition.</li>
-    <li> toutes les occurences des param&egrave;tres sont substitu&eacute;es
par leur valeur.</li>
-    <li> en cas de conflit, le nom le plus long est choisi.</li>
-    <li> une r&eacute;cursion dans l'expansion d'une macro est d&eacute;tect&eacute;e
et interrompue avec envoi d'un message d'erreur.</li>
-    <li> si un argument vide est d&eacute;tect&eacute;, un avertissement est
g&eacute;n&eacute;r&eacute;.</li>
-    <li> le syst&egrave;me s'efforce de g&eacute;n&eacute;rer une description
pr&eacute;cise de la localisation des erreurs.</li>
-    <li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;es par
<code>$</code> et <code>%</code> ne sont pas &eacute;chapp&eacute;es.</li>
-    <li> les valeurs des param&egrave;tres pr&eacute;fix&eacute;es par
<code>@</code> sont &eacute;chapp&eacute;es par des guillemets.</li>
-    </ul>
-
-    <p>Suppression de la d&eacute;finition d'une macro :</p>
-    <ul>
-    <li> la macro supprim&eacute;e doit avoir &eacute;t&eacute; d&eacute;finie
auparavant.</li>
-    </ul>
+<section id="usage"><title>Utilisation</title>    
+<p>On d&eacute;finit une macro &agrave; l'aide des blocs <directive
+type="section">Macro</directive> qui contiennent la portion de votre
+configuration qui intervient de mani&egrave;re r&eacute;p&eacute;titive, y compris
les
+variables pour les parties qui devront &ecirc;tre substitu&eacute;es.</p>
+
+<p>Par exemple, vous pouvez utiliser une macro pour d&eacute;finir un bloc
+<directive type="section">VirtualHost</directive>, afin de pouvoir
+d&eacute;finir de nombreux serveurs virtuels similaires :</p>    
 
     <highlight language="config">
-&lt;Macro DirGroup $dir $group&gt;
-  &lt;Directory $dir&gt;
-    require group $group
-  &lt;/Directory&gt;
+&lt;Macro VHost $name $domain&gt;
+&lt;VirtualHost *:80&gt;
+    ServerName $domain
+    ServerAlias www.$domain
+
+    DocumentRoot /var/www/vhosts/$name
+    ErrorLog /var/log/httpd/$name.error_log
+    CustomLog /var/log/httpd/$name.access_log combined
+&gt;/VirtualHost&gt;
 &lt;/Macro&gt;
+</highlight>
 
-Use DirGroup /www/apache/private private
-Use DirGroup /www/apache/server  admin
+<p>Comme les directives de configuration httpd, les noms des macros sont
+insensibles &agrave; la casse, &agrave; la diff&eacute;rence des variables qui
y sont, elles,
+sensibles.</p>
 
-UndefMacro DirGroup
+<p>Vous pouvez alors invoquer cette macro autant de fois que vous le
+voulez pour cr&eacute;er des serveurs virtuels </p>
+
+<highlight language="config">
+Use VHost example example.com
+Use VHost myhost hostname.org
+Use VHost apache apache.org
+
+UndefMacro VHost
     </highlight>
+
+<p>Au d&eacute;marrage du serveur, chacune de ces invocations
+<directive>Use</directive> sera remplac&eacute;e par une d&eacute;finition
de serveur
+virtuel compl&egrave;te, comme d&eacute;crit dans la d&eacute;finition de la
+<directive>Macro</directive>.</p>
+
+<p>La directive <directive>UndefMacro</directive> permet d'&eacute;viter
les
+conflits de d&eacute;finitions qui pourraient provenir de l'utilisation
+ult&eacute;rieure de macros contenant les m&ecirc;mes noms de variables.</p>
+
+<p>Vous trouverez une version plus &eacute;labor&eacute;e de cet exemple plus
loin
+dans la section Exemples.</p>
+
+</section>
+
+<section id="tips"><title>Conseils</title>
+
+<p>Les noms de param&egrave;tres doivent commencer par un sigil tel que
+<code>$</code>, <code>%</code>, ou <code>@</code>, de
fa&ccedil;on &agrave; ce qu'ils
+soient clairement identifiables, mais aussi afin de faciliter les
+interactions avec les autres directives, comme la directive de base
+<directive module="core">Define</directive>. Dans le cas contraire, vous
+recevrez un avertissement. En tout &eacute;tat de cause, il est conseill&eacute;
+d'avoir une bonne connaissance globale de la configuration du serveur,
+afin d'&eacute;viter la r&eacute;utilisation des m&ecirc;mes variables &agrave;
diff&eacute;rents niveaux,
+ce qui peut &ecirc;tre &agrave; l'origine de confusions.</p>
+
+<p>Les param&egrave;tres pr&eacute;fix&eacute;s par <code>$</code>
ou <code>%</code> ne sont
+pas &eacute;chapp&eacute;s. Les param&egrave;tres pr&eacute;fix&eacute;s
par <code>@</code> sont &eacute;chapp&eacute;s
+entre guillemets.</p>
+
+<p>Evitez de pr&eacute;fixer un param&egrave;tre par le nom d'un autre param&egrave;tre
(par
+exemple, pr&eacute;sence simultan&eacute;e des param&egrave;tres <code>$win</code>
et
+<code>$winter</code>), car ceci peut introduire de la confusion lors de
+l'&eacute;valuation des expressions. Si cela se produit, c'est le nom de
+param&egrave;tre le plus long possible qui sera utilis&eacute;.</p>
+
+<p>Si vous d&eacute;sirez ins&eacute;rer une valeur dans une cha&icirc;ne,
il est conseill&eacute;
+de l'entourer d'accolades afin d'&eacute;viter toute confusion :</p>
+
+<highlight language="config">
+&lt;Macro DocRoot ${docroot}&gt;
+    DocumentRoot /var/www/${docroot}/htdocs
+&lt;/Macro&gt;
+</highlight>
+
 </section>
 
-<section id="examples"><title>Exemples</title>
+<section id="examples">
+<title>Exemples</title>
+
+<section>
+<title>D&eacute;finition de serveurs virtuels</title>
 
 <p>Un exemple typique d'utilisation de <module>mod_macro</module> est la
 cr&eacute;ation dynamique de serveurs virtuels.</p>
@@ -122,8 +146,9 @@ cr&eacute;ation dynamique de serveurs vi
     ServerName $host
     DocumentRoot $dir
 
+    # Racine des documents publique
     &lt;Directory $dir&gt;
-      # directives propres au r&eacute;pertoire $dir ...
+      Require all granted
     &lt;/Directory&gt;
 
     # restriction d'acc&egrave;s au sous-r&eacute;pertoire intranet.
@@ -139,8 +164,32 @@ Use VHost www.apache.org 80 /vhosts/apac
 Use VHost example.org 8080 /vhosts/example/htdocs
 Use VHost www.example.fr 1234 /vhosts/example.fr/htdocs
 </highlight>
+</section> <!-- Vhosts -->
 
-</section>
+<section>
+<title>Suppression d'une d&eacute;finition de macro</title>
+
+<p>Il est recommand&eacute; de supprimer la d&eacute;finition d'une macro apr&egrave;s
+l'avoir utilis&eacute;e. Ceci permet d'&eacute;viter les confusions au sein d'un
+fichier de configuration complexe o&ugrave; des conflits entre noms de
+variables peuvent survenir.</p>
+
+<highlight language="config">
+&lt;Macro DirGroup $dir $group&gt;
+  &lt;Directory $dir&gt;
+    Require group $group
+  &lt;/Directory&gt;
+&lt;/Macro&gt;
+
+Use DirGroup /www/apache/private private
+Use DirGroup /www/apache/server  admin
+
+UndefMacro DirGroup
+</highlight>
+
+</section> <!-- UndefMacro -->
+
+</section> <!-- Example -->
 
 <!-- Macro -->
 <directivesynopsis type="section">
@@ -233,4 +282,5 @@ UndefMacro RestrictedAccessPolicy
     </highlight>
 </usage>
 </directivesynopsis>
+
 </modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/ssl/ssl_intro.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/ssl/ssl_intro.xml.fr?rev=1527200&r1=1527199&r2=1527200&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/ssl/ssl_intro.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/ssl/ssl_intro.xml.fr Sat Sep 28 15:22:23 2013
@@ -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 : 1328589 -->
+<!-- English revision : 1525489 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -414,42 +414,38 @@ l'&eacute;tablissement de la session pro
     <tr><th>Version</th>
         <th>Source</th>
         <th>Description</th>
-        <th>Navigateurs support&eacute;s</th></tr>
+    </tr>
     <tr><td>SSL v2.0</td>
         <td>Standard du fournisseur (de Netscape Corp.)</td>
         <td>Premier protocole SSL pour lequel il existe des impl&eacute;mentations</td>
-        <td>- NS Navigator 1.x/2.x<br />
-        - MS IE 3.x<br />
-        - Lynx/2.8+OpenSSL</td></tr>
+    </tr>
     <tr><td>SSL v3.0</td>
         <td>Projet Internet arriv&eacute; &agrave; expiration (de Netscape
Corp.) [<a href="#SSL3"
         >SSL3</a>]</td>
         <td>Comporte des r&eacute;visions permettant de pr&eacute;venir certaines
attaques de
 	s&eacute;curit&eacute; sp&eacute;cifiques, ajout de chiffrements non RSA, et
support des
 	cha&icirc;nes de certification</td>
-        <td>- NS Navigator 2.x/3.x/4.x<br />
-        - MS IE 3.x/4.x<br />
-        - Lynx/2.8+OpenSSL</td></tr>
+    </tr>
     <tr><td>TLS v1.0</td>
         <td>Standard propos&eacute; pour l'Internet (de l'IETF) [<a href="#TLS1"
         >TLS1</a>]</td>
         <td>R&eacute;vision de SSL 3.0 pour mettre &agrave; jour la couche
MAC vers HMAC,
 	ajout du bourrage de bloc pour le chiffrement de bloc, standardisation
 	de l'ordonnancement des messages et plus de messages d'alerte.</td>
-        <td>- Lynx/2.8+OpenSSL</td></tr>
-	<tr><td>TLS v1.1</td>
+    </tr>
+    <tr><td>TLS v1.1</td>
         <td>Standard propos&eacute; pour l'Internet (de l'IETF) [<a href="#TLS11"
         >TLS11</a>]</td>
         <td>Mise &agrave; jour de TLS 1.0 pour la protection contre les
 	attaques de type Cipher block chaining (CBC).</td>
-        <td>-</td></tr>
+    </tr>
     <tr><td>TLS v1.2</td>
         <td>Standard propos&eacute; pour l'Internet (de l'IETF) [<a href="#TLS12"
         >TLS12</a>]</td>
         <td>Mise &agrave; jour de TLS 1.2 rendant les condens&eacute;s MD5
obsol&egrave;tes,
 	et introduisant une incompatibilit&eacute; avec SSL ce qui interdit toute
 	n&eacute;gociation en vue d'une utilisation de SSLv2.</td>
-        <td>-</td></tr>
+    </tr>
     </table>
 </section>
 



Mime
View raw message