نام (NAME)

bpftool-perf - ابزاری برای بازرسی پیوست‌های برنامه bpf مرتبط با perf

خلاصه دستور (SYNOPSIS)

bpftool [OPTIONS] perf COMMAND

OPTIONS := { { -j | --json } [{ -p | --pretty }] | { -d | --debug } }

COMMANDS := { show | list | help }

دستورات PERF (PERF COMMANDS)

bpftool perf { show | list }
bpftool perf help

توضیحات (DESCRIPTION)

bpftool perf { show | list }: فهرست کردن تمام پیوست‌های raw_tracepoint، tracepoint و kprobe در سیستم.
خروجی با شناسه فرایند (PID) و توصیف‌گر فایل در آن فرایند آغاز می‌شود، و در ادامه شناسه برنامه bpf، اطلاعات پیوست و نقطه پیوست می‌آید. نقطه پیوست برای raw_tracepoint/tracepoint نام پروب ردیابی است. نقطه پیوست برای k[ret]probe یا نام نماد و آفست، یا یک نشانی مجازی هسته است. نقطه پیوست برای u[ret]probe نام فایل و آفست درون فایل است.
bpftool perf help: چاپ پیام کوتاه راهنما.

گزینه‌ها (OPTIONS)

-h, --help: چاپ پیام کوتاه راهنما (مشابه bpftool help).
-V, --version: چاپ شماره نسخه bpftool (مشابه bpftool version)، شماره نسخه libbpf در حال استفاده، و ویژگی‌های اختیاری که هنگام کامپایل bpftool گنجانده شده‌اند. ویژگی‌های اختیاری شامل پیوند با LLVM یا libbfd برای ارائه دیزاسمبلر برای برنامه‌های JIT شده (bpftool prog dump jited) و استفاده از اسکلت‌های BPF است (برخی ویژگی‌ها مانند bpftool prog profile یا نمایش pidهای مرتبط با اشیاء BPF ممکن است به آن متکی باشند).
-j, --json: تولید خروجی JSON. برای دستوراتی که نمی‌توانند JSON تولید کنند، این گزینه هیچ تاثیری ندارد.
-p, --pretty: تولید خروجی JSON با قالب خوانا برای انسان. به‌طور ضمنی -j را فعال می‌کند.
-d, --debug: چاپ تمامی لاگ‌های موجود، حتی اطلاعات در سطح دیباگ. این شامل لاگ‌های libbpf و همچنین اعتبارسنج (verifier) هنگام تلاش برای بارگذاری برنامه‌ها می‌شود.

مثال‌ها (EXAMPLES)

# bpftool perf

pid 21711  fd 5: prog_id 5  kprobe  func __x64_sys_write  offset 0
pid 21765  fd 5: prog_id 7  kretprobe  func __x64_sys_nanosleep  offset 0
pid 21767  fd 5: prog_id 8  tracepoint  sys_enter_nanosleep
pid 21800  fd 5: prog_id 9  uprobe  filename /home/yhs/a.out  offset 1159

# bpftool -j perf

[{"pid":21711,"fd":5,"prog_id":5,"fd_type":"kprobe","func":"__x64_sys_write","offset":0}, \
 {"pid":21765,"fd":5,"prog_id":7,"fd_type":"kretprobe","func":"__x64_sys_nanosleep","offset":0}, \
 {"pid":21767,"fd":5,"prog_id":8,"fd_type":"tracepoint","tracepoint":"sys_enter_nanosleep"}, \
 {"pid":21800,"fd":5,"prog_id":9,"fd_type":"uprobe","filename":"/home/yhs/a.out","offset":1159}]

همچنین ببینید (SEE ALSO)

bpf(2), bpf-helpers(7), bpftool(8), bpftool-btf(8), bpftool-cgroup(8), bpftool-feature(8), bpftool-gen(8), bpftool-iter(8), bpftool-link(8), bpftool-map(8), bpftool-net(8), bpftool-prog(8), bpftool-struct_ops(8), bpftool-token(8)