Save transfer flags before invoking callback

The callback may free the transfer, in which case we can't read the flags
after it has returned.

API documentation

Hopefully mostly complete. Some constants were renamed and move into
enums.

Fix get_device_list for realloc case

get_device_list can modify pointer passed to it with realloc, but this
case wasn't handled and caused crash on my machine. Fixed

Signed-off-by: Vasily Khoruzhick <anarsoul@gmail.com>

Beginnings of cross-platform abstraction

This also includes a libusb_get_pollfds API change

Add transfer flags

Simplify libusb_fill_control_transfer()

Transfer length can be inferred from the setup packet.

get_device fixup

Rename API away from "devh" and fix implementation to match header

Rename descriptor-getting functions

Based on feedback from Tim Roberts

Simplify cancellation API

No need to provide the device here.

Rename libusb_dev_handle to libusb_device_handle

Move synchronous I/O implementation to its own file

Separate transfer allocation and submission

Leads to some hefty API changes. Now we're much more similar to the
Linux kernel model.

Problems with dealing with asynchronous control transfers are passed
on to the user, basically you must allocate a buffer, start with the
setup, and put the data after. This won't make much sense until
documented (soon...)

Rework URB API naming

Now refer to everything as "transfers" as consistent with the USB spec
libusb_transfer is now a kind of transfer handle. To reduce confusion
with libusb_bulk_transfer and libusb_control_transfer, those have been
renamed to libusb_{control,bulk}_transfer_request.

Add fallback on /proc/bus/usb

/dev/bus/usb is a relatively new thing probably not present on every
system

Persistent libusb_device storage

Devices are now assigned a session ID (currently busnum:devaddr) which
is used to distinguish unique devices.

Now multiple callers of libusb_get_device_list will get the same
libusb_device structure instances.

Add convenience function to find and open a device by USB VID+PID

Lots of libusb apps I write are simple test apps not intended to be real
apps. Having a function available to quickly locate my device will be
handy in such situations.

Rework device discovery API

libusb_find_devices and libusb_get_devices are no more

libusb_get_device_list obtains a list of libusb_device structures for all
known devices in the system.

Each libusb_device now has a reference count, defaulting to 1 on
instantiation. The reference count of 1 refers to the fact that it is
present in the list in this scenario.

Opening a device adds a pointer to the libusb_device structure in the
handle, so that also adds a reference. Closing the device removes that
reference.

The function to free the device list can optionally unref all the devices
inside.

In future we will make the libusb_device instances all "global" so that if
the app calls get_device_list twice it actually gets the same libusb_device
structure references back. This way we can start to track disconnects, and
we can investigate adding a unique "session ID" to each libusb_device, an
identifier guaranteed to be unique to that device until reboot.

Remove ctrl debug code

This was unintentionally committed

Notifications for changes to the fd set

Applications can now be notified when they should start and stop polling
new file descriptors.

Fix header installation path

TODO update

Remove timers and signalfd

Instead of timers, add a mechanism for informing the parent app when the
next timeout is due to happen, so that it can call us at that time.

As we no longer use signals, signalfd has also been removed.

Poll usbfs descriptors directly

We don't need to use signalfd for this functionality because we can poll
the file descriptors for write events.

Fix dpfp example compilation

C++ header safety

Pointed out by JF

Only use -fgnu89-inline when supported

J F pointed out that this option only works on gcc 4.3 and newer.

Remove more fpusb remnants

TODO update

Start listing the things I want to discuss/reconsider before 1.0 API
is final.

Rename some _devh_ functions

Decided against naming functions in this style based on advice from
Tim Roberts. Still not really sure about devh naming in general.

Use "transfer" instead of "msg"

Based on a discussion with Tim Roberts.

Plural of bus is busses

SF #1633043

API renaming: remove fpi and usb_ stuff

fpi changed to usbi.

We should not expose structures with prefix "usb_" in the public
namespace as it is quite likely there will be some conflict somewhere.
Instead, using "libusb_" should be safer.

Rename to libusb-1.0

I've taken over the libusb project, and what was previously known as fpusb
will eventually be released as libusb-1.0.

Compiler flags update

Also fix some warnings

Fix signalfd structure size on x86

ptr is a 64-bit value

Don't pass ctrl_msg/bulk_msg structures through async paths

These are easiest to construct on the stack, but in the async case it is
likely that the submitting function returns (hence stack is destroyed)
before URB completion.

Add functionality to access device descriptors

Rename fpusb_device_handle functions to devh

Prevents confusion with functions that work on fpusb_dev structures.

Add API to access poll fd

Almost forgot... :)

Initial commit

Basic library structure which supports enumerating detected USB devices