Skip to content

Commit d127651

Browse files
docs(linux): document UHID permission matching
Document the backend-owned physical path that remains stable when libvirtualhid is linked directly into a host, and recommend it for native-named hidraw and input event nodes.
1 parent 10ce294 commit d127651

1 file changed

Lines changed: 13 additions & 3 deletions

File tree

docs/platform-support.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -184,9 +184,19 @@ KERNEL=="uinput", SUBSYSTEM=="misc", OPTIONS+="static_node=uinput", GROUP="input
184184
KERNEL=="uhid", GROUP="input", MODE="0660", TAG+="uaccess"
185185
```
186186

187-
Consuming applications may also install name-matched rules for stable virtual
188-
device names when generated `hidraw` or `input` nodes must be accessible to the
189-
session user:
187+
UHID gamepads use a stable `libvirtualhid/uhid/*` physical path even when the
188+
library is compiled directly into a consuming application. Match that path for
189+
generated `hidraw` and input event nodes because native profiles such as
190+
DualShock 4 and DualSense intentionally do not retain the application's product
191+
name:
192+
193+
```udev
194+
KERNEL=="hidraw*", ATTRS{phys}=="libvirtualhid/uhid/*", GROUP="input", MODE="0660", TAG+="uaccess"
195+
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{phys}=="libvirtualhid/uhid/*", GROUP="input", MODE="0660", TAG+="uaccess"
196+
```
197+
198+
Consuming applications may additionally install name-matched rules for stable
199+
virtual device names, including uinput-backed gamepads:
190200

191201
```udev
192202
KERNEL=="hidraw*", ATTRS{name}=="Your App Controller*", GROUP="input", MODE="0660", TAG+="uaccess"

0 commit comments

Comments
 (0)