.\" 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-link" "8" "" ""
.SH "نام (NAME)"
bpftool-link \- ابزار بازرسی و دستکاری پیوندهای bpf
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbpftool\fP [\fIOPTIONS\fP] \fBlink\fP \fICOMMAND\fP
.sp
\fIOPTIONS\fP := { { \fB\-j\fP | \fB\-\-json\fP } [{ \fB\-p\fP | \fB\-\-pretty\fP }] | { \fB\-d\fP | \fB\-\-debug\fP } | { \fB\-f\fP | \fB\-\-bpffs\fP } | { \fB\-n\fP | \fB\-\-nomount\fP } }
.sp
\fICOMMANDS\fP := { \fBshow\fP | \fBlist\fP | \fBpin\fP | \fBhelp\fP }
.SH "دستورات پیوند (LINK COMMANDS)"
.nf
\fBbpftool\fP \fBlink { show | list }\fP [\fILINK\fP]
\fBbpftool\fP \fBlink pin\fP \fILINK\fP \fIFILE\fP
\fBbpftool\fP \fBlink detach\fP \fILINK\fP
\fBbpftool\fP \fBlink help\fP

\fILINK\fP := { \fBid\fP \fILINK_ID\fP | \fBpinned\fP \fIFILE\fP }
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.INDENT 0.0
.TP
.B bpftool link { show | list } [\fILINK\fP]
نمایش اطلاعات درباره پیوندهای فعال. اگر
.I LINK
مشخص شده باشد، اطلاعات فقط برای پیوند داده‌شده نمایش می‌یابد، در غیر این صورت تمام پیوندهای فعال فعلی روی سیستم فهرست می‌شوند.
.sp
خروجی با شناسه پیوند (link ID) آغاز شده و به دنبال آن نوع پیوند و صفر یا چند صفت نام‌گذاری‌شده می‌آید که برخی از آن‌ها به نوع پیوند بستگی دارند.
.sp
از لینوکس 5.8 به بعد، ابزار bpftool قادر است اطلاعات مربوط به فرآیندهایی را که توصیف‌کننده‌های پرونده (FDs) باز روی پیوندهای BPF دارند شناسایی کند. روی این هسته‌ها، bpftool به طور خودکار این اطلاعات را نیز صادر می‌کند.
.TP
.B bpftool link pin \fILINK\fP \fIFILE\fP
سنجاق کردن پیوند
.I LINK
به عنوان
.IR FILE .
.sp
نکته:
.I FILE
باید در یک نقطه سوارشدن (mount) مربوط به
.I bpffs
قرار داشته باشد. نباید حاوی نویسه نقطه (\(aq.\(aq) باشد، که برای توسعه‌های آینده
.I bpffs
رزرو شده است.
.TP
.B bpftool link detach \fILINK\fP
جداسازی اجباری پیوند
.IR LINK .
پیوند BPF و برنامه BPF زیربنایی آن معتبر باقی خواهند ماند، اما از قلاب (hook) مربوط به BPF جدا خواهند شد و پیوند BPF به یک وضعیت ازکارافتاده (defunct) منتقل می‌شود تا زمانی که آخرین توصیف‌کننده پرونده باز برای آن پیوند بسته شود.
.TP
.B bpftool link help
چاپ پیام راهنمای کوتاه.
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
چاپ پیام راهنمای کوتاه (مشابه
.BR "bpftool help" ).
.TP
.B  \-V\fP,\fB  \-\-version
چاپ شماره نسخه bpftool (مشابه
.BR "bpftool version" )،
شماره نسخه libbpf در حال استفاده، و ویژگی‌های اختیاری که هنگام کامپایل bpftool گنجانده شده‌اند. ویژگی‌های اختیاری شامل پیوند با LLVM یا libbfd برای ارائه دیزاسمبلر برای برنامه‌های JIT شده
.RB ( "bpftool prog dump jited" )
و استفاده از اسکلت‌های BPF (برخی ویژگی‌ها مانند
.B bpftool prog profile
یا نمایش pidهای مرتبط با اشیاء BPF ممکن است به آن متکی باشند) می‌شود.
.TP
.B  \-j\fP,\fB  \-\-json
تولید خروجی JSON. برای دستوراتی که نمی‌توانند JSON تولید کنند، این گزینه هیچ تاثیری ندارد.
.TP
.B  \-p\fP,\fB  \-\-pretty
تولید خروجی JSON خوانا برای انسان. مستلزم
.B \-j
است.
.TP
.B  \-d\fP,\fB  \-\-debug
چاپ تمام گزارش‌های موجود، حتی اطلاعات در سطح دیباگ. این شامل گزارش‌های libbpf و همچنین گزارش‌های تاییدکننده (verifier) هنگام تلاش برای بارگذاری برنامه‌ها می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B  \-f\fP,\fB  \-\-bpffs
هنگام نمایش پیوندهای BPF، نام فایل‌های پیوندهای سنجاق‌شده (pinned) را نشان می‌دهد.
.TP
.B  \-n\fP,\fB  \-\-nomount
در صورت لزوم، به طور خودکار برای سوار کردن (mount) هیچ سیستم فایل مجازی (مانند tracefs یا سیستم فایل مجازی BPF) تلاش نمی‌کند.
.UNINDENT
.UNINDENT
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
\fB# bpftool link show\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
10: cgroup  prog 25
        cgroup_id 614  attach_type egress
        pids test_progs(223)
.EE
.UNINDENT
.UNINDENT
.sp
\fB# bpftool \-\-json \-\-pretty link show\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[{
        \(dqtype\(dq: \(dqcgroup\(dq,
        \(dqprog_id\(dq: 25,
        \(dqcgroup_id\(dq: 614,
        \(dqattach_type\(dq: \(dqegress\(dq,
        \(dqpids\(dq: [{
                \(dqpid\(dq: 223,
                \(dqcomm\(dq: \(dqtest_progs\(dq
            }
        ]
    }
]
.EE
.UNINDENT
.UNINDENT
.nf

\fB# bpftool link pin id 10 /sys/fs/bpf/link\fP
\fB# ls \-l /sys/fs/bpf/\fP
.fi
.sp
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\-rw\-\-\-\-\-\-\- 1 root root 0 Apr 23 21:39 link
.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\-iter\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.