pkey_alloc(2)                 System Calls Manual                pkey_alloc(2)

NUME
       pkey_alloc, pkey_free - aloca sau elibereaza o cheie de protec<?>ie

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #define _GNU_SOURCE             /* Consulta<?>i feature_test_macros(7) */
       #include <sys/mman.h>

       int pkey_alloc(unsigned int flags, unsigned int access_rights);
       int pkey_free(int pkey);

DESCRIERE
       pkey_alloc() aloca o cheie de protec<?>ie (pkey) <?>i permite ca
       aceasta sa fie transmisa la pkey_mprotect(2).

       Parametrul flags al pkey_alloc() este rezervat pentru utilizare
       viitoare <?>i, in prezent, trebuie sa fie intotdeauna specificat ca
       fiind 0.

       Argumentul pkey_alloc() access_rights poate con<?>ine zero sau mai
       multe opera<?>ii de dezactivare:

       PKEY_DISABLE_ACCESS
              Dezactiveaza accesul tuturor datelor la memoria acoperita de
              cheia de protec<?>ie returnata.

       PKEY_DISABLE_WRITE
              Dezactiveaza accesul pentru scriere la memoria acoperita de
              cheia de protec<?>ie returnata.

       pkey_free() elibereaza o cheie de protec<?>ie <?>i o face disponibila
       pentru alocari ulterioare. Dupa ce o cheie de protec<?>ie a fost
       eliberata, aceasta nu mai poate fi utilizata in nicio opera<?>ie legata
       de chei de protec<?>ie.

       O aplica<?>ie nu ar trebui sa apeleze pkey_free() pe o cheie de
       protec<?>ie care a fost atribuita unui interval de adrese de catre
       pkey_mprotect(2) <?>i care este inca in uz. Comportamentul in acest caz
       este nedefinit <?>i poate duce la o eroare.

VALOAREA RETURNATA
       In caz de succes, pkey_alloc() returneaza o valoare pozitiva a cheii de
       protec<?>ie. In caz de succes, pkey_free() returneaza zero. In caz de
       eroare, se returneaza -1, iar errno este configurata pentru a indica
       eroarea.

ERORI-IE<?>IRE
       EINVAL pkey, flags, sau access_rights nu este valid.

       ENOSPC (pkey_alloc()) Toate cheile de protec<?>ie disponibile pentru
              procesul curent au fost alocate. Numarul de chei disponibile
              este specific arhitecturii <?>i implementarii <?>i poate fi
              redus prin utilizarea anumitor chei in interiorul nucleului. In
              prezent, exista 15 chei disponibile pentru programele utilizator
              pe x86.

              Aceasta eroare va fi returnata <?>i in cazul in care procesorul
              sau sistemul de operare nu accepta chei de protec<?>ie.
              Aplica<?>iile ar trebui sa fie intotdeauna pregatite sa
              gestioneze aceasta eroare, deoarece factori care nu pot fi
              controla<?>i de aplica<?>ie pot reduce numarul de chei de
              protec<?>ie disponibile.

STANDARDE
       Linux.

ISTORIC
       Linux 4.9, glibc 2.27.

NOTE
       pkey_alloc() poate fi apelat intotdeauna in siguran<?>a, indiferent
       daca sistemul de operare accepta sau nu chei de protec<?>ie.  Acesta
       poate fi utilizat in locul oricarui alt mecanism de detectare a
       suportului pentru chei de protec<?>ie <?>i va e<?>ua pur <?>i simplu cu
       eroarea ENOSPC daca sistemul de operare nu suporta chei de protec<?>ie.

       Nucleul garanteaza ca con<?>inutul registrului de drepturi hardware
       (PKRU) va fi pastrat numai pentru cheile de protec<?>ie alocate. Ori de
       cate ori o cheie este nealocata (fie inainte de primul apel care
       returneaza cheia respectiva de la pkey_alloc(), fie dupa ce aceasta
       este eliberata prin pkey_free()), nucleul poate efectua modificari
       arbitrare ale par<?>ilor din registrul de drepturi care afecteaza
       accesul la acea cheie.

EXEMPLE
       A se vedea pkeys(7).

CONSULTA<?>I <?>I
       pkey_mprotect(2), pkeys(7)

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                 pkey_alloc(2)