s390_sthyi(2)                 System Calls Manual                s390_sthyi(2)

NUME
       s390_sthyi - emuleaza instruc<?>iunea STHYI

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <asm/sthyi.h>        /* Defini<?>ia constantelor STHYI_* */
       #include <sys/syscall.h>      /* Defini<?>ia constantelor SYS_* */
       #include <unistd.h>

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

       Nota: glibc nu ofera nicio func<?>ie invaluitoare pentru s390_sthyi(),
       fiind necesara utilizarea syscall(2).

DESCRIERE
       Apelul de sistem s390_sthyi() emuleaza instruc<?>iunea STHYI (Store
       Hypervisor Information). Aceasta furnizeaza informa<?>ii despre
       resursele hardware pentru ma<?>ina <?>i nivelurile de virtualizare ale
       acesteia. Acestea includ tipul <?>i capacitatea procesorului, precum
       <?>i modelul ma<?>inii <?>i al<?>i parametri.

       Argumentul function_code indica ce func<?>ie trebuie executata. Sunt
       acceptate urmatoarele coduri:

       STHYI_FC_CP_IFL_CAP
              Returneaza informa<?>ii despre capacitatea CP (Central
              Processor) <?>i IFL (Integrated Facility for Linux).

       Argumentul resp_buffer specifica adresa unei memorii tampon de raspuns.
       Atunci cand function_code este STHYI_FC_CP_IFL_CAP, memoria tampon
       trebuie sa aiba dimensiunea unei pagini (4K). Daca apelul de sistem
       returneaza 0, memoria tampon de raspuns va fi umpluta cu informa<?>ii
       privind capacitatea CPU. In caz contrar, con<?>inutul memoriei tampon
       de raspuns ramane neschimbat.

       Argumentul return_code stocheaza codul de returnare al instruc<?>iunii
       STHYI, utilizand una dintre urmatoarele valori:

       0      Succes.

       4      Cod de func<?>ie neacceptat.

       Pentru mai multe detalii despre return_code, function_code <?>i
       resp_buffer, a se vedea referin<?>ele date in sec<?>iunea NOTE.

       Argumentul flags este furnizat pentru a permite extinderi viitoare <?>i
       in prezent trebuie sa fie stabilit la 0.

VALOAREA RETURNATA
       In caz de succes (adica: emulare reu<?>ita), valoarea de intoarcere a
       s390_sthyi() corespunde codului de condi<?>ie al instruc<?>iunilor
       STHYI, care este o valoare in intervalul [0..3]. O valoare de retur de
       0 indica faptul ca informa<?>iile privind capacitatea CPU sunt stocate
       in *resp_buffer. O valoare de returnare de 3 indica ,,cod de func<?>ie
       neacceptat", iar con<?>inutul lui *resp_buffer ramane neschimbat.
       Valorile de returnare 1 <?>i 2 sunt rezervate.

       In caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

ERORI-IE<?>IRE
       EFAULT Valoarea specificata in resp_buffer sau return_code nu este o
              adresa valida.

       EINVAL Valoarea specificata in flags este diferita de zero.

       ENOMEM A e<?>uat alocarea memoriei pentru gestionarea informa<?>iilor
              privind capacitatea CPU.

       EOPNOTSUPP
              Valoarea specificata in function_code nu este valabila.

STANDARDE
       Linux pe s390.

ISTORIC
       Linux 4.15.

NOTE
       Pentru detalii despre instruc<?>iunea STHYI, consulta<?>i pagina de
       documenta<?>ie <https://www.ibm.com/support/knowledgecenter
       /SSB27U_6.3.0/com.ibm.zvm.v630.hcpb4/hcpb4sth.htm>.

       Atunci cand se utilizeaza interfa<?>a de apel de sistem, memoria tampon
       de raspuns nu trebuie sa indeplineasca toate cerin<?>ele de aliniere
       descrise in defini<?>ia instruc<?>iunii STHYI.

       Nucleul memoreaza raspunsul (pana la o secunda, incepand cu Linux
       4.16).  Invocarile ulterioare ale apelurilor de sistem pot returna
       raspunsul memorat in spa<?>iul de prestocare (cache) al nucleului.

CONSULTA<?>I <?>I
       syscall(2)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                 s390_sthyi(2)