remap_file_pages(2)           System Calls Manual          remap_file_pages(2)

NUME
       remap_file_pages - creeaza o cartografiere neliniara a fi<?>ierelor

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #define _GNU_SOURCE         /* A se vedea feature_test_macros(7) */
       #include <sys/mman.h>

       [[depreciat]] int remap_file_pages(void addr[.size], size_t size,
                                           int prot, size_t pgoff, int flags);

DESCRIERE
       Nota: acest apel de sistem a fost marcat ca fiind depreciat incepand cu
       Linux 3.16. In Linux 4.0, implementarea a fost inlocuita cu o
       emula<?>ie in nucleu mai lenta. Acele cateva aplica<?>ii care
       utilizeaza acest apel de sistem ar trebui sa ia in considerare migrarea
       catre alternative. Aceasta modificare a fost facuta deoarece codul
       nucleului pentru acest apel de sistem era complex <?>i se crede ca este
       pu<?>in utilizat sau poate chiar complet nefolosit. De<?>i a avut unele
       cazuri de utilizare in aplica<?>iile de baze de date pe sisteme pe 32
       de bi<?>i, aceste cazuri de utilizare nu exista pe sistemele pe 64 de
       bi<?>i.

       Apelul de sistem remap_file_pages() este utilizat pentru a crea o
       cartografiere neliniara, adica o cartografiere in care paginile
       fi<?>ierului sunt cartografiate intr-o ordine nesecven<?>iala in
       memorie. Avantajul utilizarii remap_file_pages() fa<?>a de utilizarea
       apelurilor repetate la mmap(2) consta in faptul ca prima abordare nu
       necesita ca nucleul sa creeze structuri de date suplimentare VMA
       (Virtual Memory Area).

       Pentru a crea o cartografiere neliniara, efectuam urmatorii pa<?>i:

       1. Utiliza<?>i mmap(2) pentru a crea o cartografiere (care este
          ini<?>ial liniara). Aceasta cartografiere trebuie sa fie creata cu
          indicatorul MAP_SHARED.

       2. Utiliza<?>i unul sau mai multe apeluri la remap_file_pages() pentru
          a rearanja coresponden<?>a dintre paginile din cartografiere <?>i
          paginile din fi<?>ier.  Este posibil sa se cartografieze aceea<?>i
          pagina a unui fi<?>ier in mai multe loca<?>ii din regiunea
          cartografiata.

       Argumentele pgoff <?>i size specifica regiunea din fi<?>ier care
       trebuie realocata in cadrul cartografierii: pgoff este un interval al
       fi<?>ierului in unita<?>i de dimensiune a paginii de sistem; size este
       lungimea regiunii in octe<?>i.

       Argumentul addr are doua scopuri. In primul rand, identifica
       cartografierea ale carei pagini dorim sa le rearanjam. Astfel, addr
       trebuie sa fie o adresa care sa se incadreze intr-o regiune
       cartografiata anterior printr-un apel la mmap(2). In al doilea rand,
       addr specifica adresa la care vor fi plasate paginile de fi<?>ier
       identificate de pgoff <?>i size.

       Valorile specificate in addr <?>i size trebuie sa fie multiplii
       dimensiunii paginii de sistem. Daca nu sunt, atunci nucleul
       rotunje<?>te valorile both down la cel mai apropiat multiplu al
       dimensiunii paginii.

       Argumentul prot trebuie sa fie specificat ca fiind 0.

       Argumentul prot trebuie sa fie specificat ca fiind 0. Argumentul flags
       are aceea<?>i semnifica<?>ie ca <?>i pentru mmap(2), dar toate
       fanioanele, altele decat MAP_NONBLOCK, sunt ignorate.

VALOAREA RETURNATA
       In caz de succes, remap_file_pages() returneaza 0. In caz de eroare, se
       returneaza -1, iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EINVAL addr nu se refera la o cartografiere valida creata cu
              indicatorul MAP_SHARED.

       EINVAL addr, size, prot, sau pgoff nu este valid.

STANDARDE
       Linux.

ISTORIC
       Linux 2.5.46, glibc 2.3.3.

NOTE
       Incepand cu Linux 2.6.23, remap_file_pages() creeaza cartografieri
       neliniare numai pe sistemele de fi<?>iere in memorie, cum ar fi
       tmpfs(5), hugetlbfs sau ramfs. Pe sistemele de fi<?>iere cu o memorie
       de rezerva, remap_file_pages() nu este mult mai eficient decat
       utilizarea mmap(2) pentru a ajusta ce par<?>i ale fi<?>ierului sunt
       cartografiate la ce adrese.

CONSULTA<?>I <?>I
       getpagesize(2), mmap(2), mmap2(2), mprotect(2), mremap(2), msync(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           remap_file_pages(2)