set_mempolicy(2)              System Calls Manual             set_mempolicy(2)

NUME
       set_mempolicy - stabile<?>te politica implicita de memorie NUMA pentru
       un fir <?>i copiii acestuia

BIBLIOTECA
       Biblioteca de politici NUMA (,,Non-Uniform Memory Access": acces
       neuniform la memorie) (libnuma, -lnuma)

SINOPSIS
       #include <numaif.h>

       long set_mempolicy(int mod, const unsigned long *nodemask,
                          unsigned long maxnode);

DESCRIERE
       set_mempolicy() stabile<?>te politica de memorie NUMA a firului
       apelant, care consta intr-un mod de politica <?>i zero sau mai multe
       noduri, la valorile specificate de argumentele mode, nodemask <?>i
       maxnode.

       O ma<?>ina NUMA are diferite controloare de memorie cu distan<?>e
       diferite fa<?>a de diferitele CPU-uri. Politica de memorie define<?>te
       din ce nod este alocata memoria pentru firul de execu<?>ie.

       Acest apel de sistem define<?>te politica implicita pentru firele de
       execu<?>ie. Politica firelor de execu<?>ie guverneaza alocarea de
       pagini in spa<?>iul de adrese al procesului in afara intervalelor de
       memorie controlate de o politica mai specifica stabilita de mbind(2).
       Politica implicita a firelor de execu<?>ie controleaza, de asemenea,
       alocarea oricaror pagini pentru fi<?>ierele cu memorie alocata
       utilizand apelul mmap(2) cu fanionul MAP_PRIVATE <?>i care sunt citite
       (incarcate) numai de catre firul de execu<?>ie <?>i a fi<?>ierelor cu
       memorie alocata utilizand apelul mmap(2) cu fanionul MAP_SHARED,
       indiferent de tipul de acces. Politica este aplicata numai atunci cand
       o noua pagina este alocata pentru firul de execu<?>ie. Pentru memoria
       anonima, acest lucru se intampla atunci cand pagina este accesata
       pentru prima data de catre firul de execu<?>ie.

       Argumentul mod trebuie sa specifice unul dintre MPOL_DEFAULT,
       MPOL_BIND, MPOL_INTERLEAVE, MPOL_WEIGHTED_INTERLEAVE, MPOL_PREFERRED
       sau MPOL_LOCAL (care sunt descrise in detaliu in continuare). Toate
       modurile, cu excep<?>ia MPOL_DEFAULT, necesita ca apelantul sa
       specifice nodul sau nodurile la care se aplica modul, prin intermediul
       argumentului nodemask.

       Argumentul mod poate include, de asemenea, un fanion de mod op<?>ional.
       Fanioanele mod acceptate sunt:

       MPOL_F_NUMA_BALANCING (incepand cu Linux 5.12)
              Atunci cand mod este MPOL_BIND, se activeaza echilibrarea NUMA a
              nucleului pentru sarcina, daca aceasta este acceptata de nucleu.
              Daca fanionul nu este acceptat de nucleu sau este utilizat cu un
              mod altul decat MPOL_BIND, se returneaza -1 <?>i errno este
              configurata la EINVAL.

       MPOL_F_RELATIVE_NODES (incepand cu Linux 2.6.26)
              Un argument nodemask nevid specifica ID-urile nodurilor care
              sunt relative la setul de ID-uri ale nodurilor permise de
              ,,cpuset-ul" curent al procesului (limitarea la subseturile de
              noduri de procesare <?>i de memorie actuala a procesului).

       MPOL_F_STATIC_NODES (incepand cu Linux 2.6.26)
              Un argument nodemask nevid specifica ID-urile nodurilor fizice.
              Linux nu va repozi<?>iona nodemask atunci cand procesul se muta
              intr-un context cpuset diferit <?>i nici atunci cand se schimba
              setul de noduri permise de contextul cpuset curent al
              procesului.

       nodemask indica o masca de bi<?>i a ID-urilor nodurilor care con<?>ine
       pana la maxnode bi<?>i. Dimensiunea ma<?>tii de bi<?>i este rotunjita
       la urmatorul multiplu de sizeof(unsigned long), dar nucleul va utiliza
       bi<?>i numai pana la maxnode. O valoare NULL a nodemask sau o valoare
       maxnode de zero specifica setul gol de noduri. Daca valoarea lui
       maxnode este zero, argumentul nodemask este ignorat.

       Atunci cand este necesara o masca de noduri nodemask, aceasta trebuie
       sa con<?>ina cel pu<?>in un nod care este activ, permis de contextul
       cpuset curent al procesului (cu excep<?>ia cazului in care este
       specificat fanionul de mod MPOL_F_STATIC_NODES) <?>i con<?>ine memorie.
       Daca MPOL_F_STATIC_NODES este definit in mod <?>i o masca de noduri
       nodemask necesara nu con<?>ine noduri care sunt permise de contextul
       cpuset curent al procesului, politica de memorie revine la alocarea
       locala local allocation. Aceasta prevaleaza efectiv asupra politicii
       specificate pana cand contextul cpuset al procesului include unul sau
       mai multe noduri specificate de nodemask.

       Argumentul mod trebuie sa includa una dintre urmatoarele valori:

       MPOL_DEFAULT
              Acest mod specifica faptul ca orice politica de memorie a
              firelor de execu<?>ie care nu este implicita este eliminata,
              astfel incat politica de memorie ,,revine" la politica implicita
              a sistemului. Politica implicita a sistemului este ,,alocare
              locala" -- adica, alocarea memoriei pe nodul CPU care a
              declan<?>at alocarea. Masca de noduri nodemask trebuie sa fie
              specificata ca NULL. Daca ,,nodul local" nu con<?>ine memorie
              libera, sistemul va incerca sa aloce memorie de pe un nod
              ,,apropiat".

       MPOL_BIND
              Acest mod define<?>te o politica stricta care restric<?>ioneaza
              alocarea de memorie la nodurile specificate in nodemask. Daca
              nodemask specifica mai mult de un nod, alocarile de pagini vor
              proveni mai intai de la nodul cu cel mai mic ID de nod numeric,
              pana cand nodul respectiv nu con<?>ine memorie libera. Alocarile
              vor veni apoi de la nodul cu urmatorul ID de nod cel mai mare
              specificat in nodemask <?>i a<?>a mai departe, pana cand
              niciunul dintre nodurile specificate nu con<?>ine memorie
              libera. Paginile nu vor fi alocate din niciun nod care nu este
              specificat in nodemask.

       MPOL_INTERLEAVE
              Acest mod intercaleaza alocarile de pagini intre nodurile
              specificate in nodemask in ordinea numerica a ID-ului nodului.
              Acest lucru optimizeaza la<?>imea de banda in loc de laten<?>a
              prin repartizarea paginilor <?>i a accesarilor de memorie la
              acele pagini pe mai multe noduri. Cu toate acestea, accesul la o
              singura pagina va fi in continuare limitat la la<?>imea de banda
              de memorie a unui singur nod.

       MPOL_WEIGHTED_INTERLEAVE (incepand cu Linux 6.9)
              Acest mod intercaleaza alocarile de pagini intre nodurile
              specificate in nodemask in func<?>ie de ponderile din
              /sys/kernel/mm/mempolicy/weighted_interleave. De exemplu, daca
              bi<?>ii 0, 2 <?>i 5 sunt defini<?>i in nodemask, iar
              con<?>inutul /sys/kernel/mm/mempolicy/weighted_interleave/node0,
              /sys/... /node2, <?>i /sys/.../node5 sunt 4, 7 <?>i, respectiv,
              9, atunci paginile din aceasta regiune vor fi alocate nodurilor
              0, 2 <?>i 5 intr-un raport 4:7:9.

       MPOL_PREFERRED
              Acest mod stabile<?>te nodul preferat pentru alocare. Nucleul va
              incerca sa aloce mai intai pagini din acest nod <?>i va reveni
              la nodurile ,,apropiate" daca nodul preferat are pu<?>ina
              memorie libera. Daca nodemask specifica mai mult de un ID de
              nod, primul nod din masca va fi selectat ca nod preferat. Daca
              argumentele nodemask <?>i maxnode specifica setul gol, atunci
              politica specifica ,,alocare locala" (precum politica implicita
              a sistemului discutata mai sus).

       MPOL_LOCAL (incepand cu Linux 3.8)
              Acest mod specifica ,,alocare locala"; memoria este alocata pe
              nodul CPU care a declan<?>at alocarea (,,nodul local").
              Argumentele nodemask <?>i maxnode trebuie sa specifice setul
              gol. Daca ,,nodul local" are pu<?>ina memorie libera, nucleul va
              incerca sa aloce memorie din alte noduri. Nucleul va aloca
              memorie din ,,nodul local" ori de cate ori este disponibila
              memorie pentru acest nod. Daca ,,nodul local" nu este permis de
              contextul cpuset curent al procesului, nucleul va incerca sa
              aloce memorie din alte noduri. Nucleul va aloca memorie din
              ,,nodul local" ori de cate ori aceasta devine permisa de
              contextul cpuset curent al procesului.

       Politica de memorie a firelor de execu<?>ie este pastrata pe parcursul
       unui apel execve(2) <?>i este mo<?>tenita de firele de execu<?>ie copii
       create utilizand fork(2) sau clone(2).

VALOAREA RETURNATA
       In caz de succes, set_mempolicy() returneaza 0; in caz de eroare, se
       returneaza -1 <?>i errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EFAULT O parte din tot intervalul de memorie specificat de nodemask
              <?>i maxnode indica in afara spa<?>iului de adrese accesibil.

       EINVAL Argumentul mod nu este valid. Sau, mod este MPOL_DEFAULT <?>i
              masca de noduri nodemask nu este goala, sau mod este MPOL_BIND
              sau MPOL_INTERLEAVE <?>i nodemask este goala. Sau, maxnode
              specifica mai mult de o pagina de bi<?>i. Sau, nodemask
              specifica unul sau mai multe ID-uri de nod care sunt mai mari
              decat ID-ul maxim de nod acceptat. Sau, niciunul dintre ID-urile
              de nod specificate de nodemask nu este activ <?>i permis de
              contextul cpuset curent al procesului, sau niciunul dintre
              nodurile specificate nu con<?>ine memorie. Sau argumentul mod a
              specificat atat MPOL_F_STATIC_NODES, cat <?>i
              MPOL_F_RELATIVE_NODES. Sau, MPOL_F_NUMA_BALANCING nu este
              acceptat de nucleu sau este utilizat cu un mod altul decat
              MPOL_BIND.

       ENOMEM Nu a fost disponibila suficienta memorie pentru nucleu.

STANDARDE
       Linux.

ISTORIC
       Linux 2.6.7.

NOTE
       Politica de memorie nu este re<?>inuta daca pagina este transferata.
       Atunci cand o astfel de pagina este reimportata in memoriei, aceasta va
       utiliza politica firului sau a intervalului de memorie care este in
       vigoare la momentul alocarii paginii.

       Pentru informa<?>ii privind suportul de biblioteca, consulta<?>i
       numa(7).

CONSULTA<?>I <?>I
       get_mempolicy(2), getcpu(2), mbind(2), mmap(2), numa(3), cpuset(7),
       numa(7), numactl(8)

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.9.1   2 mai 2024                  set_mempolicy(2)