SG_SAT_IDENTIFY(8) SG3_UTILS SG_SAT_IDENTIFY(8)

sg_sat_identify - ارسال دستور ATA IDENTIFY DEVICE از طریق لایه ترجمه SCSI به ATA (SAT)

sg_sat_identify [--ck_cond] [--extend] [--help] [--hex] [--ident] [--len=CLEN] [--packet] [--raw] [--readonly] [--verbose] [--version] DEVICE

این ابزار یکی از دستورات ATA IDENTIFY DEVICE یا ATA IDENTIFY PACKET DEVICE را به DEVICE ارسال کرده و پاسخ دریافتی را نمایش می‌دهد. دستگاه‌هایی که به این دستورات پاسخ می‌دهند به ترتیب دیسک‌های ATA و دستگاه‌های ATAPI هستند. این دستورات به جای ارسال مستقیم به دستگاه، از طریق یک بستر انتقال SCSI ارسال می‌شوند که فرض می‌شود دارای یک لایه ترجمه SCSI به ATA با نام اختصاری SATL (SCSI to ATA Translation Layer) است. لایه SATL ممکن است در یک درایور سیستم‌عامل، در سفت‌افزار (فریم‌ور) آداپتور گذرگاه میزبان یا در یک محفظه بیرونی قرار داشته باشد.

استاندارد SAT (استاندارد SAT ANSI INCITS 431-2007، پیش‌نویس پیشین: sat-r09.pdf در www.t10.org) دو دستور SCSI با عنوان «ATA PASS-THROUGH» را تعریف می‌کند: یکی با استفاده از یک cdb شانزده بایتی و دیگری با یک cdb دوازده بایتی. این ابزار به طور پیش‌فرض از حالت cdb شانزده بایتی استفاده می‌کند. بازنگری ۵ از SAT-4 دستور SCSI با عنوان «ATA PASS-THROUGH(32)» را اضافه کرد. همچنین SAT-2 و SAT-3 اکنون استاندارد هستند: SAT-2 ANSI INCITS 465-2010 و SAT-3 ANSI INCITS 517-2015. پروژه SAT-4 نزدیک به مرحله استانداردسازی است و جدیدترین پیش‌نویس آن sat4r06.pdf می‌باشد.

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

بیت CK_COND را در cdb دستور SCSI با عنوان ATA PASS-THROUGH تنظیم می‌کند. تنظیم پیش‌فرض، غیرفعال (یعنی 0) است. در صورت تنظیم بودن، SATL باید صرف‌نظر از اینکه دستور موفق بوده یا با شکست مواجه شده است، یک بافر حسگر (sense buffer) شامل توصیف‌گر نتیجه ATA برگرداند. در صورت غیرفعال بودن، SATL تنها در صورتی باید یک بافر حسگر شامل توصیف‌گر نتیجه ATA برگرداند که دستور ناموفق بوده باشد.
بیت EXTEND را در cdb دستور SCSI با عنوان ATA PASS-THROUGH تنظیم می‌کند. مقدار پیش‌فرض، غیرفعال (یعنی 0) است. در صورت تنظیم شدن، یک دستور ۴۸ بیتی LBA به دستگاه ارسال می‌شود. این گزینه در صورت استفاده از --len=12 هیچ تاثیری ندارد.
پیام راهنمای استفاده که خلاصه‌ای از گزینه‌های خط فرمان است را نمایش داده و خارج می‌شود. در صورت مشخص شدن DEVICE، آن را نادیده می‌گیرد.
پاسخ دستور ATA IDENTIFY (PACKET) DEVICE را در قالب هگزادسیمال نمایش می‌دهد. رفتار پیش‌فرض (یعنی بدون هیچ گزینه «-H») نمایش پاسخ در قالب هگز و گروه‌بندی‌شده در کلمات ۱۶ بیتی است (که روش مورد ترجیح استاندارد ATA است). اگر یک‌بار مشخص شود، پاسخ به صورت بایت‌های هگز اسکی خروجی داده می‌شود (که روش مورد ترجیح استاندارد SCSI است). اگر دو بار مشخص شود (یعنی «-HH»)، خروجی در قالب هگز و گروه‌بندی‌شده در کلمات ۱۶ بیتی است؛ همانند حالت پیش‌فرض اما بدون سرآیند (header). اگر سه بار مشخص شود (یعنی «-HHH»)، خروجی در قالب هگز و گروه‌بندی‌شده در کلمات ۱۶ بیتی و در قالبی است که برای پردازش توسط «hdparm --Istdin» قابل قبول است. گزینه «-HHHH» صرفاً بایت‌های داده هگزادسیمال را که با فاصله جدا شده‌اند، با تعداد ۱۶ بایت در هر سطر نمایش می‌دهد.
شناسه جهانی دستگاه (World Wide Name یا WWN) را خروجی می‌دهد. این مقدار باید یک عدد ۶۴ بیتی NAA-5 باشد. این مقدار به صورت هگز با پیشوند «0x» نمایش داده می‌شود. اگر در دسترس نباشد، مقدار «0x0000000000000000» نمایش داده خواهد شد. معادل این مقدار برای یک دیسک SCSI (یعنی نام واحد منطقی آن) را می‌توان با دستور «sg_vpd -ii» پیدا کرد.
شناسه CLEN طول cdb دستور SCSI مورد استفاده برای ATA PASS-THROUGH است. مقدار CLEN می‌تواند 12، 16 یا 32 باشد. مقدار پیش‌فرض 16 است. اندازه‌های بزرگ‌تر cdb برای آدرس‌دهی ۴۸ بیتی LBA دستگاه‌های ATA مورد نیاز است. ثبات‌های Auxiliary و ICC در ATA تنها با نوع cdb سی و دو بایتی منتقل می‌شوند.
دستور ATA IDENTIFY PACKET DEVICE را (از طریق SATL) ارسال می‌کند. رفتار پیش‌فرض، ارسال دستور ATA IDENTIFY DEVICE است. توجه داشته باشید که مشخصات ATAPI توسط کمیته T13 (یعنی رابط PACKET) اکنون منسوخ شده است.
پاسخ دستور ATA IDENTIFY (PACKET) DEVICE را به صورت باینری نمایش می‌دهد. هنگام استفاده از این گزینه، خروجی باید به یک فایل یا ابزار دیگر لوله‌کشی (pipe) شود. داده‌های باینری به خروجی استاندارد (stdout) و خطاها به خروجی استاندارد خطا (stderr) فرستاده می‌شوند.
دستگاه DEVICE را به صورت فقط‌خواندنی باز می‌کند (برای مثال در یونیکس با پرچم O_RDONLY). رفتار پیش‌فرض، باز کردن آن به صورت خواندن-نوشتن است.
سطح جزئیات خروجی را افزایش می‌دهد.
رشته نسخه برنامه را چاپ می‌کند.

از آنجا که پاسخ به دستور IDENTIFY (PACKET) DEVICE برای استفاده صحیح از یک دستگاه ATA(PI) بسیار حیاتی است (و معمولاً نخستین دستور ارسال‌شده است)، یک SATL باید یک صفحه VPD حاوی اطلاعات ATA فراهم کند که دارای اطلاعات مشابهی است.

کد عملیاتی (opcode) دستور SCSI ATA PASS-THROUGH (12) مقدار 0xa1 است که با دستور BLANK در مجموعه MMC مورد استفاده توسط رایترهای cd/dvd تداخل دارد. بنابراین یک SATL در مواجهه با یک دستگاه ATAPI که از MMC استفاده می‌کند (یعنی دارای نوع دستگاه جانبی ۵ است)، احتمالاً باید با آپ‌کد 0xa1 به عنوان دستور BLANK رفتار کرده و آن را به درایو cd/dvd منتقل کند. کد عملیاتی دستور ATA PASS-THROUGH (16) یعنی (0x85) با هیچ دستوری تداخل ندارد، بنابراین انتخاب بهتری است.

پیش از نسخه 2.6.29 هسته لینوکس، ذخیره‌سازهای انبوه USB داده‌های حسگر (sense data) را به ۱۸ بایت محدود می‌کردند که باعث می‌شد گزینه --ck_cond نتایج عجیب (بریده‌شده) به بار آورد.

این مثال‌ها از نام‌های دستگاه در لینوکس و ابزاری در لینوکس به نام hdparm استفاده می‌کنند. برای مشاهده نام‌های مناسب دستگاه در سایر سیستم‌عامل‌های پشتیبانی‌شده به صفحه راهنمای sg3_utils(8) مراجعه کنید.

در این مثال /dev/sdb یک دیسک ۲.۵ اینچی SATA است که از طریق یک دانگل USB (کانکتور نوع C) که پروتکل UAS (SCSI پیوست‌شده به USB، همچنین معروف به UASP) را پیاده‌سازی می‌کند متصل شده است. پروتکل UAS بهبود چشمگیری نسبت به کلاس حافظه انبوه USB است.

   # sg_sat_identify /dev/sdb
   Response for IDENTIFY DEVICE ATA command:
   00   0c5a 3fff c837 0010 0000 0000 003f 0000  .Z ?. .7 .. .. .. .? ..
....

خروجی هگزادسیمال اسکی (با متن اسکی ساده در سمت راست) به یک سطر خلاصه شده است (یعنی ۱۶ بایت اول (یا ۸ کلمه)). اکنون برای رمزگشایی بخشی از این پاسخ شناسایی ATA، ابتدا sg_inq می‌تواند چند رشته را رمزگشایی کند:

# sg_sat_identify -HHHH /dev/sdb | sg_inq --ata -I -
ATA device: model, serial number and firmware revision:
ST9500420AS     5VJCE6R7 0002SDM1

برای دریافت جزئیات بیشتر، ابزار hdparm انتخاب مناسبی است:

# sg_sat_identify -HHH /dev/sdb | hdparm --Istdin
ATA device, with non-removable media
    Model Number:       ST9500420AS
    Serial Number:      5VJCE6R7
    Firmware Revision:  0002SDM1
    Transport:          Serial
Standards:
....

در این حالت حدود ۸۰ سطر دیگر از جزئیات توسط hdparm رمزگشایی می‌شود. به تفاوت در تعداد گزینه‌های «H» توجه فرمایید: سه مورد، خروجی هگز بدون حاشیه را مرتب‌شده در کلمات (یعنی ۱۶ بیت برای هر کلمه و با ترتیب little endian) نمایش می‌دهند، در حالی که چهار مورد گزینه «H» خروجی هگز را بر حسب بایت (یعنی ۸ بیت برای هر بایت) تولید می‌کنند.

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

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

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

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

sg_vpd(sg3_utils), sg_inq(sg3_utils), sdparm(sdparm), hdparm(hdparm)

January 2020 sg3_utils-1.45