[BRLTTY] brltty and libusb-compat
William Hubbs
w.d.hubbs at gmail.com
Sat May 16 23:14:16 EDT 2009
Hi Dave,
On Sat, May 16, 2009 at 11:02:44PM -0400, Dave Mielke wrote:
> Can you point me to documentation which gives the details for what will/may no
> longer work?
>
> Do you know if they provide a compile-time way (ifdef?) to determine which
> version of libusb is being used?
The README is very small, so I am attaching it below.
Let me know what you think.
Thanks,
William
-------------- next part --------------
libusb-compat-0.1
=================
A compatibility layer allowing applications written for libusb-0.1 to work
with libusb-1.0. libusb-compat-0.1 attempts to look, feel, smell and walk
like libusb-0.1.
Do not attempt to install libusb-0.1 and libusb-compat-0.1 on the same system.
Known quirks/differences from libusb-0.1:
1. usb_resetep(), a previously deprecated function, is implemented as
equivalent to calling usb_clear_halt().
2. libusb-0.1 allowed you to open a device which you did not have permission
to do anything useful with (all I/O requests would immediately fail).
libusb-compat-0.1 does not allow you to open such devices. You can still
read descriptor info without opening a device.
3. usb_device's "num_children" attribute is hardcoded to 0, and "children"
is hardcoded to NULL. Do you need this information in your software? Let
us know on the mailing list, and we'll add it.
4. Some libusb-0.1 users may have implemented I/O cancellation by running
transfers in their own threads and simply killing the thread when they
don't want to do the transfer any more. This is bad programming practice
for obvious reasons, and this lack of functionality was one of the primary
drivers for libusb-1.0 development. With libusb-1.0 or libusb-compat-0.1
backed by libusb-1.0, forcefully killing threads in this way is likely
to cause all libusb I/O to halt. Instead, port your application to use
libusb-1.0's asynchronous transfer API, which supports transfer
cancellation.
libusb homepage:
http://libusb.sourceforge.net
Use the mailing list for questions, comments, etc:
https://sourceforge.net/mailarchive/forum.php?forum_name=libusb-devel
- Daniel Drake <dsd at gentoo.org>
(use the mailing list rather than mailing developers directly)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: not available
Url : http://mielke.cc/pipermail/brltty/attachments/20090516/009dfe5c/attachment.bin
More information about the BRLTTY
mailing list