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
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" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <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.3</a></div><div id="page-content"><div id="preamble"><h1>Support des objets dynamiques partagés (DSO)</h1>
21 <p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
22 <a href="./fr/dso.html" title="Français"> fr </a> |
23 <a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
24 <a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
25 <a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
28 <p>La conception modulaire du serveur HTTP Apache permet à l'administrateur
29 de choisir les fonctionnalités à inclure dans le serveur en sélectionnant
30 un certain nombre de modules. Les modules peuvent être soit intégrés
31 statiquement dans le binaire <code class="program"><a href="./programs/httpd.html">httpd</a></code> lors de la
32 compilation du serveur, soit compilés en tant qu'objets
33 dynamiques partagés (DSOs) qui existeront indépendamment du binaire
34 principal <code class="program"><a href="./programs/httpd.html">httpd</a></code>. Les modules DSO peuvent être compilés
35 au moment de la construction du serveur, ou bien compilés séparément,
36 à l'aide de l'utilitaire des extensions d'Apache (<code class="program"><a href="./programs/apxs.html">apxs</a></code>),
37 et associés au serveur ultérieurement.</p>
39 <p>Ce document décrit l'utilisation des modules DSO ainsi que les dessous
40 de leur fonctionnement.</p>
42 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implémentation</a></li>
43 <li><img alt="" src="./images/down.gif" /> <a href="#usage">Mode d'emploi succinct</a></li>
44 <li><img alt="" src="./images/down.gif" /> <a href="#background">Les dessous du fonctionnement des DSO</a></li>
45 <li><img alt="" src="./images/down.gif" /> <a href="#advantages">Avantages et inconvénients</a></li>
47 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
49 <h2><a name="implementation" id="implementation">Implémentation</a></h2>
51 <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>
53 <p>Le support DSO pour le chargement de modules individuels d'Apache est
54 assuré par un module nommé <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> qui doit être compilé
55 statiquement dans le coeur d'Apache. Il s'agit du seul module avec le
56 module <code class="module"><a href="./mod/core.html">core</a></code> à ne pas pouvoir être compilé en tant que
57 module DSO lui-même. Pratiquement tous les autres modules d'Apache
58 distribués peuvent être compilés en tant que modules DSO en sélectionnant
59 pour chacun d'entre eux le mode de construction DSO à l'aide de l'option
60 <code>--enable-<em>module</em>=shared</code> du script
61 <code class="program"><a href="./programs/configure.html">configure</a></code>, comme décrit dans la
62 <a href="install.html">Documentation de l'installation</a>. Une fois
63 compilé en tant que module DSO, un module peut être chargé en mémoire au
64 démarrage ou redémarrage du serveur à l'aide de la commande
65 <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du module
66 <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>, placée
67 dans votre fichier <code>httpd.conf</code>.</p>
69 <p>Un nouvel utilitaire a été introduit afin de simplifier la création de
70 fichiers DSO pour les modules d'Apache
71 (particulièrement pour les modules tiers) ; il s'agit du programme nommé
72 <code class="program"><a href="./programs/apxs.html">apxs</a></code> (<dfn>APache
73 eXtenSion</dfn>). On peut l'utiliser pour construire des modules de type
74 DSO <em>en dehors</em> de l'arborescence des sources d'Apache. L'idée est
75 simple : à l'installation d'Apache, la procédure <code>make install</code>
76 du script <code class="program"><a href="./programs/configure.html">configure</a></code> installe les fichiers d'en-têtes
77 d'Apache et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de
78 l'éditeur de liens à l'intérieur du programme
79 <code class="program"><a href="./programs/apxs.html">apxs</a></code>, qui sera utilisé pour la construction de fichiers DSO.
80 Il est ainsi possible d'utiliser le programme <code class="program"><a href="./programs/apxs.html">apxs</a></code>
81 pour compiler ses sources de modules Apache sans avoir besoin de
82 l'arborescence des sources de la distribution d'Apache, et sans avoir à
83 régler les drapeaux du compilateur et de l'éditeur de liens pour le support DSO.</p>
84 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
86 <h2><a name="usage" id="usage">Mode d'emploi succinct</a></h2>
88 <p>Afin que vous puissiez vous faire une idée des fonctionnalités DSO
89 d'Apache 2.x, en voici un résumé court et concis :</p>
93 Construire et installer un module Apache <em>faisant partie de la
94 distribution</em>, par exemple <code>mod_foo.c</code>,
95 en tant que module DSO <code>mod_foo.so</code> :
97 <div class="example"><p><code>
98 $ ./configure --prefix=/chemin/vers/répertoire-installation
99 --enable-foo=shared<br />
105 Construire et installer un module Apache <em>tiers</em>, par exemple
106 <code>mod_foo.c</code>, en tant que module DSO <code>mod_foo.so</code> :
108 <div class="example"><p><code>
109 $ ./configure --add-module=<var>type_de_module</var>:
110 /chemin/vers/module_tiers/mod_foo.c \<br />
111 <span class="indent">
112 --enable-foo=shared<br />
119 Configurer Apache pour <em>pouvoir installer ultérieurement</em> des
122 <div class="example"><p><code>
123 $ ./configure --enable-so<br />
129 Construire et installer un module Apache <em>tiers</em>, par exemple
130 <code>mod_foo.c</code>, en tant que module DSO
131 <code>mod_foo.so</code> <em>en dehors</em> de l'arborescence des sources
132 d'Apache à l'aide du programme <code class="program"><a href="./programs/apxs.html">apxs</a></code> :
134 <div class="example"><p><code>
135 $ cd /chemin/vers/module_tiers<br />
136 $ apxs -c mod_foo.c<br />
137 $ apxs -i -a -n foo mod_foo.la
142 <p>Dans tous les cas, une fois le module partagé compilé, vous devez
143 ajouter une directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
144 dans le fichier <code>httpd.conf</code> pour qu'Apache active le module.</p>
145 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
146 <div class="section">
147 <h2><a name="background" id="background">Les dessous du fonctionnement des DSO</a></h2>
149 <p>Les clônes modernes d'UNIX proposent un astucieux mécanisme
150 communément appelé édition de liens et chargement dynamiques d'
151 <em>Objets Dynamiques Partagés</em> (DSO), qui permet de construire un
152 morceau de programme dans un format spécial pour le rendre chargeable
153 à l'exécution dans l'espace d'adressage d'un programme exécutable.</p>
155 <p>Ce chargement peut s'effectuer de deux manières : automatiquement par
156 un programme système appelé <code>ld.so</code> quand un programme
157 exécutable est démarré, ou manuellement à partir du programme en cours
158 d'exécution via sa propre interface système vers le chargeur Unix à l'aide
159 des appels système <code>dlopen()/dlsym()</code>.</p>
161 <p>Dans la première méthode, les DSO sont en général appelés
162 <em>bibliothèques partagées</em> ou encore <em>bibliothèques DSO</em>, et
163 possèdent des noms du style
164 <code>libfoo.so</code> ou <code>libfoo.so.1.2</code>. Ils résident dans un
165 répertoire système (en général <code>/usr/lib</code>)
166 et le lien avec le programme exécutable est établi à la compilation en
167 ajoutant <code>-lfoo</code> à la commande de l'éditeur de liens. Les
168 références à la bibliothèque sont ainsi codées en dur dans le fichier du
169 programme exécutable de façon à ce qu'au démarrage du programme, le
170 chargeur Unix soit capable de localiser <code>libfoo.so</code> dans
171 <code>/usr/lib</code>, dans des chemins codés en dur à l'aide d'options de
172 l'éditeur de liens comme <code>-R</code> ou dans des chemins définis par la
173 variable d'environnement
174 <code>LD_LIBRARY_PATH</code>. Le chargeur peut dès lors résoudre tous les symboles
175 (jusque là non encore résolus) du DSO dans le programme exécutable.</p>
177 <p>Les symboles du programme exécutable ne sont en général pas
178 référencés par le DSO (car c'est une bibliothèque de code à usage général
180 et ainsi aucune résolution supplémentaire n'est nécessaire. De son côté,
181 le programme exécutable ne doit accomplir aucune action particulière
183 symboles du DSO car toutes les résolutions sont effectuées par le chargeur
184 Unix. En fait, le code permettant d'invoquer
185 <code>ld.so</code> fait partie du code de démarrage pour l'exécution qui
186 est lié dans tout programme exécutable non statiquement lié.
187 L'avantage du chargement dynamique du code d'une bibliothèque partagée est
188 évident : le code de la bibliothèque ne doit être stocké qu'une seule fois
189 dans une bibliothèque système telle que <code>libc.so</code>, ce qui permet
190 d'économiser de l'espace disque pour les autres programmes.</p>
192 <p>Dans la seconde méthode, les DSO sont en général appelés <em>objets
193 partagés</em> ou <em>fichiers DSO</em>, et peuvent être nommés avec
194 l'extension de son choix (bien que le nom conseillé soit du style
195 <code>foo.so</code>). Ces fichiers résident en général dans un répertoire
196 spécifique à un programme, et aucun lien n'est automatiquement établi avec
197 le programme exécutable dans lequel ils sont utilisés.
198 Le programme exécutable charge manuellement le DSO à l'exécution dans son
199 espace d'adressage à l'aide de l'appel système <code>dlopen()</code>.
200 A ce moment, aucune résolution de symboles du DSO n'est effectuée pour le
201 programme exécutable. Par contre le chargeur Unix
202 résoud automatiquement tout symbole du DSO (non encore résolu)
203 faisant partie de l'ensemble de symboles exporté par le programme
204 exécutable et ses bibliothèques DSO déjà chargées (et en particulier tous
205 les symboles de la bibliothèque à tout faire <code>libc.so</code>).
206 De cette façon, le DSO prend connaissance de l'ensemble de symboles du
207 programme exécutable comme s'il avait été lié statiquement avec lui
210 <p>Finalement, pour tirer profit de l'API des DSO, le programme exécutable
211 doit résoudre certains symboles du DSO à l'aide de l'appel système
212 <code>dlsym()</code> pour une utilisation ultérieure dans les tables de
213 distribution, <em>etc...</em> En d'autres termes, le programme exécutable doit
214 résoudre manuellement tous les symboles dont il a besoin pour pouvoir les
216 Avantage d'un tel mécanisme : les modules optionnels du programme n'ont pas
217 besoin d'être chargés (et ne gaspillent donc pas de ressources mémoire)
218 tant qu'il ne sont pas nécessaires au programme en question. Si nécessaire,
219 ces modules peuvent être chargés dynamiquement afin d'étendre les
220 fonctionnalités de base du programme.</p>
222 <p>Bien que ce mécanisme DSO paraisse évident, il comporte au moins une
223 étape difficile : la résolution des symboles depuis le programme exécutable
224 pour le DSO lorsqu'on utilise un DSO pour étendre les fonctionnalités d'un
225 programme (la seconde méthode). Pourquoi ? Parce que la "résolution
226 inverse" des symboles DSO à partir du jeu de symboles du programme
227 exécutable dépend de la conception de la bibliothèque (la bibliothèque n'a
228 aucune information sur le programme qui l'utilise) et n'est ni standardisée
229 ni disponible sur toutes les plateformes. En pratique, les symboles globaux
230 du programme exécutable ne sont en général pas réexportés et donc
231 indisponibles pour l'utilisation dans un DSO. Trouver une méthode pour
232 forcer l'éditeur de liens à exporter tous les symboles globaux est le
233 principal problème que l'on doit résoudre lorsqu'on utilise un DSO pour
234 étendre les fonctionnalités d'un programme au moment de son exécution.</p>
236 <p>L'approche des bibliothèques partagées est la plus courante, parce que
237 c'est dans cette optique que le mécanisme DSO a été conçu ; c'est cette
238 approche qui est ainsi
239 utilisée par pratiquement tous les types de bibliothèques que fournit le
240 système d'exploitation. Par contre, les objets partagés sont relativement
241 peu utilisés pour étendre les fonctionnalités d'un programme.</p>
243 <p>En 1998, seule une poignée de logiciels distribués
244 utilisaient le mécanisme DSO pour réellement étendre leurs fonctionnalités
245 au moment de l'exécution : Perl 5 (via son mécanisme XS et le module
246 DynaLoader), le serveur Netscape, <em>etc...</em> A partir de la
247 version 1.3, Apache rejoignit ce groupe, car Apache
248 présentait déjà un concept modulaire pour étendre ses fonctionnalités, et
249 utilisait en interne une approche basée sur une liste de distribution pour
250 relier des modules externes avec les fonctionnalités de base d'Apache.
251 Ainsi, Apache était vraiment prédestiné à l'utilisation des DSO pour
252 charger ses modules au moment de l'exécution.</p>
253 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
254 <div class="section">
255 <h2><a name="advantages" id="advantages">Avantages et inconvénients</a></h2>
257 <p>Les fonctionnalités ci-dessus basées sur les DSO présentent les
258 avantages suivants :</p>
261 <li>Le paquetage du serveur est plus flexible à l'exécution car le
262 processus serveur effectif peut être assemblé à l'exécution via la
263 directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du fichier de
264 configuration <code>httpd.conf</code> plutôt que par des options du script
265 <code class="program"><a href="./programs/configure.html">configure</a></code> à la compilation. Par exemple,
266 on peut ainsi exécuter différentes instances du serveur
267 (standard et version SSL, version minimale et version étoffée
268 [mod_perl, PHP], <em>etc...</em>) à partir d'une seule installation
271 <li>Le paquetage du serveur peut être facilement étendu avec des modules
272 tiers, même après l'installation. Ceci présente en tout cas un gros
273 avantage pour les mainteneurs de paquetages destinés aux distributions,
274 car ils peuvent créer un paquetage Apache de base, et des paquetages
275 additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi,
278 <li>Une facilité de prototypage des modules Apache car la paire
279 DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> vous permet d'une part de travailler en
280 dehors de l'arborescence des sources d'Apache, et d'autre part de n'avoir
281 besoin que de la commande <code>apxs -i</code>
282 suivie d'un <code>apachectl restart</code> pour introduire une nouvelle
283 version de votre module fraîchement développé dans le serveur Apache
284 en cours d'exécution.</li>
287 <p>Inconvénients des DSO :</p>
290 <li>Le mécanisme DSO n'est pas disponible sur toutes les plates-formes
291 car tous les systèmes d'exploitation ne supportent pas le chargement
292 dynamique de code dans l'espace d'adressage d'un programme.</li>
294 <li>Le serveur est environ 20 % plus lent au démarrage
295 à cause des résolutions de symboles supplémentaires que le chargeur
296 Unix doit effectuer.</li>
298 <li>Le serveur est environ 5 % plus lent à l'exécution
299 sur certaines plates-formes, car le code indépendant de la position (PIC)
300 nécessite parfois des manipulations compliquées en assembleur pour
301 l'adressage relatif qui ne sont pas toujours aussi rapides que celles
302 que permet l'adressage absolu.</li>
304 <li>Comme les modules DSO ne peuvent pas être liés avec d'autres
305 bibliothèques basées sur DSO (<code>ld -lfoo</code>) sur toutes les
307 (par exemple, les plates-formes basées sur a.out ne fournissent en
308 général pas cette fonctionnalité alors que les plates-formes basées sur
309 ELF le font), vous ne pouvez pas utiliser le mécanisme DSO pour tous les
310 types de modules. Ou en d'autres termes, les modules compilés comme
311 fichiers DSO sont contraints de n'utiliser que les symboles du coeur
312 d'Apache, de la bibliothèque C
313 (<code>libc</code>) et toutes autres bibliothèques statiques ou
314 dynamiques utilisées par le coeur d'Apache, ou d'archives statiques
315 (<code>libfoo.a</code>) contenant du code indépendant de la
317 Il y a deux solutions pour utiliser un autre type de code : soit le
318 coeur d'Apache contient déjà lui-même une référence au code, soit vous
319 chargez le code vous-même via <code>dlopen()</code>.</li>
323 <div class="bottomlang">
324 <p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
325 <a href="./fr/dso.html" title="Français"> fr </a> |
326 <a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
327 <a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
328 <a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
329 </div><div id="footer">
330 <p class="apache">Copyright 2008 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
331 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>