Thread (22 messages) 22 messages, 2 authors, 11d ago
COOLING11d REVIEWED: 1 (1M)

[PATCH v4 01/11] Documentation: Correction in HID output_report callback description.

From: Jingyuan Liang <hidden>
Date: 2026-06-09 04:41:26
Also in: linux-devicetree, linux-doc, linux-spi, linux-trace-kernel, lkml
Subsystem: documentation, hid core layer, the rest · Maintainers: Jonathan Corbet, Jiri Kosina, Benjamin Tissoires, Linus Torvalds

From: Jarrett Schultz <redacted>

Originally output_report callback was described as must-be asynchronous,
but that is not the case in some implementations, namely i2c-hid.
Correct the documentation to say that it may be asynchronous.

Signed-off-by: Dmitry Antipov <redacted>
Reviewed-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Signed-off-by: Jingyuan Liang <redacted>
---
 Documentation/hid/hid-transport.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/hid/hid-transport.rst b/Documentation/hid/hid-transport.rst
index 6f1692da296c..2008cf432af1 100644
--- a/Documentation/hid/hid-transport.rst
+++ b/Documentation/hid/hid-transport.rst
@@ -327,8 +327,8 @@ The available HID callbacks are:
 
    Send raw output report via intr channel. Used by some HID device drivers
    which require high throughput for outgoing requests on the intr channel. This
-   must not cause SET_REPORT calls! This must be implemented as asynchronous
-   output report on the intr channel!
+   must not cause SET_REPORT calls! This call might be asynchronous, so the
+   caller should not expect an immediate response!
 
    ::
 
-- 
2.54.0.1064.gd145956f57-goog
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help