.TH udev-hid-bpf "1" "" "udev-hid-bpf 2.3.0-20260703" "udev-hid-bpf Manual"
.SH "نام (NAME)"
udev\-hid\-bpf \- ابزار بارگذاری برای برنامه‌های HID eBPF
.SH "خلاصه دستور (SYNOPSIS)"
.B udev\-hid\-bpf [\-\-help|\-\-version] \fI<command>\fR \fI[args]\fR
.SH "توضیحات (DESCRIPTION)"
.PP
.B udev\-hid\-bpf
یک ابزار بارگذاری و برنامهٔ کمکی عمومی برای برنامه‌های HID eBPF است.
به‌طور معمول این ابزار توسط udev برای بارگذاری و تخلیهٔ برنامه‌های HID eBPF
سازگار با یک دستگاه مشخص فراخوانی می‌شود، اما همچنین دستوراتی را برای تسهیل توسعهٔ
برنامه‌های جدید eBPF و نصب برنامه‌های خاص eBPF که به‌صورت
پیش‌فرض نصب نشده‌اند، ارائه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-help
چاپ راهنما و خروج
.TP
.B \-\-verbose
فعال‌سازی خروجی با جزئیات برای دستور مشخص‌شده
.TP
.B \-\-version
چاپ نسخه و خروج
.SH "دستورات (COMMANDS)"
.TP
.B add [\-\-bpfdir \fI/path/to/directory\fB]\fR \fIdevice\fR [\fI/path/to/program.bpf.o\fR]
بارگذاری برنامه‌های HID eBPF برای یک دستگاه. این دستور به‌طور معمول
از طریق یک قاعدهٔ udev در کنش «add» فراخوانی می‌شود.
.IP
اگر هیچ برنامهٔ eBPFای ارائه نشود، برنامه‌های منطبق eBPF از
مشخصه‌های udev تنظیم‌شده روی آن دستگاه دریافت می‌شوند.
.IP
اگر چندین دستگاه و/یا برنامهٔ eBPF مشخص شده باشند، دستگاه‌ها و برنامه‌های eBPF
باید با یک نویسهٔ «-» ساده از یکدیگر جدا شوند. برای نمونه:
.B udev-hid-bpf add dev1 dev2 - 1.bpf.o 2.bpf.o
.IP
اگر برنامه‌های eBPF بدون مسیر کامل مشخص شوند، جست‌وجوی آن‌ها به ترتیب در
دایرکتوری ارائه‌شده با گزینهٔ \fB\-\-bpfdir\fR (در صورت وجود) و
دایرکتوری‌های توکار \fI/usr/lib/firmware/hid/bpf, /usr/local/lib/firmware/hid/bpf, /lib/firmware/hid/bpf\fR انجام می‌گیرد.
.IP
دستگاه باید به عنوان یک syspath مشخص شود.
.RS 8
.TP
.B --bpfdir
افزودن یک دایرکتوری به ابتدای فهرست دایرکتوری‌های جست‌وجو برای برنامه‌های eBPF.
.TP
.B --property KEY=VALUE
ارائهٔ یک جفت دلخواه NAME=VALUE به برنامهٔ BPF.
این جفت NAME=VALUE به‌گونه‌ای پردازش می‌شود که گویی مشخصه‌ای
تنظیم‌شده روی دستگاه است، و بر هر مشخصهٔ udev هم‌نام دیگر
اولویت دارد.
این گزینه می‌تواند چندین بار مشخص شود تا
چندین مشخصه ارائه گردد. مشخصه‌های خالی باید
به‌صورت رشتهٔ خالی باشند (NAME="").
.TP
.B --replace
ابتدا برنامه‌های BPF کنونی دستگاه را حذف می‌کند.
این کار معادل آن است که نخست دستور \fBudev\-hid\-bpf remove\fR با
همان آرگومان دستگاه اجرا شود.
.RE
.TP
.B remove \fIdevice\fR
حذف تمام برنامه‌های HID eBPF برای یک دستگاه مشخص. این دستور به‌طور معمول
از طریق یک قاعدهٔ udev در کنش «remove» فراخوانی می‌شود.
.IP
دستگاه باید به عنوان یک syspath مشخص شود.
.TP
.B list\-bpf\-programs [\-\-bpfdir \fI/path/to/directory\fR]
فهرست کردن برنامه‌های HID eBPF موجود در دایرکتوری‌های جست‌وجوی
پیش‌فرض (توکار) یا دایرکتوری مشخص‌شده.
.TP
.B list\-devices
فهرست کردن دستگاه‌های HID موجود.
.TP
.B inspect \fIpath/to/program.bpf.o\fR
بررسی و بازرسی برنامهٔ eBPF مشخص‌شده.
.TP
.B install [options] \fIpath/to/program.bpf.o\fR
نصب برنامهٔ eBPF مشخص‌شده در \fI/etc/udev-hid-bpf\fR به همراه
یک قاعدهٔ متناظر udev در \fI/etc/udev/rules.d\fR. این دستور
باید برای آزمایش یک برنامهٔ تکی eBPF یا در مواردی که
نصب کامل udev\-hid\-bpf مناسب نیست، استفاده شود.
.IP
گزینه‌های زیر برای دستور
.B \-\-install
در دسترس هستند:
.RS 8
.TP
.B \-\-dry-run
انجام تمام مراحل به‌جز ساخت واقعی دایرکتوری‌ها و نصب فایل‌های هدف
.TP
.B \-\-install-exe
نصب فایل اجرایی
.B udev\-hid\-bpf
در \fI$prefix/bin\fR. اگر فایل اجرایی از قبل در آن مسیر وجود داشته باشد،
این گزینه کاری انجام نمی‌دهد.
.TP
.B \-\-force
بازنویسی فایل‌های موجود با نام یکسان
.TP
.B \-\-prefix \fI/path/to/prefix\fR
نصب در پیشوند مشخص‌شده. به‌صورت پیش‌فرض پیشوند توکار \fI/usr\fR استفاده می‌شود.
.RE
.SH "همچنین ببینید (SEE ALSO)"
مستندات برخط udev\-hid\-bpf:
.LP
.I https://libevdev.pages.freedesktop.org/udev-hid-bpf