NOME

       swapon, swapoff - start/stop swapping sul file/dispositivo

SINTASSI

       #include <sys/swap.h>

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

DESCRIZIONE

       swapon()  imposta  lo  swap  sul  dispositivo  a  blocchi  o sul file specificato in path.
       swapoff() ferma lo swap sul dispositivo a blocchi o sul file specificato in path.

       Se nell'argomento swapflags di swapon() è specificata l'opzione SWAP_FLAG_PREFER, la nuova
       area di swap avrà una priorità maggiore di quella predefinita. La priorità è codificata in
       swapflags come:

           (prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

       Se nell'argomento swapflags di swapon()  è  specificata  l'opzione  SWAP_FLAG_DISCARD,  le
       pagine  di swap liberate saranno segnate come scartate prima di essere riutilizzate, se il
       dispositivo di swap supporta l'operazione discard o trim. (Questo potrebbe  migliorare  le
       prestazioni  di alcuni Dispositivi a Stato Solido, ma spesso non avviene). Vedere anche la
       sezione NOTE.

       Queste funzioni possono essere usate solo da un  processo  privilegiato  (uno  che  ha  le
       funzionalità CAP_SYS_ADMIN).

   Priorità
       Ogni  area di swap ha una sua priorità, sia essa alta o bassa. Quella predefinita è bassa.
       Tra le aree a bassa priorità le aree più nuove hanno sempre una priorità più  bassa  delle
       aree più vecchie.

       Tutte  le priorità impostate attraverso swapflags sono ad alta prorità, più alta di quella
       predefinita. Esse possono avere qualunque valore non  negativo  scelto  dal  chiamante.  A
       numero maggiore corrisponde priorità maggiore.

       Le  pagine  di swap sono allocate in aree in ordine di priorità, prima quelle con priorità
       maggiore.  Per aree aventi priorità diverse, un'area con priorità più alta viene  esaurita
       prima  che  venga  usata  un'area  a  priorità più bassa. Se vi sono due o più aree con la
       stessa priorità, ed è la massima priorità disponibile, le pagine sono allocate secondo uno
       schema a "round-robin".

       Fino al kernel 1.3.6, si seguivano queste regole, ma con alcune eccezioni.

VALORE RESTITUITO

       In  caso  di  successo  restituisce  zero. In caso di errore restituisce -1, e errno verrà
       impostato per indicare l'errore.

ERRORI

       EBUSY  (per swapon()) Il percorso specificato è già stato usato come area di swap.

       EINVAL Il percorso del file esiste, ma non fa riferimento nè a un file regolare, nè  a  un
              dispositivo a blocchi.

       EINVAL (swapon())  Il percorso indicato non contiene una firma di swap valida o risiede in
              un filesystem in memoria come tmpfs(5).

       EINVAL (a partire da Linux 3.4)
              (swapon()) Un valore di opzione non valido è sato specificato in swapflags.

       EINVAL (swapoff()) percorso attualmente non è un'area di swap.

       ENFILE E' stato raggiunto il limite per l'intero sistema sul numero totale di file aperti.

       ENOENT Il percorso del file non esiste.

       ENOMEM Il sistema ha memoria insufficiente per iniziare lo swapping.

       EPERM  Il chiamante non ha  la  funzionalità  CAP_SYS_ADMIN.  In  alternativa,  il  numero
              massimo di file di swap è già in uso; vedere le NOTE sotto.

CONFORME A

       Queste  funzioni  sono  specifiche di Linux e non devono essere usate in programmi pensati
       per essere portabili. Il secondo argomento swapflags è stato introdotto in Linux 1.3.2.

NOTE

       La partizione o percorso devono essere preparati con mkswap(8).

       C'è un limite superiore al numero di file di swap che si  possono  usare,  definito  dalla
       costante del kernel MAX_SWAPFILES. Prima del kernel 2.4.10, il valore di MAX_SWAPFILES era
       8; dal kernel 2.4.10 il valore è 32. A partire dal kernel 2.6.18 il limite è sceso di  due
       unità  (quindi:  30)  se il kernel è compilato con l'opzione CONFIG_MIGRATION (che riserva
       due voci nella tabella di swap per le funzionalità di migrazione  di  pagina  del  comando
       mbind(2) e migrate_pages(2)). A partire dal kernel 2.6.32, il limite è sceso ulteriormente
       di 1 se il kernel è compilato con l'opzione CONFIG_MEMORY_FAILURE.

       Lo scarto di pagine di swap è stato  introdotto  nel  kernel  2.6.29  e  reso  in  seguito
       dipendente  dall'opzione  SWAP_FLAG_DISCARD  nel kernel 2.6.36, che scarta ancora l'intera
       area di swap quando swapon() viene chiamato, anche se il bit dell'opzione non è impostato.

VEDERE ANCHE

       mkswap(8), swapoff(8), swapon(8)

COLOPHON

       Questa pagina fa parte del rilascio 5.13 del progetto Linux man-pages. Una descrizione del
       progetto,  le  istruzioni  per la segnalazione degli errori, e l'ultima versione di questa
       pagina si trovano su https://www.kernel.org/doc/man-pages/.

TRADUZIONE

       La traduzione italiana di questa pagina di manuale è stata creata da  Goffredo  Baroncelli
       <kreijack@usa.net>,  Giulio  Daprelà  <giulio@pluto.it>,  Elisabetta  Galli <lab@kkk.it> e
       Marco Curreli <marcocurreli@tiscali.it>

       Questa traduzione è documentazione libera; leggere la GNU General Public License  Versione
       3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o successiva per le condizioni di copyright.
       Non ci assumiamo alcuna responsabilità.

       Per segnalare errori nella traduzione di questa pagina di manuale inviare un  messaggio  a
       ⟨pluto-ildp@lists.pluto.it⟩.