نام (NAME)

sg_safte - دسترسی به دستگاه محفظه خطاپذیر مبتنی بر SCSI (SAF-TE)

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

sg_safte [--config] [--devstatus] [--encstatus] [--flags] [--help] [--hex] [--insertions] [--raw] [--usage] [--verbose] [--version] DEVICE

توضیحات (DESCRIPTION)

وضعیت محفظه را (از طریق یک دستور SCSI READ BUFFER) واکشی می‌کند. DEVICE باید یک دستگاه SAF-TE باشد که ممکن است یک کنترل‌کننده آرایه ذخیره‌سازی (نوع دستگاه جانبی 0xc در INQUIRY) یا یک دستگاه پردازنده عمومی (نوع دستگاه جانبی 0x3 در INQUIRY) باشد.

اگر هیچ گزینه‌ای داده نشود (فقط آرگومان DEVICE داده شود)، وضعیت کلی محفظه همان‌طور که توسط گزینه --config گزارش می‌شود، بازگردانده خواهد شد.

گزینه‌ها (OPTIONS)

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

-c, --config: یک cdb از نوع Read Enclosure Configuration (READ BUFFER ID 0) را به دستگاه ارسال می‌کند که فهرستی از منابع سخت‌افزاری محفظه را بازمی‌گرداند.
-d, --devstatus: یک cdb از نوع Read Device Slot Status (READ BUFFER ID 4) را به دستگاه ارسال می‌کند که اطلاعاتی درباره وضعیت فعلی هر درایو یا اسلات بازمی‌گرداند.
-s, --encstatus: یک cdb از نوع Read Enclosure Status (READ BUFFER ID 1) را به دستگاه ارسال می‌کند که وضعیت عملیاتی قطعات را بازمی‌گرداند.
-f, --flags: یک cdb از نوع Read Global Flags (READ BUFFER ID 5) را به دستگاه ارسال می‌کند که تازه‌ترین وضعیت پرچم‌های سراسری دستگاه پردازنده RAID را می‌خواند.
-h, --help: پیام راهنمای استفاده را نمایش داده و سپس خارج می‌شود.
-H, --hex: پاسخ یک دستور READ BUFFER را در قالب هگزادسیمال ASCII به خروجی استاندارد (stdout) ارسال می‌کند. اگر یک بار استفاده شود، پاسخ نخستین دستور READ BUFFER (یعنی با buffer_id=0) را خروجی می‌دهد؛ این خروجی باید پیکربندی محفظه باشد. در صورت استفاده دوبار (یا بیشتر)، پاسخ دستورات بعدی READ BUFFER خروجی داده می‌شود.
-i, --insertions: یک cdb از نوع Read Device Insertions (دستور READ BUFFER با شناسه 3) را به دستگاه ارسال می‌کند که اطلاعاتی درباره تعداد دفعاتی که دستگاه‌ها در حین روشن بودن سامانه RAID متصل (وارد) شده‌اند بازمی‌گرداند.
-r, --raw: پاسخ یک دستور READ BUFFER را به صورت باینری (دودویی) به خروجی استاندارد (stdout) ارسال می‌کند. اگر یک بار استفاده شود، پاسخ نخستین دستور READ BUFFER (یعنی با buffer_id=0) را خروجی می‌دهد؛ این خروجی باید پیکربندی محفظه باشد. در صورت استفاده دوبار (یا بیشتر)، پاسخ دستورات بعدی READ BUFFER خروجی داده می‌شود.
-u, --usage: یک cdb از نوع Read Usage Statistics (دستور READ BUFFER با شناسه 2) را به دستگاه ارسال می‌کند که اطلاعات مربوط به مدت زمان کل استفاده و تعداد چرخه‌های روشن‌شدن دستگاه RAID را بازمی‌گرداند.
-v, --verbose: سطح پرحرفی را افزایش می‌دهد (یعنی خروجی اشکال‌زدایی).
-V, --version: رشته نسخه را چاپ کرده و سپس خارج می‌شود.

نکات (NOTES)

این پیاده‌سازی بر اساس سند بازبینی میانی مورخ ۱۹۹۷۰۴۱۴ و با نام "SR041497.pdf" است، بنابراین بسیار قدیمی است. شرکت‌های Intel و nStor نویسندگان آن هستند. اینتل دارای یک بایگانی فشرده (zip) شامل این سند و مستندات مرتبط در بخش "SAF-TE: SCSI Accessed Fault Tolerant Enclosures Interface Specification" در این صفحه است:

https://www.intel.com/content/www/us/en/servers/ipmi/ipmi-technical-resources.html

قابلیت‌های مشابهی توسط دستگاه‌های خدمات محفظه SCSI در SPC-4 موسوم به SES (دستگاه جانبی نوع 0xd) ارائه می‌شود، که می‌توان آن‌ها را با استفاده از ابزار sg_ses بررسی و استعلام کرد.

مثال‌ها (EXAMPLES)

برای مشاهده پیکربندی:

sg_safte /dev/sg1

برای مشاهده وضعیت اسلات دستگاه:

sg_safte --devstatus /dev/sg1

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

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

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

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

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

گزارش باگ‌ها را به <dgilbert at interlog dot com> بفرستید.

حق نشر (COPYRIGHT)

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

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

sg_inq, sg_ses (در بسته sg3_utils)؛ safte-monitor (اینترنت)