НАЗВА

       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 (деякі невдало,
       деякі успішно).

АВТОРИ

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

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

       blkdiscard(8), mount(8)

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

       Для звітування щодо вад скористайтеся системою стеження за вадами -
       https://github.com/util-linux/util-linux/issues.

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

       Програма fstrim є частиною пакунка util-linux, який можна отримати з архіву ядра Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.