نام (NAME)

blkzone - اجرای دستورات منطقه‌بندی بر روی دستگاه‌های بلوکی

خلاصه دستور (SYNOPSIS)

blkzone command [options] device

توضیحات (DESCRIPTION)

دستور blkzone برای اجرای دستورات مربوط به منطقه‌بندی (zone) بر روی دستگاه‌هایی که از Zoned Block Commands (ZBC) یا Zoned-device ATA Commands (ZAC) پشتیبانی می‌کنند، استفاده می‌شود. مناطقی که عملیات باید بر روی آن‌ها انجام شود را می‌توان با استفاده از گزینه‌های offset، count و length مشخص کرد.

آرگومان device مسیر پرونده دستگاه بلوکی است.

دستورها (COMMANDS)

report

دستور blkzone report برای گزارش اطلاعات مناطق دستگاه استفاده می‌شود.

به‌طور پیش‌فرض، این دستور تمامی مناطق را از ابتدای دستگاه بلوکی گزارش می‌دهد. می‌توان از گزینه‌ها برای تغییر این رفتار و تغییر دادن منطقه شروع یا اندازه گزارش به صورتی که در زیر توضیح داده شده استفاده کرد.

خروجی گزارش:

start	بخش (سکتور) شروع منطقه
len	طول منطقه بر حسب تعداد بخش‌ها (سکتورها)
cap	ظرفیت منطقه بر حسب تعداد بخش‌ها (سکتورها)
wptr	موقعیت اشاره‌گر نوشتن (write pointer) منطقه
reset	بازنشانی اشاره‌گر نوشتن پیشنهاد می‌شود
non-seq	منابع نوشتن غیرترتیبی فعال هستند
cond	وضعیت منطقه
type	نوع منطقه

وضعیت‌های منطقه:

cl	بسته (Closed)
nw	فاقد اشاره‌گر نوشتن (Not write pointer)
em	خالی (Empty)
fu	پر (Full)
oe	صریحاً بازشده (Explicitly opened)
oi	ضمنی بازشده (Implicitly opened)
ol	برون‌خط (Offline)
ro	فقط‌خواندنی (Read only)
x?	وضعیت‌های رزروشده (نباید گزارش شوند)

capacity

دستور blkzone capacity برای گزارش اطلاعات ظرفیت دستگاه استفاده می‌شود.

به‌طور پیش‌فرض، این دستور مجموع ظرفیت تمامی مناطق موجود بر روی دستگاه را بر حسب تعداد بخش‌ها (سکتورها) گزارش می‌دهد. می‌توان از گزینه‌ها برای تغییر این رفتار و تغییر منطقه شروع یا اندازه گزارش به صورتی که در زیر توضیح داده شده استفاده کرد.

reset

دستور blkzone reset برای بازنشانی یک یا چند منطقه استفاده می‌شود. برخلاف sg_reset_wp(8)، این دستور از لایه بلوکی (block layer) عمل می‌کند و می‌تواند بازه‌ای از مناطق را بازنشانی کند.

open

دستور blkzone open برای باز کردن صریح یک یا چند منطقه استفاده می‌شود. برخلاف عملیات باز کردن در sg_zone(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را باز کند.

close

دستور blkzone close برای بستن یک یا چند منطقه استفاده می‌شود. برخلاف عملیات بستن در sg_zone(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را ببندد.

finish

دستور blkzone finish برای پایان دادن (انتقال به وضعیت پر یا full) یک یا چند منطقه استفاده می‌شود. برخلاف عملیات پایان دادن در sg_zone(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را به پایان برساند.

به‌طور پیش‌فرض، دستورهای reset، open، close و finish از منطقه واقع در بخش (سکتور) 0 دستگاه شروع کرده و بر روی تمامی مناطق عمل می‌کنند. می‌توان از گزینه‌ها برای تغییر این رفتار به صورتی که در زیر توضیح داده شده استفاده کرد.

گزینه‌ها (OPTIONS)

آرگومان‌های گزینه‌های offset و length می‌توانند همراه با پسوندهای ضربی 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 برای مشخص کردن offset و length در مبنای شانزده (هگزادسیمال) استفاده کرد.

-o, --offset sector

منطقه شروع مشخص‌شده به عنوان آفست بخش (سکتور). آفست ارائه‌شده بر حسب واحدهای بخش (۵۱۲ بایت) باید با ابتدای یک منطقه مطابقت داشته باشد. مقدار پیش‌فرض صفر است.

-l, --length sectors

حداکثر تعداد بخش‌هایی (سکتورهایی) که دستور باید بر روی آن‌ها عمل کند. مقدار پیش‌فرض، تعداد بخش‌های باقی‌مانده پس از offset است. این گزینه نمی‌تواند همراه با گزینه --count استفاده شود.

-c, --count count

حداکثر تعداد مناطقی که دستور باید بر روی آن‌ها عمل کند. مقدار پیش‌فرض، تعداد مناطق با شروع از offset است. این گزینه نمی‌تواند همراه با گزینه --length استفاده شود.

-f, --force

اجرای اجباری دستورها برای تغییر وضعیت منطقه بر روی دستگاه‌های بلوکی مورد استفاده سیستم.

-v, --verbose

نمایش تعداد مناطق بازگردانده‌شده در گزارش یا بازه بخش‌های (سکتورهای) بازنشانی‌شده.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

نویسندگان (AUTHORS)

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

همچنین ببینید (SEE ALSO)

sg_rep_zones(8)

گزارش اشکالات (REPORTING BUGS)

برای گزارش اشکال‌ها، از ردیاب اشکال https://github.com/util-linux/util-linux/issues.

در دسترس بودن (AVAILABILITY)

دستور blkzone بخشی از بسته util-linux است که می‌توان آن را از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux.