Skip to contentSkip to conversation

Input: reserve 2 events code because of HID

PATCH In review Benjamin Tissoires 4 participants 4 messages Sep 7, 2018 – Oct 4, 2018

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Input: reserve 2 events code because of HID

From: Benjamin Tissoires <[email protected]>

Prior to commit 190d7f02ce8e ("HID: input: do not increment usages when a duplicate is found") from the v4.18 kernel, HID used to shift the event codes if a duplicate usage was found. This ended up in a situation where a device would export a ton of ABS_MISC+n event codes, or a ton of REL_MISC+n event codes.

This is now fixed, however userspace needs to detect those situation. Fortunately, ABS_MISC+1 was never assigned a code, and so libinput can detect fake multitouch devices from genuine ones by checking is ABS_MISC+1 is set.

Now that we have REL_WHEEL_HI_RES, libinput won't be able to differentiate true high res mice from some other device in a pre-v4.18 kernel.

Set in stone that the ABS_MISC+1 and REL_MISC+1 are reserved and should not be used so userspace can properly work around those old kernels.

---

Hi,

while reviewing my local tree, I realize that we might want to be able to differentiate older kernels from new ones that export REL_WHEEL_HI_RES.

I know Dmitry was against adding several REL_MISC, so I hope just moving REL_WHEEL_HI_RES by one and reserving the faulty event codes would be good this time.

This patch applies on top of the branch for-4.20/logitech-highres from Jiri's tree. It should go through Jiri's tree as well.

Cheers,
Benjamin

 include/uapi/linux/input-event-codes.h | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
include/uapi/linux/input-event-codes.h +12 -1
index 29fb891ea337..30149939249a 100644
@@ -708,7 +708,12 @@
 #define REL_DIAL		0x07
 #define REL_WHEEL		0x08
 #define REL_MISC		0x09
-#define REL_WHEEL_HI_RES	0x0a
+/*
+ * 0x0a is reserved and should not be used.
+ * It was used by HID as REL_MISC+1 and usersapce needs to detect if
+ * the next REL_* event is correct or is just REL_MISC + n.
+ */
+#define REL_WHEEL_HI_RES	0x0b
 #define REL_MAX			0x0f
 #define REL_CNT			(REL_MAX+1)
 
@@ -745,6 +750,12 @@
 
 #define ABS_MISC		0x28
 
+/*
+ * 0x29 is reserved and should not be used.
+ * It was used by HID as ABS_MISC+1 and usersapce needs to detect if
+ * the next ABS_* event is correct or is just ABS_MISC + n.
+ */
+
 #define ABS_MT_SLOT		0x2f	/* MT slot being modified */
 #define ABS_MT_TOUCH_MAJOR	0x30	/* Major axis of touching ellipse */
 #define ABS_MT_TOUCH_MINOR	0x31	/* Minor axis (omit if circular) */
Signature · 1 line
2.14.3
maintainer Acked-by on v1 1/1
#1 lore raw
Quoted 27 lines · Benjamin Tissoires

From: Benjamin Tissoires <[email protected]>

Prior to commit 190d7f02ce8e ("HID: input: do not increment usages when a duplicate is found") from the v4.18 kernel, HID used to shift the event codes if a duplicate usage was found. This ended up in a situation where a device would export a ton of ABS_MISC+n event codes, or a ton of REL_MISC+n event codes.

This is now fixed, however userspace needs to detect those situation. Fortunately, ABS_MISC+1 was never assigned a code, and so libinput can detect fake multitouch devices from genuine ones by checking is ABS_MISC+1 is set.

Now that we have REL_WHEEL_HI_RES, libinput won't be able to differentiate true high res mice from some other device in a pre-v4.18 kernel.

Set in stone that the ABS_MISC+1 and REL_MISC+1 are reserved and should not be used so userspace can properly work around those old kernels.

---

Hi,

while reviewing my local tree, I realize that we might want to be able to differentiate older kernels from new ones that export REL_WHEEL_HI_RES.

Quoted 6 lines

I know Dmitry was against adding several REL_MISC, so I hope just moving REL_WHEEL_HI_RES by one and reserving the faulty event codes would be good this time.

This patch applies on top of the branch for-4.20/logitech-highres from Jiri's tree. It should go through Jiri's tree as well.

Hm, this is a bit ugly, bit I guess we could spare an event code.

Quoted 41 lines

Cheers,
Benjamin

 include/uapi/linux/input-event-codes.h | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
include/uapi/linux/input-event-codes.h +12 -1
index 29fb891ea337..30149939249a 100644
@@ -708,7 +708,12 @@
 #define REL_DIAL		0x07
 #define REL_WHEEL		0x08
 #define REL_MISC		0x09
-#define REL_WHEEL_HI_RES	0x0a
+/*
+ * 0x0a is reserved and should not be used.
+ * It was used by HID as REL_MISC+1 and usersapce needs to detect if
+ * the next REL_* event is correct or is just REL_MISC + n.
+ */
+#define REL_WHEEL_HI_RES	0x0b
 #define REL_MAX			0x0f
 #define REL_CNT			(REL_MAX+1)
 
@@ -745,6 +750,12 @@
 
 #define ABS_MISC		0x28
 
+/*
+ * 0x29 is reserved and should not be used.
+ * It was used by HID as ABS_MISC+1 and usersapce needs to detect if
+ * the next ABS_* event is correct or is just ABS_MISC + n.
+ */
+
 #define ABS_MT_SLOT		0x2f	/* MT slot being modified */
 #define ABS_MT_TOUCH_MAJOR	0x30	/* Major axis of touching ellipse */
 #define ABS_MT_TOUCH_MINOR	0x31	/* Minor axis (omit if circular) */
Signature · 1 line
2.14.3
Signature · 1 line
Dmitry
#2 lore raw
In reply to Benjamin Tissoires
Quoted 8 lines · Benjamin Tissoires

From: Benjamin Tissoires <[email protected]>

Prior to commit 190d7f02ce8e ("HID: input: do not increment usages when a duplicate is found") from the v4.18 kernel, HID used to shift the event codes if a duplicate usage was found. This ended up in a situation where a device would export a ton of ABS_MISC+n event codes, or a ton of REL_MISC+n event codes.

Quoted 4 lines

This is now fixed, however userspace needs to detect those situation. Fortunately, ABS_MISC+1 was never assigned a code, and so libinput can detect fake multitouch devices from genuine ones by checking is ABS_MISC+1 is set.

sorry, this isn't quite correct. we use ABS_MT_SLOT - 1 (0x2e) for the detection of fake MT devices, i.e.
if (ABS_MT_SLOT and not ABS_MT_SLOT-1) then multitouch

That gives you up to ABS_MISC + 6 for legitimate usage. this is handled by libevdev, not libinput directly. libevdev adjusts the various bits on "is this device an MT device" based on whether ABS_MT_SLOT-1 is set.

I can change this to also check for (ABS_MISC and not ABS_MISC+1) but that obviously will depend on updated libraries then. Though I guess it won't really be an issue until we fill up the other codes up to including 0x2e with real values and expect userspace to handle those.

None of the bits I maintain have special code for REL_MISC+n so that bit works fine, IMO.

One request though: instead of just having the value reserved, can we make it REL_RESERVED and ABS_RESERVED please? Or ABS_CANARY :) Much easier than hardcoding the numeric value.

Cheers,
Peter

Quoted 61 lines

Now that we have REL_WHEEL_HI_RES, libinput won't be able to differentiate true high res mice from some other device in a pre-v4.18 kernel.

Set in stone that the ABS_MISC+1 and REL_MISC+1 are reserved and should not be used so userspace can properly work around those old kernels.

---

Hi,

while reviewing my local tree, I realize that we might want to be able to differentiate older kernels from new ones that export REL_WHEEL_HI_RES.

I know Dmitry was against adding several REL_MISC, so I hope just moving REL_WHEEL_HI_RES by one and reserving the faulty event codes would be good this time.

This patch applies on top of the branch for-4.20/logitech-highres from Jiri's tree. It should go through Jiri's tree as well.

Cheers,
Benjamin

 include/uapi/linux/input-event-codes.h | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
include/uapi/linux/input-event-codes.h +12 -1
index 29fb891ea337..30149939249a 100644
@@ -708,7 +708,12 @@
 #define REL_DIAL		0x07
 #define REL_WHEEL		0x08
 #define REL_MISC		0x09
-#define REL_WHEEL_HI_RES	0x0a
+/*
+ * 0x0a is reserved and should not be used.
+ * It was used by HID as REL_MISC+1 and usersapce needs to detect if
+ * the next REL_* event is correct or is just REL_MISC + n.
+ */
+#define REL_WHEEL_HI_RES	0x0b
 #define REL_MAX			0x0f
 #define REL_CNT			(REL_MAX+1)
 
@@ -745,6 +750,12 @@
 
 #define ABS_MISC		0x28
 
+/*
+ * 0x29 is reserved and should not be used.
+ * It was used by HID as ABS_MISC+1 and usersapce needs to detect if
+ * the next ABS_* event is correct or is just ABS_MISC + n.
+ */
+
 #define ABS_MT_SLOT		0x2f	/* MT slot being modified */
 #define ABS_MT_TOUCH_MAJOR	0x30	/* Major axis of touching ellipse */
 #define ABS_MT_TOUCH_MINOR	0x31	/* Minor axis (omit if circular) */
Signature · 1 line
2.14.3
#3 lore raw

Oops, looks like this one fell through the cracks.

Quoted 10 lines · Peter Hutterer
Quoted 8 lines · Benjamin Tissoires

From: Benjamin Tissoires <[email protected]>

Prior to commit 190d7f02ce8e ("HID: input: do not increment usages when a duplicate is found") from the v4.18 kernel, HID used to shift the event codes if a duplicate usage was found. This ended up in a situation where a device would export a ton of ABS_MISC+n event codes, or a ton of REL_MISC+n event codes.

Quoted 8 lines
Quoted 4 lines

This is now fixed, however userspace needs to detect those situation. Fortunately, ABS_MISC+1 was never assigned a code, and so libinput can detect fake multitouch devices from genuine ones by checking is ABS_MISC+1 is set.

sorry, this isn't quite correct. we use ABS_MT_SLOT - 1 (0x2e) for the detection of fake MT devices, i.e.
if (ABS_MT_SLOT and not ABS_MT_SLOT-1) then multitouch

Will send a v2 ASAP.

Quoted 9 lines

That gives you up to ABS_MISC + 6 for legitimate usage. this is handled by libevdev, not libinput directly. libevdev adjusts the various bits on "is this device an MT device" based on whether ABS_MT_SLOT-1 is set.

I can change this to also check for (ABS_MISC and not ABS_MISC+1) but that obviously will depend on updated libraries then. Though I guess it won't really be an issue until we fill up the other codes up to including 0x2e with real values and expect userspace to handle those.

Nah, better changing the value here.

Quoted 7 lines

None of the bits I maintain have special code for REL_MISC+n so that bit works fine, IMO.

One request though: instead of just having the value reserved, can we make it REL_RESERVED and ABS_RESERVED please? Or ABS_CANARY :) Much easier than hardcoding the numeric value.

My first thoughts were that ABS_CANARY has the inconvenient of being too tempting to be used as a real value.
OTOH, REL_RESERVED and ABS_RESERVED should be fine.

I'll send out a v2 with those changes.

Cheers,
Benjamin

Quoted 66 lines

Cheers,
Peter

Quoted 61 lines

Now that we have REL_WHEEL_HI_RES, libinput won't be able to differentiate true high res mice from some other device in a pre-v4.18 kernel.

Set in stone that the ABS_MISC+1 and REL_MISC+1 are reserved and should not be used so userspace can properly work around those old kernels.

---

Hi,

while reviewing my local tree, I realize that we might want to be able to differentiate older kernels from new ones that export REL_WHEEL_HI_RES.

I know Dmitry was against adding several REL_MISC, so I hope just moving REL_WHEEL_HI_RES by one and reserving the faulty event codes would be good this time.

This patch applies on top of the branch for-4.20/logitech-highres from Jiri's tree. It should go through Jiri's tree as well.

Cheers,
Benjamin

 include/uapi/linux/input-event-codes.h | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
include/uapi/linux/input-event-codes.h +12 -2
index 29fb891ea337..30149939249a 100644
@@ -708,7 +708,12 @@
 #define REL_DIAL             0x07
 #define REL_WHEEL            0x08
 #define REL_MISC             0x09
-#define REL_WHEEL_HI_RES     0x0a
+/*
+ * 0x0a is reserved and should not be used.
+ * It was used by HID as REL_MISC+1 and usersapce needs to detect if
+ * the next REL_* event is correct or is just REL_MISC + n.
+ */
+#define REL_WHEEL_HI_RES     0x0b
 #define REL_MAX                      0x0f
 #define REL_CNT                      (REL_MAX+1)
 
@@ -745,6 +750,12 @@
 
 #define ABS_MISC             0x28
 
+/*
+ * 0x29 is reserved and should not be used.
+ * It was used by HID as ABS_MISC+1 and usersapce needs to detect if
+ * the next ABS_* event is correct or is just ABS_MISC + n.
+ */
+
 #define ABS_MT_SLOT          0x2f    /* MT slot being modified */
 #define ABS_MT_TOUCH_MAJOR   0x30    /* Major axis of touching ellipse */
 #define ABS_MT_TOUCH_MINOR   0x31    /* Minor axis (omit if circular) */
--

2.14.3