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

#include <linux/module.h>

int get_kernel_syms(struct kernel_sym *table);

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.

Renvoie le nombre de symboles copiés dans table. Il n’y a pas d’erreur de retour possible.

get_kernel_syms() est spécifique à Linux.

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).

Cet appel système n’est présent sous Linux que depuis le noyau 2.4 ; il a été retiré dans le noyau 2.6.

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

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

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=en 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.