GETUNWIND

Manuel du programmeur Linux (2)
13 février 2013

NOM

getunwind - Copier les données unwind vers le tampon de l'appelant

SYNOPSIS

#include <syscall.h>
#include <linux/unwind.h>

long getunwind(void *buf, size_t buf_size);

Remarque : il n'existe pas de fonction glibc autour de cet appel système ; consultez NOTES.

DESCRIPTION

Remarque : cette fonction est obsolète.

L'appel système getunwind() spécifique à IA-64 copie les données unwind de la trame d'appel du noyau vers le tampon pointé par buf et renvoie la taille des données unwind ; ces données décrivent la page gate (le code du noyau qui est projeté dans l'espace utilisateur).

La taille du tampon buf est indiquée dans buf_size. Les données ne sont copiées que si buf_size est plus grand ou égal à la taille des données unwind et que buf n'est pas NULL ; sinon, aucune donnée n'est copiée et l'appel réussit, en renvoyant la taille qui aurait été nécessaire pour stocker les données unwind.

La première partie des données unwind contient une table unwind. Le reste contient les renseignements unwind associés, sans ordre particulier. La table unwind contient des entrées sous la forme suivante :

    u64 start;      (adresse 64 bits du début de fonction)
    u64 end;        (adresse 64 bits de fin de fonction)
    u64 info;       (offset relatif au tampon des renseignements unwind)

Une entrée dont la valeur start est zéro indique la fin de la table. Pour plus de renseignements sur le format, consultez le manuel IA-64 Software Conventions and Runtime Architecture.

VALEUR RENVOYÉE

S'il réussit, getunwind() renvoie la taille de table unwind. En cas d'erreur, il renvoie -1 et remplit errno avec la valeur d'erreur.

ERREURS

getunwind() échoue avec l'erreur EFAULT si les renseignements unwind ne peuvent pas être stockés dans l'espace indiqué par buf.

VERSIONS

Cet appel système est disponible depuis Linux 2.4.

CONFORMITÉ

Cet appel système est spécifique à Linux et n'est disponible que sur l'architecture IA-64.

NOTES

Cet appel système est maintenant obsolète. La façon moderne d'obtenir les données unwind du noyau est avec le DSO gate. L'adresse de l'en-tête ELF pour ce DSO est passée au niveau utilisateur à l'aide de AT_SYSINFO_EHDR (consultez getauxval(3)).

La glibc ne fournit pas de fonction autour de cet appel système ; dans l'éventualité où vous voudriez quand même l'appeler, utilisez syscall(2).

VOIR AUSSI

getauxval(3)

COLOPHON

Cette page fait partie de la publication 3.66 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».

This document was created by man2html, using the manual pages.
Time: 21:52:34 GMT, July 12, 2014