SWAPON(2)

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

SINTASSI
#include <unistd.h>
#include <asm/page.h> /* to find PAGE_SIZE */
#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 device a blocchi o sul file specificato in path.

swapon() prende l'argomento swapflags. Se swapflags ha il bit SWAP_FLAG_PREFER attivato la nuova area di swap avrà una priorità maggiore del default. La priorità è codificata in swapflags come:

(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

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 di default è 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 maggiori rispetto a quella di default. 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. Prima di usare un'area con una certa priorità tutte quelle con priorità maggiore sono state utilizzate. 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 ( ?!?! ndt )

VALORI RESTITUITI
In caso di successo viene restituito 0, altrimenti -1 ed errno contine il codice di 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; o, per swapon(), il percorso indicato non contiene una firma di swap valida o risiede in un file system in memoria come tmpfs; o, per 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.6.10, il valore di MAX_SWAPFILES era 8; dal kernel 2.6.10 il valore è 32. A partire dal kernel 2.6.18 il limite è sceso di due unità (quindi: 30) se nel kernel è integrata 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)).

VEDERE ANCHE
mkswap(8), swapoff(8), swapon(8)