.TH runqlen.bt 8  "2018-10-07" "USER COMMANDS"
.SH "نام (NAME)"
runqlen.bt \- طول صف اجرای زمان‌بند پردازنده به‌صورت هیستوگرام. از bpftrace/eBPF استفاده می‌کند.
.SH "خلاصه دستور (SYNOPSIS)"
.B runqlen.bt
.SH "توضیحات (DESCRIPTION)"
این برنامه طول صف زمان‌بند را به‌صورت یک هیستوگرام خلاصه می‌کند، و همچنین می‌تواند میزان اشغال صف اجرا را نشان دهد. این ابزار با نمونه‌برداری از طول صف اجرا روی تمام پردازنده‌ها (CPUها) با فرکانس ۹۹ هرتز کار می‌کند.
.PP
این ابزار می‌تواند برای شناسایی عدم‌تعادل‌ها مورد استفاده قرار گیرد؛ برای نمونه هنگامی که پردازه‌ها به پردازنده‌های خاصی مقید (bound) شده‌اند و موجب تشکیل صف می‌شوند، یا هنگامی که نگاشت وقفه‌ها (interrupt mappings) سبب بروز چنین وضعیتی می‌شود.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.
.SH "مثال‌ها (EXAMPLES)"
.TP
ردگیری سراسری طول صف اجرای پردازنده در کل سیستم، و چاپ یک هیستوگرام با فشردن Ctrl-C:
#
.B runqlen.bt
.SH "فیلدها (FIELDS)"
.TP
1st, 2nd
طول صف اجرا در فیلد اول (پس از \(dq[\(dq) نشان داده می‌شود.
.TP
3rd
ستونی که تعداد نمونه‌ها را برای آن طول نشان می‌دهد.
.TP
4th
این یک هیستوگرام اسکی (ASCII) است که ستون تعداد را نمایش می‌دهد.
.SH "سربار (OVERHEAD)"
این ابزار ساختارهای داده زمان‌بند را در سراسر تمام پردازنده‌ها با نرخ ۹۹ هرتز نمونه‌برداری می‌کند. این مقدار نسبتاً نرخ پایینی از رویدادها است و انتظار می‌رود سربار این ابزار نزدیک به صفر باشد.
.SH "منبع (SOURCE)"
این ابزار برگرفته از bpftrace است.
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به پرونده همراه _examples.txt حاوی نمونه‌های نحوه استفاده، خروجی و توضیحات این ابزار مراجعه کنید.
.PP
این یک نسخه bpftrace از ابزار bcc با همین نام است. ابزار bcc ممکن است گزینه‌ها و قابلیت‌های سفارشی‌سازی بیشتری فراهم کند.
.IP
https://github.com/iovisor/bcc
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
runqlat.bt(8), mpstat(1), pidstat(1), uptime(1)