3 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
5 * Copyright (c) 2009 Sylvestre Gallon. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 #ifndef __LIBUSB10_H__
30 #define __LIBUSB10_H__
32 #ifndef LIBUSB_GLOBAL_INCLUDE_FILE
33 #include <sys/queue.h>
36 #define GET_CONTEXT(ctx) (((ctx) == NULL) ? usbi_default_context : (ctx))
37 #define UNEXPORTED __attribute__((__visibility__("hidden")))
38 #define CTX_LOCK(ctx) pthread_mutex_lock(&(ctx)->ctx_lock)
39 #define CTX_TRYLOCK(ctx) pthread_mutex_trylock(&(ctx)->ctx_lock)
40 #define CTX_UNLOCK(ctx) pthread_mutex_unlock(&(ctx)->ctx_lock)
41 #define HOTPLUG_LOCK(ctx) pthread_mutex_lock(&(ctx)->hotplug_lock)
42 #define HOTPLUG_UNLOCK(ctx) pthread_mutex_unlock(&(ctx)->hotplug_lock)
44 #define DPRINTF(ctx, dbg, format, ...) do { \
46 case LIBUSB_DEBUG_FUNCTION: \
47 if ((ctx)->debug & LIBUSB_DEBUG_FUNCTION) { \
48 printf("LIBUSB_FUNCTION: " \
49 format "\n", ## __VA_ARGS__); \
52 case LIBUSB_DEBUG_TRANSFER: \
53 if ((ctx)->debug & LIBUSB_DEBUG_TRANSFER) { \
54 printf("LIBUSB_TRANSFER: " \
55 format "\n", ## __VA_ARGS__); \
63 /* internal structures */
65 struct libusb_super_pollfd {
66 TAILQ_ENTRY(libusb_super_pollfd) entry;
67 struct libusb20_device *pdev;
68 struct libusb_pollfd pollfd;
71 struct libusb_super_transfer {
72 TAILQ_ENTRY(libusb_super_transfer) entry;
78 #define LIBUSB_SUPER_XFER_ST_NONE 0
79 #define LIBUSB_SUPER_XFER_ST_PEND 1
82 struct libusb_hotplug_callback_handle_struct {
83 TAILQ_ENTRY(libusb_hotplug_callback_handle_struct) entry;
88 libusb_hotplug_callback_fn fn;
92 TAILQ_HEAD(libusb_device_head, libusb_device);
94 struct libusb_context {
101 pthread_mutex_t ctx_lock;
102 pthread_mutex_t hotplug_lock;
103 pthread_cond_t ctx_cond;
104 pthread_t hotplug_handler;
105 pthread_t ctx_handler;
106 #define NO_THREAD ((pthread_t)-1)
108 TAILQ_HEAD(, libusb_super_pollfd) pollfds;
109 TAILQ_HEAD(, libusb_super_transfer) tr_done;
110 TAILQ_HEAD(, libusb_hotplug_callback_handle_struct) hotplug_cbh;
111 struct libusb_device_head hotplug_devs;
113 struct libusb_super_pollfd ctx_poll;
115 libusb_pollfd_added_cb fd_added_cb;
116 libusb_pollfd_removed_cb fd_removed_cb;
117 void *fd_cb_user_data;
120 struct libusb_device {
125 uint32_t claimed_interfaces;
127 struct libusb_super_pollfd dev_poll;
129 struct libusb_context *ctx;
131 TAILQ_ENTRY(libusb_device) hotplug_entry;
133 TAILQ_HEAD(, libusb_super_transfer) tr_head;
135 struct libusb20_device *os_priv;
138 extern struct libusb_context *usbi_default_context;
140 void libusb10_add_pollfd(libusb_context *ctx, struct libusb_super_pollfd *pollfd, struct libusb20_device *pdev, int fd, short events);
141 void libusb10_remove_pollfd(libusb_context *ctx, struct libusb_super_pollfd *pollfd);
142 void libusb10_cancel_all_transfer(libusb_device *dev);
143 void libusb10_cancel_all_transfer_locked(struct libusb20_device *pdev, struct libusb_device *dev);
145 #endif /* __LIBUSB10_H__ */