SWAPON(8) Administracja systemem SWAPON(8) NAZWA swapon, swapoff - wlacza/wylacza urzadzenia oraz pliki stronicowania i wymiany SKLADNIA swapon [opcje] [plik-specjalny...] swapoff [-va] [plik-specjalny...] OPIS Polecenie swapon jest uzywane do okreslania urzadzen do stronicowania i wymiany. Urzadzenie lub plik moze byc podany za pomoca parametru plik-specjalny. Moze miec on postac -L etykieta lub -U uuid, aby okreslic urzadzenie za pomoca etykiety lub uuid (unikatowego identyfikatora). Odwolanie do swapon normalnie powinno sie pojawiac w systemowych skryptach rozruchowych, udostepniajac wszystkie urzadzenia wymiany, dzieki czemu stronicowanie i wymiana jest rozlozone miedzy wiele urzadzen i plikow. Polecenie swapoff wylacza wymiane na podanych urzadzeniach i plikach. Jesli uzyto opcji -a, to swap jest wylaczany na wszystkich znanych urzadzeniach i plikach wymiany (zgodnie z plikiem /proc/swaps lub /etc/fstab). OPCJE -a, --all Udostepnia wszystkie urzadzenia oznaczone jako "swap" w pliku /etc/fstab, z wyjatkiem plikow z opcja "noauto". Urzadzenia, ktore sa juz uzywane jako swap, sa po cichu pomijane. Wiecej szczegolow w rozdziale KONFIGURACJA FSTAB. -T, --fstab sciezka Okresla alternatywny plik fstab, dla zachowania kompatybilnosci z mount(8). Jesli sciezka jest katalogiem, to pliki w katalogu sa sortowane za pomoca strverscmp(3); pliki zaczynajace sie od "." lub nieposiadajace rozszerzenia .fstab sa ignorowane. Mozna podac te opcje wiecej niz jeden raz. Jest ona wlasciwie przeznaczona dla skryptow chroot i initramfs, gdy podawana jest dodatkowa konfiguracja poza standardowa konfiguracja systemu. -d, --discard[=tryb] Wlacza odrzucanie (discard), jesli powiazane urzadzenie wymiany pozwala na operacje discard lub trim. Moze to pozytywnie wplynac na wydajnosc na niektorych dyskach polprzewodnikowych (SSD), ale czesto tak nie jest. Opcja pozwala na wybor sposrod dwoch dostepnych trybow odrzucania: --discard=once do przeprowadzania pojedynczych operacji odrzucania calej przestrzeni wymiany lub --discard=pages do asynchronicznego odrzucania zwolnionych stron wymiany przed udostepnieniem ich do ponownego uzycia. Jesli nie wybierze sie zadnego z tych trybow, to domyslnym zachowaniem jest wlaczenie ich obu. Mozna rowniez wlaczyc odrzucanie w /etc/fstab za pomoca opcji montowania discard, discard=once lub discard=pages. -e, --ifexists Pomija po cichu nieistniejace urzadzenia. Opcja montowania nofail w /etc/fstab moze rowniez posluzyc do pomijania nieistniejacych urzadzen. -f, --fixpgsz Ponownie inicjuje przestrzen wymiany (exec mkswap), jesli rozmiar strony nie pasuje do rozmiaru podawanego przez obecnie uruchomione jadro. Polecenie mkswap(8) inicjuje cale urzadzenie i nie sprawdza go pod katem blednych blokow. -L etykieta Uzywa partycji z okreslona etykieta (potrzebny jest w tym celu dostep do /proc/partitions). -o, --options opcje Podaje opcje swap jako liste, zgodna z formatem fstab, z przecinkiem jako separatorem. Na przyklad: swapon -o pri=1,discard=pages,nofail /dev/sda2 Lancuch opts jest przetwarzany ostatni i przeslania wszystkie inne opcje wiersza polecen. -p, --priority priorytet Okresla priorytet urzadzenia wymiany. Priorytet jest wartoscia z przedzialu pomiedzy 0 a 32767. Wieksza liczba oznacza wyzszy priorytet. Podrecznik polecenia swapon(2) zawiera pelny opis priorytetow swap. Do pliku /etc/fstab mozna dodac opcje pri=wartosc, ktora bedzie uzywana ze swapon -a. Jesli nie zdefiniowano priorytetu, to wartoscia domyslna jadra Linux bedzie wartosc ujemna. -s, --summary Wyswietla podsumowanie uzycia przestrzeni wymiany wg urzadzenia. Jest to odpowiednik cat /proc/swaps. Ten format wyjscia jest PRZESTARZALY. Zalecany format --show umozliwia wieksza kontrole nad danymi wyjsciowymi. --show[=kolumna...] Wyswietla mozliwa do zdefiniowania tabele obszarow wymiany. Liste dostepnych kolumn mozna znalezc w wyjsciu opcji --help. --output-all Wypisuje wszystkie dostepne kolumny. --annotate[=kiedy] Wypisuje adnotacje przy kazdej nazwie naglowka kolumny. Takie adnotacje moga byc pokazywane jako dymek na terminalach, ktore obsluguja te funkcje. Opcjonalny argument kiedy mozna ustawic na always (zawsze), never (nigdy) lub auto. Jesli pominie sie opcjonalny argument, to domyslnie przyjmuje wartosc auto oznaczajaca, ze adnotacje beda uzywane tylko wtedy, gdy wyjsciem jest terminal. --noheadings Nie wyswietla naglowkow w wyjsciu opcji --show. --raw Nie wyrownuje kolumn tabeli wyswietlanej przez --show. --bytes Opcja --show wyswietla rozmiar przestrzeni wymiany w bajtach, a nie w jednostkach czytelnych dla uzytkownika. -U uuid Uzywa partycji o okreslonym uuid (unikalnym identyfikatorze). -v, --verbose Wiecej szczegolow. -h, --help Wyswietla ten tekst i wychodzi. -V, --version Wyswietla wersje i wychodzi. KONFIGURACJA FSTAB Polecenie swapon --all odczytuje konfiguracje z /etc/fstab (lub pliku podanego opcja wiersza polecen --fstab). Istotne sa tylko wpisy fstab z typem systemu plikow (trzecim polem) ustawionym na "swap". Opcja --options akceptuje wartosci w takiej samej postaci, jaka mozna podac w czwartym polu pliku fstab. Pierwsze pole (zrodlo) Okresla zrodlo przestrzeni wymiany. Jesli zrodlo jest zwyklym plikiem, podaje sie je jako sciezke bezwzgledna. Jesli przestrzen wymiany jest urzadzeniem blokowym, mozna je zaadresowac sciezka urzadzenia, znacznikami przestrzeni wymiany LABEL= lub UUID= (wiecej szczegolow w podreczniku mkswap(8)) lub znacznikami partycji, takimi jak PARTLABEL= lub PARTUUID=. Drugie pole (cel) Nieuzywane przez swapon, zaleca sie wpisanie "none". Trzecie pole (typ) Wymaga podania "swap" jako typu systemu plikow. Czwarte pole (opcje) Jest to lista opcji rozdzielona przecinkami. Wszystkie nieznane opcje sa po cichu ignorowane. Jesli opcje sa niepotrzebne, zaleca sie wpisanie "defaults". Opcje podane w fstab rozszerzaja lub przeslaniaja ustawienia okreslone w wierszu polecenia swapon. Obslugiwane opcje przestrzeni wymiany: noauto Ignoruje wpis, gdy poda sie swapon --all. nofail Nie informuje o bledach urzadzenia, jesli ono nie istnieje. discard[=tryb] Wlacza odrzucanie w przestrzeni wymiany. Obslugiwane sa ustawienia: discard, discard=once lub discard=pages. Wiecej szczegolow w opisie opcji wiersza polecen --discard. pri=priorytet Okresla priorytet urzadzenia wymiany. Wiecej szczegolow w opisie opcji wiersza polecen --priority. Piate pole Nieuzywane przez swapon, zalecana sie pozostawienie go pustego. Szoste pole Nieuzywane przez swapon, zalecana sie pozostawienie go pustego. STATUS ZAKONCZENIA swapoff ma nastepujace wartosci kodow zakonczenia od wersji v2.36: 0 sukces 2 system ma zbyt malo pamieci aby zaprzestac uzywania przestrzeni wymiany (OOM) 4 wywolanie systemowe swapoff(2) nie powiodlo sie z innych przyczyn 8 blad wywolania systemowego niezwiazany ze swapoff(2) (za malo pamieci itp.) 16 blad uzycia lub skladni 32 wszystkie wywolania swapoff nie powiodly sie (przy uzyciu opcji --all) 64 czesc wywolan swapoff powiodla sie (przy uzyciu opcji --all) Polecenie swapoff --all zwraca 0 (wszystkie sie powiodly), 32 (wszystkie nie powiodly sie) lub 64 (czesc sie powiodla, a czesc nie). + Wersje starsze niz v2.36 nie maja udokumentowanego statusu zakonczenia, natomiast 0 oznacza sukces we wszystkich wersjach. SRODOWISKO LIBMOUNT_DEBUG=all wlacza wyjscie debugowania libmount. LIBBLKID_DEBUG=all wlacza wyjscie debugowania libblkid. PLIKI /dev/sd?? standardowe urzadzenia stronicowania /etc/fstab tablica opisujaca systemy plikow w ascii UWAGI Pliki z dziurami Implementacja pliku wymiany w jadrze spodziewa sie mozliwosci bezposrednich zapisow do pliku, to jest bez posrednictwa systemu plikow. Stanowi to problem na plikach z dziurami oraz na systemach plikow copy-on-write (kopiuj przy zapisie), takich jak Btrfs. Polecenia takie jak cp(1) lub truncate(1) tworza pliki z dziurami. Zostana one odrzucone przez swapon. Prealokowane pliki tworzone przez fallocate(1) moga byc rowniez interpretowane jako pliki z dziurami, w zaleznosci od systemu plikow. Prealokowane pliki wymiany sa obslugiwane w systemie plikow XFS od Linuksa 4.18. Najbardziej przenosnym rozwiazaniem jest tworzenie plikow wymiany za pomoca dd(1) i /dev/zero. Btrfs Pliki wymiany w systemie plikow Btrfs sa obslugiwane od Linuksa 5.0 (pliki z atrybutem nocow). Strona podrecznika systemowego btrfs(5) zawiera wiecej informacji na ten temat. Od wersji 2.41, polecenie mkswap --file moze tworzyc nowy plik wymiany z atrybutem nocow. NFS Przestrzen wymiany poprzez NFS moze nie dzialac. Stan wstrzymania Polecenie swapon automatycznie wykrywa i nadpisuje podpis przestrzeni wymiany ze starymi danymi wstrzymania (np. S1SUSPEND, S2SUSPEND, ...). Jest to konieczne, gdyz w przeciwnym wypadku nastapiloby uszkodzenie danych przy kolejnej probie wybudzenia. HISTORIA Polecenie swapon pojawilo sie w 4.0BSD. ZOBACZ TAKZE swapoff(2), swapon(2), fstab(5), init(8), fallocate(1), mkswap(8), mount(8), rc(8) ZGLASZANIE BLEDOW Problemy nalezy zglaszac w systemie sledzenia bledow . DOSTEPNOSC Polecenie swapon jest czescia pakietu util-linux, ktory mozna pobrac ze strony Archiwum jadra Linux . util-linux 2.42.3 2026-09-02 SWAPON(8)