1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Support des objets partagés dynamiques (DSO) - Serveur Apache HTTP</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/dso.html" rel="canonical" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.0</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<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.0</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
<p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
<ul><li><a href="http://httpd.apache.org/docs/current/">Current release version of Apache HTTP Server documentation</a></li></ul><p>You may follow <a href="http://httpd.apache.org/docs/current/dso.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>Support des objets partagés dynamiques (DSO)</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/dso.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/dso.html" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Cette traduction peut être périmée. Consultez la version
Anglaise pour les changements récents.</div>
<p>Le serveur HTTP Apache est un programme modulaire permettant à
l'administrateur de choisir les fonctionnalités qu'il souhaite
activer, au moyen de modules. Les modules peuvent être intégrés
dans le programme binaire <code>httpd</code> au moment de la
compilation. Il est également possible de compiler à part des
modules en tant qu'objets dynamiques partagés (Dynamic Shared
Objects : DSOs) existant séparément du fichier binaire principal
<code>httpd</code>. Les modules DSO peuvent être compilés en même
temps que le serveur, ou après, au moyen de l'outil Apache pour
les extensions (<code class="program"><a href="./programs/apxs.html">apxs</a></code>).</p>
<p>Ce document décrit les principes de fonctionnement des modules DSO, et
montre comment les utiliser.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implémentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Résumé sur l'utilisation des DSO</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background">Contexte</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages">Avantages et Inconvénients</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="implementation" id="implementation">Implémentation</a></h2>
<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>
<p>Le support DSO servant à charger des modules Apache, est lui-même
codé dans un module, nommé <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>, qui doit être
compilé dans le noyau d'Apache. Ce module, ainsi que le module
<code class="module"><a href="./mod/core.html">core</a></code>, sont les deux seuls modules qui ne peuvent
être compilés séparément d'Apache. En pratique, tous les autres
modules d'Apache peuvent être compilés en tant que modules DSO,
en passant au script <code>configure</code> l'option
<code>--enable-<em>module</em>=shared</code>, comme précisé dans
la <a href="install.html">documentation d'installation</a>. Après
qu'un module ait été compilé en DSO (nommé
<code>mod_monmodule.so</code>), il est possible d'utiliser la
directive de <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> : <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> dans le fichier <code>httpd.conf</code>,
afin qu'Apache charge ledit module au démarrage ou redémarrage du
serveur.</p>
<p>Afin de simplifier la création de fichiers DSO pour les
modules Apache (et en particulier les modules tiers), un nouveau
programme de support a été ajouté : <a href="programs/apxs.html">apxs</a> (<em>APache eXtenSion</em>). Ce programme peut être
utilisé pour créer des modules DSO <em>en se passant de</em>
l'arborescence source d'Apache. L'idée en est simple : lors de
l'installation d'Apache, la commande <code>make install</code>
positionne les fichiers d'en-têtes C d'Apache, ainsi que les
options du compilateur et les options propres à la plate-forme
dans le programme <code>apxs</code>. Ceci permet à l'utilisateur
de compiler ses modules Apache, au moyen de <code>apxs</code>,
sans disposer de l'arborescence source d'Apache et sans devoir
manipuler les options de compilation ou les options propres à
sa plate-forme.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Résumé sur l'utilisation des DSO</a></h2>
<p>Voici un résumé bref des fonctionnalités DSO d'Apache 2.0 :</p>
<ol>
<li>
Pour compiler et installer un module Apache <em>distribué
avec Apache</em>, par exemple <code>mod_foo.c</code>, en tant
que DSO, sous le nom <code>mod_foo.so</code> :
<div class="example"><p><code>
$ ./configure --prefix=/path/to/install --enable-foo=shared<br />
$ make install
</code></p></div>
</li>
<li>
Pour compiler et installer un module Apache <em>fourni par un
tiers</em>, par exemple <code>mod_foo.c</code>, en tant que DSO,
sous le nom <code>mod_foo.so</code> :
<div class="example"><p><code>
$ ./configure --add-module=module_type:/chemin/vers/le/tiers/mod_foo.c --enable-foo=shared<br />
$ make install
</code></p></div>
</li>
<li>
Pour configurer Apache afin qu'il puisse accepter les modules DSO :
<div class="example"><p><code>
$ ./configure --enable-so<br />
$ make install
</code></p></div>
</li>
<li>
Pour compiler et installer un module Apache <em>fourni par un
tiers</em>, par exemple <code>mod_foo.c</code>, en tant que
DSO, et sans disposer de l'arborescence source d'Apache
(utilisation d'<a href="programs/apxs.html">apxs</a>) :
<div class="example"><p><code>
$ cd /chemin/vers/le/tiers<br />
$ apxs -c mod_foo.c<br />
$ apxs -i -a -n foo mod_foo.la
</code></p></div>
</li>
</ol>
<p>Dans tous les cas, une fois qu'un module a été compilé en tant
que DSO, vous devrez utiliser la directive
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> dans le
fichier <code>httpd.conf</code> afin qu'Apache active le module.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background">Contexte</a></h2>
<p>Sur les systèmes récents, dérivés d'Unix, il existe un procédé
élégant, habituellement appelé chargement dynamique d'objets
partagés DSO, permettant de compiler un morceau de code sous un
format spécial, et de pouvoir le charger en temps réel dans
l'espace d'adressage d'un programme exécutable.</p>
<p>Ce chargement peut être réalisé de deux manières :
automatiquement, grâce à un programme système nommé <code>ld.so</code>
lors du démarrage d'un exécutable, ou manuellement depuis un programme
en exécution via une interface programmée au moyen des appels
systèmes <code>dlopen()/dlsym()</code> du "chargeur" Unix</p>
<p>Dans le premier cas, il est courant d'appeler les DSO des
<em>bibliothèques partagées</em> ou des <em>bibliothèques DSO</em> ;
on les nomme <code>libfoo.so</code> ou <code>libfoo.so.1.2</code>.
Elles sont toutes placées dans un répertoire système (souvent
<code>/usr/lib</code>) et sont liées par les programmes exécutables
lors de la compilation de ces derniers, en précisant au moment de
la compilation l'option <code>-lfoo</code> à la commande de link
(linker command). Cette manière de procéder insère les références
des bibliothèques dans le coeur des programmes, afin qu'au moment
du démarrage du programme, le "chargeur" Unix puisse trouver
<code>libfoo.so</code> dans <code>/usr/lib</code>, ou bien dans
les chemins codés en dur au moyen de l'option de link <code>-R</code>,
ou dans un chemin configuré au moyen de la variable d'environnement
<code>LD_LIBRARY_PATH</code>. Tous les symboles non résolus présents
dans le programme sont alors résolus au moyen de DSO.</p>
<p>Les symboles propres au programme exécutable ne sont généralement
pas référencés par le DSO (puisque c'est une bibliothèque de code
générique), et donc aucune résolution ne doit être suivie au delà
de ce point. Le programme exécutable n'a pas de travail particulier
à faire pour résoudre les symboles des DSO, puisque c'est le
"chargeur" Unix qui s'occupe de cette tâche. (En réalité, le code
utilisé pour invoquer <code>ld.so</code> fait partie du code de
démarrage run-time, qui est lié à chaque programme exécutable
non statique). L'avantage du chargement dynamique des bibliothèques
de code générique est évident : le code n'est conservé qu'à un seul
endroit du disque, dans une bibliothèque système comme
<code>libc.so</code>, ce qui permet de gagner de l'espace disque
pour chaque programme.</p>
<p>Dans le second cas, les DSO sont appelés <em>objets partagés</em>
ou <em>fichiers DSO</em> et on peut leur attribuer une extension au
choix (bien que leur nom soit habituellement <code>foo.so</code>).
Ces fichiers résident normalement dans un répertoire propre au
programme qui les utilise, et ils ne sont pas liés de manière
automatique au programme qui les appelle. Celui-ci les charge en
temps réel lors de son exécution, au moyen de <code>dlopen()</code>.
À cet instant, aucune résolution des symboles du DSO n'est réalisée.
C'est le "chargeur" Unix qui réalise la tâche de résoudre les
symboles non résolus du DSO, à partir du jeu de symboles exportés
par le programme et ses bibliothèques DSO (en particulier, tous
les symboles de l'omniprésente <code>libc.so</code>). Ainsi, le DSO
gagne la connaissance des symboles du programme exécutable, comme
s'il lui avait été lié statiquement au départ.</p>
<p>Enfin, pour tirer parti de l'API DSO, l'exécutable doit résoudre
les symboles propres au DSO via <code>dlsym()</code>, pour les
utiliser plus tard dans les tables de répartition (NdT : "dispatch
tables"), <em>etc.</em> En d'autres termes, le programme exécutable
doit résoudre lui-même chaque symbole pour utiliser chacun d'entre
eux. L'avantage de ce mécanisme est que les parties optionnelles
d'un programme ne sont pas chargées (et donc, n'encombrent pas la
mémoire) avant que le programme n'en ait effectivement besoin.
Quand elles deviennent nécessaires, ces parties du programme peuvent
être chargées dynamiquement pour étendre les fonctionnalités du
programme.</p>
<p>Bien que ce fonctionnement de DSO puisse paraître simple à
comprendre, il existe au moins une difficulté d'implémentation :
permettre au DSO de résoudre les symboles du programme quand un DSO
est utilisé pour étendre un programme. Pourquoi cela ? Parce que la
"résolution à l'envers" des symboles DSO à partir des symboles du
programme exécutable est contraire au principe de conception des
bibliothèques (où, rappelons-le, la bibliothèque ne sait rien du
programme qui l'utilise) ; cette "résolution à l'envers" n'est pas
standardisée, et n'existe pas sur toutes les plates-formes. En
pratique, les symboles globaux d'un programme exécutable ne sont
que rarement réexportés vers un DSO, et donc ne sont pas accessibles.
Celui qui veut pouvoir étendre les fonctionnalités d'un programme
dynamiquement, lors de l'exécution, doit trouver un moyen de forcer
le programme de liaison à exporter tous les symboles globaux de ce
programme.</p>
<p>L'approche par bibliothèques partagées est de loin la plus courante
parce que c'est celle pour laquelle les mécanismes DSO ont été conçus ;
elle est donc utilisée par presque toutes les bibliothèques du système
d'exploitation. De l'autre coté, l'utilisation des objets partagés reste
une approche marginale.</p>
<p>Depuis 1998, seules quelques solutions logiciels existantes
utilisent le mécanisme des DSO pour étendre leurs fonctionnalités
en cours exécution : Perl 5 (via son "XS mechanism" et le module
DynaLoader), Netscape Server, <em>etc.</em> Depuis la version 1.3,
Apache a rejoint ce groupe, car Apache utilise une approche
modulaire pour étendre ses fonctionnalités, et utilise de manière
interne des mécanismes de répartition par liste pour lier des
modules externes à son noyau. Apache était vraiment prédestiné,
par concept, à utiliser les DSO pour charger ses modules en temps
réel.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages">Avantages et Inconvénients</a></h2>
<p>Les possibilités des DSO décrites ci-avant présentent les
avantages suivants :</p>
<ul>
<li>Le paquetage du serveur est plus flexible lors de son exécution,
car les processus du serveur central peuvent être étendus pendant
son exécution, au moyen de la directive
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>, dans
<code>httpd.conf</code>, plutôt que forcer les utilisateurs à
recompiler le serveur pour modifier ses fonctionnalités. Par
exemple, ce mode de fonctionnement permet de faire tourner
plusieurs instances du serveur (version standard & SSL
version, version minimaliste & étendue [mod_perl, PHP3],
<em>etc.</em>) au moyen d'une seule installation d'Apache.</li>
<li>Il est très facile d'étendre les fonctionnalités du serveur
de base, même après son installation. Ceci est d'un grand secours
aux mainteneurs des paquets qui peuvent facilement créer des
paquets pour l'installation de base d'Apache et d'autres paquets
différents pour les extensions, comme PHP3, mod_perl,
mod_fastcgi, <em>etc.</em></li>
<li>Facilité de développement des modules Apache ; grâce aux outils
DSO/<code>apxs</code>, ce travail est faisable sans l'arborescence
source d'Apache, et ne nécessite qu'une commande <code>apxs -i</code>
suivi d'un <code>apachectl restart</code> pour ajouter au serveur
déjà en marche les fonctionnalités du module développé.</li>
</ul>
<p>Les inconvénients liés à l'utilisation des DSO :</p>
<ul>
<li>Les mécanismes de DSO ne sont pas portables sur toutes les
plates-formes, car tous les systèmes d'exploitation ne supportent
pas le chargement dynamique de code dans l'espace d'adressage d'un
programme en marche.</li>
<li>Le serveur est à peu près 20% plus lent au démarrage, à cause de la
charge prise par le "chargeur" Unix de la résolution des symboles.</li>
<li>Le serveur est à peu près 5% plus lent en fonctionnement sur
certaines plates-formes parce que le code indépendant de la
position ("position independent code" - PIC) requiert parfois des
tours de passe-passe en assembleur pour l'adressage relatif, ce qui
n'est pas toujours aussi rapide que l'adressage absolu.</li>
<li>Les modules DSO ne pouvant pas être liés à d'autres bibliothèques
DSO (<code>ld -lfoo</code>) sur toutes les plates-formes (par
exemple, les plates-formes basées sur a.out ne le permettent pas,
alors que celles basées sur ELF le permettent), il n'est pas possible
d'utiliser les mécanismes de DSO pour tous les modules. En d'autres
termes, les modules compilés en tant que fichiers DSO sont limités
à l'utilisation des symboles exportés par le noyau d'Apache, par
la bibliothèque C (<code>libc</code>) et toute autre bibliothèque
dynamique ou statique utilisée par le noyau d'Apache, ou par des
archives de bibliothèques statiques (<code>libfoo.a</code>) qui
contiennent du code indépendant de la position. Les seuls moyens
d'utiliser du code à l'extérieur d'un fichier DSO sont, soit de
s'assurer que le noyau d'Apache contienne une référence vers ce
code, soit de charger ce code au moyen de <code>dlopen()</code>.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/dso.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/dso.html" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<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>
<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>
</body></html>
|
