s390_runtime_instr(2)         System Calls Manual        s390_runtime_instr(2)

NOM
       s390_runtime_instr - Activer ou desactiver l'instrumentation de
       l'activite du processeur s390

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <asm/runtime_instr.h> /* Definition des constantes S390_* */
       #include <sys/syscall.h>       /* Definition des constantes SYS_* */
       #include <unistd.h>

       int syscall(SYS_s390_runtime_instr, int command, int signum);

       Remarque : La glibc ne fournit pas d'enveloppe pour
       s390_runtime_instr() ; appelez-la en utilisant syscall(2).

DESCRIPTION
       L'appel systeme s390_runtime_instr() demarre ou arrete
       l'instrumentation de l'activite du processeur pour le thread appelant.

       L'argument command decide du demarrage (S390_RUNTIME_INSTR_START, 1) ou
       de l'arret (S390_RUNTIME_INSTR_STOP, 2) de l'instrumentation lors de
       l'execution du thread appelant.

       L'argument signum precise le numero du signal temps-reel. Cet argument
       etait utilise pour indiquer un numero de signal a delivrer au thread si
       le tampon d'instrumentation etait plein ou si une interruption
       << run-time-instrumentation-halted >> etait survenue. Cette
       fonctionnalite n'a jamais ete utilisee et sa prise en charge a ete
       supprimee dans Linux 4.4. Par consequent, dans les noyaux actuels, cet
       argument est ignore.

VALEUR RENVOYEE
       S'il reussit, l'appel s390_runtime_instr() renvoie la valeur 0 et
       permet au thread l'instrumentation de l'execution en lui assignant un
       bloc de controle d'instrumentation par defaut. Le composant appelant
       peut alors acceder en lecture ou modifier le bloc de controle et
       demarrer l'instrumentation. S'il echoue, l'appel renvoie -1 et errno
       est positionne pour indiquer l'erreur.

ERREURS
       EINVAL La valeur specifiee dans  command n'est pas une commande
              valable.

       EINVAL La valeur indiquee dans signum n'est pas un numero de signal
              temps reel. A partir de Linux 4.4, l'argument signum n'a pas
              d'effet, si bien qu'un numero de signal non valable n'engendrera
              pas une erreur.

       ENOMEM L'allocation de la memoire pour le bloc de controle
              d'instrumentation a echoue.

       EOPNOTSUPP
              Le mecanisme d'instrumentation d'execution n'est pas disponible.

STANDARDS
       Linux sur s390.

HISTORIQUE
       Linux 3.7.  System z EC12.

NOTES
       Le fichier d'en-tete asm/runtime_instr.h est disponible depuis
       Linux 4.16.

       A partir de Linux 4.4, la prise en charge des signaux a ete supprimee
       ainsi que la verification si signum est un signal temps reel valable.
       Pour une retro-compatibilite avec les anciens noyaux, il est recommande
       de fournir un numero de signal temps reel valable dans signum et
       d'installer un gestionnaire pour ce signal.

VOIR AUSSI
       syscall(2), signal(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Cedric Boutillier <cedric.boutillier@gmail.com>,
       Frederic Hantrais <fhantrais@gmail.com> et Jean-Philippe MENGUAL
       <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023          s390_runtime_instr(2)