.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "bpftool-iter" "8" "" ""
.SH "نام (NAME)"
bpftool-iter \- ابزاری برای ایجاد تکرارکننده‌های BPF (پیمایش‌گرها)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbpftool\fP [\fIOPTIONS\fP] \fBiter\fP \fICOMMAND\fP
.sp
\fIOPTIONS\fP := { { \fB\-j\fP | \fB\-\-json\fP } [{ \fB\-p\fP | \fB\-\-pretty\fP }] | { \fB\-d\fP | \fB\-\-debug\fP } }
.sp
\fICOMMANDS\fP := { \fBpin\fP | \fBhelp\fP }
.SH "دستورات تکرارکننده (ITER COMMANDS)"
.nf
\fBbpftool\fP \fBiter pin\fP \fIOBJ\fP \fIPATH\fP [\fBmap\fP \fIMAP\fP]
\fBbpftool\fP \fBiter help\fP

\fIOBJ\fP := /a/file/of/bpf_iter_target.o
\fIMAP\fP := { \fBid\fP \fIMAP_ID\fP | \fBpinned\fP \fIFILE\fP }
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.INDENT 0.0
.TP
.B bpftool iter pin \fIOBJ\fP \fIPATH\fP [map \fIMAP\fP]
یک تکرارکننده BPF، پیمایش در هسته روی داده‌های خاص هسته (مانند tasks، bpf_maps و غیره) را با یک برنامه bpf که برای هر شیء داده هسته فراخوانی می‌شود (مانند یک task، یک bpf_map و غیره) ترکیب می‌کند. فضای کاربری می‌تواند خروجی تکرارکننده هسته را از طریق فراخوانی سیستمی \fIread()\fP بخواند.
.sp
دستور \fIpin\fP یک تکرارکننده bpf از \fIOBJ\fP ایجاد کرده و آن را به \fIPATH\fP سنجاق (pin) می‌کند\&.
مسیر \fIPATH\fP باید در نقطه اتصال \fIbpffs\fP قرار داشته باشد. این مسیر نباید شامل نویسه نقطه (\(aq.\(aq) باشد، زیرا این نویسه برای توسعه‌های آینده \fIbpffs\fP رزرو شده است\&.
.sp
تکرارکننده bpf برای عناصر نگاشت به یک پارامتر اضافی \fIMAP\fP نیاز دارد تا برنامه bpf بتواند روی عناصر آن نگاشت پیمایش کند. کاربر می‌تواند یک برنامه bpf در هسته داشته باشد تا به ازای هر عنصر نگاشت اجرا شده و بررسی، پالایش (فیلتر کردن)، تجمیع و غیره را بدون نیاز به کپی کردن داده‌ها به فضای کاربری انجام دهد.
.sp
کاربر سپس می‌تواند با دستور \fIcat PATH\fP خروجی تکرارکننده bpf را مشاهده کند.
.TP
.B bpftool iter help
چاپ پیام راهنمای کوتاه.
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
چاپ پیام راهنمای کوتاه (مشابه \fBbpftool help\fP).
.TP
.B  \-V\fP,\fB  \-\-version
چاپ شماره نسخه bpftool (مشابه \fBbpftool version\fP)، شماره نسخه libbpf در حال استفاده، و ویژگی‌های اختیاری که هنگام کامپایل bpftool گنجانده شده‌اند. ویژگی‌های اختیاری شامل پیوند با LLVM یا libbfd برای ارائه دیزاسمبلر برای برنامه‌های JIT شده (\fBbpftool prog dump jited\fP) و استفاده از اسکلت‌های BPF (برخی ویژگی‌ها مانند \fBbpftool prog profile\fP یا نمایش pidهای مرتبط با شیءهای BPF ممکن است به آن متکی باشند) می‌شود.
.TP
.B  \-j\fP,\fB  \-\-json
تولید خروجی JSON. برای دستوراتی که نمی‌توانند JSON تولید کنند، این گزینه هیچ تأثیری ندارد.
.TP
.B  \-p\fP,\fB  \-\-pretty
تولید خروجی JSON خوانا برای انسان. مستلزم \fB\-j\fP است.
.TP
.B  \-d\fP,\fB  \-\-debug
چاپ تمام لاگ‌های موجود، حتی اطلاعات سطح اشکال‌زدایی (debug-level). این شامل لاگ‌های libbpf و همچنین وارسی‌کننده (verifier) هنگام تلاش برای بارگذاری برنامه‌ها می‌شود.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
\fB# bpftool iter pin bpf_iter_netlink.o /sys/fs/bpf/my_netlink\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ایجاد یک تکرارکننده bpf مبتنی بر فایل از bpf_iter_netlink.o و سنجاق کردن (pin) آن
به /sys/fs/bpf/my_netlink
.EE
.UNINDENT
.UNINDENT
.sp
\fB# bpftool iter pin bpf_iter_hashmap.o /sys/fs/bpf/my_hashmap map id 20\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ایجاد یک تکرارکننده bpf مبتنی بر فایل از bpf_iter_hashmap.o و نگاشت با
شناسه 20، و سنجاق کردن (pin) آن به /sys/fs/bpf/my_hashmap
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBbpf\fP(2),
\fBbpf\-helpers\fP(7),
\fBbpftool\fP(8),
\fBbpftool\-btf\fP(8),
\fBbpftool\-cgroup\fP(8),
\fBbpftool\-feature\fP(8),
\fBbpftool\-gen\fP(8),
\fBbpftool\-link\fP(8),
\fBbpftool\-map\fP(8),
\fBbpftool\-net\fP(8),
\fBbpftool\-perf\fP(8),
\fBbpftool\-prog\fP(8),
\fBbpftool\-struct_ops\fP(8),
\fBbpftool\-token\fP(8)
.\" End of generated man page.