NOM

       s390_runtime_instr - Activer ou désactiver la collecte des traces 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 la collecte des traces 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 la collecte des traces lors de l'exécution du thread appelant.

       L'argument  signum précise le nombre de signaux temps-réel. Le signal temps-réel est envoyé au thread  si
       le  tampon de collecte des traces est plein, ou si l'interruption « run-time-instrumentation-halted » est
       survenue.

VALEUR RENVOYÉE

       S'il réussit, l'appel s390_runtime_instr() renvoie la valeur 0 et active le thread pour la  collecte  des
       traces  d'exécution  en lui assignant un bloc de contrôle de collecte des traces par défaut. Le composant
       appelant peut alors accéder en lecture ou modifier le bloc  de  contrôle  et  démarrer  la  collecte  des
       traces.  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  valide  ou  la  valeur  spécifiée  dans
              signum n'est pas une valeur numérique admise pour le signal temps-réel.

       ENOMEM L'allocation de la mémoire pour le bloc de contrôle de collecte des traces a échoué.

       EOPNOTSUPP
              Le mécanisme des collecte des traces 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 de
       collecte des traces d'exécution est disponible à partir du System z EC12.

NOTES

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

VOIR AUSSI

       syscall(2), signal(7)

COLOPHON

       Cette page fait partie de la publication 3.65 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 à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

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

Manuel du programmeur Linux                     17 décembre 2012                           S390_RUNTIME_INSTR(2)