Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] dlclose, dlerror, dlopen, dlsym - Interface de programmation pour le chargeur de bibliothèques dynamiques. [size=18] [b]Résumé[/b] [/size] [b]#include <dlfcn.h>[/b] [b][i]void * dlopen (const char * filename , int flag );[/i][/b] [b][/b] [b][i]const char * dlerror(void);[/i][/b] [b][/b] [b][i]void * dlsym (void * handle , char * symbol );[/i][/b] [b][/b] [b][i]int dlclose (void * handle );[/i][/b] Symboles spéciaux : [b]_init , _fini .[/b] [size=18] [b]Description[/b] [/size] [b]dlopen[/b] charge une bibliothèque dynamique depuis le fichier dont le nom est fourni dans la chaîne [i]filename[/i] (terminée par un caractère nul) et renvoie un descripteur opaque [b] ( handle )[/b] représentant la bibliothèque dynamique. Si le nom [i]filename[/i] n'est pas un chemin absolu (commençant pas un "/"), le fichier est recherché aux endroits suivants :[table][row][col]    [/col][col] La liste des répertoires (séparés par des deux-points) contenue dans la variable d'environnement [b]LD_LIBRARY_PATH[/b]. La liste des bibliothèques mémorisées dans [i]/etc/ld.so.cache[/i]. [i]/lib[/i], puis [i]/usr/lib[/i].[/col][/row][/table] Si l'argument [i]filename[/i] est un pointeur NULL, le descripteur renvoyé correspond au programme principal. Les références externes de la bibliothèque sont résolues en utilisant les bibliothèqujes mentionnées dans sa liste de dépendances, et toutes les autres bibliothèques éventuellement ouvertes auparavant avec l'attribut [b]RTLD_GLOBAL .[/b] Si l'édition des liens de l'exécutable a été faite avec l'option "-rdynamic", alors ses symboles globaux seront également employés pour résoudre les références de la bibliothèque chargée dynamiquement. L'attribut [i]flag[/i] doit être soit [b]RTLD_LAZY ,[/b] indiquant que la résolution des symboles aura lieu lorsque le code sera exécuté, soit [b]RTLD_NOW ,[/b] demandant la résolution de tous les symboles indéfinis avant le retour de [b]dlopen [/b] et l'échec de cette routine si c'est impossible. En option, on peut ajouter (avec un OU binaire) l'attribut [b]RTLD_GLOBAL[/b] rendant les symboles externes de la bibliothèque disponible pour les bibliothèques chargées ultérieurement. Si la bibliothèque exporte une routine nommée [b]_init ,[/b] alors ce code sera exécuté avant le retour de [b]dlopen() .[/b] Au cas où vous voudriez éviter le lien avec les fichiers de démarrage du système, vous pouvez préciser le paramètre "-nostartfiles" sur la ligne de commande de gcc. Si la même bibliothèque est chargée deux fois avec [b]dlopen() ,[/b] le même descripteur sera renvoyé. Un compte du nombre de chargements est toutefois conservé afin d'éviter de la décharger avant que la fonction [b]dlclose()[/b] n'ait été appelée autant de fois que [b]dlopen()[/b] a réussi. Si [b]dlopen()[/b] échoue pour une raison quelconque, elle renvoie NULL. Une chaîne de caractères en clair, décrivant la dernière erreur rencontrée dans une routine dlopen(), dlsym() ou dlclose() peut être récupérée en appelant [b]dlerror() .[/b] La fonction [b]dlerror()[/b] renvoie NULL si aucune erreur ne s'est produite depuis l'initialisation ou depuis sa dernière invocation (si on appelle deux fois de suite [b]dlerror (),[/b] le second appel donnera toujours NULL). La fonction [b]dlsym()[/b] prend un descripteur de bibliothèque dynamique renvoyée par [b]dlopen ()[/b] et un nom de symbole terminé par un caractère nul, et renvoie l'adresse où ce symbole a été chargé. Si le symbole n'est pas trouvé, [b]dlsym()[/b] renvoie NULL. Toutefois la bonne manière de vérifier si une erreur s'est produite dans [b]dlsym()[/b] est d'examiner le résultat de [b]dlerror()[/b] (en le sauvegardant dans une variable). En effet, le symbole peut avoir légitimement la valeur NULL sans qu'une erreur ne se soit produite. Le fait de sauvegarder le résultat de [b]dlerror()[/b] dans une variable pour examiner s'il est NULL est indispensable, car un second appel pour afficher l'erreur renverrait toujours NULL. Il y a deux pseudo-handles spéciaux [b]RTLD_DEFAULT[/b] et [b]RTLD_NEXT .[/b] le premier recherche la première occurrence du symbole désiré en utilisant l'ordre de recherche des bibliothèques par défaut. Le second, qui ne peut servir que pour une bibliothèque dynamique, recherchera l'occurrence suivante, d'une fonction à partir de la bibliothèque en cours. Ceci permet de fournir un encadrement pour une fonction se trouvant dans une autre bibliothèque partagée. La fonction [b]dlclose()[/b] décrémente le nombre de références sur la bibliothèque dynamique dont le descripteur est [b]handle .[/b] Si ce nombre descend à zéro et si aucune autre bibliothèque n'emploie des symboles exportés par celle-ci, elle est déchargée. Si la bibliothèque exporte une routine nommée [b]_fini ,[/b] alors elle est appelée juste avant le déchargement. [size=18] [b]Valeur renvoyée[/b] [/size] [b]dlclose[/b] renvoie zéro si elle réussi ou une valeur non-nulle en cas d'erreur. [size=18] [b]Exemple[/b] [/size] [b]Charger la bibliothèque mathématique et afficher le cosinus de 2.0 :[/b][table][row][col]    [/col][col] .nf .if t .ft CW #include <stdio.h> #include <dlfcn.h> int main(int argc, char *argv) { void handle; double (cosine)(double); char error; handle = dlopen ("/lib/libm.so", RTLD_LAZY); if (!handle) { fputs (dlerror(), stderr); exit(1); } cosine = dlsym(handle, "cos"); if ((error = dlerror()) != NULL) { fprintf (stderr, "%sen", error); exit(1); } printf ("%fen", (*cosine)(2.0)); dlclose(handle); } .if t .ft P .fi[/col][/row][/table] Supposons que le programme s'appelle "foo.c", on doit le compiler ainsi :[table][row][col]    [/col][col]     gcc -rdynamic -o foo foo.c -ldl[/col][/row][/table] Une bibliothèque (disons bar.c) qui exporte _init() et _fini() sera compilée comme suit :[table][row][col]    [/col][col]     gcc -shared -nostartfiles -o bar bar.c[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Les symboles RTLD_DEFAULT et RTLD_NEXT sont définis dans [i]<dlfcn.h>[/i] seulement si _GNU_SOURCE a été définie avant l'inclusion. [size=18] [b]Historique[/b] [/size] L'interface standard dlopen provient de SunOS. [size=18] [b]Voir aussi[/b] [/size] [b]ld (1),[/b] [b]ld.so (8),[/b] [b]ldconfig (8),[/b] [b]ldd (1),[/b] [b]ld.so.info[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2000-2003.
Fichier