'\" t
.\"     Title: mkswap
.\"    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 "MKSWAP" "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"
mkswap \- konfiguruje linuksowy obszar wymiany
.SH "SKŁADNIA"
.sp
\fBmkswap\fP [opcje] \fIurządzenie\fP [\fIbloki\fP]
.sp
\fBmkswap\fP [opcje] \-\-size \fIrozmiar\fP \-\-file \fIplik\fP
.SH "OPIS"
.sp
\fBmkswap\fP konfiguruje linuksowy obszar wymiany na urządzeniu lub w pliku.
.sp
Argument \fIurządzenie\fP zwykle jest partycją dyskową (czymś w stylu \fI/dev/sdb7\fP), lecz może być również plikiem. Jądro Linux nie zważa na identyfikatory partycji, lecz wiele skryptów instalacyjnych zakłada, że partycje typu (szesnastkowo) 82 (LINUX_SWAP) są partycjami wymiany. (\fBUwaga: Solaris również używa tego typu. Proszę uważać, aby nie zniszczyć swoich partycji solarisowych\fP.)
.sp
Parametr \fIbloki\fP jest niepotrzebny, lecz został zachowany w celu zgodności wstecznej. Określa on potrzebny rozmiar wymiany w blokach 1024\-bajtowych. \fBmkswap\fP w przypadku pominięcia tego parametru używa całej partycji lub całego pliku. Podawanie tego parametru jest niemądre \- literówka może zniszczyć dysk.
.sp
Po utworzeniu obszaru wymiany, konieczne jest użycie polecenia \fBswapon\fP(8), aby go aktywować. Obszary wymiany są zwykle uwzględniane w \fI/etc/fstab\fP, więc mogą być włączane do użytku podczas rozruchu poleceniem \fBswapon \-a\fP, w jakimś skrypcie startowym.
.SH "OSTRZEŻENIE"
.sp
Nagłówek obszaru wymiany nie używa pierwszego bloku. Może znajdować się tam program rozruchowy lub etykieta partycji, ale nie jest to polecane ustawienie. Zalecaną konfiguracją linuksowej przestrzeni wymiany jest użycie oddzielnej partycji.
.sp
\fBmkswap\fP, podobnie jak wiele innych narzędzi mkfs, \fBusuwa pierwszy blok partycji aby ukryć istniejący wcześniej system plików\fP.
.sp
\fBmkswap\fP odmówi jednak usunięcia pierwszego bloku urządzenia na urządzeniu z etykietą dysku (SUN, BSD, ... \- nie mylić z etykietą partycji).
.SH "OPCJE"
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
Sprawdza urządzenie (jeśli jest urządzeniem blokowym) w poszukiwaniu uszkodzonych bloków przed utworzeniem obszaru wymiany. Jeśli znajdzie uszkodzone bloki, wypisze ich liczbę.
.RE
.sp
\fB\-F\fP, \fB\-\-file\fP
.RS 4
Tworzy plik wymiany, z odpowiednimi uprawnieniami plików i utworzonymi blokami na dysku.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
Wymusza działanie, nawet jeśli polecenie jest idiotyczne. Umożliwia to utworzenie obszaru wymiany większego niż plik lub partycja, na którym się ono znajduje.
.sp
Poza tym, bez tej opcji, \fBmkswap\fP odmówi usunięcia pierwszego bloku na urządzeniu z tablicą partycji.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
Wyłącza wyświetlanie wyników i ostrzeżeń.
.RE
.sp
\fB\-L\fP, \fB\-\-label\fP \fIetykieta\fP
.RS 4
Określa \fIetykietę\fP urządzenia, pozwalając wykonać \fBswapon\fP(8) przez podanie etykiety.
.RE
.sp
\fB\-\-lock\fP[\fB=\fP\fItryb\fP]
.RS 4
Używa blokady na wyłączność BSD do urządzeń i plików na których działa. Opcjonalnym argumentem \fItryb\fP może być \fByes\fP, \fBno\fP (albo \fB1\fP lub \fB0\fP) lub też \fBnonblock\fP. Jeśli nie poda się \fItrybu\fP, domyślną wartością jest \fByes\fP. Opcja ta przesłania zmienną środowiskową \fB$LOCK_BLOCK_DEVICE\fP. Choć domyślnie nie jest używana żadna blokada, zaleca się jej użycie aby uniknąć kolizji z \fBsystemd\-udevd\fP(8) i innymi narzędziami.
.RE
.sp
\fB\-p\fP, \fB\-\-pagesize\fP \fIrozmiar\fP
.RS 4
Określa \fIrozmiar\fP (w bajtach) używanej strony. Podanie tej opcji jest zwykle niepotrzebne \- \fBmkswap\fP odczyta odpowiedni rozmiar z jądra.
.RE
.sp
\fB\-U\fP, \fB\-\-uuid\fP \fIUUID\fP
.RS 4
Określa uniwersalny, unikatowy identyfikator (universally unique identifier \- UUID) systemu plików na \fIUUID\fP. Domyślnie UUID jest generowany. UUID składa się z serii cyfr w systemie szesnastkowym, oddzielonych myślnikami, jak np.: "c1b9d5a2\-f162\-11cf\-9ece\-0020afc76f16". Parametr \fIUUID\fP może przyjmować też następujące wartości:
.sp
\fBclear\fP
.RS 4
usuwa UUID systemu plików
.RE
.sp
\fBrandom\fP
.RS 4
generuje nowy, losowy UUID
.RE
.sp
\fBtime\fP
.RS 4
generuje nowy UUID, oparty na czasie
.RE
.RE
.sp
\fB\-e\fP, \fB\-\-endianness\fP \fIKOLEJNOŚĆ\-BAJTÓW\fP
.RS 4
Określa \fIKOLEJNOŚĆ\-BAJTÓW\fP, jaka będzie stosowana; prawidłowe wartości to: \fBnative\fP, \fBlittle\fP lub \fBbig\fP. Domyślną jest \fBnative\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIprzesunięcie\fP
.RS 4
Określa \fIprzesunięcie\fP do zapisania przestrzeni wymiany.
.RE
.sp
\fB\-s\fP, \fB\-\-size\fP \fIrozmiar\fP
.RS 4
Określa rozmiar tworzonego pliku wymiany w bajtach, po którym mogą występować przyrostki oznaczające wielokrotność: KiB (=1024), MiB (=1024*1024) i tak dalej dla GiB, TiB, PiB, EiB, ZiB oraz YiB (część "iB" jest opcjonalna, na przykład "K" ma to samo znaczenie, co "KiB"). Jeśli plik istnieje i ma rozmiar większy od \fIrozmiaru\fP, zostanie przycięty do podanej wartości. Opcja ta ma sens tylko w połączeniu z \fB\-\-file\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-swapversion 1\fP
.RS 4
Podaje wersję przestrzeni wymiany. Opcja ta jest obecnie bezużyteczna, jako że dawna opcja \fB\-v 0\fP stała się przestarzała i obecnie obsługiwana jest wyłącznie \fB\-v 1\fP. Jądro nie obsługuje przestrzeni wymiany w formacie v0 od wersji 2.5.22 (czerwiec 2002). Nowa wersja v1 jest obsługiwana od jądra 2.1.117 (sierpień 1998).
.RE
.sp
\fB\-\-verbose\fP
.RS 4
Więcej informacji. Ta opcja powoduje, że \fBmkswap\fP wypisuje więcej szczegółów o wykrytych problemach przy tworzeniu przestrzeni wymiany.
.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 "ŚRODOWISKO"
.sp
LIBBLKID_DEBUG=all
.RS 4
włącza wyjście debugowania libblkid.
.RE
.sp
LOCK_BLOCK_DEVICE=<tryb>
.RS 4
używa blokady na wyłączność BSD. Tryb to "1" lub "0". Więcej informacji w opisie opcji \fB\-\-lock\fP.
.RE
.SH "UWAGI"
.sp
Maksymalny użyteczny rozmiar obszaru wymiany zależy od architektury i wersji jądra.
.sp
Maksymalną liczbą stron możliwych do zaadresowania przez nagłówek obszaru wymiany jest 4294967295 (32\-bitowa liczba całkowita bez znaku). Pozostała przestrzeń urządzenia wymiany jest ignorowana.
.sp
Aktualnie, Linux pozwala na 32 przestrzenie wymiany. Używane obszary można zobaczyć w pliku \fI/proc/swaps\fP.
.sp
\fBmkswap\fP odmówi działania w przypadku przestrzeni wymiany mniejszych niż 10 stron.
.sp
Jeśli nie wiadomo jaki rozmiar strony jest używany przez dany komputer, można to sprawdzić poleceniem \fBgetconf PAGESIZE\fP.
.sp
Oprócz wykonania \fBmkswap \-\-file\fP, można również utworzyć plik wymiany ręcznie, przed zainicjowaniem go za pomocą \fBmkswap\fP, np. korzystając z polecenia w stylu
.sp
Od wersji 2.41, \fBmkswap \-\-file\fP ustawia nowo tworzonym plikom atrybut nocow, aby obsługiwać pliki wymiany w systemie plików Btrfs.
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=plik_wymiany bs=1MiB count=$((8*1024))
.fam
.fi
.if n .RE
.sp
do utworzenia pliku_wymiany o rozmiarze 8GiB.
.sp
W takim przypadku, proszę zapoznać się z uwagami w podręczniku \fBswapon\fP(8), aby dowiedzieć się o \fBograniczeniach plików wymiany\fP (problemy z: plikami z dziurami, wstępną alokacją, kopiowaniem przy zapisie).
.SH "ZOBACZ TAKŻE"
.sp
\fBfdisk\fP(8), \fBswapon\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 \fBmkswap\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" "."