NOM

       s390_sthyi – Émuler une instruction STHYI

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <asm/sthyi.h>        /* Définition des constantes STHYI_* */
       #include <sys/syscall.h>      /* Définition des constantes SYS_* */
       #include <unistd.h>

       int syscall(SYS_s390_sthyi, unsigned long function_code,
                   void *resp_buffer, uint64_t *return_code,
                   unsigned long flags);

       Note : la glibc ne fournit pas d'enveloppe pour s390_sthyi(), il est nécessaire d'utiliser syscall(2).

DESCRIPTION

       L'appel  système  s390_sthyi()  émule  l'instruction  STHYI  (Store Hypervisor Information). Il donne des
       informations sur les ressources matérielles de  la  machine  et  ses  niveaux  de  virtualisation.  Elles
       comprennent  le  type  de  processeur  et  sa  capacité,  ainsi  que  le modèle de la machine et d'autres
       métriques.

       L'argument function_code indique la fonction à effectuer. Le/les code(s) suivant(s) sont pris en charge :

       STHYI_FC_CP_IFL_CAP
              Renvoyer les informations de capacité CP (Central  Processor)  et  IFL  (Integrated  Facility  for
              Linux).

       L'argument   resp_buffer   indique   l'adresse   d'un   tampon   de  réponse.  Quand  function_code  vaut
       STHYI_FC_CP_IFL_CAP, le tampon doit être de la taille d'une page (4K). Si l'appel système renvoie  0,  le
       tampon  de  réponse sera rempli avec les informations de capacité du processeur. Sinon, son contenu n'est
       pas modifié.

       L'argument return_code stocke le code de retour de l'instruction  STHYI  en  utilisant  une  des  valeurs
       suivantes :

       0      Succès.

       4      Code de fonction non pris en charge.

       Pour  plus  de  détails  sur return_code, function_code et resp_buffer, voir la référence donnée dans les
       NOTES.

       L'argument flags est fourni pour de futures extensions et doit être positionné actuellement sur 0.

VALEUR RENVOYÉE

       En cas de succès (c'est-à-dire si l'émulation a eu lieu), le code de retour de s390_sthyi() correspond au
       code de condition des instructions STHYI qui est une valeur dans l'intervalle [0..3]. Un code  de  retour
       de  0  indique que les informations de capacité du processeur sont stockées dans *resp_buffer. Un code de
       retour de 3 indique « code de fonction non pris en charge » et  le  contenu  de  *resp_buffer  n'est  pas
       modifié. Les codes de retour 1 et 2 sont réservés.

       En cas d'erreur, la valeur de retour est -1 et errno est définie pour préciser l'erreur.

ERREURS

       EFAULT La valeur indiquée dans resp_buffer ou return_code n'est pas une adresse valable.

       EINVAL La valeur indiquée dans flags n'est pas nulle.

       ENOMEM L'allocation de mémoire pour la gestion des informations de capacité du processeur a échoué.

       EOPNOTSUPP
              La valeur indiquée dans function_code n'est pas valable.

STANDARDS

       Linux sur s390.

HISTORIQUE

       Linux 4.15.

NOTES

       Pour des détails sur l'instruction STHYI, voir la page de documentation.

       Quand  l'interface  de  l'appel  système  est  utilisée,  le  tampon  de  réponse  n'a  pas d'obligations
       d'alignement parfait décrit dans la définition de l'instruction STHYI.

       Le noyau met en cache la réponse (jusqu'à une seconde à partir de Linux 4.16). Il se peut que les recours
       ultérieurs à l'appel système renvoient la réponse en cache.

VOIR AUSSI

       syscall(2)

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.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                      s390_sthyi(2)