.TH OSLAT 8 "August 17, 2020" # SPDX-License-Identifier: GPL-3.0-only .\" for manpage-specific macros, see man(7) .SH "نام (NAME)" oslat \- آشکارساز تأخیر سیستم‌عامل .SH "خلاصه دستور (SYNOPSIS)" .SY oslat .RI "[ \-shvz ] [ \-b " bucket-size " ] [ \-B " bias " ] [ \-c " cpu-list " ] \ [ \-C " cpu-main-thread " ] [ \-f " rt-prio " ] [ \-\-json " filename " ] \ [ \-m " workload-mem " ] [\-t " runtime " ] [ \-T " trace-threshold " ] \ [ \-w " workload " ] [ \-W " bucket-width " ]" .SH "توضیحات (DESCRIPTION)" دستور .B oslat یک برنامه متن‌باز در فضای کاربری (userspace) با حالت سرکشی (polling mode) برای وارد کردن بار کاری و استرس جهت تشخیص تأخیر در سطح سیستم‌عامل است. این برنامه یک حلقه فعال (busy loop) را بدون بار کاری یا با بارهای کاری گوناگون اجرا می‌کند و در طول این فرآیند اطلاعات شمارنده برچسب زمانی (TSC) را گردآوری کرده و زمان را به طور مکرر اندازه‌گیری می‌کند. .SH "گزینه‌ها (OPTIONS)" .TP .B \-b, \-\-bucket-size=N مشخص کردن تعداد باکت‌ها (۴-۱۰۲۴). .TP .B \-B, \-\-bias افزودن یک مقدار بایاس (انحراف) به تمام باکت‌ها با استفاده از حداقل تخمینی. .TP .B \-c, \-\-cpu-list=CPULIST مشخص کردن پردازنده‌ها (CPU) برای اجرا. برای نمونه، '1,3,5,7-15'. .TP .B \-C, \-\-cpu-main-thread=CORE مشخص کردن اینکه ریسه اصلی بر روی کدام پردازنده اجرا شود. مقدار پیش‌فرض cpu0 است. .TP .B \-f, \-\-rtprio=PRIORITY استفاده از اولویت مشخص SCHED_FIFO (بین ۱ تا ۹۹). در غیر این صورت از اولویت پیش‌فرض استفاده می‌شود که معمولاً SCHED_OTHER است. .TP .B \-\-json=FILENAME نوشتن نتایج نهایی با قالب JSON در FILENAME. .TP .B \-m, \-\-workload-mem=SIZE اندازه حافظه مورد استفاده برای بار کاری (برای نمونه، 4K یا 1M). میزان کل حافظه مصرفی حاصل ضرب این مقدار در 2*N خواهد بود، زیرا برای هر ریسه بافرهای مبدأ/مقصد وجود دارد و N تعداد پردازنده‌های مورد آزمایش است. .TP .B \-D, \-\-duration=TIME تعیین مدت زمان آزمایش؛ برای نمونه، 60، 20m، 2H (m/M: دقیقه، h/H: ساعت، d/D: روز). به طور پیش‌فرض، واحد ثانیه است. .TP .B \-T, \-\-trace-threshold=THRESHOLD متوقف کردن آزمایش در هنگام فعال شدن آستانه (بر حسب میکروثانیه). در همین حین، یک نشانگر در ftrace ثبت شده و ftrace نیز متوقف می‌شود. .TP .B \-w, \-\-workload=WORKLOAD تعیین یک نوع بار کاری؛ پیش‌فرض بدون بار کاری است. گزینه‌ها: "no" و "memmove". .TP .B \-s, \-\-single-preheat استفاده از یک ریسه منفرد هنگام اندازه‌گیری تأخیر در مرحله پیش‌گرمایش (preheat) .br نکته: لطفاً پیش از استفاده از این پارامتر اطمینان حاصل کنید که فرکانس CPU در تمام هسته‌های آزمایشی قفل شده است. اگر نمی‌دانید چگونه فرکانس را قفل کنید، لطفاً از این پارامتر استفاده نکنید. .TP .B \-W, \-\-bucket-width فاصله بین باکت‌ها بر حسب نانوثانیه .PP نکته: پهناهایی که مضربی از ۱۰۰۰ نباشند خروجی با دقت نانوثانیه تولید می‌کنند. مسئولیت در نظر گرفتن تأثیر سربار اندازه‌گیری در مقیاس نانوثانیه بر عهده شما است. .TP .B \-h, \-\-help نمایش پیام راهنما. .TP .B \-v, \-\-version نمایش نسخه برنامه. .TP .B \-z, \-\-zero-omit عدم نمایش باکت‌ها در هیستوگرام خروجی در صورتی که همه مقادیر صفر باشند. .SH "نویسنده (AUTHOR)" .B oslat توسط Peter Xu نوشته شده است.