NOM

       s390_runtime_instr – Activer ou désactiver l’instrumentation de l'activité du processeur s390

SYNOPSIS

       #include <asm/runtime_instr.h>

       int s390_runtime_instr(int command, int signum);

DESCRIPTION

       L'appel système s390_runtime_instr() démarre ou arrête l’instrumentation de l'activité du processeur pour
       le thread appelant.

       L'argument    command    décide    du    démarrage    (S390_RUNTIME_INSTR_START,   1)   ou   de   l'arrêt
       (S390_RUNTIME_INSTR_STOP, 2) de l’instrumentation lors de l'exécution du thread appelant.

       L'argument signum précise le numéro du signal temps-réel. Cet argument était  utilisé  pour  indiquer  un
       numéro  de  signal à délivrer au thread si le tampon d’instrumentation était plein ou si une interruption
       « run-time-instrumentation-halted » était survenue. Cette fonctionnalité n’a jamais été  utilisée  et  sa
       prise en charge a été supprimée dans Linux 4.4. Par conséquent, dans les noyaux actuels, cet argument est
       ignoré.

VALEUR RENVOYÉE

       S'il réussit, l'appel s390_runtime_instr() renvoie la valeur 0 et active le thread pour l’instrumentation
       d'exécution en lui assignant un bloc de contrôle d’instrumentation par défaut. Le composant appelant peut
       alors  accéder  en  lecture  ou  modifier le bloc de contrôle et démarrer l’instrumentation. S'il échoue,
       l'appel retourne -1 et errno prend pour valeur l'un des codes erreur décrits plus bas.

ERREURS

       EINVAL La valeur spécifiée dans  command n'est pas une commande valable.

       EINVAL La valeur indiquée dans signum n'est pas un numéro de signal temps réel. À  partir  de  Linux 4.4,
              l'argument signum n'a pas d'effet, si bien qu'un numéro de signal non valable n’engendrera pas une
              erreur.

       ENOMEM L'allocation de la mémoire pour le bloc de contrôle d’instrumentation a échoué.

       EOPNOTSUPP
              Le mécanisme d’instrumentation d'exécution n'est pas disponible.

VERSIONS

       Cet appel système est disponible depuis Linux 3.7.

CONFORMITÉ

       L'appel  système  spécifique  à  Linux  n'est  disponible  que  pour  l'architecture  s390.  Le mécanisme
       d’instrumentation d'exécution est disponible à partir d’EC12 de System z.

NOTES

       La glibc ne fournit pas de fonction autour de cet appel système ; utilisez syscall(2) pour l'appeler.

       Le fichier d'en-tête asm/runtime_instr.h est disponible depuis Linux 4.16.

       À partir de Linux 4.4, la prise en charge des signaux a été supprimée ainsi que la vérification si signum
       est un signal temps réel valable. Pour une rétro-compatibilité avec les anciens noyaux, il est recommandé
       de fournir un numéro de signal temps réel valable dans signum et  d'installer  un  gestionnaire  pour  ce
       signal.

VOIR AUSSI

       syscall(2), signal(7)

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>,     Cédric     Boutillier     <cedric.boutillier@gmail.com>,    Frédéric    Hantrais
       <fhantrais@gmail.com> 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.

Manuel du programmeur Linux                        9 juin 2020                             S390_RUNTIME_INSTR(2)