swapon(2)                     System Calls Manual                    swapon(2)

NUME
       swapon, swapoff - porne<?>te/opre<?>te gestionarea spa<?>iului de
       interschimb (memoria virtuala, ,,swap") din fi<?>ier/dispozitiv

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <sys/swap.h>

       int swapon(const char *path, int swapflags);
       int swapoff(const char *path);

DESCRIERE
       swapon() activeaza spa<?>iul de interschimb din fi<?>ierul sau
       dispozitivul de blocuri specificat de path.  swapoff() dezactiveaza
       spa<?>iul de interschimb din fi<?>ierul sau dispozitivul de blocuri
       specificat de path.

       Daca in argumentul SWAP_FLAG_PREFER este specificat fanionul swapon()
       swapflags, noul spa<?>iu de interschimb va avea o prioritate mai mare
       decat cea implicita.  Prioritatea este codificata in swapflags sub
       forma: swapflags:

           (prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

       In cazul in care in argumentul SWAP_FLAG_DISCARD este specificat in
       argumentul swapon() swapflags, paginile de interschimb eliberate vor fi
       inlaturate inainte de a fi reutilizate, daca dispozitivul de
       interschimb suporta opera<?>ia de inlaturare sau de taiere; (acest
       lucru poate imbunata<?>i performan<?>ele pe unele dispozitive cu stare
       solida, dar adesea nu o face). A se vedea, de asemenea, sec<?>iunea
       NOTE.

       Aceste func<?>ii pot fi utilizate numai de catre un proces privilegiat
       (unul care are capacitatea CAP_SYS_ADMIN).

   Prioritate
       Fiecare spa<?>iu de interschimb are o prioritate, fie mare, fie mica.
       Prioritatea implicita este mica. In cadrul spa<?>iilor cu prioritate
       redusa, spa<?>iile mai noi au o prioritate <?>i mai redusa decat cele
       mai vechi.

       Toate priorita<?>ile stabilite cu swapflags sunt de prioritate inalta,
       mai mari decat cele implicite. Acestea pot avea orice valoare
       nenegativa aleasa de apelant. Un numar mai mare inseamna o prioritate
       mai mare.

       Paginile de interschimb sunt alocate din zone in ordinea priorita<?>ii,
       cu prioritate maxima. In cazul zonelor cu priorita<?>i diferite, o zona
       cu prioritate mai mare este epuizata inainte de a utiliza o zona cu
       prioritate mai mica. In cazul in care doua sau mai multe zone au
       aceea<?>i prioritate, iar aceasta este cea mai mare prioritate
       disponibila, paginile sunt alocate pe baza de rota<?>ie intre ele.

       Incepand cu Linux 1.3.6, nucleul respecta de obicei aceste reguli, dar
       exista <?>i excep<?>ii.

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

ERORI-IE<?>IRE
       EBUSY  (pentru swapon()) path specificata este deja utilizata ca
              spa<?>iu de interschimb.

       EINVAL Fi<?>ierul path exista, dar nu se refera nici la un fi<?>ier
              obi<?>nuit, nici la un dispozitiv de blocuri;

       EINVAL (swapon()) Ruta indicata nu con<?>ine o semnatura de spa<?>iu de
              interschimb valida sau se afla pe un sistem de fi<?>iere in
              memorie, cum ar fi tmpfs(5).

       EINVAL (incepand cu Linux 3.4)
              (swapon()) In swapflags a fost specificata o valoare nevalida a
              fanionului.

       EINVAL (swapoff()) path nu este in prezent un spa<?>iu de interschimb.

       ENFILE Limita la nivel de sistem a numarului total de fi<?>iere
              deschise a fost atinsa.

       ENOENT Fi<?>ierul path nu exista.

       ENOMEM Sistemul nu are suficienta memorie pentru a ini<?>ia gestionarea
              spa<?>iului de interschimb.

       EPERM  Apelantul nu are capacitatea CAP_SYS_ADMIN. Alternativ, numarul
              maxim de fi<?>iere de spa<?>ii de interschimb (swap) este deja
              utilizat; a se vedea sec<?>iunea NOTE de mai jos.

STANDARDE
       Linux.

ISTORIC
       Argumentul swapflags a fost introdus in Linux 1.3.2.

NOTE
       Parti<?>ia sau ruta trebuie sa fie pregatita cu mkswap(8).

       Exista o limita superioara a numarului de fi<?>iere de interschimb
       ,,swap" care pot fi utilizate, definita de constanta nucleului
       MAX_SWAPFILES. Inainte de Linux 2.4.10, MAX_SWAPFILES avea valoarea 8;
       incepand cu Linux 2.4.10, aceasta are valoarea 32. Incepand cu Linux
       2.6.18, limita este diminuata cu 2 (deci 30); incepand cu Linux 5.19,
       limita este diminuata cu 3 (deci: 29) daca nucleul este construit cu
       op<?>iunea CONFIG_MIGRATION (care rezerva doua intrari in tabelul de
       interschimb pentru caracteristicile de migrare a paginilor din mbind(2)
       <?>i migrate_pages(2)). Incepand cu Linux 2.6.32, limita este redusa
       <?>i mai mult cu 1 daca nucleul este construit cu op<?>iunea
       CONFIG_MEMORY_FAILURE. Incepand cu Linux 5.14, limita este redusa <?>i
       mai mult cu 4 daca nucleul este construit cu op<?>iunea
       CONFIG_DEVICE_PRIVATE. Incepand cu Linux 5.19, limita este redusa
       suplimentar cu 1 daca nucleul este construit cu op<?>iunea
       CONFIG_PTE_MARKER.

       Retragerea paginilor de interschimb a fost introdusa in Linux 2.6.29,
       apoi a fost condi<?>ionata de fanionul SWAP_FLAG_DISCARD in Linux
       2.6.36, care inca inlatura intreaga zona de interschimb atunci cand
       este apelat swapon(), chiar daca bitul de fanion nu este activat.

CONSULTA<?>I <?>I
       mkswap(8), swapoff(8), swapon(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.06 22 decembrie 2023                     swapon(2)