NOM

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

SYNOPSIS

       #include <linux/unwind.h>
       #include <sys/syscall.h>      /* Definition of SYS_* constants */
       #include <unistd.h>

       long syscall(SYS_getunwind, void *buf, size_t buf_size);

       Remarque :  la  glibc  ne  fournit  pas  d'enveloppe  autour  de  getunwind(), nécessitant
       l'utilisation de syscall(2).

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

VOIR AUSSI

       getauxval(3)

COLOPHON

       Cette  page  fait partie de la publication 5.13 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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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⟩.