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

       Note : il n'existe pas d'enveloppe pour cet appel système dans la glibc ; voir 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;       (position par rapport 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 des données unwind. En cas d'erreur, il renvoie -1 et remplit
       errno avec l'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 vdso(7).

       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 5.10 du projet man-pages Linux. Une description du projet et des
       instructions  pour  signaler  des  anomalies et la dernière version de cette page peuvent être trouvées à
       l'adresse https://www.kernel.org/doc/man-pages/.

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>, François Micaux, Alain Portal  <aportal@univ-montp2.fr>,  Jean-Philippe  Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,     Thomas     Huriaux      <thomas.huriaux@gmail.com>,      Nicolas      François
       <nicolas.francois@centraliens.net>,     Florentin     Duneau    <fduneau@gmail.com>,    Simon    Paillard
       <simon.paillard@resel.enst-bretagne.fr>,    Denis    Barbier    <barbier@debian.org>,    David     Prévot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Linux                                           15 septembre 2017                                   GETUNWIND(2)