1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>Support des objets dynamiques partag�s (DSO) - Serveur Apache HTTP</title> 9<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" /> 12<script src="./style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="./images/favicon.ico" rel="shortcut icon" /></head> 16<body id="manual-page"><div id="page-header"> 17<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p> 18<p class="apache">Serveur Apache HTTP Version 2.4</p> 19<img alt="" src="./images/feather.gif" /></div> 20<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div> 21<div id="path"> 22<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Support des objets dynamiques partag�s (DSO)</h1> 23<div class="toplang"> 24<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> | 25<a href="./fr/dso.html" title="Fran�ais"> fr </a> | 26<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 27<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 28<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 29</div> 30 31 <p>La conception modulaire du serveur HTTP Apache permet � l'administrateur 32 de choisir les fonctionnalit�s � inclure dans le serveur en s�lectionnant 33 un certain nombre de modules. Les modules seront compil�s en tant 34 qu'Objets Dynamiques Partag�s (Dynamic Shared Objects ou DSOs) 35 qui m�nent une existence s�par�e du fichier binaire principal 36 <code class="program"><a href="./programs/httpd.html">httpd</a></code>. Les modules DSO peuvent �tre compil�s en 37 m�me temps que le serveur, ou compil�s et ajout�s ult�rieurement via 38 l'Outil des Extensions � Apache (Apache Extension Tool ou 39 <code class="program"><a href="./programs/apxs.html">apxs</a></code>).</p> 40 <p>Les modules peuvent aussi �tre int�gr�s statiquement dans le 41 binaire <code class="program"><a href="./programs/httpd.html">httpd</a></code> lors de la compilation de ce 42 dernier.</p> 43 44 <p>Ce document d�crit l'utilisation des modules DSO ainsi que les dessous 45 de leur fonctionnement.</p> 46 </div> 47<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Impl�mentation</a></li> 48<li><img alt="" src="./images/down.gif" /> <a href="#usage">Mode d'emploi succinct</a></li> 49<li><img alt="" src="./images/down.gif" /> <a href="#background">Les dessous du fonctionnement des DSO</a></li> 50<li><img alt="" src="./images/down.gif" /> <a href="#advantages">Avantages et inconv�nients</a></li> 51</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 52<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 53<div class="section"> 54<h2><a name="implementation" id="implementation">Impl�mentation</a></h2> 55 56<table class="related"><tr><th>Modules Apparent�s</th><th>Directives Apparent�es</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table> 57 58 <p>Le support DSO pour le chargement de modules individuels d'Apache 59 httpd est 60 assur� par un module nomm� <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> qui doit �tre compil� 61 statiquement dans le coeur d'Apache httpd. Il s'agit du seul module avec le 62 module <code class="module"><a href="./mod/core.html">core</a></code> � ne pas pouvoir �tre compil� en tant que 63 module DSO lui-m�me. Pratiquement tous les autres modules d'Apache httpd 64 distribu�s seront alors compil�s en tant que modules DSO. Une fois 65 compil� en tant que module DSO nomm� <code>mod_foo.so</code>, un 66 module peut �tre charg� en m�moire au 67 d�marrage ou red�marrage du serveur � l'aide de 68 la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du module 69 <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>, plac�e 70 dans votre fichier <code>httpd.conf</code>.</p> 71 <p>La compilation en mode DSO peut �tre d�sactiv�e pour certains 72 modules via l'option <code>--enable-mods-static</code> du script 73 <code class="program"><a href="./programs/configure.html">configure</a></code>, comme expliqu� dans la <a href="install.html">Documentation sur l'installation</a>.</p> 74 75 <p>Un utilitaire permet de simplifier la cr�ation de 76 fichiers DSO pour les modules d'Apache httpd 77 (particuli�rement pour les modules tiers) ; il s'agit du programme nomm� 78 <code class="program"><a href="./programs/apxs.html">apxs</a></code> (<dfn>APache 79 eXtenSion</dfn>). On peut l'utiliser pour construire des modules de type 80 DSO <em>en dehors</em> de l'arborescence des sources d'Apache httpd. L'id�e est 81 simple : � l'installation du serveur HTTP Apache, la proc�dure <code>make install</code> 82 du script <code class="program"><a href="./programs/configure.html">configure</a></code> installe les fichiers d'en-t�tes 83 d'Apache httpd et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de 84 l'�diteur de liens � l'int�rieur du programme 85 <code class="program"><a href="./programs/apxs.html">apxs</a></code>, qui sera utilis� pour la construction de fichiers DSO. 86 Il est ainsi possible d'utiliser le programme <code class="program"><a href="./programs/apxs.html">apxs</a></code> 87 pour compiler ses sources de modules Apache httpd sans avoir besoin de 88 l'arborescence des sources de la distribution d'Apache, et sans avoir � 89 r�gler les drapeaux du compilateur et de l'�diteur de liens pour le support DSO.</p> 90</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 91<div class="section"> 92<h2><a name="usage" id="usage">Mode d'emploi succinct</a></h2> 93 94 <p>Afin que vous puissiez vous faire une id�e des fonctionnalit�s DSO 95 du serveur HTTP Apache 2.x, en voici un r�sum� court et concis :</p> 96 97 <ol> 98 <li> 99 <p>Construire et installer un module Apache httpd <em>faisant partie de la 100 distribution</em>, par exemple <code>mod_foo.c</code>, 101 en tant que module DSO <code>mod_foo.so</code> :</p> 102 103<div class="example"><p><code> 104$ ./configure --prefix=/chemin/vers/installation --enable-foo<br /> 105$ make install 106</code></p></div> 107 </li> 108 109 <li> 110 <p>Configure le serveur HTTP Apache avec tous les modules 111 activ�s. Seul un jeu de modules de base sera charg� au 112 d�marrage du serveur. Vous pouvez modifier ce jeu de modules 113 charg�s au d�marrage en activant ou d�sactivant les directives <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> correspondantes dans le 114 fichier <code>httpd.conf</code>.</p> 115 116<div class="example"><p><code> 117$ ./configure --enable-mods-shared=all<br /> 118$ make install 119</code></p></div> 120 121 <p>L'argument <code>most</code> de l'option 122 <code>--enable-modules</code> indique que tous les modules 123 non-exp�rimentaux ou qui ne sont pas l� � titre d'exemple seront 124 compil�s.</p> 125 </li> 126 127 <li> 128 <p>Certains modules ne sont utilis�s que par les d�veloppeurs et 129 ne seront pas compil�s. Si vous voulez les utiliser, sp�cifiez 130 l'option <em>all</em>. Pour compiler tous les modules disponibles, 131 y compris les modules de d�veloppeurs, sp�cifiez l'option 132 <em>reallyall</em>. En outre, la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> peut �tre activ�e pour tous 133 les modules compil�s via l'option du script configure 134 <code>--enable-load-all-modules</code>.</p> 135 136<div class="example"><p><code> 137$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br /> 138$ make install 139</code></p></div> 140 </li> 141 142 <li> 143 Construire et installer un module Apache httpd <em>tiers</em>, par exemple 144 <code>mod_foo.c</code>, en tant que module DSO 145 <code>mod_foo.so</code> <em>en dehors</em> de l'arborescence des sources 146 d'Apache httpd � l'aide du programme <code class="program"><a href="./programs/apxs.html">apxs</a></code> : 147 148<div class="example"><p><code> 149$ cd /chemin/vers/module_tiers<br /> 150$ apxs -cia mod_foo.c 151</code></p></div> 152 </li> 153 </ol> 154 155 <p>Dans tous les cas, une fois le module partag� compil�, vous devez 156 ajouter une directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> 157 dans le fichier <code>httpd.conf</code> pour qu'Apache httpd active le module.</p> 158 159 <p>Voir la <a href="programs/apxs.html">documentation sur apxs</a> 160 pour plus de d�tails.</p> 161</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 162<div class="section"> 163<h2><a name="background" id="background">Les dessous du fonctionnement des DSO</a></h2> 164 165 <p>Les cl�nes modernes d'UNIX proposent un m�canisme 166 appel� �dition de liens et chargement dynamiques d' 167 <em>Objets Dynamiques Partag�s</em> (DSO), qui permet de construire un 168 morceau de programme dans un format sp�cial pour le rendre chargeable 169 � l'ex�cution dans l'espace d'adressage d'un programme ex�cutable.</p> 170 171 <p>Ce chargement peut s'effectuer de deux mani�res : automatiquement par 172 un programme syst�me appel� <code>ld.so</code> quand un programme 173 ex�cutable est d�marr�, ou manuellement � partir du programme en cours 174 d'ex�cution via sa propre interface syst�me vers le chargeur Unix � l'aide 175 des appels syst�me <code>dlopen()/dlsym()</code>.</p> 176 177 <p>Dans la premi�re m�thode, les DSO sont en g�n�ral appel�s 178 <em>biblioth�ques partag�es</em> ou encore <em>biblioth�ques DSO</em>, et 179 poss�dent des noms du style 180 <code>libfoo.so</code> ou <code>libfoo.so.1.2</code>. Ils r�sident dans un 181 r�pertoire syst�me (en g�n�ral <code>/usr/lib</code>) 182 et le lien avec le programme ex�cutable est �tabli � la compilation en 183 ajoutant <code>-lfoo</code> � la commande de l'�diteur de liens. Les 184 r�f�rences � la biblioth�que sont ainsi cod�es en dur dans le fichier du 185 programme ex�cutable de fa�on � ce qu'au d�marrage du programme, le 186 chargeur Unix soit capable de localiser <code>libfoo.so</code> dans 187 <code>/usr/lib</code>, dans des chemins cod�s en dur � l'aide d'options de 188 l'�diteur de liens comme <code>-R</code> ou dans des chemins d�finis par la 189 variable d'environnement 190 <code>LD_LIBRARY_PATH</code>. Le chargeur peut d�s lors r�soudre tous les symboles 191 (jusque l� non encore r�solus) du DSO dans le programme ex�cutable.</p> 192 193 <p>Les symboles du programme ex�cutable ne sont en g�n�ral pas 194 r�f�renc�s par le DSO (car c'est une biblioth�que de code � usage g�n�ral 195 et r�utilisable), 196 et ainsi aucune r�solution suppl�mentaire n'est n�cessaire. De son c�t�, 197 le programme ex�cutable ne doit accomplir aucune action particuli�re 198 pour utiliser les 199 symboles du DSO car toutes les r�solutions sont effectu�es par le chargeur 200 Unix. En fait, le code permettant d'invoquer 201 <code>ld.so</code> fait partie du code de d�marrage pour l'ex�cution qui 202 est li� dans tout programme ex�cutable non statiquement li�. 203 L'avantage du chargement dynamique du code d'une biblioth�que partag�e est 204 �vident : le code de la biblioth�que ne doit �tre stock� qu'une seule fois 205 dans une biblioth�que syst�me telle que <code>libc.so</code>, ce qui permet 206 d'�conomiser de l'espace disque pour les autres programmes.</p> 207 208 <p>Dans la seconde m�thode, les DSO sont en g�n�ral appel�s <em>objets 209 partag�s</em> ou <em>fichiers DSO</em>, et peuvent �tre nomm�s avec 210 l'extension de son choix (bien que le nom conseill� soit du style 211 <code>foo.so</code>). Ces fichiers r�sident en g�n�ral dans un r�pertoire 212 sp�cifique � un programme, et aucun lien n'est automatiquement �tabli avec 213 le programme ex�cutable dans lequel ils sont utilis�s. 214 Le programme ex�cutable charge manuellement le DSO � l'ex�cution dans son 215 espace d'adressage � l'aide de l'appel syst�me <code>dlopen()</code>. 216 A ce moment, aucune r�solution de symboles du DSO n'est effectu�e pour le 217 programme ex�cutable. Par contre le chargeur Unix 218 r�soud automatiquement tout symbole du DSO (non encore r�solu) 219 faisant partie de l'ensemble de symboles export� par le programme 220 ex�cutable et ses biblioth�ques DSO d�j� charg�es (et en particulier tous 221 les symboles de la biblioth�que � tout faire <code>libc.so</code>). 222 De cette fa�on, le DSO prend connaissance de l'ensemble de symboles du 223 programme ex�cutable comme s'il avait �t� li� statiquement avec lui 224 auparavant.</p> 225 226 <p>Finalement, pour tirer profit de l'API des DSO, le programme ex�cutable 227 doit r�soudre certains symboles du DSO � l'aide de l'appel syst�me 228 <code>dlsym()</code> pour une utilisation ult�rieure dans les tables de 229 distribution, <em>etc...</em> En d'autres termes, le programme ex�cutable doit 230 r�soudre manuellement tous les symboles dont il a besoin pour pouvoir les 231 utiliser. 232 Avantage d'un tel m�canisme : les modules optionnels du programme n'ont pas 233 besoin d'�tre charg�s (et ne gaspillent donc pas de ressources m�moire) 234 tant qu'il ne sont pas n�cessaires au programme en question. Si n�cessaire, 235 ces modules peuvent �tre charg�s dynamiquement afin d'�tendre les 236 fonctionnalit�s de base du programme.</p> 237 238 <p>Bien que ce m�canisme DSO paraisse �vident, il comporte au moins une 239 �tape difficile : la r�solution des symboles depuis le programme ex�cutable 240 pour le DSO lorsqu'on utilise un DSO pour �tendre les fonctionnalit�s d'un 241 programme (la seconde m�thode). Pourquoi ? Parce que la "r�solution 242 inverse" des symboles DSO � partir du jeu de symboles du programme 243 ex�cutable d�pend de la conception de la biblioth�que (la biblioth�que n'a 244 aucune information sur le programme qui l'utilise) et n'est ni standardis�e 245 ni disponible sur toutes les plateformes. En pratique, les symboles globaux 246 du programme ex�cutable ne sont en g�n�ral pas r�export�s et donc 247 indisponibles pour l'utilisation dans un DSO. Trouver une m�thode pour 248 forcer l'�diteur de liens � exporter tous les symboles globaux est le 249 principal probl�me que l'on doit r�soudre lorsqu'on utilise un DSO pour 250 �tendre les fonctionnalit�s d'un programme au moment de son ex�cution.</p> 251 252 <p>L'approche des biblioth�ques partag�es est la plus courante, parce que 253 c'est dans cette optique que le m�canisme DSO a �t� con�u ; c'est cette 254 approche qui est ainsi 255 utilis�e par pratiquement tous les types de biblioth�ques que fournit le 256 syst�me d'exploitation.</p> 257 258</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 259<div class="section"> 260<h2><a name="advantages" id="advantages">Avantages et inconv�nients</a></h2> 261 262 <p>Les fonctionnalit�s ci-dessus bas�es sur les DSO pr�sentent les 263 avantages suivants :</p> 264 265 <ul> 266 <li>Le paquetage du serveur est plus flexible � l'ex�cution car le 267 processus serveur peut �tre assembl� � l'ex�cution via la 268 directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du fichier de 269 configuration <code>httpd.conf</code> plut�t que par des options du script 270 <code class="program"><a href="./programs/configure.html">configure</a></code> � la compilation. Par exemple, 271 on peut ainsi ex�cuter diff�rentes instances du serveur 272 (standard et version SSL, version minimale et version dynamique 273 [mod_perl, mod_php], <em>etc...</em>) � partir d'une seule installation 274 d'Apache httpd.</li> 275 276 <li>Le paquetage du serveur peut �tre facilement �tendu avec des modules 277 tiers, m�me apr�s l'installation. Ceci pr�sente un gros 278 avantage pour les mainteneurs de paquetages destin�s aux distributions, 279 car ils peuvent cr�er un paquetage Apache httpd de base, et des paquetages 280 additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi, 281 <em>etc...</em></li> 282 283 <li>Une facilit� de prototypage des modules Apache httpd, car la paire 284 DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> vous permet d'une part de travailler en 285 dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir 286 besoin que de la commande <code>apxs -i</code> 287 suivie d'un <code>apachectl restart</code> pour introduire une nouvelle 288 version de votre module fra�chement d�velopp� dans le serveur HTTP Apache 289 en cours d'ex�cution.</li> 290 </ul> 291 292 <p>Inconv�nients des DSO :</p> 293 294 <ul> 295 <li>Le serveur est environ 20 % plus lent au d�marrage 296 � cause des r�solutions de symboles suppl�mentaires que le chargeur 297 Unix doit effectuer.</li> 298 299 <li>Le serveur est environ 5 % plus lent � l'ex�cution 300 sur certaines plates-formes, car le code ind�pendant de la position (PIC) 301 n�cessite parfois des manipulations compliqu�es en assembleur pour 302 l'adressage relatif qui ne sont pas toujours aussi rapides que celles 303 que permet l'adressage absolu.</li> 304 305 <li>Comme les modules DSO ne peuvent pas �tre li�s avec d'autres 306 biblioth�ques bas�es sur DSO (<code>ld -lfoo</code>) sur toutes les 307 plates-formes 308 (par exemple, les plates-formes bas�es sur a.out ne fournissent en 309 g�n�ral pas cette fonctionnalit� alors que les plates-formes bas�es sur 310 ELF le font), vous ne pouvez pas utiliser le m�canisme DSO pour tous les 311 types de modules. Ou en d'autres termes, les modules compil�s comme 312 fichiers DSO sont contraints de n'utiliser que les symboles du coeur 313 d'Apache httpd, de la biblioth�que C 314 (<code>libc</code>) et toutes autres biblioth�ques statiques ou 315 dynamiques utilis�es par le coeur d'Apache httpd, ou d'archives statiques 316 (<code>libfoo.a</code>) contenant du code ind�pendant de la 317 position (PIC). 318 Il y a deux solutions pour utiliser un autre type de code : soit le 319 coeur d'Apache httpd contient d�j� lui-m�me une r�f�rence au code, soit vous 320 chargez le code vous-m�me via <code>dlopen()</code>.</li> 321 </ul> 322 323</div></div> 324<div class="bottomlang"> 325<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> | 326<a href="./fr/dso.html" title="Fran�ais"> fr </a> | 327<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 328<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 329<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 330</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 331<script type="text/javascript"><!--//--><![CDATA[//><!-- 332var comments_shortname = 'httpd'; 333var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html'; 334(function(w, d) { 335 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 336 d.write('<div id="comments_thread"><\/div>'); 337 var s = d.createElement('script'); 338 s.type = 'text/javascript'; 339 s.async = true; 340 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 341 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 342 } 343 else { 344 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 345 } 346})(window, document); 347//--><!]]></script></div><div id="footer"> 348<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 349<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 350if (typeof(prettyPrint) !== 'undefined') { 351 prettyPrint(); 352} 353//--><!]]></script> 354</body></html>
