diff options
author | mav <mav@FreeBSD.org> | 2012-09-20 18:56:27 +0000 |
---|---|---|
committer | mav <mav@FreeBSD.org> | 2012-09-20 18:56:27 +0000 |
commit | 3a2b0e2811fa295dd198978ef2dcb53b37c2570d (patch) | |
tree | c4bb13c59030ccd9fce54c69846a554e23212d84 /lib/libusbhid/usbhid.3 | |
parent | 4e994ee0cd8c584f856f8ce211add093547f82b3 (diff) | |
download | FreeBSD-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.3 | 7 |
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 |