s390_sthyi(2) System Calls Manual s390_sthyi(2) NOM s390_sthyi - Emuler une instruction STHYI BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include /* Definition des constantes STHYI_* */ #include /* Definition des constantes SYS_* */ #include 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 necessaire d'utiliser syscall(2). DESCRIPTION L'appel systeme s390_sthyi() emule l'instruction STHYI (Store Hypervisor Information). Il donne des informations sur les ressources materielles de la machine et ses niveaux de virtualisation. Elles comprennent le type de processeur et sa capacite, ainsi que le modele de la machine et d'autres metriques. L'argument function_code indique la fonction a effectuer. Le/les code(s) suivant(s) sont pris en charge : STHYI_FC_CP_IFL_CAP Renvoyer les informations de capacite CP (Central Processor) et IFL (Integrated Facility for Linux). L'argument resp_buffer indique l'adresse d'un tampon de reponse. Quand function_code vaut STHYI_FC_CP_IFL_CAP, le tampon doit etre de la taille d'une page (4K). Si l'appel systeme renvoie 0, le tampon de reponse sera rempli avec les informations de capacite du processeur. Sinon, son contenu n'est pas modifie. L'argument return_code stocke le code de retour de l'instruction STHYI en utilisant une des valeurs suivantes : 0 Succes. 4 Code de fonction non pris en charge. Pour plus de details sur return_code, function_code et resp_buffer, voir la reference donnee dans les NOTES. L'argument flags est fourni pour de futures extensions et doit etre positionne actuellement sur 0. VALEUR RENVOYEE En cas de succes (c'est-a-dire si l'emulation 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 capacite du processeur sont stockees 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 modifie. Les codes de retour 1 et 2 sont reserves. En cas d'erreur, la valeur de retour est -1 et errno est definie pour preciser l'erreur. ERREURS EFAULT La valeur indiquee dans resp_buffer ou return_code n'est pas une adresse valable. EINVAL La valeur indiquee dans flags n'est pas nulle. ENOMEM L'allocation de memoire pour la gestion des informations de capacite du processeur a echoue. EOPNOTSUPP La valeur indiquee dans function_code n'est pas valable. STANDARDS Linux sur s390. HISTORIQUE Linux 4.15. NOTES Pour des details sur l'instruction STHYI, voir la page de documentation . Quand l'interface de l'appel systeme est utilisee, le tampon de reponse n'a pas d'obligations d'alignement parfait decrit dans la definition de l'instruction STHYI. Le noyau met en cache la reponse (jusqu'a une seconde a partir de Linux 4.16). Il se peut que les recours ulterieurs a l'appel systeme renvoient la reponse en cache. VOIR AUSSI syscall(2) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 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 . Pages du manuel de Linux 6.06 31 octobre 2023 s390_sthyi(2)