Provided by: manpages-it_3.73-2_all 
NOME
swapon, swapoff - start/stop swapping sul file/dispositivo
SINTASSI
#include <unistd.h> #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 viene restituito 0; in caso di errore -1 ed errno viene impostato di conseguenza.
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.
EINVAL (a partire da Linux 3.4)
(swapon()) Un valore di opzione non valido è sato specificato in flags.
EINVAL (swapoff()) il percorso attualmente non è un'area di swap.
ENFILE È stato raggiunto il limite del 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 3.73 del progetto Linux man-pages. Una descrizione del progetto, le
istruzioni per la segnalazione degli errori, e l'ultima versione di questa pagina si trova su
http://www.kernel.org/doc/man-pages/.
La versione italiana fa parte del pacchetto man-pages-it v. 3.73, a cura di: ILDP "Italian Linux
Documentation Project" http://www.pluto.it/ildp
Per la traduzione in italiano si può fare riferimento a http://www.pluto.it/ildp/collaborare/
Segnalare eventuali errori di traduzione a ildp@pluto.it