FSTRIM(8)

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

SKŁADNIA

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

OPIS

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.

OPCJE

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.

STATUS ZAKOŃCZENIA

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

AUTORZY

ZOBACZ TAKŻE

blkdiscard(8), mount(8)

ZGŁASZANIE BŁĘDÓW

Problemy należy zgłaszać w

DOSTĘPNOŚĆ

Polecenie fstrim jest częścią pakietu util-linux, który można pobrać ze strony