udev-hid-bpf

An automatic HID-BPF loader based on udev events. This repository aims to provide a simple way for users to write a HID-BPF program that fixes their device.

This project is written in Rust but knowledge of Rust should not be required, it is only used for scaffolding, users intending to write a HID-BPF program do not need to edit the Rust code and the resulting BPF programs have no Rust dependencies.

Contents:

• Getting started
  • Dependencies
  • Building all files
  • Install all files
  • Install a specific bpf.o file only
  • Running the BPF program
• Tutorial
  • Identifying the device
  • Scaffolding
  • Probing
  • Modifying the HID Reports
  • Modifying the HID Report Descriptor
  • Bringing it all together
• Filename conventions
  • Versioning files
  • Vendor and Product naming guidelines
• Quirks, user hacks, testing and stable
• Matching BPF programs to a device
  • Manual loading
  • Metadata in the HID-BPF sources (modalias matches)
  • Sharing the same BPF program for different devices
  • Run-time probe
• HID-BPF metadata
  • Overview
  • How this is interpreted?