НАЗВА

       blkzone - запуск команди зони на пристрої

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

       blkzone команда [параметри] пристрій

ОПИС

       blkzone використовують для запуску команд обробки зон на пристрої, де передбачено
       підтримку Zoned Block Commands (ZBC) або Zoned-device ATA Commands (ZAC). Зони, з якими
       слід працювати, може бути вказано за допомогою параметрів відступу, кількості та довжину.

       Аргумент пристрій визначає шлях до блокового пристрою.

КОМАНДИ

   report
       Команду blkzone report використовують для створення звітів щодо зон пристрою.

       Типово, команда повідомить про усі зони від початку блокового пристрою. Параметрами можна
       скористатися для внесення змін до цієї поведінки, зміни початкової зони або розмір звіту,
       як це описано нижче.

       Виведення звіту:

       ┌────────┬────────────────────────────────┐
       │        │                                │
       │start   │ Початковий сектор зони         │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │len     │ Довжина зони у кількості       │
       │        │ секторів                       │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │cap     │ Місткість зони у кількості     │
       │        │ секторів                       │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │wptr    │ Позиція вказівника запису зони │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │reset   │ Рекомендоване скидання         │
       │        │ вказівника запису              │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │non-seq │ Активними є ресурси            │
       │        │ непослідовного запису          │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │cond    │ Стан зони                      │
       ├────────┼────────────────────────────────┤
       │        │                                │
       │type    │ Тип зони                       │
       └────────┴────────────────────────────────┘

       Стани зони:

       ┌───┬─────────────────────────────┐
       │   │                             │
       │cl │ Закрита                     │
       ├───┼─────────────────────────────┤
       │   │                             │
       │nw │ Не є вказівником запису     │
       ├───┼─────────────────────────────┤
       │   │                             │
       │em │ Порожня                     │
       ├───┼─────────────────────────────┤
       │   │                             │
       │fu │ Повна                       │
       ├───┼─────────────────────────────┤
       │   │                             │
       │oe │ Явно відкрита               │
       ├───┼─────────────────────────────┤
       │   │                             │
       │oi │ Явно відкрита               │
       ├───┼─────────────────────────────┤
       │   │                             │
       │ol │ Не працює                   │
       ├───┼─────────────────────────────┤
       │   │                             │
       │ro │ Лише читання                │
       ├───┼─────────────────────────────┤
       │   │                             │
       │x? │ Зарезервовані стани (не має │
       │   │ повідомлятися)              │
       └───┴─────────────────────────────┘

   capacity
       Команду blkzone capacity використовують для створення звітів щодо місткості.

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

   reset
       Команду blkzone reset використовують для скидання однієї або декількох зон. На відміну від
       sg_reset_wp(8), ця команда працює з шару блоків та може скидати діапазон зон.

   open
       Команду blkzone open використовують для явного відкриття однієї або декількох зон. На
       відміну від sg_zone(), дії з відкриття, ця команда працює з шару блоків та може відкривати
       діапазон зон.

   close
       Команду blkzone close використовують для закриття однієї або декількох зон. На відміну від
       sg_zone(), дії з закриття, ця команда працює з шару блоків та може закривати діапазон зон.

   finish
       Команду blkzone finish використовують для завершення (переведення до умови повноти) однієї
       або декількох зон. На відміну від sg_zone(), дії з завершення, ця команда працює з шару
       блоків та може завершувати діапазон зон.

       Типово, команди reset, open, close і finish працюватимуть з зони на секторі 0 пристрою і з
       усіма зонами. Параметрами можна скористатися для внесення змін до цієї поведінки, як це
       пояснено нижче.

ПАРАМЕТРИ

       Після аргументів відступ і довжина можна додавати суфікси одиниць 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. Крім того, префіксом 0x можна скористатися для визначення
       відступу і довжини у форматі шістнадцяткових чисел.

       -o, --offset сектор
           Початкова зона, яку вказано як відступ у секторах. Заданий відступ в одиницях секторів
           (512 байтів) має відповідати початку зони. Типовим є нульове значення.

       -l, --length сектори
           Максимальна кількість секторів, з якими має працювати команда. Типовим є значення
           кількості секторів, які лишаються після відступу. Цим параметром не можна
           користуватися у поєднанні із параметром --count.

       -c, --count кількість
           Максимальна кількість зон, з якими має працювати команда. Типовим є значення кількості
           зон, починаючи зі значення відступу. Цим параметром не можна користуватися у поєднанні
           із параметром --length.

       -f, --force
           Наказати командам змінювати стан зон на блокових пристроях, які використано системою.

       -v, --verbose
           Вивести кількість зон, які повернуто у звіті, або діапазон скинутих секторів.

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

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

АВТОРИ

       Shaun Tancheff <shaun@tancheff.com>, Karel Zak <kzak@redhat.com>

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

       sg_rep_zones(8)

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

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

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

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