.TH SG_SAT_PHY_EVENT "8" "ژوئیه 2020" "sg3_utils\-1.46" "راهنمای پارچ لینوکس"
.SH "نام (NAME)"
sg_sat_phy_event \- واکشی شمارنده‌های رخداد فیزیکی SATA با استفاده از دستور ATA READ LOG EXT از طریق گذرگاه SAT
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_sat_phy_event
[\fI\-\-ck_cond\fR] [\fI\-\-extend\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR]
[\fI\-\-ignore\fR] [\fI\-\-len=\fR{16|12}] [\fI\-\-raw\fR] [\fI\-\-reset\fR]
[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
این ابزار یک دستور ATA READ LOG EXT را با صفحه گزارش تنظیم‌شده روی 11h به
.I DEVICE
ارسال کرده و پاسخ را نمایش می‌دهد. صفحه گزارش 11h در استاندارد SATA 2.5 تعریف شده و شامل شمارنده‌های رخدادهای لایه فیزیکی (phy) است. به جای ارسال مستقیم این دستور به دستگاه، فرامین از طریق انتقال SCSI ارسال می‌شوند که فرض می‌شود دارای یک لایه ترجمه SCSI به ATA با نام اختصاری SAT (یا SATL) است. این لایه SATL می‌تواند در درایور سیستم‌عامل، سفت‌افزار آداپتور گذرگاه میزبان یا در یک محفظه بیرونی قرار داشته باشد.
.PP
استاندارد SAT (استاندارد SAT ANSI INCITS 431\-2007) دو دستور SCSI با نام «ATA PASS\-THROUGH» تعریف می‌کند: یکی با استفاده از cdb شانزده بایتی و دیگری با cdb دوازده بایتی. این ابزار به‌طور پیش‌فرض از نوع cdb شانزده بایتی استفاده می‌کند. استاندارد SAT\-2 و پیش‌نویس‌های مرتبط نیز موجود هستند.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های بلند برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-c\fR, \fB\-\-ck_cond\fR
بیت CK_COND را در بلوک cdb دستور ATA PASS\-THROUGH تنظیم می‌کند. حالت پیش‌فرض صفر است. در صورت تنظیم، لایه SATL بدون توجه به موفقیت یا شکست دستور، بافر حس‌گر حاوی توصیف‌گر نتیجه ATA را بازمی‌گرداند.
.TP
\fB\-e\fR, \fB\-\-extend\fR
بیت EXTEND را در بلوک cdb دستور ATA PASS\-THROUGH تنظیم می‌کند. حالت پیش‌فرض صفر است. در صورت تنظیم، یک دستور ۴۸ بیتی LBA به دستگاه فرستاده می‌شود. این گزینه در صورت استفاده از \fI\-\-len=12\fR هیچ تاثیری ندارد.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنما و خلاصه گزینه‌های خط فرمان را نمایش داده و خارج می‌شود. در صورت ارائه \fIDEVICE\fR، آن را نادیده می‌گیرد.
.TP
\fB\-H\fR, \fB\-\-hex\fR
پاسخ ATA READ LOG EXT را در قالب هگزادسیمال نمایش می‌دهد. حالت پیش‌فرض نمایش در قالب هگزادسیمال در کلمات ۱۶ بیتی است. با یک‌بار استفاده، خروجی به صورت بایت‌های هگزادسیمال اسکی و با دو بار استفاده (\fB\-HH\fR)، بدون هدر نمایش داده می‌شود.
.TP
\fB\-i\fR, \fB\-\-ignore\fR
معمولاً نام‌های شناسه شمارنده لایه فیزیکی رمزگشایی می‌شوند. با فعال بودن این گزینه، مقدار عددی شناسه، پرچم سازنده، طول داده به بایت و مقدار متناظر آن نمایش می‌یابد.
.TP
\fB\-l\fR, \fB\-\-len\fR={16|12}
طول بلوک cdb دستورات ATA PASS\-THROUGH در SCSI است. آرگومان می‌تواند ۱۶ یا ۱۲ باشد و مقدار پیش‌فرض ۱۶ است. اندازه ۱۶ بایتی برای آدرس‌دهی ۴۸ بیتی LBA نیاز است.
.TP
\fB\-r\fR, \fB\-\-raw\fR
پاسخ را در قالب باینری در خروجی استاندارد قرار می‌دهد. در صورت استفاده از این گزینه، خروجی باید به یک پرونده یا برنامه دیگر هدایت شود.
.TP
\fB\-R\fR, \fB\-\-reset\fR
شمارنده‌ها را پس از دریافت مقادیر فعلی و نمایش آن‌ها بازنشانی می‌کند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی اشکال‌زدایی.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه برنامه و خروج.
.SH "نکات (NOTES)"
کد عملیات دستور SCSI ATA PASS\-THROUGH (12) برابر 0xa1 بوده و با دستور BLANK در رده دیسک‌گردان‌های نوری تداخل دارد. از این رو دستور ATA PASS\-THROUGH (16) با کد عملیات 0x85 بدون تداخل بوده و گزینه بهتری است.
.PP
در هسته‌های سری ۲.۴ لینوکس،
.I DEVICE
باید یک دستگاه عمومی SCSI (sg) باشد. در سری‌های ۲.۶ به بعد دستگاه‌های بلوکی دیسک‌ها نیز پشتیبانی می‌شوند.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_sat_phy_event در صورت موفقیت برابر با 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه فرمایید.
.SH "نویسندگان (AUTHORS)"
نوشته شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2006\-2020 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا مناسب بودن برای یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.BR sg_sat_identify ,
.BR sg_sat_read_gplog (sg3_utils),
.BR smp_rep_phy_err_log (smp_utils),
.BR sdparm (sdparm),
.BR hdparm (hdparm)