.TH HWLATDETECT 8 "May  12, 2009"
# SPDX-License-Identifier: GPL-2.0-only
.SH "نام (NAME)"
hwlatdetect \- برنامه‌ای برای کنترل بخش تشخیص تأخیر سخت‌افزاری در ftrace هسته
.SH "خلاصه دستور (SYNOPSIS)"
.B hwlatdetect
.RI "[ \-\-duration=<time> ] [\-\-threshold=<usecs> ] \
[\-\-window=<time interval> ] [\-\-width=<time interval> ] \
[\-\-hardlimit=<microsecond value> ] [\-\-report=<path> ] \
[\-\-debug ] [\-\-quiet ] [\-\-watch]"
.SH "توضیحات (DESCRIPTION)"
برنامه
.B hwlatdetect
آشکارساز تأخیر سخت‌افزاری هسته در ftrace
.RI ( hwlatdetector )
را کنترل می‌کند.
.B hwlatdetector
برای تشخیص تأخیرهای بزرگ سیستمی ناشی از رفتار سخت‌افزار یا سفت‌افزار (فریم‌ور) زیرین، مستقل از خود لینوکس، استفاده می‌شود.
این کد در ابتدا برای تشخیص وقفه‌های مدیریت سیستم
.RI ( SMI
یا
.IR "System Management Interrupts" )
روی سیستم‌های x86 توسعه یافته بود، هرچند هیچ ویژگی خاص و منحصر به x86 در آن وجود ندارد.
این ابزار در ابتدا برای استفاده در مجموعه وصله‌های «RT» نوشته شد زیرا هسته بی‌درنگ (Real Time) به تأخیر حساسیت بالایی دارد.
.PP
وقفه‌های SMI معمولاً توسط هسته لینوکس مدیریت نمی‌شوند و لینوکس معمولاً حتی از وقوع آن‌ها آگاه نمی‌شود. وقفه‌های SMI در عوض توسط کد BIOS تنظیم و اجرا می‌شوند، که معمولاً برای رویدادهای «بحرانی» نظیر مدیریت حسگرهای حرارتی و فن‌ها به کار می‌روند. با این حال گاهی اوقات وقفه‌های SMI برای وظایف دیگر استفاده می‌شوند و این وظایف می‌توانند زمان بسیار زیادی را در روتین وقفه سپری کنند (گاهی در مقیاس میلی‌ثانیه). بدیهی است اگر در تلاش برای پایین نگه‌داشتن تأخیر پاسخ‌دهی رویدادها در محدوده میکروثانیه باشید، این موضوع یک مشکل اساسی است.
.PP
آشکارساز تأخیر سخت‌افزاری ftrace از طریق در اختیار گرفتن کامل تمام پردازنده‌ها (CPUها) برای مدت‌زمان‌های قابل‌پیکربندی (با فراخوانی
.BR ()stop_machine )،
پایش شمارنده برچسب زمانی پردازنده
.RI ( TSC
یا
.IR "Time Stamp Counter" )
برای یک بازه زمانی مشخص، و سپس جستجوی شکاف‌ها در داده‌های TSC عمل می‌کند. هرگونه شکاف نشان‌دهنده زمانی است که فرآیند پایش متوقف شده است، و از آنجا که پردازنده‌ها متوقف شده و وقفه‌ها غیرفعال هستند، تنها عاملی که می‌تواند باعث چنین وقفه‌ای شود یک SMI است.
.PP
اسکریپت
.B hwlatdetector
عملیات مانت و آن‌مانت کردن
.B debugfs
و همچنین تعامل با
.B hwlatdetector
در ftrace را مدیریت می‌کند. اگر
.B debugfs
از پیش مانت شده باشد،
.B hwlatdetector
پس از اجرا آن را آن‌مانت نخواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-duration=<time>{s,m,d}
اجرای منطق آشکارساز برای مدت‌زمان مشخص‌شده. مدت‌زمان یک عدد صحیح در مبنای ۱۰ است که به‌طور پیش‌فرض بر حسب ثانیه در نظر گرفته می‌شود. پسوندهای اختیاری می‌توانند برای تعیین دقیقه، ساعت یا روز مشخص شوند.
.TP
.B \-\-threshold=<microsecond value>
تعیین شکاف TSC مورد استفاده برای تشخیص SMI. هر مقدار شکاف بزرگ‌تر از
.B <threshold>
به‌عنوان نتیجه وقوع یک SMI تلقی می‌شود.
.TP
.B \-\-hardlimit=<microsecond value>
در صورت رخ دادن مقداری بیش از
.BR hardlimit ،
آزمون ناموفق در نظر گرفته می‌شود. این موضوع بر کد وضعیت خروجی
.B hwlatdetect
تأثیر می‌گذارد.
.TP
.B \-\-window=<time value>{us,ms,s,m,d}
تعیین اندازه پنجره نمونه‌برداری. این مقدار هنگام ارسال به هسته به میکروثانیه تبدیل می‌شود.
.TP
.B \-\-width=<time value>{us,ms,s,m,d}
میزان زمان در پنجره نمونه‌برداری که در آن آشکارساز عملاً نمونه‌برداری می‌کند. این مقدار باید کمتر از مقدار
.B \-\-window
باشد.
.TP
.B \-\-report=FILENAME
تعیین نام فایل خروجی برای گزارش آشکارساز. رفتار پیش‌فرض چاپ در خروجی استاندارد است.
.TP
.B \-\-cpu-list=CPU-LIST
تعیین پردازنده‌هایی که رشته برنامه
.B hwlat
باید در میان آن‌ها جابه‌جا شود.
.TP
.B \-\-debug
فعال کردن پیام‌های اشکال‌زدایی.
.TP
.B \-\-quiet
غیرفعال کردن تمام پیام‌های اطلاع‌رسانی.
.TP
.B \-\-watch
چاپ داده‌های نمونه در خروجی استاندارد هم‌زمان با دریافت آن‌ها.
.SH "نویسندگان (AUTHORS)"
.B hwlatdetect
توسط Clark Williams <williams@redhat.com> نوشته شده است.
.br
.B hwlat_detector.ko
توسط Jon Masters <jcm@redhat.com> نوشته شده است.