'\" t
.\"     Title: blkzone
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "BLKZONE" "8" "2026-06-16" "util\-linux 2.41.5" "مدیریت سیستم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
blkzone \- اجرای دستورات منطقه‌بندی بر روی دستگاه‌های بلوکی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBblkzone\fP \fIcommand\fP [options] \fIdevice\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBblkzone\fP برای اجرای دستورات مربوط به منطقه‌بندی (zone) بر روی دستگاه‌هایی که از Zoned Block Commands (ZBC) یا Zoned\-device ATA Commands (ZAC) پشتیبانی می‌کنند، استفاده می‌شود. مناطقی که عملیات باید بر روی آن‌ها انجام شود را می‌توان با استفاده از گزینه‌های offset، count و length مشخص کرد.
.sp
آرگومان \fIdevice\fP مسیر پرونده دستگاه بلوکی است.
.SH "دستورها (COMMANDS)"
.SS "report"
.sp
دستور \fBblkzone report\fP برای گزارش اطلاعات مناطق دستگاه استفاده می‌شود.
.sp
به‌طور پیش‌فرض، این دستور تمامی مناطق را از ابتدای دستگاه بلوکی گزارش می‌دهد. می‌توان از گزینه‌ها برای تغییر این رفتار و تغییر دادن منطقه شروع یا اندازه گزارش به صورتی که در زیر توضیح داده شده استفاده کرد.
.sp
خروجی گزارش:
.TS
allbox tab(:);
lt lt.
T{
.sp
start
T}:T{
.sp
بخش (سکتور) شروع منطقه
T}
T{
.sp
len
T}:T{
.sp
طول منطقه بر حسب تعداد بخش‌ها (سکتورها)
T}
T{
.sp
cap
T}:T{
.sp
ظرفیت منطقه بر حسب تعداد بخش‌ها (سکتورها)
T}
T{
.sp
wptr
T}:T{
.sp
موقعیت اشاره‌گر نوشتن (write pointer) منطقه
T}
T{
.sp
reset
T}:T{
.sp
بازنشانی اشاره‌گر نوشتن پیشنهاد می‌شود
T}
T{
.sp
non\-seq
T}:T{
.sp
منابع نوشتن غیرترتیبی فعال هستند
T}
T{
.sp
cond
T}:T{
.sp
وضعیت منطقه
T}
T{
.sp
type
T}:T{
.sp
نوع منطقه
T}
.TE
.sp
.sp
وضعیت‌های منطقه:
.TS
allbox tab(:);
lt lt.
T{
.sp
cl
T}:T{
.sp
بسته (Closed)
T}
T{
.sp
nw
T}:T{
.sp
فاقد اشاره‌گر نوشتن (Not write pointer)
T}
T{
.sp
em
T}:T{
.sp
خالی (Empty)
T}
T{
.sp
fu
T}:T{
.sp
پر (Full)
T}
T{
.sp
oe
T}:T{
.sp
صریحاً بازشده (Explicitly opened)
T}
T{
.sp
oi
T}:T{
.sp
ضمنی بازشده (Implicitly opened)
T}
T{
.sp
ol
T}:T{
.sp
برون‌خط (Offline)
T}
T{
.sp
ro
T}:T{
.sp
فقط‌خواندنی (Read only)
T}
T{
.sp
x?
T}:T{
.sp
وضعیت‌های رزروشده (نباید گزارش شوند)
T}
.TE
.sp
.SS "capacity"
.sp
دستور \fBblkzone capacity\fP برای گزارش اطلاعات ظرفیت دستگاه استفاده می‌شود.
.sp
به‌طور پیش‌فرض، این دستور مجموع ظرفیت تمامی مناطق موجود بر روی دستگاه را بر حسب تعداد بخش‌ها (سکتورها) گزارش می‌دهد. می‌توان از گزینه‌ها برای تغییر این رفتار و تغییر منطقه شروع یا اندازه گزارش به صورتی که در زیر توضیح داده شده استفاده کرد.
.SS "reset"
.sp
دستور \fBblkzone reset\fP برای بازنشانی یک یا چند منطقه استفاده می‌شود. برخلاف \fBsg_reset_wp\fP(8)، این دستور از لایه بلوکی (block layer) عمل می‌کند و می‌تواند بازه‌ای از مناطق را بازنشانی کند.
.SS "open"
.sp
دستور \fBblkzone open\fP برای باز کردن صریح یک یا چند منطقه استفاده می‌شود. برخلاف عملیات باز کردن در \fBsg_zone\fP(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را باز کند.
.SS "close"
.sp
دستور \fBblkzone close\fP برای بستن یک یا چند منطقه استفاده می‌شود. برخلاف عملیات بستن در \fBsg_zone\fP(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را ببندد.
.SS "finish"
.sp
دستور \fBblkzone finish\fP برای پایان دادن (انتقال به وضعیت پر یا full) یک یا چند منطقه استفاده می‌شود. برخلاف عملیات پایان دادن در \fBsg_zone\fP(8)، این دستور از لایه بلوکی عمل می‌کند و می‌تواند بازه‌ای از مناطق را به پایان برساند.
.sp
به‌طور پیش‌فرض، دستورهای \fBreset\fP، \fBopen\fP، \fBclose\fP و \fBfinish\fP از منطقه واقع در بخش (سکتور) 0 دستگاه شروع کرده و بر روی تمامی مناطق عمل می‌کنند. می‌توان از گزینه‌ها برای تغییر این رفتار به صورتی که در زیر توضیح داده شده استفاده کرد.
.SH "گزینه‌ها (OPTIONS)"
.sp
آرگومان‌های گزینه‌های \fIoffset\fP و \fIlength\fP می‌توانند همراه با پسوندهای ضربی 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 برای مشخص کردن \fIoffset\fP و \fIlength\fP در مبنای شانزده (هگزادسیمال) استفاده کرد.
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIsector\fP
.RS 4
منطقه شروع مشخص‌شده به عنوان آفست بخش (سکتور). آفست ارائه‌شده بر حسب واحدهای بخش (۵۱۲ بایت) باید با ابتدای یک منطقه مطابقت داشته باشد. مقدار پیش‌فرض صفر است.
.RE
.sp
\fB\-l\fP, \fB\-\-length\fP \fIsectors\fP
.RS 4
حداکثر تعداد بخش‌هایی (سکتورهایی) که دستور باید بر روی آن‌ها عمل کند. مقدار پیش‌فرض، تعداد بخش‌های باقی‌مانده پس از \fIoffset\fP است. این گزینه نمی‌تواند همراه با گزینه \fB\-\-count\fP استفاده شود.
.RE
.sp
\fB\-c\fP, \fB\-\-count\fP \fIcount\fP
.RS 4
حداکثر تعداد مناطقی که دستور باید بر روی آن‌ها عمل کند. مقدار پیش‌فرض، تعداد مناطق با شروع از \fIoffset\fP است. این گزینه نمی‌تواند همراه با گزینه \fB\-\-length\fP استفاده شود.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
اجرای اجباری دستورها برای تغییر وضعیت منطقه بر روی دستگاه‌های بلوکی مورد استفاده سیستم.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
نمایش تعداد مناطق بازگردانده‌شده در گزارش یا بازه بخش‌های (سکتورهای) بازنشانی‌شده.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "shaun\(attancheff.com" "Shaun Tancheff" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBsg_rep_zones\fP(8)
.SH "گزارش اشکالات (REPORTING BUGS)"
.sp
برای گزارش اشکال‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب اشکال" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBblkzone\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."