.TH naptime.bt 8  "2019-07-05" "USER COMMANDS"
.SH "نام (NAME)"
naptime.bt \- ردیابی فراخوانی‌های توقف اختیاری (sleep). استفاده از bpftrace/eBPF.
.SH "خلاصه دستور (SYNOPSIS)"
.B naptime.bt
.SH "توضیحات (DESCRIPTION)"
این ابزار توقف‌های اختیاری برنامه‌ها (sleep) را ردیابی می‌کند و می‌تواند برای اشکال‌زدایی تاخیر بالا که ممکن است بر اثر خواب‌های عمدی قرار داده شده در روتین‌های برنامه‌ها، به ویژه اسکریپت‌های مدیریتی باشد، استفاده شود.
.PP
این ابزار با ردیابی فراخوانی سیستمی
.BR nanosleep(2)
با استفاده از نقاط ردیابی (tracepoints) فراخوانی‌های سیستمی کار می‌کند.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی توقف‌های برنامه‌ها از طریق nanosleep(2):
#
.B naptime.bt
.SH "فیلدها (FIELDS)"
.TP
TIME
برچسب زمانی در قالب HH:MM:SS.
.TP
PPID
شناسه فرایند والد (Parent PID).
.TP
PCOMM
نام فرایند والد.
.TP
PID
شناسه فرایند در حال خواب.
.TP
COMM
نام فرایند در حال خواب.
.TP
SECONDS
مدت زمان درخواست‌شده برای توقف (بر حسب ثانیه).
.SH "بار پردازشی (OVERHEAD)"
انتظار می‌رود فراخوانی‌های nanosleep(2) بسامد پایینی داشته باشند (بسیار کمتر از ۱۰۰ در ثانیه)، بنابراین انتظار می‌رود بار پردازشی این ابزار ناچیز باشد.
.SH "منبع (SOURCE)"
این ابزار برگرفته از کتاب «BPF Performance Tools» منتشر شده توسط Addison Wesley (۲۰۱۹) است:
.IP
http://www.brendangregg.com/bpf-performance-tools-book.html
.PP
برای مستندات بیشتر پیرامون این ابزار به کتاب مراجعه کنید.
.PP
این نسخه در مخزن bpftrace قرار دارد:
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به پرونده همراه _examples.txt که شامل نمونه نحوه استفاده، خروجی و توضیحات این ابزار است مراجعه کنید.
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
capable.bt(8)