.TH SG_ZONE "8" "2026-07-01" "sg3_utils\-1.49" SG3_UTILS
.SH "نام (NAME)"
sg_zone \- ارسال یک دستور اصلاح زون (ZONE) در SCSI
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_zone
[\fI\-\-all\fR] [\fI\-\-close\fR] [\fI\-\-count=ZC\fR] [\fI\-\-element=EID\fR]
[\fI\-\-finish\fR] [\fI\-\-help\fR] [\fI\-\-open\fR] [\fI\-\-remove\fR]
[\fI\-\-sequentialize\fR] [\fI\-\-timeout=SE\fR] [\fI\-\-verbose\fR]
[\fI\-\-version\fR] [\fI\-\-zone=ID\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
یک دستور SCSI از نوع OPEN ZONE، CLOSE ZONE، FINISH ZONE، REMOVE ELEMENT AND MODIFY
ZONES یا SEQUENTIALIZE ZONE را به
.I DEVICE
ارسال می‌کند. به‌جز دو مورد آخر، همه در استاندارد ZBC
.RB ( INCITS\ 536\-2016 )
آمده‌اند. دستور REMOVE ELEMENT AND MODIFY ZONES در zbc2r07 اضافه شد، در حالی که دستور SEQUENTIALIZE ZONE در zbc2r01b اضافه گردید.
.PP
تنها و تنها یکی از گزینه‌های
.IR \-\-open ،
.IR \-\-close ،
.IR \-\-finish ،
.I \-\-remove
و
.I \-\-sequentialize
می‌تواند انتخاب شود.
.PP
دستورات REPORT ZONES، REPORT REALMS و REPORT ZONE DOMAINS ممکن است از طریق ابزار
.B sg_rep_zones
در دسترس باشند. دستورات ZONE ACTIVATE و ZONE QUERY ممکن است از طریق ابزار
.B sg_z_act_query
در دسترس باشند. دستور RESET WRITE POINTER ممکن است از طریق ابزار
.B sg_reset_wp
در دسترس باشد.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های بلند برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-a\fR, \fB\-\-all\fR
فیلد ALL را در cdb تنظیم می‌کند.
.TP
\fB\-c\fR, \fB\-\-close\fR
باعث ارسال دستور CLOSE ZONE به
.I DEVICE
می‌شود.
.TP
\fB\-C\fR, \fB\-\-count\fR=\fIZC\fR
مقدار ZC در فیلد Zone Count در cdb هر چهار دستور پشتیبانی‌شده توسط این ابزار قرار می‌گیرد. ZC باید مقداری از 0 تا 65535 (0xffff) شامل خود آن‌ها باشد.
.TP
\fB\-e\fR, \fB\-\-element\fR=\fIEID\fR
که در آن
.I EID
شناسه عنصر است که یک عدد صحیح بدون علامت ۳۲ بیتی با شروع از یک می‌باشد. این فیلد توسط دستور REMOVE ELEMENT AND MODIFY ZONES استفاده می‌شود و مقدار پیش‌فرض آن صفر است (که نامعتبر است). بنابراین کاربر در صورت استفاده از
.I \-\-remove
باید یک شناسه عنصر معتبر ارائه دهد.
.TP
\fB\-f\fR, \fB\-\-finish\fR
باعث ارسال دستور FINISH ZONE به
.I DEVICE
می‌شود.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنمای نحوه استفاده را چاپ کرده و سپس خارج می‌شود.
.TP
\fB\-o\fR, \fB\-\-open\fR
باعث ارسال دستور OPEN ZONE به
.I DEVICE
می‌شود.
.TP
\fB\-r\fR, \fB\-\-remove\fR
باعث ارسال دستور REMOVE ELEMENT AND MODIFY ZONES به
.I DEVICE
می‌شود. در عمل،
.I \-\-element=EID
نیز باید مشخص شود.
.TP
\fB\-S\fR, \fB\-\-sequentialize\fR
باعث ارسال دستور SEQUENTIALIZE ZONE به
.I DEVICE
می‌شود.
.TP
\fB\-t\fR, \fB\-\-timeout\fR=\fISE\fR
که در آن
.I SE
مدت زمان انتظار (تایم‌اوت) دستور بر حسب ثانیه است. مقدار پیش‌فرض ۶۰ ثانیه است و اگر 0 وارد شود، به ۶۰ نگاشت می‌شود. شکل جایگزین آن
.I \-\-tmo=SE
است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات، (مانند خروجی اشکال‌زدایی).
.TP
\fB\-V\fR, \fB\-\-version\fR
رشته نسخه را چاپ کرده و سپس خارج می‌شود.
.TP
\fB\-z\fR, \fB\-\-zone\fR=\fIID\fR
که در آن
.I ID
در فیلد ZONE ID مربوط به cdb قرار می‌گیرد. یک شناسه زون (zone id) آدرس بلوک منطقی (LBA) شروع زون است. مقدار پیش‌فرض 0 است. فرض می‌شود
.I ID
در مبنای ۱۰ باشد مگر اینکه پیشوند '0x' داشته باشد یا پسوند 'h' داشته باشد که نشان‌دهنده مبنای ۱۶ است.
.SH "نکات (NOTES)"
پس از تکمیل دستور REMOVE ELEMENT AND MODIFY ZONES، عنصر مورد نظر اصطلاحاً depopulated (تخلیه‌شده) نامیده می‌شود و هرگونه زون تحت تأثیر در وضعیت زون 'offline' قرار می‌گیرد.
.PP
استاندارد SBC\-4 دستور مشابهی با REMOVE ELEMENT AND MODIFY ZONES دارد که REMOVE ELEMENT AND TRUNCATE نامیده می‌شود. تفاوت در این است که دستور دوم «ارتباط بین LBAها و بلوک‌های فیزیکی را تغییر می‌دهد» و دستور اول آن ارتباط را تغییر نمی‌دهد. در هر دو حالت، عناصر تخلیه‌شده‌ای که بیت 'Restoration Allowed' (RALWD) آن‌ها تنظیم شده است (نگاه کنید به
.BR sg_get_elem_status )
ممکن است با دستور RESTORE ELEMENTS AND REBUILD بازیابی شوند؛ ابزار
.B sg_rem_rest_elem
را ببینید. ابزار
.B sg_rem_rest_elem
همچنین می‌تواند دستور REMOVE ELEMENT AND MODIFY ZONES را با گزینه
.I \-\-modify
خود صادر کند.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_zone در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2014\-2026 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_rem_rest_elem,sg_rep_zones,sg_reset_wp,sg_z_act_query(sg3_utils)