SG_SAT_READ_GPLOG(8) SG3_UTILS SG_SAT_READ_GPLOG(8)

sg_sat_read_gplog - استفاده از دستور ATA READ LOG EXT یا SMART READ LOG از طریق لایه ترجمه SCSI به ATA (SAT)

sg_sat_read_gplog [--address=LA_L] [--ck_cond] [--count=CO] [--dma] [--help] [--hex] [--len=CMD_LEN] [--log=LA_L] [--page=PN] [--ppt=PPT] [--readonly] [--smart] [--verbose] [--version] DEVICE

این ابزار یک دستور ATA READ LOG EXT،‏ ATA READ LOG DMA EXT، یا ATA SMART READ LOG را به DEVICE ارسال می‌کند. حالت پیش‌فرض، ارسال یکی از دو دستور اول برای خواندن برگه(های) «لاگ همه‌منظوره» (general purpose log) است. تنها دستگاه‌های (S)ATA (مانند دیسک‌ها) و نه دستگاه‌های ATAPI (مانند گرداننده‌های DVD) از برگه‌های لاگ همه‌منظوره پشتیبانی می‌کنند. دستور READ LOG (DMA) EXT به جای ارسال مستقیم به دستگاه، از طریق یک لایه انتقال SCSI فرستاده می‌شود که فرض می‌شود شامل یک لایه ترجمه SCSI به ATA (SAT) با سرنام SATL باشد. لایه SATL ممکن است در یک درایور سیستم‌عامل، در سفت‌افزار آداپتور گذرگاه میزبان (HBA) یا در یک محفظه (enclosure) خارجی قرار داشته باشد.

این ابزار در حال حاضر تلاشی برای رمزگشایی پاسخ دریافتی از دیسک ATA نمی‌کند، بلکه پاسخ را به صورت هگزادسیمال اسکی (ASCII hexadecimal) گروه‌بندی‌شده در بایت‌های ۸ بیتی یا کلمات ۱۶ بیتی نمایش می‌دهد. بر اساس قراردادهای ATA، این کلمات به صورت کم‌ارزش‌ترین بایت در ابتدا (little endian) رمزگشایی می‌شوند (توجه داشته باشید که دستورات SCSI از نمایش باارزش‌ترین بایت در ابتدا یا big endian استفاده می‌کنند). آدرس لاگ 0، شماره برگه 0 برگه لاگ «فهرست راهنما» (directory) است و در صورتی که گزینه --hex داده نشود، رمزگشایی می‌شود. در آینده ممکن است این ابزار تلاش کند تا برگه‌های لاگ دیگر را نیز رمزگشایی کند. شاید سایر ابزارهای ATA بتوانند با دریافت خروجی هگزادسیمال این ابزار، این برگه‌های لاگ را رمزگشایی کنند.

دریافت تمام برگه‌های لاگ به نظر ساده می‌آید: خواندن برگه لاگ فهرست راهنما و سپس دسترسی به آن دسته از آدرس‌های لاگ که بیش از صفر شماره برگه مرتبط دارند. متأسفانه قضیه به این سادگی نیست. برخی از آدرس‌های لاگ (به‌طور مشخص 0xe1 یا «انتقال داده SCT») پیش از واکشی برگه لاگ در آن آدرس لاگ، نیازمند اجرای یک دستور SCT هستند. سایر آدرس‌های لاگ ممکن است مشکل‌ساز باشند (برای مثال، پیشنهاد شده است که از «لاگ‌های مختص سازنده دستگاه» 0xa0:0xdf اجتناب شود)، بنابراین شاید بهتر باشد از آن‌ها نیز صرف‌نظر شود. به همین دلیل گزینه‌های --address=LA_L و --log=LA_L طوری طراحی شده‌اند که فهرستی از محدوده‌ها را دریافت کنند.

استاندارد SAT-4 (پیش‌نویس قبلی SAT ANSI INCITS 491-201r7: فایل sat4r06.pdf در www.t10.org) سه دستور SCSI به نام «ATA PASS-THROUGH» تعریف می‌کند: یکی با استفاده از یک cdb دوازده (12) بایتی، دیگری با استفاده از cdb شانزده (16) بایتی، و سومی با یک cdb سی و دو (32) بایتی. این ابزار به طور پیش‌فرض از نگارش cdb شانزده بایتی استفاده می‌کند.

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

که در آن LA_L یک «آدرس لاگ» منفرد، محدوده‌ای از آدرس‌های لاگ، یا فهرستی از (محدوده‌های) آدرس‌های لاگ است. یک آدرس لاگ عددی بین 0 تا 255 (0xff) است که در آن آدرس لاگ 0، شماره برگه 0، یک فهرست راهنما است. محدوده آدرس‌های لاگ به فرم "lo:hi" است که در آن آدرس لاگ "hi" باید بزرگ‌تر یا مساوی "lo" باشد. فهرست آدرس لاگ، یک فهرست جداشده با کاما از آدرس‌های لاگ یا محدوده‌های آدرس لاگ است.
هر آدرس لاگ حداکثر شامل 256 (لاگ SMART) یا 65536 (لاگ همه‌منظوره) شماره برگه است که از شماره برگه 0 آغاز می‌شود. تعداد شماره برگه‌های موجود برای هر آدرس لاگ در برگه فهرست راهنمای لاگ مشخص شده است.
خلاصه نحو LA_L: lo:hi,lo2:hi2,lo3:hi3 ...
بیت CK_COND را در cdb دستور ATA PASS-THROUGH SCSI تنظیم می‌کند. مقدار پیش‌فرض پاک (یعنی 0) است. در صورت تنظیم بودن، SATL باید صرف‌نظر از موفقیت یا شکست دستور ATA، یک بافر sense شامل یک توصیف‌گر نتیجه ATA (ATA Result descriptor) تولید کند. هنگامی که پاک باشد، SATL تنها در صورتی باید یک بافر sense شامل توصیف‌گر نتیجه ATA تولید کند که دستور ATA با شکست مواجه شده باشد.
عدد CO در فیلد "count" دستور ATA READ LOG EXT قرار می‌گیرد. این مقدار تعداد برگه‌های داده لاگ ۵۱۲ بایتی را مشخص می‌کند که باید از آدرس لاگ تعیین‌شده خوانده شوند. آدرس برگه مشخص‌شده، از شماره برگه ارائه‌شده شروع به خواندن می‌کند. آخرین شماره برگه خوانده‌شده (در صورت وجود) برابر با (PN + CO - 1) خواهد بود.
حداکثر مقدار CO برای برگه‌های لاگ همه‌منظوره 0xffff (65,535) و برای برگه‌های لاگ SMART برابر 0xff (255) است.
به طور معمول اگر مقدار داده‌شده --page=PN (پیش‌فرض 0) به علاوه CO از تعداد نشان‌داده‌شده در فهرست راهنمای لاگ (آدرس لاگ 0) برای آدرس لاگ تعیین‌شده بیشتر شود، خطا گزارش می‌شود.
توجه داشته باشید که CO فقط برای آدرس لاگ فعلی اعمال می‌شود؛ به عبارت دیگر هیچ چرخشی (wrap around) به ابتدای آدرس لاگ بعدی وجود ندارد.
به جای دستور ATA READ LOG EXT از دستور ATA READ LOG DMA EXT استفاده می‌کند. برخی از دستگاه‌ها برای بازگرداندن داده‌های معتبر لاگ به این دستور نیاز دارند.
پیام راهنمای استفاده که خلاصه‌ای از گزینه‌های خط فرمان است را نمایش داده و خارج می‌شود. در صورت ارائه DEVICE آن را نادیده می‌گیرد.
اگر یک بار مشخص شود، پاسخ به صورت بایت‌های هگزادسیمال اسکی نمایش داده می‌شود. اگر دو بار مشخص شود، پاسخ طبق قراردادهای ATA (یعنی little endian) در قالب کلمات ۱۶ بیتی گروه‌بندی می‌شود؛ این حالت خروجی پیش‌فرض است (یعنی هنگامی که این گزینه مشخص نشده باشد). در صورت تکرار سه باره (یعنی '-HHH')، خروجی به صورت هگزادسیمال گروه‌بندی‌شده در کلمات ۱۶ بیتی (بدون آفست در ابتدا و نویسه‌های اسکی در انتهای هر خط) در قالبی ارائه می‌شود که برای پردازش توسط 'hdparm --Istdin' قابل قبول است.

اگر این گزینه چهار بار فراخوانی شود (مانند '-HHHH')، برگه‌های لاگ به صورت بایت‌های هگز، بدون آدرس در آغاز هر خط، خارج می‌شوند. این کار رمزگشایی هگز را برای رایانه‌ها (و نه انسان‌ها) آسان‌تر می‌کند. اگر این گزینه پنج بار فراخوانی شود، یک خط توضیح که با نویسه '#' آغاز می‌شود پیش از هر برگه لاگ ۵۱۲ بایتی چاپ می‌شود. این توضیح برگه لاگ پس از خود را شرح می‌دهد.

که در آن CMD_LEN طول دستور (cdb) برای دستور SCSI ATA PASS-THROUGH است که برای تونل کردن دستورات ATA استفاده می‌شود. سه مقدار مجاز است: 12، 16 و 32 (بایت طول). نگارش ۱۲ بایتی بیشترین محدودیت‌ها را دارد (به عنوان مثال، فیلد 'count' آن تک‌بایتی است) اما سیستم‌های قدیمی‌تر ممکن است اجازه اجرای دستورات ۱۶ یا ۳۲ بایتی را ندهند.
گزینه --address=LA_L را ببینید.
عدد PN شماره برگه (درون آدرس لاگ) است و در بیت‌های 32:16 از فیلد "lba" دستور ATA READ LOG (DMA) EXT قرار می‌گیرد. مقدار پیش‌فرض قرار داده‌شده در فیلد "lba" برابر 0 است.
حداکثر مقدار PN برای برگه‌های لاگ همه‌منظوره 0xffff (65,535) و برای برگه‌های لاگ SMART برابر 0xff (255) است. در حالت دوم، PN باید 0 و CO برابر 255 باشد.

هنگامی که چندین آدرس لاگ مشخص شده باشد (از طریق آرگومان LA_L)، با این گزینه به گونه متفاوتی رفتار می‌شود. در حالت چند آدرس لاگ، اگر PN بزرگ‌تر از 0 باشد، به عنوان حد بالای تعداد شماره برگه‌هایی عمل می‌کند که برای هر آدرس لاگ خروجی داده خواهند شد. تعداد واقعی برگه‌های لاگ ۵۱۲ بایتی خروجی، به تعداد شماره برگه‌های نشان‌داده‌شده در برگه لاگ فهرست راهنما برای آدرس لاگ فعلی نیز بستگی دارد.

که در آن PPT تعداد برگه‌هایی است که در هر بار فراخوانی دستور ATA READ LOG EXT یا ATA READ LOG DMA EXT باید از DEVICE منتقل شوند. مقدار پیش‌فرض 128 (یا 64 کیبی‌بایت) است که به این دلیل انتخاب شده است که بیشتر سیستم‌عامل‌ها برای اندازه انتقال داده به و از یک دستگاه در یک دستور واحد حد بالایی دارند. وقتی تعداد برگه‌های لاگ ارائه‌شده با گزینه --count=CO زیاد باشد، ممکن است از آنچه سیستم‌عامل در یک بار اجرای دستور مجاز می‌داند فراتر رود؛ از این رو به این گزینه نیاز است.
طول cdb در SCSI است که برای دستورات ATA PASS-THROUGH استفاده می‌شود. آرگومان می‌تواند 32، 16 یا 12 باشد. مقدار پیش‌فرض 16 است. برخی از لایه‌های انتقال SCSI نمی‌توانند دستورات SCSI طولانی‌تر از ۱۲ بایت را منتقل کنند.
باعث می‌شود DEVICE با پرچم فقط‌خواندنی (O_RDONLY در یونیکس) باز شود. رفتار پیش‌فرض، باز کردن DEVICE با پرچم خواندن-نوشتن (O_RDWR در یونیکس) است. در برخی موارد، در صورتی که DEVICE با پرچم خواندن-نوشتن باز شده باشد، اقدامات سیستم‌عامل هنگام close() اثر دستورات مدیریت توان ارسالی به دیسک‌های ATA را خنثی می‌کند (برای مثال ممکن است سیستم‌عامل تصور کند که باید داده‌ای را روی دیسک تخلیه یا flush کند).
در مجموعه ویژگی‌های ATA SMART، برگه‌های لاگ «SMART» از مدت‌ها پیش وجود داشته‌اند و سابقه آن‌ها به پیش از افزوده‌شدن بعدی برگه‌های لاگ «همه‌منظوره» بازمی‌گردد. بنابراین این ابزار به سادگی می‌تواند برای خواندن برگه‌های لاگ «SMART» به جای برگه‌های لاگ همه‌منظوره گسترش یابد. این دقیقاً همان کاری است که این گزینه انجام می‌دهد.
دستور ATA SMART READ LOG فیلد شماره برگه ندارد، همه دریافت‌ها از شماره برگه 0 آغاز می‌شوند. همچنین تعداد شماره برگه‌ها (در آدرس لاگ آن) به یک بایت محدود است (بنابراین 255). برگه فهرست راهنمای لاگ همه‌منظوره و برگه فهرست راهنمای لاگ SMART دارای قالب یکسانی هستند (با در نظر گرفتن محدودیت تک‌بایتی برای تعداد شماره برگه‌ها در هر آدرس لاگ SMART).
سطح پرگویی را افزایش می‌دهد.
رشته نسخه را چاپ می‌کند.

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

تفاوت‌های جزئی در رفتار برنامه بین حالتی که یک آدرس لاگ منفرد واکشی می‌شود و حالتی که چندین برگه لاگ واکشی می‌شوند وجود دارد. در حالت آدرس لاگ منفرد، آدرس لاگ، شماره برگه و تعداد در فیلدهای مربوطه در دستور ATA READ LOG EXT یا ATA SMART READ LOG قرار می‌گیرند. هنگامی که چندین آدرس لاگ داده می‌شود، ابتدا برگه لاگ «فهرست راهنما» (log_address=0, page_number=0) بارگذاری می‌شود. سپس تنها آدرس‌های لاگی که فهرست راهنما نشان می‌دهد بیش از صفر شماره برگه لاگ دارند، واکشی می‌شوند. تعداد شماره برگه‌های لاگ مورد دسترسی، در صورتی که PN بزرگ‌تر از صفر باشد، ممکن است توسط گزینه --page=PN بیشتر محدود شود.

در ابتدا این مثالی است برای اجتناب از آدرس‌های لاگ مشکل‌ساز که در بخش توضیحات در بالا به آن‌ها اشاره شد:


sg_sat_read_gplog -a 0:0xb,0xd:0x9f,0xe0,0xe2:255 /dev/sdc

دستور بالا از شکل کوتاه گزینه --address=LA_L با فهرستی استفاده می‌کند که از آدرس‌های لاگ 0xc،‏ 0xa0 تا 0xdf و 0xe1 اجتناب می‌کند. خروجی شامل تمام آدرس‌های لاگ (به جز موارد استثناشده) خواهد بود که فهرست راهنما نشان می‌دهد بیش از 0 شماره برگه دارند.
فراخوانی زیر از دستور SMART READ LOG به جای دستور READ LOG EXT استفاده می‌کند:


sg_sat_read_gplog --smart -a 0:0xb,0xd:0x9f,0xe0,0xe2:255 /dev/sdc

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

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

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

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

sg_sat_identify(sg3_utils), sg_inq(sg3_utils), sdparm(sdparm), hdparm(hdparm), smartctl(smartmontools)

ژانویه 2023 sg3_utils-1.48