'\" t
.\"     Title: fstrim
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "FSTRIM" "8" "2026-09-02" "util\-linux 2.42.3" "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"
fstrim \- odrzuca nieużywane bloki na zamontowanym systemie plików
.SH "SKŁADNIA"
.sp
\fBfstrim\fP [\fB\-v\fP] [\fB\-o\fP \fIprzesunięcie\fP] [\fB\-l\fP \fIdługość\fP] [\fB\-m\fP \fIminimalny\-rozmiar\fP] \fB\-A\fP|\fB\-a\fP|\fIpunkt\-montowania\fP
.SH "OPIS"
.sp
\fBfstrim\fP służy do odrzucania bloków ("discard" lub "trim") zamontowanego systemu plików, które nie są wykorzystywane przez system plików. Przydatne na urządzeniach SSD oraz nośnikach "rzadko" alokowanych.
.sp
Domyślnie, \fBfstrim\fP odrzuci wszystkie bloki nieużywane w systemie plików. Podając odpowiednie opcje można zmodyfikować to zachowanie, korzystając z zakresu lub rozmiaru, jak to opisano poniżej.
.sp
Argument \fIpunkt\-montowania\fP jest ścieżką do katalogu, w którym zamontowano system plików i jest wymagany o ile nie podano któregoś z argumentów: \fB\fI\-A\fP\fP, \fB\fI\-a\fP\fP, \fB\fI\-\-fstab\fP\fP lub \fB\fI\-\-all\fP\fP.
.sp
Częste stosowanie \fBfstrim\fP, lub nawet używanie \fBmount \-o discard\fP, może negatywnie wpłynąć na żywotność niskiej jakości nośników SSD. Na większość systemów biurkowych i serwerowych wystarcza cotygodniowe stosowanie odrzucania. Proszę zauważyć, że nie wszystkie urządzenia obsługują kolejkowane przycinanie, zatem każde polecenie przycinania powoduje obniżenie wydajności wszystkiego, co chciałoby użyć dysku w tym samym czasie.
.SH "OPCJE"
.sp
Po argumentach \fIprzesunięcie\fP, \fIdługość\fP i \fIminimalny\-rozmiar\fP mogą występować przyrostki binarne (2^N): 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") lub dziesiętne (10^N): KB (=1000), MB (=1000*1000) i podobnie dla GB, TB, PB, EB, ZB oraz YB.
.sp
\fB\-A, \-\-fstab\fP
.RS 4
Przycina wszystkie zamontowane systemy wymienione w \fI/etc/fstab\fP na urządzeniach, które obsługują operację przycinania. Główny system plików jest określany na podstawie wiersza polecenia jądra, jeśli nie ma go w tym pliku. Inne podane opcje, takie jak \fB\-\-offset\fP, \fB\-\-length\fP i \fB\-\-minimum\fP są stosowane wobec wszystkich tych urządzeń. Błędy z systemów plików nieobsługujących operacji odrzucania, urządzeń tylko do odczytu, systemów plików tylko do odczytu i autofs są po cichu ignorowane. Systemy plików z opcją montowania "X\-fstrim.notrim" są pomijane.
.RE
.sp
\fB\-a, \-\-all\fP
.RS 4
Przycina wszystkie zamontowane systemy na urządzeniach, które obsługują operację przycinania. Inne podane opcje, takie jak \fB\-\-offset\fP, \fB\-\-length\fP i \fB\-\-minimum\fP są stosowane wobec wszystkich tych urządzeń. Błędy z systemów plików nieobsługujących operacji odrzucania, urządzeń tylko do odczytu i systemów plików tylko do odczytu są po cichu ignorowane.
.RE
.sp
\fB\-n, \-\-dry\-run\fP
.RS 4
Opcja powoduje wykonanie wszystkiego poza faktycznym wywołaniem ioctl \fBFITRIM\fP.
.RE
.sp
\fB\-o, \-\-offset\fP \fIprzesunięcie\fP
.RS 4
Przesunięcie w bajtach, od którego rozpocznie się poszukiwanie wolnych bloków do odrzucenia. Domyślną wartością jest zero, rozpoczynające od początku systemu plików.
.RE
.sp
\fB\-l, \-\-length\fP \fIdługość\fP
.RS 4
Liczba bajtów (po punkcie początkowym) przeszukiwanych pod kątem wolnych bloków do odrzucenia. Jeśli podana wartość wykracza poza koniec systemu plików, \fBfstrim\fP zatrzyma się na granicy rozmiaru systemu plików. Domyślna wartość sięga do końca systemu plików.
.RE
.sp
\fB\-I, \-\-listed\-in\fP \fIlista\fP
.RS 4
Określa listę plików rozdzielonych dwukropkiem w formacie fstab lub mountinfo jądra. Wszystkie nieistniejące lub puste pliki są po cichu ignorowane. Sprawdzenie plików z \fIlisty\fP zatrzyma się po odnalezieniu pierwszego niepustego pliku. Na przykład:
.sp
\fB\-\-listed\-in /etc/fstab:/proc/self/mountinfo\fP.
.sp
Systemy plików z opcją montowania "X\-fstrim.notrim" w pliku fstab są pomijane.
.RE
.sp
\fB\-m, \-\-minimum\fP \fIminimalny\-rozmiar\fP
.RS 4
Minimalna ciągła wolna przestrzeń do odrzucania, w bajtach (wartość ta jest wewnętrznie zaokrąglana w górę do wielokrotności rozmiaru bloku systemu plików). Zignoruje wolne przestrzenie o mniejszym rozmiarze; ponadto \fBfstrim\fP dostosuje podane minimum, jeśli jest mniejsze od minimalnej wartości urządzenia, zgłaszając to (fstrim_range.minlen) do przestrzeni użytkownika. Zwiększając tę wartość, działanie \fBfstrim\fP będzie szybsze w przypadku systemów plików o znacznie pofragmentowanej wolnej przestrzeni, ale nie wszystkie bloki zostaną wówczas odrzucone. Domyślna wartość wynosi zero, co oznacza odrzucenie każdego wolnego bloku.
.RE
.sp
\fB\-t\fP, \fB\-\-types\fP \fIlista\fP
.RS 4
Określa dopuszczone i wykluczone typy systemów przy łącznym stosowaniu z \fB\-\-all\fP lub \fB\-\-fstab\fP. \fILista\fP jest listą nazw systemów plików, rozdzielonych przecinkami. \fILista\fP jest interpretowana w ten sam sposób, jak wzorce typów interpretuje \fBmount \-t\fP. Dopuszczone są tylko podane typy systemów plików. Wykluczone są wszystkie podane typy jeśli listę poprzedzi się słowem "no" albo poszczególne systemy plików poprzedzone przedrostkiem "no". Jeśli nie stosuje się tej opcji, dopuszczone są wszystkie systemy plików (oprócz "autofs").
.RE
.sp
\fB\-v, \-\-verbose\fP
.RS 4
Szczegółowe wykonanie. Z tą opcją \fBfstrim\fP wypisze liczbę bajtów przekazanych z systemu plików do stosu bloków do urządzenia, do potencjalnego odrzucenia. Jest to maksimum, jakie może zostać odrzucone z punktu widzenia urządzenia, ponieważ powtórne wywołania ioctl \fIFITRIM\fP będą powtórnie wysyłały do odrzucenia te same sektory.
.sp
\fBfstrim\fP zgłosi za każdym razem te same potencjalne bajty do odrzucenia, lecz jedynie sektory zapisane pomiędzy odrzuceniami zostałyby faktycznie odrzucone przez urządzenie. Co więcej, warstwa blokowa jądra rezerwuje sobie prawo do dostosowania zakresów odrzucenia, aby dopasować się do geometrii pasków raid, urządzeń niezdolnych do operacji "trim" w konfiguracjach LVM itp. Te redukcje nie byłyby odzwierciedlane w fstrim_range.len (opcja \fB\-\-length\fP).
.RE
.sp
\fB\-\-quiet\-unsupported\fP
.RS 4
Nie wyświetla błędów, jeśli operacja (ioctl) "trim" jest nieobsługiwana. Opcja przeznaczona do stosowania w plikach usług \fBsystemd\fP lub skryptach \fBcron\fP(8) do ukrywania ostrzeżeń będących wynikiem znanych problemów, takich jak sterownika NTFS zgłaszającego \fIBad file descriptor\fP (nieprawidłowy deskryptor pliku) w przypadku urządzenia zamontowanego tylko do odczytu, albo braku obsługi wywołania ioctl \fIFITRIM\fP przez system plików. Opcja czyści również status zakończenia, gdy poda się nieobsługiwany system plików w wierszu polecenia \fBfstrim\fP.
.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
0
.RS 4
sukces
.RE
.sp
1
.RS 4
niepowodzenie
.RE
.sp
32
.RS 4
wszystko się nie powiodło
.RE
.sp
64
.RS 4
odrzucenie na niektórych systemach plików powiodło się, a na innych zawiodło
.RE
.sp
Polecenie \fBfstrim \-\-all\fP zwraca 0 (wszystkie się powiodły), 32 (wszystkie zawiodły) lub 64 (niektóre się powiodły, a inne zawiodły).
.SH "AUTORZY"
.sp
.MTO "lczerner\(atredhat.com" "Lukas Czerner" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "ZOBACZ TAKŻE"
.sp
\fBblkdiscard\fP(8), \fBmount\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 \fBfstrim\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" "."