[xf86-input-libinput] man: note that we don't do /dev/input/by-id or /dev/input/by-path

Submitted by Peter Hutterer on March 19, 2018, 12:04 a.m.

Details

Message ID 20180319000438.GA9734@jelly
State New
Headers show
Series "man: note that we don't do /dev/input/by-id or /dev/input/by-path" ( rev: 1 ) in X.org

Not browsing as part of any series.

Commit Message

Peter Hutterer March 19, 2018, 12:04 a.m.
For logind-setups we need to match the path libinput wants to open with the
Option Device path that the device has so we know when to return the
server-fd. This doesn't work for by-id or by-path because libinput resolves
those (through udev) to the actual eventX node so our paths look different
when they are the same device.

This could be fixed but since this is easy enough to work around with a
InputClass section and rather a niche case, it's not really worth the effort.

https://bugs.freedesktop.org/show_bug.cgi?id=105562

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
---
 man/libinput.man | 6 ++++++
 1 file changed, 6 insertions(+)

Patch hide | download patch | download mbox

diff --git a/man/libinput.man b/man/libinput.man
index 2725390..ec0f439 100644
--- a/man/libinput.man
+++ b/man/libinput.man
@@ -381,6 +381,12 @@  it takes left-handed-ness into account.
 .TP
 This feature is provided by this driver, not by libinput.
 
+.SH BUGS
+This driver does not work with \fBOption \*qDevice\*q\fR set to an event
+node in \fI/dev/input/by-id\fR and \fI/dev/input/by-path\fR. This can be
+usually be worked by using \fBSection \*qInputClass\*q\fR with an
+appropriate \fBMatch*\fR statement in the __xconfigfile__(__filemansuffix__).
+
 .SH AUTHORS
 Peter Hutterer
 .SH "SEE ALSO"

Comments

On Mon, 2018-03-19 at 10:04 +1000, Peter Hutterer wrote:
> For logind-setups we need to match the path libinput wants to open with the
> Option Device path that the device has so we know when to return the
> server-fd. This doesn't work for by-id or by-path because libinput resolves
> those (through udev) to the actual eventX node so our paths look different
> when they are the same device.
> 
> This could be fixed but since this is easy enough to work around with a
> InputClass section and rather a niche case, it's not really worth the effort.
> 
> https://bugs.freedesktop.org/show_bug.cgi?id=105562
> 
> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Reviewed-by: Adam Jackson <ajax@redhat.com>

- ajax