GET_KERNEL_SYMS

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 6 juin 2007
Index Menu principal

NOM

get_kernel_syms - Obtenir les symboles exportés du noyau et des modules

SYNOPSIS

#include <linux/module.h>

int get_kernel_syms(struct kernel_sym *table);

DESCRIPTION

Si table est NULL, get_kernel_syms() renvoie le nombre de symboles disponibles. Autrement, il remplit une table de structures :

struct kernel_sym {
    unsigned long value;
    char          name[60];
};

Les symboles sont dispersés avec des symboles magiques de la forme #module-name, le noyau ayant un nom vide. La valeur associée à un symbole de cette forme est l'adresse à laquelle le module a été chargé.

Les symboles exportés par chaque module suivent leur étiquette module magique et les modules sont renvoyés dans l'ordre inverse duquel ils ont été chargés.

VALEUR RENVOYÉE

En cas de réussite, renvoie le nombre de symboles copiés dans table. En cas d'échec, -1 est renvoyé et errno est rempli en conséquence.

ERREURS

Il n'y a qu'une seule erreur de retour possible :

ENOSYS: get_kernel_syms() n'est pas pris en charge par cette version du noyau. is not supported in this version of the kernel.

VERSIONS

Cet appel système n'est présent dans Linux que jusqu'au noyau 2.4 ; il a été retiré dans le noyau 2.6.

CONFORMITÉ

get_kernel_syms() est spécifique à Linux.

BOGUES

Il n'y a pas moyen d'indiquer la taille du tampon alloué à table. Si des symboles ont été ajoutés au noyau depuis que le programme s'est enquis de la taille de la table des symboles, la mémoire sera corrompue.

La longueur des noms de symboles exportés est limitée à 59 caractères.

À cause de ces limitations, cet appel système est déprécié au profit de query_module(2) (qui est lui-même aujourd'hui déprécié au profit d'autres interfaces qui sont décrites dans leurs pages de manuel).

VOIR AUSSI

create_module(2), delete_module(2), init_module(2), query_module(2)

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 21 juillet 2006 et révisée le 8 janvier 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 get_kernel_syms ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 9 janvier 2008