FSTRIM(8)

НАЗВА
fstrim - відкидання невикористаних блоків на змонтованій файловій системі

КОРОТКИЙ ОПИС

fstrim [-Aav] [-o offset] [-l length] [-m minimum-size] [mountpoint]

ОПИС

fstrim is used on a mounted filesystem to discard (or "trim") blocks which are not in use by the filesystem. This is useful for solid-state drives (SSDs) and thinly-provisioned storage.

Типово, fstrim відкине усі невикористані блоки у файловій системі. Для внесення змін до цієї поведінки на основі даних щодо діапазону або розміру, як це описано нижче, можна скористатися параметрами.

The mountpoint argument is the pathname of the directory where the filesystem is mounted and is required when -A, -a, --fstab, or --all are unspecified.

Частий запуск fstrim або навіть використання mount -o discard може негативно вплинути на строк експлуатації низькоякісних пристроїв SSD. Для більшості систем робочих станцій та серверів достатньою частотою обрізання є одне обрізання на тиждень. Зауважте, що підтримку обрізання за чергою передбачено не для усіх пристроїв, тому кожна команда обрізання передбачає штраф на швидкодію будь-яких інших спроб одночасного використання диска.

ПАРАМЕТРИ

Після аргументів відступ, довжина і мнімальний-розмір можна додавати суфікси одиниць KiB (=1024), MiB (=1024*1024) тощо для GiB, TiB, PiB, EiB, ZiB та YiB (частина «iB» є необов’язковою, наприклад, «K» є тим самим, що і «KiB») або суфікси KB (=1000), MB (=1000*1000) тощо для GB, TB, PB, EB, ZB і YB.

-A, --fstab
    Обрізати усі змонтовані файлові системи в /etc/fstab на пристроях, де передбачено підтримку операції відкидання. Кореневу файлову систему буде визначено з командного рядка ядра, якщо її запису немає у файлі. До усіх цих пристроїв буде застосовано інші надані параметри, зокрема --offset, --length і --minimum. Помилки від файлових систем, де не передбачено підтримки дії з відкидання, пристроїв, які призначено лише для читання, autofs та файлових систем, які призначено лише для читання, буде без повідомлень проігноровано. Файлові системи з параметром монтування «X-fstrim.notrim», буде пропущено.

-a, --all
    Обрізати усі змонтовані файлові системи на пристроях, де передбачено підтримку операції відкидання. До усіх цих пристроїв буде застосовано інші надані параметри, зокрема --offset, --length і --minimum. Помилки від файлових систем, де не передбачено підтримки дії з відкидання, пристроїв, які призначено лише для читання, та файлових систем, які призначено лише для читання, буде без повідомлень проігноровано.

-n, --dry-run
    Використання цього параметра призводить до виконання програмою усіх дій, окрім самого виклику керування введенням-виведенням FITRIM.

-o, --offset відступ
    Відступ у байтах у файловій системі, з якого слід починати пошук вільних блоків для відкидання. Типовим є нульове значення, тобто початок файлової системи.

-l, --length довжина
    Кількість байтів (після початкової точки) для пошуку вільних блоків для відкидання. Якщо вказане значення потрапить за кінець файлової системи, fstrim зупиниться на межі файлової системи. Типовим значенням аргументу є кінець файлової системи.

-I, --listed-in список
    Визначає список відокремлених двокрапками назв файлів у форматі fstab або mountinfo ядра. Усі файли, яких не буде знайдено, або порожні файли буде без повідомлень проігноровано. Обробку списку буде зупинено після виявлення першого непорожнього файла. Приклад:

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

    Файлові системі із параметром монтування «X-fstrim.notrim» у fstab буде пропущено.

-m, --minimum мінімальний-розмір
    Мінімальний неперервний вільний діапазон, який можна відкинути, у байтах. (Це значення на внутрішньому рівні буде округлено до кратного до розміру блоку файлової системи.) Менші за розміром вільні діапазони буде проігноровано, а fstrim скоригує мінімальне значення, якщо воно менше за мінімальне значення для пристрою, і повідомить це значення (fstrim_range.minlen) у простір користувача. Якщо збільшити це значення, завершення роботи fstrim буде швидшим у файлових системах і дуже фрагментованим вільним простором, хоча при цьому не усі блоки буде відкинуто. Типовим є нульове значення, за якого буде відкинуто усі вільні блоки.

-t, --types список
    Specifies allowed or forbidden filesystem types when used with --all or --fstab. The list is a comma-separated list of the filesystem names. The list follows how mount -t evaluates type patterns. Only specified filesystem types are allowed. All specified types are forbidden if the list is prefixed by "no" or each filesystem prefixed by "no" is forbidden. If the option is not used, then all filesystems (except "autofs") are allowed.

-v, --verbose
    Режим докладних повідомлень. Якщо вказано цей параметр, fstrim виводитиме дані щодо кількості переданих зі стосу блоків файлової системи байтів до пристрою для потенційного відкидання. Це число буде максимальною величиною відкидання з точки зору пристрою для зберігання даних, оскільки повторний виклик керування введенням-виведенням FITRIM продовжуватиме повторно надсилати ті самі сектори для відкидання.

    fstrim will report the same potential discard bytes each time, but only sectors which had been written to between the discards would actually be discarded by the storage device. Further, the kernel block layer reserves the right to adjust the discard ranges to fit raid stripe geometry, non-trim capable devices in a LVM setup, etc. These reductions would not be reflected in fstrim_range.len (the --length option).

--quiet-unsupported
    Придушити повідомлення про помилки, якщо підтримки дії з обрізання (ioctl) не передбачено. Цей параметр слід використовувати у файлі служби systemd або у скриптах cron(8) для приховування попереджень, які є результатом відомих проблем, зокрема того, що драйвер NTFS надсилає повідомлення Помилковий дескриптор файла, якщо пристрій змонтовано у режимі «лише читання», або того, що у файловій системі не передбачено підтримки виклику керування введенням-виведенням FITRIM. Використання цього параметра також знімає ненульовий стан виходу, якщо у рядку команди fstrim вказано непідтримувану файлову систему.

-h, --help
    Вивести текст довідки і завершити роботу.

-V, --version
    Вивести дані щодо версії і завершити роботу.

СТАН ВИХОДУ

0
    успіх

1
    помилка

32
    помилки для усіх

64
    для деяких файлових системі відкидання було успішним, а для деяких - ні

Команда fstrim --all повертає 0 (усі успішно), 32 (усі невдало) або 64 (деякі невдало, деякі успішно).

АВТОРИ

ТАКОЖ ПЕРЕГЛЯНЬТЕ

blkdiscard(8), mount(8)

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

Для звітування щодо вад скористайтеся системою стеження за вадами -

ДОСТУП ДО ПРОГРАМИ

Програма fstrim є частиною пакунка util-linux, який можна отримати з