xref: /freebsd/lib/libusb/libusb10.c (revision b740c88bfb6453416926271c089262e7164dace3)
1 /* $FreeBSD$ */
2 /*-
3  * Copyright (c) 2009 Sylvestre Gallon. All rights reserved.
4  * Copyright (c) 2009 Hans Petter Selasky. All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 
28 #ifdef LIBUSB_GLOBAL_INCLUDE_FILE
29 #include LIBUSB_GLOBAL_INCLUDE_FILE
30 #else
31 #include <assert.h>
32 #include <errno.h>
33 #include <poll.h>
34 #include <pthread.h>
35 #include <stdio.h>
36 #include <stdlib.h>
37 #include <string.h>
38 #include <unistd.h>
39 #include <time.h>
40 #include <sys/fcntl.h>
41 #include <sys/ioctl.h>
42 #include <sys/queue.h>
43 #include <sys/endian.h>
44 #endif
45 
46 #define	libusb_device_handle libusb20_device
47 
48 #include "libusb20.h"
49 #include "libusb20_desc.h"
50 #include "libusb20_int.h"
51 #include "libusb.h"
52 #include "libusb10.h"
53 
54 static pthread_mutex_t default_context_lock = PTHREAD_MUTEX_INITIALIZER;
55 struct libusb_context *usbi_default_context = NULL;
56 
57 /* Prototypes */
58 
59 static struct libusb20_transfer *libusb10_get_transfer(struct libusb20_device *, uint8_t, uint8_t);
60 static int libusb10_get_buffsize(struct libusb20_device *, libusb_transfer *);
61 static int libusb10_convert_error(uint8_t status);
62 static void libusb10_complete_transfer(struct libusb20_transfer *, struct libusb_super_transfer *, int);
63 static void libusb10_isoc_proxy(struct libusb20_transfer *);
64 static void libusb10_bulk_intr_proxy(struct libusb20_transfer *);
65 static void libusb10_ctrl_proxy(struct libusb20_transfer *);
66 static void libusb10_submit_transfer_sub(struct libusb20_device *, uint8_t);
67 
68 /*  Library initialisation / deinitialisation */
69 
70 void
71 libusb_set_debug(libusb_context *ctx, int level)
72 {
73 	ctx = GET_CONTEXT(ctx);
74 	if (ctx)
75 		ctx->debug = level;
76 }
77 
78 static void
79 libusb_set_nonblocking(int f)
80 {
81 	int flags;
82 
83 	/*
84 	 * We ignore any failures in this function, hence the
85 	 * non-blocking flag is not critical to the operation of
86 	 * libUSB. We use F_GETFL and F_SETFL to be compatible with
87 	 * Linux.
88 	 */
89 
90 	flags = fcntl(f, F_GETFL, NULL);
91 	if (flags == -1)
92 		return;
93 	flags |= O_NONBLOCK;
94 	fcntl(f, F_SETFL, flags);
95 }
96 
97 int
98 libusb_init(libusb_context **context)
99 {
100 	struct libusb_context *ctx;
101 	pthread_condattr_t attr;
102 	char *debug;
103 	int ret;
104 
105 	ctx = malloc(sizeof(*ctx));
106 	if (!ctx)
107 		return (LIBUSB_ERROR_INVALID_PARAM);
108 
109 	memset(ctx, 0, sizeof(*ctx));
110 
111 	debug = getenv("LIBUSB_DEBUG");
112 	if (debug != NULL) {
113 		ctx->debug = atoi(debug);
114 		if (ctx->debug != 0)
115 			ctx->debug_fixed = 1;
116 	}
117 	TAILQ_INIT(&ctx->pollfds);
118 	TAILQ_INIT(&ctx->tr_done);
119 
120 	if (pthread_mutex_init(&ctx->ctx_lock, NULL) != 0) {
121 		free(ctx);
122 		return (LIBUSB_ERROR_NO_MEM);
123 	}
124 	if (pthread_condattr_init(&attr) != 0) {
125 		pthread_mutex_destroy(&ctx->ctx_lock);
126 		free(ctx);
127 		return (LIBUSB_ERROR_NO_MEM);
128 	}
129 	if (pthread_condattr_setclock(&attr, CLOCK_MONOTONIC) != 0) {
130 		pthread_mutex_destroy(&ctx->ctx_lock);
131 		pthread_condattr_destroy(&attr);
132 		free(ctx);
133 		return (LIBUSB_ERROR_OTHER);
134 	}
135 	if (pthread_cond_init(&ctx->ctx_cond, &attr) != 0) {
136 		pthread_mutex_destroy(&ctx->ctx_lock);
137 		pthread_condattr_destroy(&attr);
138 		free(ctx);
139 		return (LIBUSB_ERROR_NO_MEM);
140 	}
141 	pthread_condattr_destroy(&attr);
142 
143 	ctx->ctx_handler = NO_THREAD;
144 
145 	ret = pipe(ctx->ctrl_pipe);
146 	if (ret < 0) {
147 		pthread_mutex_destroy(&ctx->ctx_lock);
148 		pthread_cond_destroy(&ctx->ctx_cond);
149 		free(ctx);
150 		return (LIBUSB_ERROR_OTHER);
151 	}
152 	/* set non-blocking mode on the control pipe to avoid deadlock */
153 	libusb_set_nonblocking(ctx->ctrl_pipe[0]);
154 	libusb_set_nonblocking(ctx->ctrl_pipe[1]);
155 
156 	libusb10_add_pollfd(ctx, &ctx->ctx_poll, NULL, ctx->ctrl_pipe[0], POLLIN);
157 
158 	pthread_mutex_lock(&default_context_lock);
159 	if (usbi_default_context == NULL) {
160 		usbi_default_context = ctx;
161 	}
162 	pthread_mutex_unlock(&default_context_lock);
163 
164 	if (context)
165 		*context = ctx;
166 
167 	DPRINTF(ctx, LIBUSB_DEBUG_FUNCTION, "libusb_init complete");
168 
169 	return (0);
170 }
171 
172 void
173 libusb_exit(libusb_context *ctx)
174 {
175 	ctx = GET_CONTEXT(ctx);
176 
177 	if (ctx == NULL)
178 		return;
179 
180 	/* XXX cleanup devices */
181 
182 	libusb10_remove_pollfd(ctx, &ctx->ctx_poll);
183 	close(ctx->ctrl_pipe[0]);
184 	close(ctx->ctrl_pipe[1]);
185 	pthread_mutex_destroy(&ctx->ctx_lock);
186 	pthread_cond_destroy(&ctx->ctx_cond);
187 
188 	pthread_mutex_lock(&default_context_lock);
189 	if (ctx == usbi_default_context) {
190 		usbi_default_context = NULL;
191 	}
192 	pthread_mutex_unlock(&default_context_lock);
193 
194 	free(ctx);
195 }
196 
197 /* Device handling and initialisation. */
198 
199 ssize_t
200 libusb_get_device_list(libusb_context *ctx, libusb_device ***list)
201 {
202 	struct libusb20_backend *usb_backend;
203 	struct libusb20_device *pdev;
204 	struct libusb_device *dev;
205 	int i;
206 
207 	ctx = GET_CONTEXT(ctx);
208 
209 	if (ctx == NULL)
210 		return (LIBUSB_ERROR_INVALID_PARAM);
211 
212 	if (list == NULL)
213 		return (LIBUSB_ERROR_INVALID_PARAM);
214 
215 	usb_backend = libusb20_be_alloc_default();
216 	if (usb_backend == NULL)
217 		return (LIBUSB_ERROR_NO_MEM);
218 
219 	/* figure out how many USB devices are present */
220 	pdev = NULL;
221 	i = 0;
222 	while ((pdev = libusb20_be_device_foreach(usb_backend, pdev)))
223 		i++;
224 
225 	/* allocate device pointer list */
226 	*list = malloc((i + 1) * sizeof(void *));
227 	if (*list == NULL) {
228 		libusb20_be_free(usb_backend);
229 		return (LIBUSB_ERROR_NO_MEM);
230 	}
231 	/* create libusb v1.0 compliant devices */
232 	i = 0;
233 	while ((pdev = libusb20_be_device_foreach(usb_backend, NULL))) {
234 
235 		dev = malloc(sizeof(*dev));
236 		if (dev == NULL) {
237 			while (i != 0) {
238 				libusb_unref_device((*list)[i - 1]);
239 				i--;
240 			}
241 			free(*list);
242 			*list = NULL;
243 			libusb20_be_free(usb_backend);
244 			return (LIBUSB_ERROR_NO_MEM);
245 		}
246 		/* get device into libUSB v1.0 list */
247 		libusb20_be_dequeue_device(usb_backend, pdev);
248 
249 		memset(dev, 0, sizeof(*dev));
250 
251 		/* init transfer queues */
252 		TAILQ_INIT(&dev->tr_head);
253 
254 		/* set context we belong to */
255 		dev->ctx = ctx;
256 
257 		/* link together the two structures */
258 		dev->os_priv = pdev;
259 		pdev->privLuData = dev;
260 
261 		(*list)[i] = libusb_ref_device(dev);
262 		i++;
263 	}
264 	(*list)[i] = NULL;
265 
266 	libusb20_be_free(usb_backend);
267 	return (i);
268 }
269 
270 void
271 libusb_free_device_list(libusb_device **list, int unref_devices)
272 {
273 	int i;
274 
275 	if (list == NULL)
276 		return;			/* be NULL safe */
277 
278 	if (unref_devices) {
279 		for (i = 0; list[i] != NULL; i++)
280 			libusb_unref_device(list[i]);
281 	}
282 	free(list);
283 }
284 
285 uint8_t
286 libusb_get_bus_number(libusb_device *dev)
287 {
288 	if (dev == NULL)
289 		return (0);		/* should not happen */
290 	return (libusb20_dev_get_bus_number(dev->os_priv));
291 }
292 
293 int
294 libusb_get_port_numbers(libusb_device *dev, uint8_t *buf, uint8_t bufsize)
295 {
296 	return (libusb20_dev_get_port_path(dev->os_priv, buf, bufsize));
297 }
298 
299 int
300 libusb_get_port_path(libusb_context *ctx, libusb_device *dev, uint8_t *buf,
301     uint8_t bufsize)
302 {
303 	return (libusb20_dev_get_port_path(dev->os_priv, buf, bufsize));
304 }
305 
306 uint8_t
307 libusb_get_device_address(libusb_device *dev)
308 {
309 	if (dev == NULL)
310 		return (0);		/* should not happen */
311 	return (libusb20_dev_get_address(dev->os_priv));
312 }
313 
314 enum libusb_speed
315 libusb_get_device_speed(libusb_device *dev)
316 {
317 	if (dev == NULL)
318 		return (LIBUSB_SPEED_UNKNOWN);	/* should not happen */
319 
320 	switch (libusb20_dev_get_speed(dev->os_priv)) {
321 	case LIBUSB20_SPEED_LOW:
322 		return (LIBUSB_SPEED_LOW);
323 	case LIBUSB20_SPEED_FULL:
324 		return (LIBUSB_SPEED_FULL);
325 	case LIBUSB20_SPEED_HIGH:
326 		return (LIBUSB_SPEED_HIGH);
327 	case LIBUSB20_SPEED_SUPER:
328 		return (LIBUSB_SPEED_SUPER);
329 	default:
330 		break;
331 	}
332 	return (LIBUSB_SPEED_UNKNOWN);
333 }
334 
335 int
336 libusb_get_max_packet_size(libusb_device *dev, uint8_t endpoint)
337 {
338 	struct libusb_config_descriptor *pdconf;
339 	struct libusb_interface *pinf;
340 	struct libusb_interface_descriptor *pdinf;
341 	struct libusb_endpoint_descriptor *pdend;
342 	int i;
343 	int j;
344 	int k;
345 	int ret;
346 
347 	if (dev == NULL)
348 		return (LIBUSB_ERROR_NO_DEVICE);
349 
350 	ret = libusb_get_active_config_descriptor(dev, &pdconf);
351 	if (ret < 0)
352 		return (ret);
353 
354 	ret = LIBUSB_ERROR_NOT_FOUND;
355 	for (i = 0; i < pdconf->bNumInterfaces; i++) {
356 		pinf = &pdconf->interface[i];
357 		for (j = 0; j < pinf->num_altsetting; j++) {
358 			pdinf = &pinf->altsetting[j];
359 			for (k = 0; k < pdinf->bNumEndpoints; k++) {
360 				pdend = &pdinf->endpoint[k];
361 				if (pdend->bEndpointAddress == endpoint) {
362 					ret = pdend->wMaxPacketSize;
363 					goto out;
364 				}
365 			}
366 		}
367 	}
368 
369 out:
370 	libusb_free_config_descriptor(pdconf);
371 	return (ret);
372 }
373 
374 int
375 libusb_get_max_iso_packet_size(libusb_device *dev, uint8_t endpoint)
376 {
377 	int multiplier;
378 	int ret;
379 
380 	ret = libusb_get_max_packet_size(dev, endpoint);
381 
382 	switch (libusb20_dev_get_speed(dev->os_priv)) {
383 	case LIBUSB20_SPEED_LOW:
384 	case LIBUSB20_SPEED_FULL:
385 		break;
386 	default:
387 		if (ret > -1) {
388 			multiplier = (1 + ((ret >> 11) & 3));
389 			if (multiplier > 3)
390 				multiplier = 3;
391 			ret = (ret & 0x7FF) * multiplier;
392 		}
393 		break;
394 	}
395 	return (ret);
396 }
397 
398 libusb_device *
399 libusb_ref_device(libusb_device *dev)
400 {
401 	if (dev == NULL)
402 		return (NULL);		/* be NULL safe */
403 
404 	CTX_LOCK(dev->ctx);
405 	dev->refcnt++;
406 	CTX_UNLOCK(dev->ctx);
407 
408 	return (dev);
409 }
410 
411 void
412 libusb_unref_device(libusb_device *dev)
413 {
414 	if (dev == NULL)
415 		return;			/* be NULL safe */
416 
417 	CTX_LOCK(dev->ctx);
418 	dev->refcnt--;
419 	CTX_UNLOCK(dev->ctx);
420 
421 	if (dev->refcnt == 0) {
422 		libusb20_dev_free(dev->os_priv);
423 		free(dev);
424 	}
425 }
426 
427 int
428 libusb_open(libusb_device *dev, libusb_device_handle **devh)
429 {
430 	libusb_context *ctx = dev->ctx;
431 	struct libusb20_device *pdev = dev->os_priv;
432 	uint8_t dummy;
433 	int err;
434 
435 	if (devh == NULL)
436 		return (LIBUSB_ERROR_INVALID_PARAM);
437 
438 	/* set default device handle value */
439 	*devh = NULL;
440 
441 	dev = libusb_ref_device(dev);
442 	if (dev == NULL)
443 		return (LIBUSB_ERROR_INVALID_PARAM);
444 
445 	err = libusb20_dev_open(pdev, 16 * 4 /* number of endpoints */ );
446 	if (err) {
447 		libusb_unref_device(dev);
448 		return (LIBUSB_ERROR_NO_MEM);
449 	}
450 	libusb10_add_pollfd(ctx, &dev->dev_poll, pdev, libusb20_dev_get_fd(pdev), POLLIN |
451 	    POLLOUT | POLLRDNORM | POLLWRNORM);
452 
453 	/* make sure our event loop detects the new device */
454 	dummy = 0;
455 	err = write(ctx->ctrl_pipe[1], &dummy, sizeof(dummy));
456 	if (err < (int)sizeof(dummy)) {
457 		/* ignore error, if any */
458 		DPRINTF(ctx, LIBUSB_DEBUG_FUNCTION, "libusb_open write failed!");
459 	}
460 	*devh = pdev;
461 
462 	return (0);
463 }
464 
465 libusb_device_handle *
466 libusb_open_device_with_vid_pid(libusb_context *ctx, uint16_t vendor_id,
467     uint16_t product_id)
468 {
469 	struct libusb_device **devs;
470 	struct libusb20_device *pdev;
471 	struct LIBUSB20_DEVICE_DESC_DECODED *pdesc;
472 	int i;
473 	int j;
474 
475 	ctx = GET_CONTEXT(ctx);
476 	if (ctx == NULL)
477 		return (NULL);		/* be NULL safe */
478 
479 	DPRINTF(ctx, LIBUSB_DEBUG_FUNCTION, "libusb_open_device_width_vid_pid enter");
480 
481 	if ((i = libusb_get_device_list(ctx, &devs)) < 0)
482 		return (NULL);
483 
484 	pdev = NULL;
485 	for (j = 0; j < i; j++) {
486 		struct libusb20_device *tdev;
487 
488 		tdev = devs[j]->os_priv;
489 		pdesc = libusb20_dev_get_device_desc(tdev);
490 		/*
491 		 * NOTE: The USB library will automatically swap the
492 		 * fields in the device descriptor to be of host
493 		 * endian type!
494 		 */
495 		if (pdesc->idVendor == vendor_id &&
496 		    pdesc->idProduct == product_id) {
497 			libusb_open(devs[j], &pdev);
498 			break;
499 		}
500 	}
501 
502 	libusb_free_device_list(devs, 1);
503 	DPRINTF(ctx, LIBUSB_DEBUG_FUNCTION, "libusb_open_device_width_vid_pid leave");
504 	return (pdev);
505 }
506 
507 void
508 libusb_close(struct libusb20_device *pdev)
509 {
510 	libusb_context *ctx;
511 	struct libusb_device *dev;
512 	uint8_t dummy;
513 	int err;
514 
515 	if (pdev == NULL)
516 		return;			/* be NULL safe */
517 
518 	dev = libusb_get_device(pdev);
519 	ctx = dev->ctx;
520 
521 	libusb10_remove_pollfd(ctx, &dev->dev_poll);
522 
523 	libusb20_dev_close(pdev);
524 
525 	/* unref will free the "pdev" when the refcount reaches zero */
526 	libusb_unref_device(dev);
527 
528 	/* make sure our event loop detects the closed device */
529 	dummy = 0;
530 	err = write(ctx->ctrl_pipe[1], &dummy, sizeof(dummy));
531 	if (err < (int)sizeof(dummy)) {
532 		/* ignore error, if any */
533 		DPRINTF(ctx, LIBUSB_DEBUG_FUNCTION, "libusb_close write failed!");
534 	}
535 }
536 
537 libusb_device *
538 libusb_get_device(struct libusb20_device *pdev)
539 {
540 	if (pdev == NULL)
541 		return (NULL);
542 	return ((libusb_device *)pdev->privLuData);
543 }
544 
545 int
546 libusb_get_configuration(struct libusb20_device *pdev, int *config)
547 {
548 	struct libusb20_config *pconf;
549 
550 	if (pdev == NULL || config == NULL)
551 		return (LIBUSB_ERROR_INVALID_PARAM);
552 
553 	pconf = libusb20_dev_alloc_config(pdev, libusb20_dev_get_config_index(pdev));
554 	if (pconf == NULL)
555 		return (LIBUSB_ERROR_NO_MEM);
556 
557 	*config = pconf->desc.bConfigurationValue;
558 
559 	free(pconf);
560 
561 	return (0);
562 }
563 
564 int
565 libusb_set_configuration(struct libusb20_device *pdev, int configuration)
566 {
567 	struct libusb20_config *pconf;
568 	struct libusb_device *dev;
569 	int err;
570 	uint8_t i;
571 
572 	dev = libusb_get_device(pdev);
573 	if (dev == NULL)
574 		return (LIBUSB_ERROR_INVALID_PARAM);
575 
576 	if (configuration < 1) {
577 		/* unconfigure */
578 		i = 255;
579 	} else {
580 		for (i = 0; i != 255; i++) {
581 			uint8_t found;
582 
583 			pconf = libusb20_dev_alloc_config(pdev, i);
584 			if (pconf == NULL)
585 				return (LIBUSB_ERROR_INVALID_PARAM);
586 			found = (pconf->desc.bConfigurationValue
587 			    == configuration);
588 			free(pconf);
589 
590 			if (found)
591 				goto set_config;
592 		}
593 		return (LIBUSB_ERROR_INVALID_PARAM);
594 	}
595 
596 set_config:
597 
598 	libusb10_cancel_all_transfer(dev);
599 
600 	libusb10_remove_pollfd(dev->ctx, &dev->dev_poll);
601 
602 	err = libusb20_dev_set_config_index(pdev, i);
603 
604 	libusb10_add_pollfd(dev->ctx, &dev->dev_poll, pdev, libusb20_dev_get_fd(pdev), POLLIN |
605 	    POLLOUT | POLLRDNORM | POLLWRNORM);
606 
607 	return (err ? LIBUSB_ERROR_INVALID_PARAM : 0);
608 }
609 
610 int
611 libusb_claim_interface(struct libusb20_device *pdev, int interface_number)
612 {
613 	libusb_device *dev;
614 
615 	dev = libusb_get_device(pdev);
616 	if (dev == NULL)
617 		return (LIBUSB_ERROR_INVALID_PARAM);
618 
619 	if (interface_number < 0 || interface_number > 31)
620 		return (LIBUSB_ERROR_INVALID_PARAM);
621 
622 	CTX_LOCK(dev->ctx);
623 	dev->claimed_interfaces |= (1 << interface_number);
624 	CTX_UNLOCK(dev->ctx);
625 
626 	return (0);
627 }
628 
629 int
630 libusb_release_interface(struct libusb20_device *pdev, int interface_number)
631 {
632 	libusb_device *dev;
633 	int err = 0;
634 
635 	dev = libusb_get_device(pdev);
636 	if (dev == NULL)
637 		return (LIBUSB_ERROR_INVALID_PARAM);
638 
639 	if (interface_number < 0 || interface_number > 31)
640 		return (LIBUSB_ERROR_INVALID_PARAM);
641 
642 	CTX_LOCK(dev->ctx);
643 	if (!(dev->claimed_interfaces & (1 << interface_number)))
644 		err = LIBUSB_ERROR_NOT_FOUND;
645 
646 	if (!err)
647 		dev->claimed_interfaces &= ~(1 << interface_number);
648 	CTX_UNLOCK(dev->ctx);
649 	return (err);
650 }
651 
652 int
653 libusb_set_interface_alt_setting(struct libusb20_device *pdev,
654     int interface_number, int alternate_setting)
655 {
656 	libusb_device *dev;
657 	int err = 0;
658 
659 	dev = libusb_get_device(pdev);
660 	if (dev == NULL)
661 		return (LIBUSB_ERROR_INVALID_PARAM);
662 
663 	if (interface_number < 0 || interface_number > 31)
664 		return (LIBUSB_ERROR_INVALID_PARAM);
665 
666 	CTX_LOCK(dev->ctx);
667 	if (!(dev->claimed_interfaces & (1 << interface_number)))
668 		err = LIBUSB_ERROR_NOT_FOUND;
669 	CTX_UNLOCK(dev->ctx);
670 
671 	if (err)
672 		return (err);
673 
674 	libusb10_cancel_all_transfer(dev);
675 
676 	libusb10_remove_pollfd(dev->ctx, &dev->dev_poll);
677 
678 	err = libusb20_dev_set_alt_index(pdev,
679 	    interface_number, alternate_setting);
680 
681 	libusb10_add_pollfd(dev->ctx, &dev->dev_poll,
682 	    pdev, libusb20_dev_get_fd(pdev),
683 	    POLLIN | POLLOUT | POLLRDNORM | POLLWRNORM);
684 
685 	return (err ? LIBUSB_ERROR_OTHER : 0);
686 }
687 
688 static struct libusb20_transfer *
689 libusb10_get_transfer(struct libusb20_device *pdev,
690     uint8_t endpoint, uint8_t xfer_index)
691 {
692 	xfer_index &= 1;	/* double buffering */
693 
694 	xfer_index |= (endpoint & LIBUSB20_ENDPOINT_ADDRESS_MASK) * 4;
695 
696 	if (endpoint & LIBUSB20_ENDPOINT_DIR_MASK) {
697 		/* this is an IN endpoint */
698 		xfer_index |= 2;
699 	}
700 	return (libusb20_tr_get_pointer(pdev, xfer_index));
701 }
702 
703 int
704 libusb_clear_halt(struct libusb20_device *pdev, uint8_t endpoint)
705 {
706 	struct libusb20_transfer *xfer;
707 	struct libusb_device *dev;
708 	int err;
709 
710 	xfer = libusb10_get_transfer(pdev, endpoint, 0);
711 	if (xfer == NULL)
712 		return (LIBUSB_ERROR_INVALID_PARAM);
713 
714 	dev = libusb_get_device(pdev);
715 	if (dev == NULL)
716 		return (LIBUSB_ERROR_INVALID_PARAM);
717 
718 	CTX_LOCK(dev->ctx);
719 	err = libusb20_tr_open(xfer, 0, 1, endpoint);
720 	CTX_UNLOCK(dev->ctx);
721 
722 	if (err != 0 && err != LIBUSB20_ERROR_BUSY)
723 		return (LIBUSB_ERROR_OTHER);
724 
725 	libusb20_tr_clear_stall_sync(xfer);
726 
727 	/* check if we opened the transfer */
728 	if (err == 0) {
729 		CTX_LOCK(dev->ctx);
730 		libusb20_tr_close(xfer);
731 		CTX_UNLOCK(dev->ctx);
732 	}
733 	return (0);			/* success */
734 }
735 
736 int
737 libusb_reset_device(struct libusb20_device *pdev)
738 {
739 	libusb_device *dev;
740 	int err;
741 
742 	dev = libusb_get_device(pdev);
743 	if (dev == NULL)
744 		return (LIBUSB_ERROR_INVALID_PARAM);
745 
746 	libusb10_cancel_all_transfer(dev);
747 
748 	libusb10_remove_pollfd(dev->ctx, &dev->dev_poll);
749 
750 	err = libusb20_dev_reset(pdev);
751 
752 	libusb10_add_pollfd(dev->ctx, &dev->dev_poll,
753 	    pdev, libusb20_dev_get_fd(pdev),
754 	    POLLIN | POLLOUT | POLLRDNORM | POLLWRNORM);
755 
756 	return (err ? LIBUSB_ERROR_OTHER : 0);
757 }
758 
759 int
760 libusb_check_connected(struct libusb20_device *pdev)
761 {
762 	libusb_device *dev;
763 	int err;
764 
765 	dev = libusb_get_device(pdev);
766 	if (dev == NULL)
767 		return (LIBUSB_ERROR_INVALID_PARAM);
768 
769 	err = libusb20_dev_check_connected(pdev);
770 
771 	return (err ? LIBUSB_ERROR_NO_DEVICE : 0);
772 }
773 
774 int
775 libusb_kernel_driver_active(struct libusb20_device *pdev, int interface)
776 {
777 	if (pdev == NULL)
778 		return (LIBUSB_ERROR_INVALID_PARAM);
779 
780 	if (libusb20_dev_kernel_driver_active(pdev, interface))
781 		return (0);		/* no kernel driver is active */
782 	else
783 		return (1);		/* kernel driver is active */
784 }
785 
786 int
787 libusb_get_driver_np(struct libusb20_device *pdev, int interface,
788     char *name, int namelen)
789 {
790 	return (libusb_get_driver(pdev, interface, name, namelen));
791 }
792 
793 int
794 libusb_get_driver(struct libusb20_device *pdev, int interface,
795     char *name, int namelen)
796 {
797 	char *ptr;
798 	int err;
799 
800 	if (pdev == NULL)
801 		return (LIBUSB_ERROR_INVALID_PARAM);
802 	if (namelen < 1)
803 		return (LIBUSB_ERROR_INVALID_PARAM);
804 	if (namelen > 255)
805 		namelen = 255;
806 
807 	err = libusb20_dev_get_iface_desc(
808 	    pdev, interface, name, namelen);
809 
810 	if (err != 0)
811 		return (LIBUSB_ERROR_OTHER);
812 
813 	/* we only want the driver name */
814 	ptr = strstr(name, ":");
815 	if (ptr != NULL)
816 		*ptr = 0;
817 
818 	return (0);
819 }
820 
821 int
822 libusb_detach_kernel_driver_np(struct libusb20_device *pdev, int interface)
823 {
824 	return (libusb_detach_kernel_driver(pdev, interface));
825 }
826 
827 int
828 libusb_detach_kernel_driver(struct libusb20_device *pdev, int interface)
829 {
830 	int err;
831 
832 	if (pdev == NULL)
833 		return (LIBUSB_ERROR_INVALID_PARAM);
834 
835 	err = libusb20_dev_detach_kernel_driver(
836 	    pdev, interface);
837 
838 	return (err ? LIBUSB_ERROR_OTHER : 0);
839 }
840 
841 int
842 libusb_attach_kernel_driver(struct libusb20_device *pdev, int interface)
843 {
844 	if (pdev == NULL)
845 		return (LIBUSB_ERROR_INVALID_PARAM);
846 	/* stub - currently not supported by libusb20 */
847 	return (0);
848 }
849 
850 /* Asynchronous device I/O */
851 
852 struct libusb_transfer *
853 libusb_alloc_transfer(int iso_packets)
854 {
855 	struct libusb_transfer *uxfer;
856 	struct libusb_super_transfer *sxfer;
857 	int len;
858 
859 	len = sizeof(struct libusb_transfer) +
860 	    sizeof(struct libusb_super_transfer) +
861 	    (iso_packets * sizeof(libusb_iso_packet_descriptor));
862 
863 	sxfer = malloc(len);
864 	if (sxfer == NULL)
865 		return (NULL);
866 
867 	memset(sxfer, 0, len);
868 
869 	uxfer = (struct libusb_transfer *)(
870 	    ((uint8_t *)sxfer) + sizeof(*sxfer));
871 
872 	/* set default value */
873 	uxfer->num_iso_packets = iso_packets;
874 
875 	return (uxfer);
876 }
877 
878 void
879 libusb_free_transfer(struct libusb_transfer *uxfer)
880 {
881 	struct libusb_super_transfer *sxfer;
882 
883 	if (uxfer == NULL)
884 		return;			/* be NULL safe */
885 
886 	/* check if we should free the transfer buffer */
887 	if (uxfer->flags & LIBUSB_TRANSFER_FREE_BUFFER)
888 		free(uxfer->buffer);
889 
890 	sxfer = (struct libusb_super_transfer *)(
891 	    (uint8_t *)uxfer - sizeof(*sxfer));
892 
893 	free(sxfer);
894 }
895 
896 static uint32_t
897 libusb10_get_maxframe(struct libusb20_device *pdev, libusb_transfer *xfer)
898 {
899 	uint32_t ret;
900 
901 	switch (xfer->type) {
902 	case LIBUSB_TRANSFER_TYPE_ISOCHRONOUS:
903 		ret = 60 | LIBUSB20_MAX_FRAME_PRE_SCALE;	/* 60ms */
904 		break;
905 	case LIBUSB_TRANSFER_TYPE_CONTROL:
906 		ret = 2;
907 		break;
908 	default:
909 		ret = 1;
910 		break;
911 	}
912 	return (ret);
913 }
914 
915 static int
916 libusb10_get_buffsize(struct libusb20_device *pdev, libusb_transfer *xfer)
917 {
918 	int ret;
919 	int usb_speed;
920 
921 	usb_speed = libusb20_dev_get_speed(pdev);
922 
923 	switch (xfer->type) {
924 	case LIBUSB_TRANSFER_TYPE_ISOCHRONOUS:
925 		ret = 0;		/* kernel will auto-select */
926 		break;
927 	case LIBUSB_TRANSFER_TYPE_CONTROL:
928 		ret = 1024;
929 		break;
930 	default:
931 		switch (usb_speed) {
932 		case LIBUSB20_SPEED_LOW:
933 			ret = 256;
934 			break;
935 		case LIBUSB20_SPEED_FULL:
936 			ret = 4096;
937 			break;
938 		case LIBUSB20_SPEED_SUPER:
939 			ret = 65536;
940 			break;
941 		default:
942 			ret = 16384;
943 			break;
944 		}
945 		break;
946 	}
947 	return (ret);
948 }
949 
950 static int
951 libusb10_convert_error(uint8_t status)
952 {
953 	;				/* indent fix */
954 
955 	switch (status) {
956 	case LIBUSB20_TRANSFER_START:
957 	case LIBUSB20_TRANSFER_COMPLETED:
958 		return (LIBUSB_TRANSFER_COMPLETED);
959 	case LIBUSB20_TRANSFER_OVERFLOW:
960 		return (LIBUSB_TRANSFER_OVERFLOW);
961 	case LIBUSB20_TRANSFER_NO_DEVICE:
962 		return (LIBUSB_TRANSFER_NO_DEVICE);
963 	case LIBUSB20_TRANSFER_STALL:
964 		return (LIBUSB_TRANSFER_STALL);
965 	case LIBUSB20_TRANSFER_CANCELLED:
966 		return (LIBUSB_TRANSFER_CANCELLED);
967 	case LIBUSB20_TRANSFER_TIMED_OUT:
968 		return (LIBUSB_TRANSFER_TIMED_OUT);
969 	default:
970 		return (LIBUSB_TRANSFER_ERROR);
971 	}
972 }
973 
974 /* This function must be called locked */
975 
976 static void
977 libusb10_complete_transfer(struct libusb20_transfer *pxfer,
978     struct libusb_super_transfer *sxfer, int status)
979 {
980 	struct libusb_transfer *uxfer;
981 	struct libusb_device *dev;
982 
983 	uxfer = (struct libusb_transfer *)(
984 	    ((uint8_t *)sxfer) + sizeof(*sxfer));
985 
986 	if (pxfer != NULL)
987 		libusb20_tr_set_priv_sc1(pxfer, NULL);
988 
989 	/* set transfer status */
990 	uxfer->status = status;
991 
992 	/* update super transfer state */
993 	sxfer->state = LIBUSB_SUPER_XFER_ST_NONE;
994 
995 	dev = libusb_get_device(uxfer->dev_handle);
996 
997 	TAILQ_INSERT_TAIL(&dev->ctx->tr_done, sxfer, entry);
998 }
999 
1000 /* This function must be called locked */
1001 
1002 static void
1003 libusb10_isoc_proxy(struct libusb20_transfer *pxfer)
1004 {
1005 	struct libusb_super_transfer *sxfer;
1006 	struct libusb_transfer *uxfer;
1007 	uint32_t actlen;
1008 	uint16_t iso_packets;
1009 	uint16_t i;
1010 	uint8_t status;
1011 	uint8_t flags;
1012 
1013 	status = libusb20_tr_get_status(pxfer);
1014 	sxfer = libusb20_tr_get_priv_sc1(pxfer);
1015 	actlen = libusb20_tr_get_actual_length(pxfer);
1016 	iso_packets = libusb20_tr_get_max_frames(pxfer);
1017 
1018 	if (sxfer == NULL)
1019 		return;			/* cancelled - nothing to do */
1020 
1021 	uxfer = (struct libusb_transfer *)(
1022 	    ((uint8_t *)sxfer) + sizeof(*sxfer));
1023 
1024 	if (iso_packets > uxfer->num_iso_packets)
1025 		iso_packets = uxfer->num_iso_packets;
1026 
1027 	if (iso_packets == 0)
1028 		return;			/* nothing to do */
1029 
1030 	/* make sure that the number of ISOCHRONOUS packets is valid */
1031 	uxfer->num_iso_packets = iso_packets;
1032 
1033 	flags = uxfer->flags;
1034 
1035 	switch (status) {
1036 	case LIBUSB20_TRANSFER_COMPLETED:
1037 
1038 		/* update actual length */
1039 		uxfer->actual_length = actlen;
1040 		for (i = 0; i != iso_packets; i++) {
1041 			uxfer->iso_packet_desc[i].actual_length =
1042 			    libusb20_tr_get_length(pxfer, i);
1043 		}
1044 		libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_COMPLETED);
1045 		break;
1046 
1047 	case LIBUSB20_TRANSFER_START:
1048 
1049 		/* setup length(s) */
1050 		actlen = 0;
1051 		for (i = 0; i != iso_packets; i++) {
1052 			libusb20_tr_setup_isoc(pxfer,
1053 			    &uxfer->buffer[actlen],
1054 			    uxfer->iso_packet_desc[i].length, i);
1055 			actlen += uxfer->iso_packet_desc[i].length;
1056 		}
1057 
1058 		/* no remainder */
1059 		sxfer->rem_len = 0;
1060 
1061 		libusb20_tr_set_total_frames(pxfer, iso_packets);
1062 		libusb20_tr_submit(pxfer);
1063 
1064 		/* fork another USB transfer, if any */
1065 		libusb10_submit_transfer_sub(libusb20_tr_get_priv_sc0(pxfer), uxfer->endpoint);
1066 		break;
1067 
1068 	default:
1069 		libusb10_complete_transfer(pxfer, sxfer, libusb10_convert_error(status));
1070 		break;
1071 	}
1072 }
1073 
1074 /* This function must be called locked */
1075 
1076 static void
1077 libusb10_bulk_intr_proxy(struct libusb20_transfer *pxfer)
1078 {
1079 	struct libusb_super_transfer *sxfer;
1080 	struct libusb_transfer *uxfer;
1081 	uint32_t max_bulk;
1082 	uint32_t actlen;
1083 	uint8_t status;
1084 	uint8_t flags;
1085 
1086 	status = libusb20_tr_get_status(pxfer);
1087 	sxfer = libusb20_tr_get_priv_sc1(pxfer);
1088 	max_bulk = libusb20_tr_get_max_total_length(pxfer);
1089 	actlen = libusb20_tr_get_actual_length(pxfer);
1090 
1091 	if (sxfer == NULL)
1092 		return;			/* cancelled - nothing to do */
1093 
1094 	uxfer = (struct libusb_transfer *)(
1095 	    ((uint8_t *)sxfer) + sizeof(*sxfer));
1096 
1097 	flags = uxfer->flags;
1098 
1099 	switch (status) {
1100 	case LIBUSB20_TRANSFER_COMPLETED:
1101 
1102 		uxfer->actual_length += actlen;
1103 
1104 		/* check for short packet */
1105 		if (sxfer->last_len != actlen) {
1106 			if (flags & LIBUSB_TRANSFER_SHORT_NOT_OK) {
1107 				libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_ERROR);
1108 			} else {
1109 				libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_COMPLETED);
1110 			}
1111 			break;
1112 		}
1113 		/* check for end of data */
1114 		if (sxfer->rem_len == 0) {
1115 			libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_COMPLETED);
1116 			break;
1117 		}
1118 		/* FALLTHROUGH */
1119 
1120 	case LIBUSB20_TRANSFER_START:
1121 		if (max_bulk > sxfer->rem_len) {
1122 			max_bulk = sxfer->rem_len;
1123 		}
1124 		/* setup new BULK or INTERRUPT transaction */
1125 		libusb20_tr_setup_bulk(pxfer,
1126 		    sxfer->curr_data, max_bulk, uxfer->timeout);
1127 
1128 		/* update counters */
1129 		sxfer->last_len = max_bulk;
1130 		sxfer->curr_data += max_bulk;
1131 		sxfer->rem_len -= max_bulk;
1132 
1133 		libusb20_tr_submit(pxfer);
1134 
1135 		/* check if we can fork another USB transfer */
1136 		if (sxfer->rem_len == 0)
1137 			libusb10_submit_transfer_sub(libusb20_tr_get_priv_sc0(pxfer), uxfer->endpoint);
1138 		break;
1139 
1140 	default:
1141 		libusb10_complete_transfer(pxfer, sxfer, libusb10_convert_error(status));
1142 		break;
1143 	}
1144 }
1145 
1146 /* This function must be called locked */
1147 
1148 static void
1149 libusb10_ctrl_proxy(struct libusb20_transfer *pxfer)
1150 {
1151 	struct libusb_super_transfer *sxfer;
1152 	struct libusb_transfer *uxfer;
1153 	uint32_t max_bulk;
1154 	uint32_t actlen;
1155 	uint8_t status;
1156 	uint8_t flags;
1157 
1158 	status = libusb20_tr_get_status(pxfer);
1159 	sxfer = libusb20_tr_get_priv_sc1(pxfer);
1160 	max_bulk = libusb20_tr_get_max_total_length(pxfer);
1161 	actlen = libusb20_tr_get_actual_length(pxfer);
1162 
1163 	if (sxfer == NULL)
1164 		return;			/* cancelled - nothing to do */
1165 
1166 	uxfer = (struct libusb_transfer *)(
1167 	    ((uint8_t *)sxfer) + sizeof(*sxfer));
1168 
1169 	flags = uxfer->flags;
1170 
1171 	switch (status) {
1172 	case LIBUSB20_TRANSFER_COMPLETED:
1173 
1174 		uxfer->actual_length += actlen;
1175 
1176 		/* subtract length of SETUP packet, if any */
1177 		actlen -= libusb20_tr_get_length(pxfer, 0);
1178 
1179 		/* check for short packet */
1180 		if (sxfer->last_len != actlen) {
1181 			if (flags & LIBUSB_TRANSFER_SHORT_NOT_OK) {
1182 				libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_ERROR);
1183 			} else {
1184 				libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_COMPLETED);
1185 			}
1186 			break;
1187 		}
1188 		/* check for end of data */
1189 		if (sxfer->rem_len == 0) {
1190 			libusb10_complete_transfer(pxfer, sxfer, LIBUSB_TRANSFER_COMPLETED);
1191 			break;
1192 		}
1193 		/* FALLTHROUGH */
1194 
1195 	case LIBUSB20_TRANSFER_START:
1196 		if (max_bulk > sxfer->rem_len) {
1197 			max_bulk = sxfer->rem_len;
1198 		}
1199 		/* setup new CONTROL transaction */
1200 		if (status == LIBUSB20_TRANSFER_COMPLETED) {
1201 			/* next fragment - don't send SETUP packet */
1202 			libusb20_tr_set_length(pxfer, 0, 0);
1203 		} else {
1204 			/* first fragment - send SETUP packet */
1205 			libusb20_tr_set_length(pxfer, 8, 0);
1206 			libusb20_tr_set_buffer(pxfer, uxfer->buffer, 0);
1207 		}
1208 
1209 		if (max_bulk != 0) {
1210 			libusb20_tr_set_length(pxfer, max_bulk, 1);
1211 			libusb20_tr_set_buffer(pxfer, sxfer->curr_data, 1);
1212 			libusb20_tr_set_total_frames(pxfer, 2);
1213 		} else {
1214 			libusb20_tr_set_total_frames(pxfer, 1);
1215 		}
1216 
1217 		/* update counters */
1218 		sxfer->last_len = max_bulk;
1219 		sxfer->curr_data += max_bulk;
1220 		sxfer->rem_len -= max_bulk;
1221 
1222 		libusb20_tr_submit(pxfer);
1223 
1224 		/* check if we can fork another USB transfer */
1225 		if (sxfer->rem_len == 0)
1226 			libusb10_submit_transfer_sub(libusb20_tr_get_priv_sc0(pxfer), uxfer->endpoint);
1227 		break;
1228 
1229 	default:
1230 		libusb10_complete_transfer(pxfer, sxfer, libusb10_convert_error(status));
1231 		break;
1232 	}
1233 }
1234 
1235 /* The following function must be called locked */
1236 
1237 static void
1238 libusb10_submit_transfer_sub(struct libusb20_device *pdev, uint8_t endpoint)
1239 {
1240 	struct libusb20_transfer *pxfer0;
1241 	struct libusb20_transfer *pxfer1;
1242 	struct libusb_super_transfer *sxfer;
1243 	struct libusb_transfer *uxfer;
1244 	struct libusb_device *dev;
1245 	int err;
1246 	int buffsize;
1247 	int maxframe;
1248 	int temp;
1249 	uint8_t dummy;
1250 
1251 	dev = libusb_get_device(pdev);
1252 
1253 	pxfer0 = libusb10_get_transfer(pdev, endpoint, 0);
1254 	pxfer1 = libusb10_get_transfer(pdev, endpoint, 1);
1255 
1256 	if (pxfer0 == NULL || pxfer1 == NULL)
1257 		return;			/* shouldn't happen */
1258 
1259 	temp = 0;
1260 	if (libusb20_tr_pending(pxfer0))
1261 		temp |= 1;
1262 	if (libusb20_tr_pending(pxfer1))
1263 		temp |= 2;
1264 
1265 	switch (temp) {
1266 	case 3:
1267 		/* wait till one of the transfers complete */
1268 		return;
1269 	case 2:
1270 		sxfer = libusb20_tr_get_priv_sc1(pxfer1);
1271 		if (sxfer == NULL)
1272 			return;		/* cancelling */
1273 		if (sxfer->rem_len)
1274 			return;		/* cannot queue another one */
1275 		/* swap transfers */
1276 		pxfer1 = pxfer0;
1277 		break;
1278 	case 1:
1279 		sxfer = libusb20_tr_get_priv_sc1(pxfer0);
1280 		if (sxfer == NULL)
1281 			return;		/* cancelling */
1282 		if (sxfer->rem_len)
1283 			return;		/* cannot queue another one */
1284 		/* swap transfers */
1285 		pxfer0 = pxfer1;
1286 		break;
1287 	default:
1288 		break;
1289 	}
1290 
1291 	/* find next transfer on same endpoint */
1292 	TAILQ_FOREACH(sxfer, &dev->tr_head, entry) {
1293 
1294 		uxfer = (struct libusb_transfer *)(
1295 		    ((uint8_t *)sxfer) + sizeof(*sxfer));
1296 
1297 		if (uxfer->endpoint == endpoint) {
1298 			TAILQ_REMOVE(&dev->tr_head, sxfer, entry);
1299 			sxfer->entry.tqe_prev = NULL;
1300 			goto found;
1301 		}
1302 	}
1303 	return;				/* success */
1304 
1305 found:
1306 
1307 	libusb20_tr_set_priv_sc0(pxfer0, pdev);
1308 	libusb20_tr_set_priv_sc1(pxfer0, sxfer);
1309 
1310 	/* reset super transfer state */
1311 	sxfer->rem_len = uxfer->length;
1312 	sxfer->curr_data = uxfer->buffer;
1313 	uxfer->actual_length = 0;
1314 
1315 	switch (uxfer->type) {
1316 	case LIBUSB_TRANSFER_TYPE_ISOCHRONOUS:
1317 		libusb20_tr_set_callback(pxfer0, libusb10_isoc_proxy);
1318 		break;
1319 	case LIBUSB_TRANSFER_TYPE_BULK:
1320 	case LIBUSB_TRANSFER_TYPE_INTERRUPT:
1321 		libusb20_tr_set_callback(pxfer0, libusb10_bulk_intr_proxy);
1322 		break;
1323 	case LIBUSB_TRANSFER_TYPE_CONTROL:
1324 		libusb20_tr_set_callback(pxfer0, libusb10_ctrl_proxy);
1325 		if (sxfer->rem_len < 8)
1326 			goto failure;
1327 
1328 		/* remove SETUP packet from data */
1329 		sxfer->rem_len -= 8;
1330 		sxfer->curr_data += 8;
1331 		break;
1332 	default:
1333 		goto failure;
1334 	}
1335 
1336 	buffsize = libusb10_get_buffsize(pdev, uxfer);
1337 	maxframe = libusb10_get_maxframe(pdev, uxfer);
1338 
1339 	/* make sure the transfer is opened */
1340 	err = libusb20_tr_open(pxfer0, buffsize, maxframe, endpoint);
1341 	if (err && (err != LIBUSB20_ERROR_BUSY)) {
1342 		goto failure;
1343 	}
1344 	libusb20_tr_start(pxfer0);
1345 	return;
1346 
1347 failure:
1348 	libusb10_complete_transfer(pxfer0, sxfer, LIBUSB_TRANSFER_ERROR);
1349 
1350 	/* make sure our event loop spins the done handler */
1351 	dummy = 0;
1352 	err = write(dev->ctx->ctrl_pipe[1], &dummy, sizeof(dummy));
1353 }
1354 
1355 /* The following function must be called unlocked */
1356 
1357 int
1358 libusb_submit_transfer(struct libusb_transfer *uxfer)
1359 {
1360 	struct libusb20_transfer *pxfer0;
1361 	struct libusb20_transfer *pxfer1;
1362 	struct libusb_super_transfer *sxfer;
1363 	struct libusb_device *dev;
1364 	uint8_t endpoint;
1365 	int err;
1366 
1367 	if (uxfer == NULL)
1368 		return (LIBUSB_ERROR_INVALID_PARAM);
1369 
1370 	if (uxfer->dev_handle == NULL)
1371 		return (LIBUSB_ERROR_INVALID_PARAM);
1372 
1373 	endpoint = uxfer->endpoint;
1374 
1375 	dev = libusb_get_device(uxfer->dev_handle);
1376 
1377 	DPRINTF(dev->ctx, LIBUSB_DEBUG_FUNCTION, "libusb_submit_transfer enter");
1378 
1379 	sxfer = (struct libusb_super_transfer *)(
1380 	    (uint8_t *)uxfer - sizeof(*sxfer));
1381 
1382 	CTX_LOCK(dev->ctx);
1383 
1384 	pxfer0 = libusb10_get_transfer(uxfer->dev_handle, endpoint, 0);
1385 	pxfer1 = libusb10_get_transfer(uxfer->dev_handle, endpoint, 1);
1386 
1387 	if (pxfer0 == NULL || pxfer1 == NULL) {
1388 		err = LIBUSB_ERROR_OTHER;
1389 	} else if ((sxfer->entry.tqe_prev != NULL) ||
1390 	    (libusb20_tr_get_priv_sc1(pxfer0) == sxfer) ||
1391 	    (libusb20_tr_get_priv_sc1(pxfer1) == sxfer)) {
1392 		err = LIBUSB_ERROR_BUSY;
1393 	} else {
1394 
1395 		/* set pending state */
1396 		sxfer->state = LIBUSB_SUPER_XFER_ST_PEND;
1397 
1398 		/* insert transfer into transfer head list */
1399 		TAILQ_INSERT_TAIL(&dev->tr_head, sxfer, entry);
1400 
1401 		/* start work transfers */
1402 		libusb10_submit_transfer_sub(
1403 		    uxfer->dev_handle, endpoint);
1404 
1405 		err = 0;		/* success */
1406 	}
1407 
1408 	CTX_UNLOCK(dev->ctx);
1409 
1410 	DPRINTF(dev->ctx, LIBUSB_DEBUG_FUNCTION, "libusb_submit_transfer leave %d", err);
1411 
1412 	return (err);
1413 }
1414 
1415 /* Asynchronous transfer cancel */
1416 
1417 int
1418 libusb_cancel_transfer(struct libusb_transfer *uxfer)
1419 {
1420 	struct libusb20_transfer *pxfer0;
1421 	struct libusb20_transfer *pxfer1;
1422 	struct libusb_super_transfer *sxfer;
1423 	struct libusb_device *dev;
1424 	uint8_t endpoint;
1425 	int retval;
1426 
1427 	if (uxfer == NULL)
1428 		return (LIBUSB_ERROR_INVALID_PARAM);
1429 
1430 	/* check if not initialised */
1431 	if (uxfer->dev_handle == NULL)
1432 		return (LIBUSB_ERROR_NOT_FOUND);
1433 
1434 	endpoint = uxfer->endpoint;
1435 
1436 	dev = libusb_get_device(uxfer->dev_handle);
1437 
1438 	DPRINTF(dev->ctx, LIBUSB_DEBUG_FUNCTION, "libusb_cancel_transfer enter");
1439 
1440 	sxfer = (struct libusb_super_transfer *)(
1441 	    (uint8_t *)uxfer - sizeof(*sxfer));
1442 
1443 	retval = 0;
1444 
1445 	CTX_LOCK(dev->ctx);
1446 
1447 	pxfer0 = libusb10_get_transfer(uxfer->dev_handle, endpoint, 0);
1448 	pxfer1 = libusb10_get_transfer(uxfer->dev_handle, endpoint, 1);
1449 
1450 	if (sxfer->state != LIBUSB_SUPER_XFER_ST_PEND) {
1451 		/* only update the transfer status */
1452 		uxfer->status = LIBUSB_TRANSFER_CANCELLED;
1453 		retval = LIBUSB_ERROR_NOT_FOUND;
1454 	} else if (sxfer->entry.tqe_prev != NULL) {
1455 		/* we are lucky - transfer is on a queue */
1456 		TAILQ_REMOVE(&dev->tr_head, sxfer, entry);
1457 		sxfer->entry.tqe_prev = NULL;
1458 		libusb10_complete_transfer(NULL,
1459 		    sxfer, LIBUSB_TRANSFER_CANCELLED);
1460 	} else if (pxfer0 == NULL || pxfer1 == NULL) {
1461 		/* not started */
1462 		retval = LIBUSB_ERROR_NOT_FOUND;
1463 	} else if (libusb20_tr_get_priv_sc1(pxfer0) == sxfer) {
1464 		libusb10_complete_transfer(pxfer0,
1465 		    sxfer, LIBUSB_TRANSFER_CANCELLED);
1466 		libusb20_tr_stop(pxfer0);
1467 		/* make sure the queue doesn't stall */
1468 		libusb10_submit_transfer_sub(
1469 		    uxfer->dev_handle, endpoint);
1470 	} else if (libusb20_tr_get_priv_sc1(pxfer1) == sxfer) {
1471 		libusb10_complete_transfer(pxfer1,
1472 		    sxfer, LIBUSB_TRANSFER_CANCELLED);
1473 		libusb20_tr_stop(pxfer1);
1474 		/* make sure the queue doesn't stall */
1475 		libusb10_submit_transfer_sub(
1476 		    uxfer->dev_handle, endpoint);
1477 	} else {
1478 		/* not started */
1479 		retval = LIBUSB_ERROR_NOT_FOUND;
1480 	}
1481 
1482 	CTX_UNLOCK(dev->ctx);
1483 
1484 	DPRINTF(dev->ctx, LIBUSB_DEBUG_FUNCTION, "libusb_cancel_transfer leave");
1485 
1486 	return (retval);
1487 }
1488 
1489 UNEXPORTED void
1490 libusb10_cancel_all_transfer(libusb_device *dev)
1491 {
1492 	/* TODO */
1493 }
1494 
1495 uint16_t
1496 libusb_cpu_to_le16(uint16_t x)
1497 {
1498 	return (htole16(x));
1499 }
1500 
1501 uint16_t
1502 libusb_le16_to_cpu(uint16_t x)
1503 {
1504 	return (le16toh(x));
1505 }
1506 
1507 const char *
1508 libusb_strerror(int code)
1509 {
1510 	switch (code) {
1511 	case LIBUSB_SUCCESS:
1512 		return ("Success");
1513 	case LIBUSB_ERROR_IO:
1514 		return ("I/O error");
1515 	case LIBUSB_ERROR_INVALID_PARAM:
1516 		return ("Invalid parameter");
1517 	case LIBUSB_ERROR_ACCESS:
1518 		return ("Permissions error");
1519 	case LIBUSB_ERROR_NO_DEVICE:
1520 		return ("No device");
1521 	case LIBUSB_ERROR_NOT_FOUND:
1522 		return ("Not found");
1523 	case LIBUSB_ERROR_BUSY:
1524 		return ("Device busy");
1525 	case LIBUSB_ERROR_TIMEOUT:
1526 		return ("Timeout");
1527 	case LIBUSB_ERROR_OVERFLOW:
1528 		return ("Overflow");
1529 	case LIBUSB_ERROR_PIPE:
1530 		return ("Pipe error");
1531 	case LIBUSB_ERROR_INTERRUPTED:
1532 		return ("Interrupted");
1533 	case LIBUSB_ERROR_NO_MEM:
1534 		return ("Out of memory");
1535 	case LIBUSB_ERROR_NOT_SUPPORTED:
1536 		return ("Not supported");
1537 	case LIBUSB_ERROR_OTHER:
1538 		return ("Other error");
1539 	default:
1540 		return ("Unknown error");
1541 	}
1542 }
1543 
1544 const char *
1545 libusb_error_name(int code)
1546 {
1547 	switch (code) {
1548 	case LIBUSB_SUCCESS:
1549 		return ("LIBUSB_SUCCESS");
1550 	case LIBUSB_ERROR_IO:
1551 		return ("LIBUSB_ERROR_IO");
1552 	case LIBUSB_ERROR_INVALID_PARAM:
1553 		return ("LIBUSB_ERROR_INVALID_PARAM");
1554 	case LIBUSB_ERROR_ACCESS:
1555 		return ("LIBUSB_ERROR_ACCESS");
1556 	case LIBUSB_ERROR_NO_DEVICE:
1557 		return ("LIBUSB_ERROR_NO_DEVICE");
1558 	case LIBUSB_ERROR_NOT_FOUND:
1559 		return ("LIBUSB_ERROR_NOT_FOUND");
1560 	case LIBUSB_ERROR_BUSY:
1561 		return ("LIBUSB_ERROR_BUSY");
1562 	case LIBUSB_ERROR_TIMEOUT:
1563 		return ("LIBUSB_ERROR_TIMEOUT");
1564 	case LIBUSB_ERROR_OVERFLOW:
1565 		return ("LIBUSB_ERROR_OVERFLOW");
1566 	case LIBUSB_ERROR_PIPE:
1567 		return ("LIBUSB_ERROR_PIPE");
1568 	case LIBUSB_ERROR_INTERRUPTED:
1569 		return ("LIBUSB_ERROR_INTERRUPTED");
1570 	case LIBUSB_ERROR_NO_MEM:
1571 		return ("LIBUSB_ERROR_NO_MEM");
1572 	case LIBUSB_ERROR_NOT_SUPPORTED:
1573 		return ("LIBUSB_ERROR_NOT_SUPPORTED");
1574 	case LIBUSB_ERROR_OTHER:
1575 		return ("LIBUSB_ERROR_OTHER");
1576 	default:
1577 		return ("LIBUSB_ERROR_UNKNOWN");
1578 	}
1579 }
1580