نام (NAME)

sg_z_act_query - ارسال دستور SCSI ZONE ACTIVATE یا ZONE QUERY

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

sg_z_act_query [--activate] [--all] [--force] [--help] [--hex] [--inhex=FN] [--maxlen=LEN] [--num=ZS] [--other=ZDID] [--query] [--raw] [--verbose] [--version] [--zone=ID] DEVICE

توضیحات (DESCRIPTION)

دستور SCSI ZONE ACTIVATE یا ZONE QUERY را به DEVICE ارسال می‌کند. اگر گزینه --activate داده نشود، یک دستور ZONE QUERY ارسال می‌شود. این دستورات در پیش‌نویس بازبینی ۴ استاندارد ZBC-2 (سند zbc2r04.pdf) اضافه شده‌اند.

هر دوی این دستورات دارای بلوک‌های توصیف‌گر دستور (cdb) و پاسخ‌های مشابهی هستند، از این رو هر دو در این ابزار قرار گرفته‌اند. تفاوت در این است که تنها دستور ZONE ACTIVATE ممکن است زون‌ها را فعال یا غیرفعال کند. هر دو دستور یک «عملیات اعتبارسنجی فعال‌سازی‌ها» (Verify activations operation) را همان‌طور که در ZBC-2 تعریف شده است، انجام می‌دهند.

گزینه‌ها (OPTIONS)

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

-A, --activate

یک دستور ZONE ACTIVATE را به DEVICE ارسال می‌کند. حالت پیش‌فرض (یعنی بدون این گزینه) ارسال دستور ZONE QUERY است.

-a, --all

فیلد ALL را در cdb تنظیم می‌کند.

-f, --force

هنگام رمزگشایی پاسخ این دستور، برخی بررسی‌های اولیه سلامت انجام می‌شود و در صورت شکست آن‌ها، پیامی به stderr ارسال شده و وضعیت خروج غیرصفر تنظیم می‌شود. اگر این گزینه داده شود، از این بررسی‌های سلامت چشم‌پوشی می‌شود.

-h, --help

پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.

-H, --hex

پاسخ را در مبنای شانزده (هگزادسیمال) در stdout چاپ می‌کند. هنگامی که یک‌بار استفاده شود، کل پاسخ به‌صورت هگزادسیمال اسکی همراه با آدرس ابتدایی (شروع از ۰) در هر سطر خروجی داده می‌شود. هنگامی که دوبار استفاده شود، هر توصیف‌گر فعال‌سازی زون در پاسخ به‌طور جداگانه در مبنای شانزده خروجی داده می‌شود. هنگامی که سه‌بار استفاده شود، کل پاسخ در مبنای شانزده بدون آدرس ابتدایی (در هر سطر) خروجی داده می‌شود.
فرمت خروجی هنگامی که این گزینه سه‌بار داده شود، برای فراخوانی‌های بعدی همراه با گزینه --inhex=FN مناسب است.

-i, --inhex=FN

که در آن FN نام فایلی است که فرض می‌شود محتوای آن هگزادسیمال اسکی است. اگر DEVICE نیز مشخص شده باشد، DEVICE نادیده گرفته می‌شود، یک هشدار صادر شده و برنامه با رمزگشایی فایل به نام FN ادامه می‌دهد. برای اطلاعات بیشتر بخش «HEX, BINARY AND JSON FORMATS» را در صفحه راهنمای sg3_utils بررسی کنید. اگر گزینه --raw نیز داده شده باشد، محتوای FN به‌عنوان باینری در نظر گرفته می‌شود.
به‌طور پیش‌فرض فرض می‌شود که پاسخ از یک دستور ZONE QUERY است، اما این موضوع نباید اهمیتی داشته باشد زیرا پاسخ دستورات ZONE ACTIVATE و ZONE QUERY ساختار یکسانی دارد.

-m, --maxlen=LEN

که در آن LEN طول (حداکثر) پاسخ بر حسب بایت است. این مقدار در فیلد «allocation length» در cdb قرار می‌گیرد. اگر داده نشود (یا اگر LEN صفر باشد)، مقدار ۸۱۹۲ استفاده می‌شود. حداکثر مقدار مجاز برای LEN برابر با ۱۰۴۸۵۷۶ است.
پیش‌نویس استاندارد طول‌های تخصیص کمتر از ۶۴ را مجاز نمی‌داند.

-n, --num=ZS

که در آن ZS در فیلد «Number of zones» در cdb قرار می‌گیرد. این گزینه معمولاً در صورت مشخص شدن گزینه --all نادیده گرفته می‌شود. اگر گزینه --all داده نشود، مقدار پیش‌فرض این فیلد ۱ است.

-o, --other=ZDID

که در آن مقدار ZDID در فیلد «Other zone domain ID» در cdb قرار می‌گیرد تا به DEVICE ارسال شود.

-q, --query

باعث ارسال دستور ZONE QUERY به DEVICE می‌شود. از آنجا که این رفتار پیش‌فرض است، معمولاً به این گزینه نیازی نیست. اگر هر دوی این گزینه و گزینه --activate داده شوند، خطایی گزارش خواهد شد (و هیچ دستوری ارسال نمی‌شود).

-r, --raw

پاسخ را به‌صورت باینری (در stdout) خروجی می‌دهد، مگر اینکه گزینه --inhex=FN نیز داده شده باشد. در آن صورت فایل ورودی (FN) به‌صورت باینری رمزگشایی می‌شود (و خروجی باینری نخواهد بود (بلکه ممکن است هگز باشد)).

-v, --verbose

سطح پرگویی خروجی (خروجی اشکال‌زدایی) را افزایش می‌دهد.

-V, --version

اطلاعات نسخه را چاپ کرده و خارج می‌شود.

-z, --zone=ID

که در آن ID در فیلد ZONE ID در cdb قرار می‌گیرد. شناسه زون (Zone ID) در واقع آدرس بلوک منطقی شروع زون (LBA) است. مقدار پیش‌فرض ۰ است. فرض می‌شود ID در مبنای ۱۰ (ده‌دهی) است مگر اینکه پیشوند «0x» داشته باشد یا پسوند «h» به دنبال آن بیاید که نشان‌دهنده مبنای ۱۶ (هگزادسیمال) است. بیشترین مقداری که می‌تواند مشخص شود 2^64 - 2 است. در شرایط نادری که قصد ارسال 2^64 - 1 را دارید، مقدار «-1» را وارد کنید.

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

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

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

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

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

گزارش باگ‌ها را به <dgilbert at interlog dot com> ارسال کنید.

حق نشر (COPYRIGHT)

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

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

sg_zone,sg_rep_zones,sg_reset_wp(sg3_utils)