НАЗВА

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

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

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

ОПИС

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

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

КОМАНДИ

report

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

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

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

 start      Zone start sector
 len        Zone length in number of sectors
 cap        Zone capacity in number of sectors
 wptr       Zone write pointer position
 reset      Reset write pointer recommended
 non-seq    Non-sequential write resources active
 cond       Zone condition
 type       Zone type

Стани зони:

 cl    Closed
 nw    Not write pointer
 em    Empty
 fu    Full
 oe    Explicitly opened
 oi    Implicitly opened
 ol    Offline
 ro    Read only
 xN    Reserved conditions (should not be reported)

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