SG_STPG(8) SG3_UTILS SG_STPG(8)

sg_stpg - ارسال دستور SET TARGET PORT GROUPS در اسکازی (SCSI)

sg_stpg [--active] [--help] [--hex] [--offline] [--optimized] [--raw] [--standby] [--state=S,S...] [--tp=P,P...] [--unavailable] [--verbose] [--version] DEVICE

یک دستور SCSI با عنوان SET TARGET PORT GROUPS را به DEVICE ارسال می‌کند. این ابزار بسته به این که گزینه --tp= داده شده باشد یا خیر، حالت‌های مختلفی دارد.

اگر --tp= داده شود، بلوک پارامتر دستور SET TARGET PORT GROUPS با یک توصیف‌گر برای هر عنصر در فهرست ارائه‌شده به --tp= ساخته می‌شود. مقدار وضعیت دسترسی نامتقارن متناظر یا از فهرست --state= گرفته می‌شود یا در صورت ارائه نشدن آن، از یکی از گزینه‌های صریح وضعیت (مانند --unavailable) به صورت مکرر در صورت نیاز استفاده می‌شود.

اگر --tp= داده نشود، دنباله‌ای از دستورات SCSI به DEVICE ارسال می‌شود که در نهایت به دستور SET TARGET PORT GROUPS ختم می‌شوند. ابتدا یک INQUIRY برای واکشی برگه VPD شناسایی دستگاه ارسال می‌شود تا گروه درگاه مقصد (اصلی) مرتبط با DEVICE پیدا شود. سپس یک دستور REPORT TARGET PORT GROUPS برای یافتن وضعیت فعلی و این‌که آیا گذار به وضعیت درخواستی پشتیبانی می‌شود یا خیر، صادر می‌گردد. در صورت پشتیبانی، دستور SET TARGET PORT GROUPS ارسال می‌شود.

دسترسی به گروه درگاه مقصد در استاندارد SPC-4 موجود در www.t10.org در بخش‌های ۵.۸ و ۵.۱۶ (در بازنگری 36e مورخ ۲۰۱۲/۸/۲۴) شرح داده شده است. دستور SET TARGET PORT GROUPS نیز در بخش ۶.۴۵ همان سند توصیف شده است.

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

تنظیم وضعیت فعال/غیربهینه‌شده (active/non-optimized).
نمایش پیام راهنمای نحوه استفاده و خروج.
چاپ پاسخ دستور REPORT TARGET PORT GROUPS در قالب هگزادسیمال و سپس خروج.
تنظیم وضعیت برون‌خط (offline). این وضعیت مناسبی برای قرار دادن درگاه مقصد پیش از حذف دستگاه است. توجه داشته باشید که با این وضعیت باید یک شناسه درگاه مقصد نسبی داده شود (برخلاف سایر وضعیت‌ها که شناسه گروه درگاه مقصد را می‌گیرند).
تنظیم وضعیت فعال/بهینه‌شده (active/optimized). اگر هیچ گزینه وضعیت دیگری یا گزینه --tp= داده نشود، فعال/بهینه‌شده وضعیت پیش‌فرض خواهد بود.
ارسال پاسخ دستور REPORT TARGET PORT GROUPS در قالب باینری به خروجی استاندارد و سپس خروج.
تنظیم وضعیت آماده‌باش (standby). گروه درگاه باید دستورهای فهرست‌شده برای وضعیت «unavailable» به‌علاوه دستورات LOG SELECT/SENSE، MODE SELECT/SENSE، RECEIVE DIAGNOSTIC RESULTS، SEND DIAGNOSTIC و PERSISTENT RESERVE IN/OUT را بپذیرد.
یک فهرست جداشده با کاما (یک یا چند عنصر) از وضعیت‌ها را مشخص می‌کند. می‌توان یک عدد یا یک مخفف وارد کرد. عدد دهدهی فرض می‌شود مگر اینکه پیشوند «0x» داشته باشد یا پسوند «h» به همراه داشته باشد که در این صورت مقدار هگزادسیمال در نظر گرفته می‌شود. فقط مقادیر ۰، ۱، ۲، ۳ یا ۱۴ پذیرفته می‌شوند. مخفف‌های پذیرفته‌شده عبارتند از «an»، «ao»، «o»، «s» یا «u»؛ که به ترتیب نشان‌دهنده فعال/غیربهینه‌شده (۱)، فعال/بهینه‌شده (۰)، آفلاین (۱۴)، آماده‌باش (۲) یا غیرقابل‌دسترس (۳) هستند.
یک فهرست جداشده با کاما (یک یا چند عنصر) را مشخص می‌کند. هر عنصر یا شناسه گروه درگاه مقصد است (زمانی که وضعیت متناظر چیزی غیر از «offline» باشد) یا یک شناسه درگاه مقصد نسبی است (زمانی که وضعیت متناظر «offline» باشد). هر عنصر دهدهی فرض می‌شود مگر اینکه دارای پیشوند «0x» یا پسوند «h» باشد که در آن صورت یک مقدار هگزادسیمال در نظر گرفته می‌شود.
تنظیم وضعیت غیرقابل‌دسترس (unavailable). گروه درگاه فقط باید دستورات INQUIRY، REPORT LUNS، REPORT/SET TARGET PORT GROUPS، REQUEST SENSE و READ/WRITE BUFFER را بپذیرد.
افزایش سطح پرگویی (یعنی خروجی اشکال‌زدایی).
چاپ رشته نگارش برنامه و سپس خروج.

دستور SET TARGET PORT GROUPS باید هر زمان که مقدار TPGS در پاسخ استاندارد INQUIRY برابر با ۲ یا ۳ باشد، پشتیبانی شود. [با ابزار sg_inq قابل مشاهده است.]

توجه داشته باشید که وضعیت آفلاین به عنوان «وضعیت ثانویه دسترسی نامتقارن درگاه مقصد» نامیده می‌شود و یک شناسه درگاه مقصد نسبی می‌گیرد (یعنی روی یک درگاه مقصد منفرد عمل می‌کند). تمامی وضعیت‌های دیگر به عنوان «وضعیت‌های اولیه دسترسی نامتقارن درگاه مقصد» نامیده می‌شوند و هر کدام یک شناسه گروه درگاه مقصد دریافت می‌کنند (یعنی روی یک یا چند درگاه مقصد عمل می‌کنند).

هنگامی که --tp= داده می‌شود، باید همان تعداد عنصر به گزینه --state= نیز داده شود. اگر بیش از یک عنصر فهرست به --tp= داده شود و تعداد برابری عنصر به گزینه --state= داده _نشود_، در صورتی که فقط یک وضعیت مشخص شده باشد، همان تکرار می‌شود.

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

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

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

حق نشر © 2007-2014 متعلق به Hannes Reinecke, Christophe Varoqui و D Gilbert است.
این نرم‌افزار تحت مجوز BSD-2-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

sg_inq, sg_rtpg (sg3_utils)

January 2014 sg3_utils-1.38