.TH threadsnoop.bt 8  "2019-07-02" "USER COMMANDS"
.SH "نام (NAME)"
threadsnoop.bt \- ردیابی ایجاد نخ (Thread) از طریق ()pthread_create. از bpftrace/eBPF استفاده می‌کند.
.SH "خلاصه دستور (SYNOPSIS)"
.B threadsnoop.bt
.SH "توضیحات (DESCRIPTION)"
ابزار threadsnoop فراخوانی‌های ()pthread_create را ردیابی کرده و مسیر ایجاد نخ‌ها را نمایش می‌دهد. این ابزار می‌تواند برای شناسایی و تحلیل مشخصات بار کاری (Workload Characterization) استفاده شود و ابزار مکملی برای execsnoop.bt(8) است که ()execve را ردیابی می‌کند.
.PP
این ابزار با ردیابی ()pthread_create از کتابخانه libpthread.so.0 کار می‌کند. ممکن است لازم باشد مسیر این کتابخانه در کد منبع ابزار ویرایش شود تا با سیستم شما مطابقت داشته باشد.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی فراخوانی‌های ()pthread_create:
#
.B threadsnoop.bt
.SH "فیلدها (FIELDS)"
.TP
TIME(ms)
زمان سپری‌شده از هنگام شروع ردیابی توسط ابزار (بر حسب میلی‌ثانیه).
.TP
PID
شناسه فرایند (Process ID).
.TP
COMM
نام فرایند (نخ).
.TP
FUNC
نام روال شروع (Start Routine) در صورت در دسترس بودن نماد (Symbol)، در غیر این صورت آدرس هگزادسیمال مربوط به روال شروع.
.SH "سربار (OVERHEAD)"
انتظار می‌رود نرخ ایجاد نخ‌ها پایین باشد (بسیار کمتر از ۱۰۰۰ در ثانیه)، بنابراین انتظار می‌رود سربار این ابزار ناچیز باشد.
.SH "منبع (SOURCE)"
این ابزار از کتاب «BPF Performance Tools» نشریه ادیسون وزلی (Addison Wesley 2019) برگرفته شده است:
.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)"
execsnoop.bt(8)