summaryrefslogtreecommitdiffstats
path: root/lib/libusbhid/usbhid.3
diff options
context:
space:
mode:
authormav <mav@FreeBSD.org>2012-09-20 18:56:27 +0000
committermav <mav@FreeBSD.org>2012-09-20 18:56:27 +0000
commit3a2b0e2811fa295dd198978ef2dcb53b37c2570d (patch)
treec4bb13c59030ccd9fce54c69846a554e23212d84 /lib/libusbhid/usbhid.3
parent4e994ee0cd8c584f856f8ce211add093547f82b3 (diff)
downloadFreeBSD-src-3a2b0e2811fa295dd198978ef2dcb53b37c2570d.zip
FreeBSD-src-3a2b0e2811fa295dd198978ef2dcb53b37c2570d.tar.gz
Restore handling of the third argument (id) of hid_start_parse(), same as
it is done in NetBSD/OpenBSD, and as it was here before r205728. I personally think this API or its implementation is incorrect, as it is not correct to filter collections based on report ID, as they are orthogonal in general case, but I see no harm from supporting this feature. PR: usb/171810 Submitted by: Vitaly Magerya <vmagerya@gmail.com> MFC after: 1 month
Diffstat (limited to 'lib/libusbhid/usbhid.3')
-rw-r--r--lib/libusbhid/usbhid.37
1 files changed, 3 insertions, 4 deletions
diff --git a/lib/libusbhid/usbhid.3 b/lib/libusbhid/usbhid.3
index c34a109..98fcdf5 100644
--- a/lib/libusbhid/usbhid.3
+++ b/lib/libusbhid/usbhid.3
@@ -144,16 +144,15 @@ fails it will return
.Ss Descriptor Parsing Functions
To parse the report descriptor the
.Fn hid_start_parse
-function should be called with a report descriptor and a set that
-describes which items that are interesting.
+function should be called with a report descriptor, a set that
+describes which items that are interesting, and the desired report
+ID (or -1 to obtain items of all report IDs).
The set is obtained by OR-ing together values
.Fa "(1 << k)"
where
.Fa k
is an item of type
.Vt hid_kind_t .
-The report ID (if present) is given by
-.Fa id .
The function returns
.Dv NULL
if the initialization fails, otherwise an opaque value to be used
OpenPOWER on IntegriCloud