'\" t
.\"     Title: swapon
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "SWAPON" "8" "2025-03-29" "util\-linux 2.41" "Administracja systemem"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
swapon, swapoff \- włącza/wyłącza urządzenia oraz pliki stronicowania i wymiany
.SH "SKŁADNIA"
.sp
\fBswapon\fP [opcje] [\fIplik\-specjalny\fP...]
.sp
\fBswapoff\fP [\fB\-va\fP] [\fIplik\-specjalny\fP...]
.SH "OPIS"
.sp
Polecenie \fBswapon\fP jest używane do określania urządzeń do stronicowania i wymiany.
.sp
Urządzenie lub plik może być podany za pomocą parametru \fIplik\-specjalny\fP. Może mieć on postać \fB\-L\fP \fIetykieta\fP lub \fB\-U\fP \fIuuid\fP, aby określić urządzenie za pomocą etykiety lub uuid (unikatowego identyfikatora).
.sp
Odwołanie do \fBswapon\fP normalnie powinno się pojawiać w systemowych skryptach rozruchowych, udostępniając wszystkie urządzenia wymiany, dzięki czemu stronicowanie i wymiana jest rozłożone między wiele urządzeń i plików.
.sp
Polecenie \fBswapoff\fP wyłącza wymianę na podanych urządzeniach i plikach. Jeśli użyto opcji \fB\-a\fP, to swap jest wyłączany na wszystkich znanych urządzeniach i plikach wymiany (zgodnie z plikiem \fI/proc/swaps\fP lub \fI/etc/fstab\fP).
.SH "OPCJE"
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Udostępnia wszystkie urządzenia oznaczone jako "swap" w pliku \fI/etc/fstab\fP, z wyjątkiem plików z opcją "noauto". Urządzenia, które są już używane jako swap, są po cichu pomijane.
.RE
.sp
\fB\-T\fP, \fB\-\-fstab\fP \fIścieżka\fP
.RS 4
Określa alternatywny plik fstab, dla zachowania kompatybilności z \fBmount\fP(8). Jeśli \fIścieżka\fP jest katalogiem, to pliki w katalogu są sortowane za pomocą \fBstrverscmp\fP(3); pliki zaczynające się od "." lub nieposiadające rozszerzenia \fI.fstab\fP są ignorowane. Można podać tę opcję więcej niż jeden raz. Jest ona właściwie przeznaczona dla skryptów chroot i initramfs, gdy podawana jest dodatkowa konfiguracja poza standardową konfiguracją systemu.
.RE
.sp
\fB\-d\fP, \fB\-\-discard\fP[\fB=\fP\fItryb\fP]
.RS 4
Włącza odrzucanie (discard), jeśli powiązane urządzenie wymiany pozwala na operacje discard lub trim. Może to pozytywnie wpłynąć na wydajność na niektórych dyskach półprzewodnikowych (SSD), ale często tak nie jest. Opcja pozwala na wybór spośród dwóch dostępnych trybów odrzucania:
.sp
\fB\-\-discard=once\fP
.RS 4
do przeprowadzania pojedynczych operacji odrzucania całej przestrzeni wymiany lub
.RE
.sp
\fB\-\-discard=pages\fP
.RS 4
do asynchronicznego odrzucania zwolnionych stron wymiany przed udostępnieniem ich do ponownego użycia.
.RE
.sp
Jeśli nie wybierze się żadnego z tych trybów, to domyślnym zachowaniem jest włączenie ich obu. Można również włączyć odrzucanie w \fI/etc/fstab\fP za pomocą opcji montowania \fBdiscard\fP, \fBdiscard=once\fP lub \fBdiscard=pages\fP.
.RE
.sp
\fB\-e\fP, \fB\-\-ifexists\fP
.RS 4
Pomija po cichu nieistniejące urządzenia. Opcja montowania \fBnofail\fP w \fI/etc/fstab\fP może również posłużyć do pomijania nieistniejących urządzeń.
.RE
.sp
\fB\-f\fP, \fB\-\-fixpgsz\fP
.RS 4
Ponownie inicjuje przestrzeń wymiany (exec mkswap), jeśli rozmiar strony nie pasuje do rozmiaru podawanego przez obecnie uruchomione jądro. Polecenie \fBmkswap\fP(8) inicjuje całe urządzenie i nie sprawdza go pod kątem błędnych bloków.
.RE
.sp
\fB\-L\fP \fIetykieta\fP
.RS 4
Używa partycji z określoną \fIetykietą\fP (potrzebny jest w tym celu dostęp do \fI/proc/partitions\fP).
.RE
.sp
\fB\-o\fP, \fB\-\-options\fP \fIopcje\fP
.RS 4
Podaje opcje swap jako listę, zgodną z formatem \fIfstab\fP, z przecinkiem jako separatorem. Na przykład:
.sp
\fBswapon \-o pri=1,discard=pages,nofail /dev/sda2\fP
.sp
Łańcuch \fIopts\fP jest przetwarzany ostatni i przesłania wszystkie inne opcje wiersza poleceń.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP \fIpriorytet\fP
.RS 4
Określa priorytet urządzenia wymiany. \fIPriorytet\fP jest wartością z przedziału pomiędzy 0 a 32767. Większa liczba oznacza wyższy priorytet. Podręcznik polecenia \fBswapon\fP(2) zawiera pełny opis priorytetów swap. Do pliku \fI/etc/fstab\fP można dodać opcję \fBpri=\fP\fIwartość\fP, która będzie używana ze \fBswapon \-a\fP. Jeśli nie zdefiniowano priorytetu, to wartością domyślną jądra Linux będzie wartość ujemna.
.RE
.sp
\fB\-s\fP, \fB\-\-summary\fP
.RS 4
Wyświetla podsumowanie użycia przestrzeni wymiany wg urządzenia. Jest to odpowiednik \fBcat /proc/swaps\fP. Ten format wyjścia jest PRZESTARZAŁY. Zalecany format \fB\-\-show\fP umożliwia większą kontrolę nad danymi wyjściowymi.
.RE
.sp
\fB\-\-show\fP[\fB=\fP\fIkolumna\fP...]
.RS 4
Wyświetla możliwą do zdefiniowania tabelę obszarów swap. Listę dostępnych kolumn można znaleźć w wyjściu opcji \fB\-\-help\fP.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Wypisuje wszystkie dostępne kolumny.
.RE
.sp
\fB\-\-noheadings\fP
.RS 4
Nie wyświetla nagłówków w wyjściu opcji \fB\-\-show\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Nie wyrównuje kolumn tabeli wyświetlanej przez \fB\-\-show\fP.
.RE
.sp
\fB\-\-bytes\fP
.RS 4
Opcja \fB\-\-show\fP wyświetla rozmiar przestrzeni wymiany w bajtach, a nie w jednostkach czytelnych dla użytkownika.
.RE
.sp
\fB\-U\fP \fIuuid\fP
.RS 4
Używa partycji o określonym \fIuuid\fP (unikalnym identyfikatorze).
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Więcej szczegółów.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "STATUS ZAKOŃCZENIA"
.sp
\fBswapoff\fP ma następujące wartości kodów zakończenia od wersji v2.36:
.sp
\fB0\fP
.RS 4
sukces
.RE
.sp
\fB2\fP
.RS 4
system ma zbyt mało pamięci aby zaprzestać używania przestrzeni wymiany (OOM)
.RE
.sp
\fB4\fP
.RS 4
wywołanie systemowe \fBswapoff\fP(2) nie powiodło się z innych przyczyn
.RE
.sp
\fB8\fP
.RS 4
błąd wywołania systemowego niezwiązany ze \fBswapoff\fP(2) (za mało pamięci itp.)
.RE
.sp
\fB16\fP
.RS 4
błąd użycia lub składni
.RE
.sp
\fB32\fP
.RS 4
wszystkie wywołania swapoff nie powiodły się (przy użyciu opcji \fB\-\-all\fP)
.RE
.sp
\fB64\fP
.RS 4
część wywołań swapoff powiodła się (przy użyciu opcji \fB\-\-all\fP)
.RE
.sp
Polecenie \fBswapoff \-\-all\fP zwraca 0 (wszystkie się powiodły), 32 (wszystkie nie powiodły się) lub 64 (część się powiodła, a część nie).
.sp
+
Wersje starsze niż v2.36 nie mają udokumentowanego statusu zakończenia, natomiast 0 oznacza sukces we wszystkich wersjach.
.SH "ŚRODOWISKO"
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
włącza wyjście debugowania \fBlibmount\fP.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
włącza wyjście debugowania \fBlibblkid\fP.
.RE
.SH "PLIKI"
.sp
\fI/dev/sd??\fP
.RS 4
standardowe urządzenia stronicowania
.RE
.sp
\fI/etc/fstab\fP
.RS 4
tablica opisująca systemy plików w ascii
.RE
.SH "UWAGI"
.SS "Pliki z dziurami"
.sp
Implementacja pliku wymiany w jądrze spodziewa się możliwości bezpośrednich zapisów do pliku, to jest bez pośrednictwa systemu plików. Stanowi to problem na plikach z dziurami oraz na systemach plików copy\-on\-write (kopiuj przy zapisie), takich jak Btrfs.
.sp
Polecenia takie jak \fBcp\fP(1) lub \fBtruncate\fP(1) tworzą pliki z dziurami. Zostaną one odrzucone przez \fBswapon\fP.
.sp
Prealokowane pliki tworzone przez \fBfallocate\fP(1) mogą być również interpretowane jako pliki z dziurami, w zależności od systemu plików. Prealokowane pliki wymiany są obsługiwane w systemie plików XFS od Linuksa 4.18.
.sp
Najbardziej przenośnym rozwiązaniem jest tworzenie plików wymiany za pomocą \fBdd\fP(1) i \fI/dev/zero\fP.
.SS "Btrfs"
.sp
Pliki wymiany w systemie plików Btrfs są obsługiwane od Linuksa 5.0 (pliki z atrybutem \fBnocow\fP). Strona podręcznika systemowego \fBbtrfs\fP(5) zawiera więcej informacji na ten temat.
.sp
Od wersji 2.41, polecenie \fBmkswap \-\-file\fP może tworzyć nowy plik wymiany z atrybutem \fBnocow\fP.
.SS "NFS"
.sp
Przestrzeń wymiany poprzez \fBNFS\fP może nie działać.
.SS "Stan wstrzymania"
.sp
Polecenie \fBswapon\fP automatycznie wykrywa i nadpisuje podpis przestrzeni wymiany ze starymi danymi wstrzymania (np. \fBS1SUSPEND\fP, \fBS2SUSPEND\fP, ...). Jest to konieczne, gdyż w przeciwnym wypadku nastąpiłoby uszkodzenie danych przy kolejnej próbie wybudzenia.
.SH "HISTORIA"
.sp
Polecenie \fBswapon\fP pojawiło się w 4.0BSD.
.SH "ZOBACZ TAKŻE"
.sp
\fBswapoff\fP(2), \fBswapon\fP(2), \fBfstab\fP(5), \fBinit\fP(8), \fBfallocate\fP(1), \fBmkswap\fP(8), \fBmount\fP(8), \fBrc\fP(8)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBswapon\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."