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. -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 swap. Liste dostepnych kolumn mozna znalezc w wyjsciu opcji --help. --output-all Wypisuje wszystkie dostepne kolumny. --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. 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.41 2025-03-29 SWAPON(8)