s390_guarded_storage(2)       System Calls Manual      s390_guarded_storage(2)

NUME
       s390_guarded_storage - opera<?>ii cu facilitatea de stocare protejata a
       Arhitecturii/z

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <asm/guarded_storage.h> /* Defini<?>ia constantelor GS_* */
       #include <sys/syscall.h>         /* Defini<?>ia constantelor SYS_* */
       #include <unistd.h>

       int syscall(SYS_s390_guarded_storage, int command,
                   struct gs_cb *gs_cb);

       Nota: glibc nu ofera nicio func<?>ie invaluitoare pentru
       s390_guarded_storage(), ceea ce impune utilizarea lui syscall(2).

DESCRIERE
       Apelul de sistem s390_guarded_storage() permite utilizarea
       facilita<?>ii de stocare protejata ,,Guarded Storage Facility" (o
       caracteristica specifica arhitecturii z/Architecture) pentru procesele
       din spa<?>iul utilizatorului.

       Facilitatea de stocare protejata este o caracteristica hardware care
       permite marcarea a pana la 64 de regiuni de memorie (incepand cu z14)
       ca fiind protejate; citirea unui indicator cu o instruc<?>iune nou
       introdusa ,,Load Guarded" (LGG) sau ,,Load Logical and Shift Guarded"
       (LLGFSG) va determina o verificare a intervalului de valori pentru
       valoarea incarcata <?>i va invoca un gestionar in spa<?>iul
       utilizatorului (configurat anterior) daca una dintre regiunile
       protejate este afectata.

       Argumentul command indica func<?>ia care trebuie executata. Sunt
       acceptate urmatoarele comenzi:

       GS_ENABLE
              Activeaza facilitatea de stocare protejata pentru sarcina
              apelanta. Con<?>inutul ini<?>ial al blocului de control al
              memoriei protejate va fi tot zero. Dupa activare, codul din
              spa<?>iul utilizatorului poate utiliza instruc<?>iunea ,,Load
              Guarded Storage Controls" (LGSC) (sau func<?>ia load_gs_cb()
              furnizata in antetul asm/guarded_storage.h) pentru a incarca un
              bloc de control arbitrar. In timp ce o sarcina este activata,
              nucleul va salva <?>i va restabili con<?>inutul de apelare al
              registrelor de stocare protejata la comutarea contextului.

       GS_DISABLE
              Dezactiveaza utilizarea facilita<?>ii de stocare protejata
              pentru sarcina apelanta. Nucleul va inceta sa salveze <?>i sa
              restaureze con<?>inutul registrelor de stocare protejata,
              con<?>inutul specific sarcinii din aceste registre se pierde.

       GS_SET_BC_CB
              Stabile<?>te un bloc de control de stocare cu protec<?>ie de
              difuzare la cel furnizat in argumentul gs_cb. Aceasta opera<?>ie
              este apelata pentru fiecare fir de execu<?>ie <?>i asociaza un
              anumit bloc de control al stocarii protejate cu sarcina
              apelanta. Acest bloc de control va fi utilizat in comanda de
              difuzare GS_BROADCAST.

       GS_CLEAR_BC_CB
              <?>terge blocul de control al stocarii protejate la difuzare.
              Blocul de control al stocarii protejate nu va mai avea asocierea
              stabilita prin comanda GS_SET_BC_CB.

       GS_BROADCAST
              Trimite o transmisiune catre to<?>i fra<?>ii firului de
              execu<?>ie ai sarcinii apelante. Fiecare frate care a stabilit
              un bloc de control de stocare protejata prin difuzare va incarca
              acest bloc de control <?>i va fi activat pentru stocare
              protejata. Blocul de control al stocarii protejate prin difuzare
              este consumat; o a doua difuzare fara o reimprospatare a
              blocului de control stocat cu GS_SET_BC_CB nu va avea niciun
              efect.

       Argumentul gs_cb specifica adresa unei structuri de bloc de control al
       stocarii protejate <?>i este utilizat in prezent numai de comanda
       GS_SET_BC_CB; toate celelalte comenzi men<?>ionate mai sus ignora acest
       argument.

VALOAREA RETURNATA
       In caz de succes, valoarea de returnare a s390_guarded_storage() este
       0.

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

ERORI-IE<?>IRE
       EFAULT command a fost GS_SET_BC_CB <?>i copierea structurii blocului de
              control al stocarii protejate indicat de argumentul gs_cb a
              e<?>uat.

       EINVAL Valoarea furnizata in argumentul command nu a fost valida.

       ENOMEM command a fost unul dintre GS_ENABLE sau GS_SET_BC_CB, iar
              alocarea unui nou bloc de control de stocare protejata a
              e<?>uat.

       EOPNOTSUPP
              Facilitatea de stocare protejata nu este asigurata de hardware.

STANDARDE
       Linux pe s390.

ISTORIC
       Linux 4.12. Sistem z14.

NOTE
       Descrierea facilita<?>ii de stocare protejata, impreuna cu
       instruc<?>iunile aferente <?>i cu schemele structurilor ,,Guarded
       Storage Control Block" <?>i ,,Guarded Storage Event Parameter List"
       sunt disponibile in ,,z/Architecture Principles of Operations" incepand
       cu edi<?>ia a douasprezecea.

       Structura gs_cb are un camp gsepla (Guarded Storage Event Parameter
       List Address), care este un indicator din spa<?>iul utilizatorului
       catre o structura ,,Guarded Storage Event Parameter List" (care
       con<?>ine adresa gestionarului de evenimente men<?>ionat anterior in
       campul gseha), iar structura sa este disponibila ca o defini<?>ie a
       tipului de structura gs_epl in antetul asm/guarded_storage.h

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.15    17 mai 2025          s390_guarded_storage(2)