نام (NAME)

sg_zone - ارسال یک دستور اصلاح زون (ZONE) در SCSI

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

sg_zone [--all] [--close] [--count=ZC] [--element=EID] [--finish] [--help] [--open] [--remove] [--sequentialize] [--timeout=SE] [--verbose] [--version] [--zone=ID] DEVICE

توضیحات (DESCRIPTION)

یک دستور SCSI از نوع OPEN ZONE، CLOSE ZONE، FINISH ZONE، REMOVE ELEMENT AND MODIFY ZONES یا SEQUENTIALIZE ZONE را به DEVICE ارسال می‌کند. به‌جز دو مورد آخر، همه در استاندارد ZBC (INCITS 536-2016) آمده‌اند. دستور REMOVE ELEMENT AND MODIFY ZONES در zbc2r07 اضافه شد، در حالی که دستور SEQUENTIALIZE ZONE در zbc2r01b اضافه گردید.

تنها و تنها یکی از گزینه‌های --open، --close، --finish، --remove و --sequentialize می‌تواند انتخاب شود.

دستورات REPORT ZONES، REPORT REALMS و REPORT ZONE DOMAINS ممکن است از طریق ابزار sg_rep_zones در دسترس باشند. دستورات ZONE ACTIVATE و ZONE QUERY ممکن است از طریق ابزار sg_z_act_query در دسترس باشند. دستور RESET WRITE POINTER ممکن است از طریق ابزار sg_reset_wp در دسترس باشد.

گزینه‌ها (OPTIONS)

آرگومان‌های گزینه‌های بلند برای گزینه‌های کوتاه نیز اجباری هستند.

-a, --all: فیلد ALL را در cdb تنظیم می‌کند.
-c, --close: باعث ارسال دستور CLOSE ZONE به DEVICE می‌شود.
-C, --count=ZC: مقدار ZC در فیلد Zone Count در cdb هر چهار دستور پشتیبانی‌شده توسط این ابزار قرار می‌گیرد. ZC باید مقداری از 0 تا 65535 (0xffff) شامل خود آن‌ها باشد.
-e, --element=EID: که در آن EID شناسه عنصر است که یک عدد صحیح بدون علامت ۳۲ بیتی با شروع از یک می‌باشد. این فیلد توسط دستور REMOVE ELEMENT AND MODIFY ZONES استفاده می‌شود و مقدار پیش‌فرض آن صفر است (که نامعتبر است). بنابراین کاربر در صورت استفاده از --remove باید یک شناسه عنصر معتبر ارائه دهد.
-f, --finish: باعث ارسال دستور FINISH ZONE به DEVICE می‌شود.
-h, --help: پیام راهنمای نحوه استفاده را چاپ کرده و سپس خارج می‌شود.
-o, --open: باعث ارسال دستور OPEN ZONE به DEVICE می‌شود.
-r, --remove: باعث ارسال دستور REMOVE ELEMENT AND MODIFY ZONES به DEVICE می‌شود. در عمل، --element=EID نیز باید مشخص شود.
-S, --sequentialize: باعث ارسال دستور SEQUENTIALIZE ZONE به DEVICE می‌شود.
-t, --timeout=SE: که در آن SE مدت زمان انتظار (تایم‌اوت) دستور بر حسب ثانیه است. مقدار پیش‌فرض ۶۰ ثانیه است و اگر 0 وارد شود، به ۶۰ نگاشت می‌شود. شکل جایگزین آن --tmo=SE است.
-v, --verbose: افزایش سطح جزئیات، (مانند خروجی اشکال‌زدایی).
-V, --version: رشته نسخه را چاپ کرده و سپس خارج می‌شود.
-z, --zone=ID: که در آن ID در فیلد ZONE ID مربوط به cdb قرار می‌گیرد. یک شناسه زون (zone id) آدرس بلوک منطقی (LBA) شروع زون است. مقدار پیش‌فرض 0 است. فرض می‌شود ID در مبنای ۱۰ باشد مگر اینکه پیشوند '0x' داشته باشد یا پسوند 'h' داشته باشد که نشان‌دهنده مبنای ۱۶ است.

نکات (NOTES)

پس از تکمیل دستور REMOVE ELEMENT AND MODIFY ZONES، عنصر مورد نظر اصطلاحاً depopulated (تخلیه‌شده) نامیده می‌شود و هرگونه زون تحت تأثیر در وضعیت زون 'offline' قرار می‌گیرد.

استاندارد SBC-4 دستور مشابهی با REMOVE ELEMENT AND MODIFY ZONES دارد که REMOVE ELEMENT AND TRUNCATE نامیده می‌شود. تفاوت در این است که دستور دوم «ارتباط بین LBAها و بلوک‌های فیزیکی را تغییر می‌دهد» و دستور اول آن ارتباط را تغییر نمی‌دهد. در هر دو حالت، عناصر تخلیه‌شده‌ای که بیت 'Restoration Allowed' (RALWD) آن‌ها تنظیم شده است (نگاه کنید به sg_get_elem_status) ممکن است با دستور RESTORE ELEMENTS AND REBUILD بازیابی شوند؛ ابزار sg_rem_rest_elem را ببینید. ابزار sg_rem_rest_elem همچنین می‌تواند دستور REMOVE ELEMENT AND MODIFY ZONES را با گزینه --modify خود صادر کند.

وضعیت خروج (EXIT STATUS)

وضعیت خروج sg_zone در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.

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

نوشته‌شده توسط Douglas Gilbert.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به <dgilbert at interlog dot com>.

حق نشر (COPYRIGHT)

حق نشر © 2014-2026 Douglas Gilbert
این نرم‌افزار تحت مجوز BSD-2-Clause توزیع شده است. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

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

sg_rem_rest_elem,sg_rep_zones,sg_reset_wp,sg_z_act_query(sg3_utils)