نام (NAME)

udev-hid-bpf - ابزار بارگذاری برای برنامه‌های HID eBPF

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

udev-hid-bpf [--help|--version] <command> [args]

توضیحات (DESCRIPTION)

udev-hid-bpf یک ابزار بارگذاری و برنامهٔ کمکی عمومی برای برنامه‌های HID eBPF است. به‌طور معمول این ابزار توسط udev برای بارگذاری و تخلیهٔ برنامه‌های HID eBPF سازگار با یک دستگاه مشخص فراخوانی می‌شود، اما همچنین دستوراتی را برای تسهیل توسعهٔ برنامه‌های جدید eBPF و نصب برنامه‌های خاص eBPF که به‌صورت پیش‌فرض نصب نشده‌اند، ارائه می‌دهد.

گزینه‌ها (OPTIONS)

--help: چاپ راهنما و خروج
--verbose: فعال‌سازی خروجی با جزئیات برای دستور مشخص‌شده
--version: چاپ نسخه و خروج

دستورات (COMMANDS)

add [--bpfdir /path/to/directory] device [/path/to/program.bpf.o]: بارگذاری برنامه‌های HID eBPF برای یک دستگاه. این دستور به‌طور معمول از طریق یک قاعدهٔ udev در کنش «add» فراخوانی می‌شود.

: اگر هیچ برنامهٔ eBPFای ارائه نشود، برنامه‌های منطبق eBPF از مشخصه‌های udev تنظیم‌شده روی آن دستگاه دریافت می‌شوند.
: اگر چندین دستگاه و/یا برنامهٔ eBPF مشخص شده باشند، دستگاه‌ها و برنامه‌های eBPF باید با یک نویسهٔ «-» ساده از یکدیگر جدا شوند. برای نمونه: udev-hid-bpf add dev1 dev2 - 1.bpf.o 2.bpf.o
: اگر برنامه‌های eBPF بدون مسیر کامل مشخص شوند، جست‌وجوی آن‌ها به ترتیب در دایرکتوری ارائه‌شده با گزینهٔ --bpfdir (در صورت وجود) و دایرکتوری‌های توکار /usr/lib/firmware/hid/bpf, /usr/local/lib/firmware/hid/bpf, /lib/firmware/hid/bpf انجام می‌گیرد.
: دستگاه باید به عنوان یک syspath مشخص شود.

--bpfdir: افزودن یک دایرکتوری به ابتدای فهرست دایرکتوری‌های جست‌وجو برای برنامه‌های eBPF.
--property KEY=VALUE: ارائهٔ یک جفت دلخواه NAME=VALUE به برنامهٔ BPF. این جفت NAME=VALUE به‌گونه‌ای پردازش می‌شود که گویی مشخصه‌ای تنظیم‌شده روی دستگاه است، و بر هر مشخصهٔ udev هم‌نام دیگر اولویت دارد. این گزینه می‌تواند چندین بار مشخص شود تا چندین مشخصه ارائه گردد. مشخصه‌های خالی باید به‌صورت رشتهٔ خالی باشند (NAME="").
--replace: ابتدا برنامه‌های BPF کنونی دستگاه را حذف می‌کند. این کار معادل آن است که نخست دستور udev-hid-bpf remove با همان آرگومان دستگاه اجرا شود.

remove device: حذف تمام برنامه‌های HID eBPF برای یک دستگاه مشخص. این دستور به‌طور معمول از طریق یک قاعدهٔ udev در کنش «remove» فراخوانی می‌شود.

: دستگاه باید به عنوان یک syspath مشخص شود.

list-bpf-programs [--bpfdir /path/to/directory]: فهرست کردن برنامه‌های HID eBPF موجود در دایرکتوری‌های جست‌وجوی پیش‌فرض (توکار) یا دایرکتوری مشخص‌شده.
list-devices: فهرست کردن دستگاه‌های HID موجود.
inspect path/to/program.bpf.o: بررسی و بازرسی برنامهٔ eBPF مشخص‌شده.
install [options] path/to/program.bpf.o: نصب برنامهٔ eBPF مشخص‌شده در /etc/udev-hid-bpf به همراه یک قاعدهٔ متناظر udev در /etc/udev/rules.d. این دستور باید برای آزمایش یک برنامهٔ تکی eBPF یا در مواردی که نصب کامل udev-hid-bpf مناسب نیست، استفاده شود.

: گزینه‌های زیر برای دستور --install در دسترس هستند:

--dry-run: انجام تمام مراحل به‌جز ساخت واقعی دایرکتوری‌ها و نصب فایل‌های هدف
--install-exe: نصب فایل اجرایی udev-hid-bpf در $prefix/bin. اگر فایل اجرایی از قبل در آن مسیر وجود داشته باشد، این گزینه کاری انجام نمی‌دهد.
--force: بازنویسی فایل‌های موجود با نام یکسان
--prefix /path/to/prefix: نصب در پیشوند مشخص‌شده. به‌صورت پیش‌فرض پیشوند توکار /usr استفاده می‌شود.

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

مستندات برخط udev-hid-bpf:

https://libevdev.pages.freedesktop.org/udev-hid-bpf