FSTRIM(8) Administracja systemem FSTRIM(8)

fstrim - odrzuca nieużywane bloki na zamontowanym systemie plików

fstrim [-v] [-o przesunięcie] [-l długość] [-m minimalny-rozmiar] -A|-a|punkt-montowania

fstrim 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.

Domyślnie, fstrim 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.

Argument punkt-montowania jest ścieżką do katalogu, w którym zamontowano system plików i jest wymagany o ile nie podano któregoś z argumentów: -A, -a, --fstab lub --all.

Częste stosowanie fstrim, lub nawet używanie mount -o discard, 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.

Po argumentach przesunięcie, długość i minimalny-rozmiar 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.

-A, --fstab

Przycina wszystkie zamontowane systemy wymienione w /etc/fstab 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 --offset, --length i --minimum 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.

-a, --all

Przycina wszystkie zamontowane systemy na urządzeniach, które obsługują operację przycinania. Inne podane opcje, takie jak --offset, --length i --minimum 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.

-n, --dry-run

Opcja powoduje wykonanie wszystkiego poza faktycznym wywołaniem ioctl FITRIM.

-o, --offset przesunięcie

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.

-l, --length długość

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, fstrim zatrzyma się na granicy rozmiaru systemu plików. Domyślna wartość sięga do końca systemu plików.

-I, --listed-in lista

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 listy zatrzyma się po odnalezieniu pierwszego niepustego pliku. Na przykład:

--listed-in /etc/fstab:/proc/self/mountinfo.

Systemy plików z opcją montowania "X-fstrim.notrim" w pliku fstab są pomijane.

-m, --minimum minimalny-rozmiar

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 fstrim 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 fstrim 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.

-t, --types lista

Określa dopuszczone i wykluczone typy systemów przy łącznym stosowaniu z --all lub --fstab. Lista jest listą nazw systemów plików, rozdzielonych przecinkami. Lista jest interpretowana w ten sam sposób, jak wzorce typów interpretuje mount -t. 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").

-v, --verbose

Szczegółowe wykonanie. Z tą opcją fstrim 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 FITRIM będą powtórnie wysyłały do odrzucenia te same sektory.

fstrim 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 --length).

--quiet-unsupported

Nie wyświetla błędów, jeśli operacja (ioctl) "trim" jest nieobsługiwana. Opcja przeznaczona do stosowania w plikach usług systemd lub skryptach cron(8) do ukrywania ostrzeżeń będących wynikiem znanych problemów, takich jak sterownika NTFS zgłaszającego Bad file descriptor (nieprawidłowy deskryptor pliku) w przypadku urządzenia zamontowanego tylko do odczytu, albo braku obsługi wywołania ioctl FITRIM przez system plików. Opcja czyści również status zakończenia, gdy poda się nieobsługiwany system plików w wierszu polecenia fstrim.

-h, --help

Wyświetla ten tekst i wychodzi.

-V, --version

Wyświetla wersję i wychodzi.

0

sukces

1

niepowodzenie

32

wszystko się nie powiodło

64

odrzucenie na niektórych systemach plików powiodło się, a na innych zawiodło

Polecenie fstrim --all zwraca 0 (wszystkie się powiodły), 32 (wszystkie zawiodły) lub 64 (niektóre się powiodły, a inne zawiodły).

Lukas Czerner <lczerner@redhat.com>, Karel Zak <kzak@redhat.com>

blkdiscard(8), mount(8)

Problemy należy zgłaszać w systemie śledzenia błędów https://github.com/util-linux/util-linux/issues.

Polecenie fstrim jest częścią pakietu util-linux, który można pobrać ze strony Archiwum jądra Linux https://www.kernel.org/pub/linux/utils/util-linux/.

2026-09-02 util-linux 2.42.3