usb 2.17.0 → 3.0.0-alpha.2

package/libusb/PORTING

@@ -1,94 +0,0 @@
-PORTING LIBUSB TO OTHER PLATFORMS
-
-Introduction
-============
-
-This document is aimed at developers wishing to port libusb to unsupported
-platforms. I believe the libusb API is OS-independent, so by supporting
-multiple operating systems we pave the way for cross-platform USB device
-drivers.
-
-Implementation-wise, the basic idea is that you provide an interface to
-libusb's internal "backend" API, which performs the appropriate operations on
-your target platform.
-
-In terms of USB I/O, your backend provides functionality to submit
-asynchronous transfers (synchronous transfers are implemented in the higher
-layers, based on the async interface). Your backend must also provide
-functionality to cancel those transfers.
-
-Your backend must also provide an event handling function to "reap" ongoing
-transfers and process their results.
-
-The backend must also provide standard functions for other USB operations,
-e.g. setting configuration, obtaining descriptors, etc.
-
-
-File descriptors for I/O polling
-================================
-
-For libusb to work, your event handling function obviously needs to be called
-at various points in time. Your backend must provide a set of file descriptors
-which libusb and its users can pass to poll() or select() to determine when
-it is time to call the event handling function.
-
-On Linux, this is easy: the usbfs kernel interface exposes a file descriptor
-which can be passed to poll(). If something similar is not true for your
-platform, you can emulate this using an internal library thread to reap I/O as
-necessary, and a pipe() with the main library to raise events. The file
-descriptor of the pipe can then be provided to libusb as an event source.
-
-
-Interface semantics and documentation
-=====================================
-
-Documentation of the backend interface can be found in libusbi.h inside the
-usbi_os_backend structure definition.
-
-Your implementations of these functions will need to call various internal
-libusb functions, prefixed with "usbi_". Documentation for these functions
-can be found in the .c files where they are implemented.
-
-You probably want to skim over *all* the documentation before starting your
-implementation. For example, you probably need to allocate and store private
-OS-specific data for device handles, but the documentation for the mechanism
-for doing so is probably not the first thing you will see.
-
-The Linux backend acts as a good example - view it as a reference
-implementation which you should try to match the behaviour of.
-
-
-Getting started
-===============
-
-1. Modify configure.ac to detect your platform appropriately (see the OS_LINUX
-stuff for an example).
-
-2. Implement your backend in the libusb/os/ directory, modifying
-libusb/os/Makefile.am appropriately.
-
-3. Add preprocessor logic to the top of libusb/core.c to statically assign the
-right usbi_backend for your platform.
-
-4. Produce and test your implementation.
-
-5. Send your implementation to libusb-devel mailing list.
-
-
-Implementation difficulties? Questions?
-=======================================
-
-If you encounter difficulties porting libusb to your platform, please raise
-these issues on the libusb-devel mailing list. Where possible and sensible, I
-am interested in solving problems preventing libusb from operating on other
-platforms.
-
-The libusb-devel mailing list is also a good place to ask questions and
-make suggestions about the internal API. Hopefully we can produce some
-better documentation based on your questions and other input.
-
-You are encouraged to get involved in the process; if the library needs
-some infrastructure additions/modifications to better support your platform,
-you are encouraged to make such changes (in cleanly distinct patch
-submissions). Even if you do not make such changes yourself, please do raise
-the issues on the mailing list at the very minimum.

package/libusb/README

@@ -1,29 +0,0 @@
-# libusb
-
-libusb is a library for USB device access from Linux, macOS,
-Windows, OpenBSD/NetBSD, Haiku, Solaris userspace, and WebAssembly
-via WebUSB.
-It is written in C (Haiku backend in C++) and licensed under the GNU
-Lesser General Public License version 2.1 or, at your option, any later
-version (see [COPYING](COPYING)).
-
-libusb is abstracted internally in such a way that it can hopefully
-be ported to other operating systems. Please see the [PORTING](PORTING)
-file for more information.
-
-libusb homepage:
-https://libusb.info/
-
-Developers will wish to consult the API documentation:
-http://api.libusb.info
-
-Use the mailing list for questions, comments, etc:
-http://mailing-list.libusb.info
-
-- Hans de Goede <hdegoede@redhat.com>
-- Xiaofan Chen <xiaofanc@gmail.com>
-- Ludovic Rousseau <ludovic.rousseau@gmail.com>
-- Nathan Hjelm <hjelmn@cs.unm.edu>
-- Chris Dickens <christopher.a.dickens@gmail.com>
-
-(Please use the mailing list rather than mailing developers directly)

package/libusb/README.git

@@ -1,41 +0,0 @@
-Notes related to git compilation:
---------------------------------
-
-If you retrieved the libusb repository from git and are using a gcc based
-toolchain, be mindful that you should have the autotools installed (autoconf,
-automake) and will need to run either ./autogen.sh or ./bootstrap.sh to produce
-the configure file.
-
-The difference between autogen.sh and bootstrap.sh is that the former invokes
-configure with a default set of options, and will therefore generate a Makefile,
-whereas the latter does not invoke configure at all. If using autogen.sh, note
-that you can also append options, that will be passed as is to configure.
-
-macOS-specific notes:
--------------------
-
-Starting with Xcode 4.3, neither Xcode.app nor the Xcode 'command line tools'
-includes autotools and so running either autogen.sh or bootstrap.sh will result
-in the message:
-
-libtoolize or glibtoolize was not found! Please install libtool.
-
-To proceed, you must find and install it from somewhere.
-
-Alternatively, you can use the Xcode project at Xcode/libusb.xcodeproj.
-
-Notes related to submitting new developments:
---------------------------------------------
-
-If you submit a new development to libusb (eg: new backend), that is unlikely
-to fit in a couple of small patches, we would kindly suggest that you create a
-public account on github, if you don't have one already, and then fork a new
-libusb repository under this account from https://github.com/libusb/libusb.
-
-Then you can create a git branch for your work, that we will be able to better
-reference and test.
-
-We also suggest that, if you are planning to bring in a large development, you
-try to involve the libusb community early by letting the mailing list know, as
-you may find that other people might be eager to help you out.
-See http://mailing-list.libusb.info for details on how to join the mailing list.

package/libusb/TODO

@@ -1,2 +0,0 @@
-Please see the libusb roadmap by visiting:
-https://github.com/libusb/libusb/milestones?direction=asc&sort=due_date&state=open

package/libusb/Xcode/common.xcconfig

@@ -1,92 +0,0 @@
-//
-// libusb Xcode configuration file
-// Copyright © 2012 Pete Batard <pete@akeo.ie>
-// For more information, please visit: <https://libusb.info>
-//
-// This library is free software; you can redistribute it and/or
-// modify it under the terms of the GNU Lesser General Public
-// License as published by the Free Software Foundation; either
-// version 2.1 of the License, or (at your option) any later version.
-//
-// This library is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-// Lesser General Public License for more details.
-//
-// You should have received a copy of the GNU Lesser General Public
-// License along with this library; if not, write to the Free Software
-// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
-
-// Use GNU11 dialect.
-GCC_C_LANGUAGE_STANDARD = gnu11
-
-// Don't search user paths with <> style #includes.
-ALWAYS_SEARCH_USER_PATHS = NO
-
-// Enable weak references for Objective-C
-CLANG_ENABLE_OBJC_WEAK = YES
-
-// Allocate even uninitialized global variables in the data section of the object file, rather than generating them as common blocks. This has the effect that if the same variable is declared (without 'extern') in two different compilations, you will get an error when you link them.
-GCC_NO_COMMON_BLOCKS = YES
-
-// Keep private symbols private.  The first setting is -fvisibility=hidden, the second is -fvisibility-inlines-hidden.
-GCC_SYMBOLS_PRIVATE_EXTERN = YES
-GCC_INLINES_ARE_PRIVATE_EXTERN = YES
-
-// Compiler errors.
-GCC_TREAT_IMPLICIT_FUNCTION_DECLARATIONS_AS_ERRORS = YES
-
-// Compiler warnings.
-GCC_WARN_64_TO_32_BIT_CONVERSION = YES
-GCC_WARN_ABOUT_MISSING_FIELD_INITIALIZERS = YES
-GCC_WARN_ABOUT_MISSING_NEWLINE = YES
-GCC_WARN_ABOUT_MISSING_PROTOTYPES = YES
-GCC_WARN_ABOUT_RETURN_TYPE = YES
-GCC_WARN_FOUR_CHARACTER_CONSTANTS = YES
-GCC_WARN_INITIALIZER_NOT_FULLY_BRACKETED = YES
-GCC_WARN_SHADOW = YES
-GCC_WARN_UNINITIALIZED_AUTOS = YES
-GCC_WARN_UNKNOWN_PRAGMAS = YES
-GCC_WARN_UNUSED_FUNCTION = YES
-GCC_WARN_UNUSED_LABEL = YES
-GCC_WARN_UNUSED_PARAMETER = YES
-GCC_WARN_UNUSED_VARIABLE = YES
-CLANG_WARN_ASSIGN_ENUM = YES
-CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES
-CLANG_WARN_BOOL_CONVERSION = YES
-CLANG_WARN_COMMA = YES
-CLANG_WARN_CONSTANT_CONVERSION = YES
-CLANG_WARN_DOCUMENTATION_COMMENTS = YES
-CLANG_WARN_EMPTY_BODY = YES
-CLANG_WARN_ENUM_CONVERSION = YES
-CLANG_WARN_FLOAT_CONVERSION = YES
-CLANG_WARN_INFINITE_RECURSION = YES
-CLANG_WARN_INT_CONVERSION = YES
-CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES
-CLANG_WARN_STRICT_PROTOTYPES = YES
-CLANG_WARN_SUSPICIOUS_IMPLICIT_CONVERSION = YES
-CLANG_WARN_COMPLETION_HANDLER_MISUSE = YES
-CLANG_WARN_IMPLICIT_FALLTHROUGH = YES
-CLANG_WARN_FRAMEWORK_INCLUDE_PRIVATE_FROM_PUBLIC = YES
-CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES
-CLANG_WARN_SEMICOLON_BEFORE_METHOD_BODY = YES
-GCC_WARN_SIGN_COMPARE = YES
-CLANG_WARN__EXIT_TIME_DESTRUCTORS = YES
-GCC_WARN_NON_VIRTUAL_DESTRUCTOR = YES
-GCC_WARN_HIDDEN_VIRTUAL_FUNCTIONS = YES
-CLANG_WARN_ATOMIC_IMPLICIT_SEQ_CST = YES
-CLANG_WARN_OBJC_IMPLICIT_ATOMIC_PROPERTIES = YES
-CLANG_WARN_OBJC_INTERFACE_IVARS = YES
-GCC_WARN_STRICT_SELECTOR_MATCH = YES
-CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES
-CLANG_WARN_UNREACHABLE_CODE = YES
-CLANG_WARN_RANGE_LOOP_ANALYSIS = YES
-CLANG_WARN_SUSPICIOUS_MOVE = YES
-CLANG_WARN__DUPLICATE_METHOD_MATCH = YES
-CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES
-GCC_WARN_UNDECLARED_SELECTOR = YES
-
-// Static analyzer warnings.
-CLANG_ANALYZER_NONNULL = YES
-CLANG_ANALYZER_SECURITY_FLOATLOOPCOUNTER = YES
-CLANG_ANALYZER_SECURITY_INSECUREAPI_RAND = YES

package/libusb/Xcode/config.h

@@ -1,31 +0,0 @@
-/* config.h.  Manually generated for Xcode.  */
-
-#include <AvailabilityMacros.h>
-
-/* Define to the attribute for default visibility. */
-#define DEFAULT_VISIBILITY __attribute__ ((visibility ("default")))
-
-/* Define to 1 to enable message logging. */
-#define ENABLE_LOGGING 1
-
-/* On 10.6 and later, use newly available pthread_threadid_np() function */
-#if MAC_OS_X_VERSION_MIN_REQUIRED >= 1060
-/* Define to 1 if you have the 'pthread_threadid_np' function. */
-#define HAVE_PTHREAD_THREADID_NP 1
-#endif
-
-/* Define to 1 if the system has the type `nfds_t'. */
-#define HAVE_NFDS_T 1
-
-/* Define to 1 if you have the <sys/time.h> header file. */
-#define HAVE_SYS_TIME_H 1
-
-/* Define to 1 if compiling for a POSIX platform. */
-#define PLATFORM_POSIX 1
-
-/* Define to the attribute for enabling parameter checks on printf-like
-   functions. */
-#define PRINTF_FORMAT(a, b) __attribute__ ((__format__ (__printf__, a, b)))
-
-/* Enable GNU extensions. */
-#define _GNU_SOURCE 1

package/libusb/Xcode/debug.xcconfig

@@ -1,32 +0,0 @@
-//
-// libusb Xcode configuration file
-// Copyright © 2012 Pete Batard <pete@akeo.ie>
-// For more information, please visit: <https://libusb.info>
-//
-// This library is free software; you can redistribute it and/or
-// modify it under the terms of the GNU Lesser General Public
-// License as published by the Free Software Foundation; either
-// version 2.1 of the License, or (at your option) any later version.
-//
-// This library is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-// Lesser General Public License for more details.
-//
-// You should have received a copy of the GNU Lesser General Public
-// License along with this library; if not, write to the Free Software
-// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
-
-#include "common.xcconfig"
-
-// Embed debug symbols in binary itself.
-DEBUG_INFORMATION_FORMAT = dwarf
-
-// No optimizations in debug.
-GCC_OPTIMIZATION_LEVEL = 0
-
-// 
-GCC_PREPROCESSOR_DEFINITIONS = $(inherited) DEBUG=1
-
-// No need for Universal Binaries in debug.
-ONLY_ACTIVE_ARCH = YES

package/libusb/Xcode/libusb.xcconfig

@@ -1,21 +0,0 @@
-//
-// libusb Xcode configuration file
-// Copyright © 2012 Pete Batard <pete@akeo.ie>
-// For more information, please visit: <https://libusb.info>
-//
-// This library is free software; you can redistribute it and/or
-// modify it under the terms of the GNU Lesser General Public
-// License as published by the Free Software Foundation; either
-// version 2.1 of the License, or (at your option) any later version.
-//
-// This library is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-// Lesser General Public License for more details.
-//
-// You should have received a copy of the GNU Lesser General Public
-// License along with this library; if not, write to the Free Software
-// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
-
-PRODUCT_NAME = libusb-1.0.0
-LD_DYLIB_INSTALL_NAME = @rpath/libusb-1.0.0.dylib