OpenBSD backend
[platform/upstream/libusb.git] / libusb / os / openbsd_usb.c
1 /*
2  * Copyright (c) 2011 Martin Pieuchot <mpi@openbsd.org>
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18
19 #include <sys/time.h>
20 #include <sys/types.h>
21
22 #include <errno.h>
23 #include <fcntl.h>
24 #include <stdio.h>
25 #include <stdlib.h>
26 #include <string.h>
27 #include <unistd.h>
28
29 #include <dev/usb/usb.h>
30
31 #include "libusb.h"
32 #include "libusbi.h"
33
34 struct device_priv {
35         char devnode[16];
36         int fd;
37
38         unsigned char *cdesc;                   /* active config descriptor */
39         usb_device_descriptor_t ddesc;          /* usb device descriptor */
40 };
41
42 struct handle_priv {
43         int pipe[2];                            /* for event notification */
44         int endpoints[USB_MAX_ENDPOINTS];
45 };
46
47 /*
48  * Backend functions
49  */
50 static int obsd_get_device_list(struct libusb_context *,
51     struct discovered_devs **);
52 static int obsd_open(struct libusb_device_handle *);
53 static void obsd_close(struct libusb_device_handle *);
54
55 static int obsd_get_device_descriptor(struct libusb_device *, unsigned char *,
56     int *);
57 static int obsd_get_active_config_descriptor(struct libusb_device *,
58     unsigned char *, size_t, int *);
59 static int obsd_get_config_descriptor(struct libusb_device *, uint8_t,
60     unsigned char *, size_t, int *);
61
62 static int obsd_get_configuration(struct libusb_device_handle *, int *);
63 static int obsd_set_configuration(struct libusb_device_handle *, int);
64
65 static int obsd_claim_interface(struct libusb_device_handle *, int);
66 static int obsd_release_interface(struct libusb_device_handle *, int);
67
68 static int obsd_set_interface_altsetting(struct libusb_device_handle *, int,
69     int);
70 static int obsd_clear_halt(struct libusb_device_handle *, unsigned char);
71 static int obsd_reset_device(struct libusb_device_handle *);
72 static void obsd_destroy_device(struct libusb_device *);
73
74 static int obsd_submit_transfer(struct usbi_transfer *);
75 static int obsd_cancel_transfer(struct usbi_transfer *);
76 static void obsd_clear_transfer_priv(struct usbi_transfer *);
77 static int obsd_handle_events(struct libusb_context *ctx, struct pollfd *,
78     nfds_t, int);
79 static int obsd_clock_gettime(int, struct timespec *);
80
81 /*
82  * Private functions
83  */
84 static int _errno_to_libusb(int);
85 static int _cache_active_config_descriptor(struct libusb_device *, int);
86 static int _sync_control_transfer(struct usbi_transfer *);
87 static int _sync_gen_transfer(struct usbi_transfer *);
88 static int _access_endpoint(struct libusb_transfer *);
89
90 const struct usbi_os_backend openbsd_backend = {
91         "Synchronous OpenBSD backend",
92         NULL,                           /* init() */
93         NULL,                           /* exit() */
94         obsd_get_device_list,
95         obsd_open,
96         obsd_close,
97
98         obsd_get_device_descriptor,
99         obsd_get_active_config_descriptor,
100         obsd_get_config_descriptor,
101
102         obsd_get_configuration,
103         obsd_set_configuration,
104
105         obsd_claim_interface,
106         obsd_release_interface,
107
108         obsd_set_interface_altsetting,
109         obsd_clear_halt,
110         obsd_reset_device,
111
112         NULL,                           /* kernel_driver_active() */
113         NULL,                           /* detach_kernel_driver() */
114         NULL,                           /* attach_kernel_driver() */
115
116         obsd_destroy_device,
117
118         obsd_submit_transfer,
119         obsd_cancel_transfer,
120         obsd_clear_transfer_priv,
121
122         obsd_handle_events,
123
124         obsd_clock_gettime,
125         sizeof(struct device_priv),
126         sizeof(struct handle_priv),
127         0,                              /* transfer_priv_size */
128         0,                              /* add_iso_packet_size */
129 };
130
131 int
132 obsd_get_device_list(struct libusb_context * ctx,
133         struct discovered_devs **discdevs)
134 {
135         struct libusb_device *dev;
136         struct device_priv *dpriv;
137         struct usb_device_info di;
138         unsigned long session_id;
139         char devnode[16];
140         int fd, err, i;
141
142         usbi_dbg("");
143
144         /* Only ugen(4) is supported */
145         for (i = 0; i < USB_MAX_DEVICES; i++) {
146                 /* Control endpoint is always .00 */
147                 snprintf(devnode, sizeof(devnode), "/dev/ugen%d.00", i);
148
149                 if ((fd = open(devnode, O_RDONLY)) < 0) {
150                         if (errno != ENOENT && errno != ENXIO)
151                                 usbi_err(ctx, "could not open %s", devnode);
152                         continue;
153                 }
154
155                 if (ioctl(fd, USB_GET_DEVICEINFO, &di) < 0)
156                         continue;
157
158                 session_id = (di.udi_bus << 8 | di.udi_addr);
159                 dev = usbi_get_device_by_session_id(ctx, session_id);
160
161                 if (dev == NULL) {
162                         dev = usbi_alloc_device(ctx, session_id);
163                         if (dev == NULL)
164                                 return (LIBUSB_ERROR_NO_MEM);
165
166                         dev->bus_number = di.udi_bus;
167                         dev->device_address = di.udi_addr;
168
169                         dpriv = (struct device_priv *)dev->os_priv;
170                         strlcpy(dpriv->devnode, devnode, sizeof(devnode));
171                         dpriv->fd = -1;
172
173                         if (ioctl(fd, USB_GET_DEVICE_DESC, &dpriv->ddesc) < 0) {
174                                 err = errno;
175                                 goto error;
176                         }
177
178                         dpriv->cdesc = NULL;
179                         if (_cache_active_config_descriptor(dev, fd)) {
180                                 err = errno;
181                                 goto error;
182                         }
183
184                         if ((err = usbi_sanitize_device(dev)))
185                                 goto error;
186                 }
187                 close(fd);
188
189                 if (discovered_devs_append(*discdevs, dev) == NULL)
190                         return (LIBUSB_ERROR_NO_MEM);
191         }
192
193         return (LIBUSB_SUCCESS);
194
195 error:
196         close(fd);
197         libusb_unref_device(dev);
198         return _errno_to_libusb(err);
199 }
200
201 int
202 obsd_open(struct libusb_device_handle *handle)
203 {
204         struct handle_priv *hpriv = (struct handle_priv *)handle->os_priv;
205         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
206
207         dpriv->fd = open(dpriv->devnode, O_RDWR);
208         if (dpriv->fd < 0) {
209                 dpriv->fd = open(dpriv->devnode, O_RDONLY);
210                 if (dpriv->fd < 0)
211                         return _errno_to_libusb(errno);
212         }
213
214         usbi_dbg("open %s: fd %d", dpriv->devnode, dpriv->fd);
215
216         if (pipe(hpriv->pipe) < 0)
217                 return _errno_to_libusb(errno);
218
219         return usbi_add_pollfd(HANDLE_CTX(handle), hpriv->pipe[0], POLLIN);
220 }
221
222 void
223 obsd_close(struct libusb_device_handle *handle)
224 {
225         struct handle_priv *hpriv = (struct handle_priv *)handle->os_priv;
226         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
227
228         usbi_dbg("close: fd %d", dpriv->fd);
229
230         close(dpriv->fd);
231         dpriv->fd = -1;
232
233         usbi_remove_pollfd(HANDLE_CTX(handle), hpriv->pipe[0]);
234
235         close(hpriv->pipe[0]);
236         close(hpriv->pipe[1]);
237 }
238
239 int
240 obsd_get_device_descriptor(struct libusb_device *dev, unsigned char *buf,
241     int *host_endian)
242 {
243         struct device_priv *dpriv = (struct device_priv *)dev->os_priv;
244
245         usbi_dbg("");
246
247         memcpy(buf, &dpriv->ddesc, DEVICE_DESC_LENGTH);
248
249         *host_endian = 0;
250
251         return (LIBUSB_SUCCESS);
252 }
253
254 int
255 obsd_get_active_config_descriptor(struct libusb_device *dev,
256     unsigned char *buf, size_t len, int *host_endian)
257 {
258         struct device_priv *dpriv = (struct device_priv *)dev->os_priv;
259         usb_config_descriptor_t *ucd;
260
261         ucd = (usb_config_descriptor_t *) dpriv->cdesc;
262         len = MIN(len, UGETW(ucd->wTotalLength));
263
264         usbi_dbg("len %d", len);
265
266         memcpy(buf, dpriv->cdesc, len);
267
268         *host_endian = 0;
269
270         return (LIBUSB_SUCCESS);
271 }
272
273 int
274 obsd_get_config_descriptor(struct libusb_device *dev, uint8_t idx,
275     unsigned char *buf, size_t len, int *host_endian)
276 {
277         struct device_priv *dpriv = (struct device_priv *)dev->os_priv;
278         struct usb_full_desc ufd;
279         int fd, err;
280
281         usbi_dbg("index %d, len %d", idx, len);
282
283         /* A config descriptor may be requested before opening the device */
284         if (dpriv->fd >= 0) {
285                 fd = dpriv->fd;
286         } else {
287                 fd = open(dpriv->devnode, O_RDONLY);
288                 if (fd < 0)
289                         return _errno_to_libusb(errno);
290         }
291
292         ufd.ufd_config_index = idx;
293         ufd.ufd_size = len;
294         ufd.ufd_data = buf;
295
296         if ((ioctl(fd, USB_GET_FULL_DESC, &ufd)) < 0) {
297                 err = errno;
298                 if (dpriv->fd < 0)
299                         close(fd);
300                 return _errno_to_libusb(err);
301         }
302
303         if (dpriv->fd < 0)
304                 close(fd);
305
306         *host_endian = 0;
307
308         return (LIBUSB_SUCCESS);
309 }
310
311 int
312 obsd_get_configuration(struct libusb_device_handle *handle, int *config)
313 {
314         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
315
316         usbi_dbg("");
317
318         if (ioctl(dpriv->fd, USB_GET_CONFIG, config) < 0)
319                 return _errno_to_libusb(errno);
320
321         usbi_dbg("configuration %d", *config);
322
323         return (LIBUSB_SUCCESS);
324 }
325
326 int
327 obsd_set_configuration(struct libusb_device_handle *handle, int config)
328 {
329         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
330
331         usbi_dbg("configuration %d", config);
332
333         if (ioctl(dpriv->fd, USB_SET_CONFIG, &config) < 0)
334                 return _errno_to_libusb(errno);
335
336         return _cache_active_config_descriptor(handle->dev, dpriv->fd);
337 }
338
339 int
340 obsd_claim_interface(struct libusb_device_handle *handle, int iface)
341 {
342         struct handle_priv *hpriv = (struct handle_priv *)handle->os_priv;
343         int i;
344
345         for (i = 0; i < USB_MAX_ENDPOINTS; i++)
346                 hpriv->endpoints[i] = -1;
347
348         return (LIBUSB_SUCCESS);
349 }
350
351 int
352 obsd_release_interface(struct libusb_device_handle *handle, int iface)
353 {
354         struct handle_priv *hpriv = (struct handle_priv *)handle->os_priv;
355         int i;
356
357         for (i = 0; i < USB_MAX_ENDPOINTS; i++)
358                 if (hpriv->endpoints[i] >= 0)
359                         close(hpriv->endpoints[i]);
360
361         return (LIBUSB_SUCCESS);
362 }
363
364 int
365 obsd_set_interface_altsetting(struct libusb_device_handle *handle, int iface,
366     int altsetting)
367 {
368         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
369         struct usb_alt_interface intf;
370
371         usbi_dbg("iface %d, setting %d", iface, altsetting);
372
373         memset(&intf, 0, sizeof(intf));
374
375         intf.uai_interface_index = iface;
376         intf.uai_alt_no = altsetting;
377
378         if (ioctl(dpriv->fd, USB_SET_ALTINTERFACE, &intf) < 0)
379                 return _errno_to_libusb(errno);
380
381         return (LIBUSB_SUCCESS);
382 }
383
384 int
385 obsd_clear_halt(struct libusb_device_handle *handle, unsigned char endpoint)
386 {
387         struct device_priv *dpriv = (struct device_priv *)handle->dev->os_priv;
388         struct usb_ctl_request req;
389
390         usbi_dbg("");
391
392         req.ucr_request.bmRequestType = UT_WRITE_ENDPOINT;
393         req.ucr_request.bRequest = UR_CLEAR_FEATURE;
394         USETW(req.ucr_request.wValue, UF_ENDPOINT_HALT);
395         USETW(req.ucr_request.wIndex, endpoint);
396         USETW(req.ucr_request.wLength, 0);
397
398         if (ioctl(dpriv->fd, USB_DO_REQUEST, &req) < 0)
399                 return _errno_to_libusb(errno);
400
401         return (LIBUSB_SUCCESS);
402 }
403
404 int
405 obsd_reset_device(struct libusb_device_handle *handle)
406 {
407         usbi_dbg("");
408
409         return (LIBUSB_ERROR_NOT_SUPPORTED);
410 }
411
412 void
413 obsd_destroy_device(struct libusb_device *dev)
414 {
415         struct device_priv *dpriv = (struct device_priv *)dev->os_priv;
416
417         usbi_dbg("");
418
419         free(dpriv->cdesc);
420 }
421
422 int
423 obsd_submit_transfer(struct usbi_transfer *itransfer)
424 {
425         struct libusb_transfer *transfer;
426         struct handle_priv *hpriv;
427         int err = 0;
428
429         usbi_dbg("");
430
431         transfer = USBI_TRANSFER_TO_LIBUSB_TRANSFER(itransfer);
432         hpriv = (struct handle_priv *)transfer->dev_handle->os_priv;
433
434         switch (transfer->type) {
435         case LIBUSB_TRANSFER_TYPE_CONTROL:
436                 err = _sync_control_transfer(itransfer);
437                 break;
438         case LIBUSB_TRANSFER_TYPE_ISOCHRONOUS:
439                 if (transfer->endpoint & LIBUSB_ENDPOINT_OUT) {
440                         /* Isochronous write is not supported */
441                         err = LIBUSB_ERROR_NOT_SUPPORTED;
442                         break;
443                 }
444                 /* PASSTHROUGH */
445         case LIBUSB_TRANSFER_TYPE_BULK:
446         case LIBUSB_TRANSFER_TYPE_INTERRUPT:
447                 err = _sync_gen_transfer(itransfer);
448                 break;
449         }
450
451         if (err)
452                 return (err);
453
454         if (write(hpriv->pipe[1], &itransfer, sizeof(itransfer)) < 0)
455                 return _errno_to_libusb(errno);
456
457         return (LIBUSB_SUCCESS);
458 }
459
460 int
461 obsd_cancel_transfer(struct usbi_transfer *itransfer)
462 {
463         usbi_dbg("");
464
465         return (LIBUSB_ERROR_NOT_SUPPORTED);
466 }
467
468 void
469 obsd_clear_transfer_priv(struct usbi_transfer *itransfer)
470 {
471         usbi_dbg("");
472
473         /* Nothing to do */
474 }
475
476 int
477 obsd_handle_events(struct libusb_context *ctx, struct pollfd *fds, nfds_t nfds,
478     int num_ready)
479 {
480         struct libusb_device_handle *handle;
481         struct handle_priv *hpriv;
482         struct usbi_transfer *itransfer;
483         struct pollfd *pollfd;
484         int i, err = 0;
485
486         usbi_dbg("");
487
488         pthread_mutex_lock(&ctx->open_devs_lock);
489         for (i = 0; i < nfds && num_ready > 0; i++) {
490                 pollfd = &fds[i];
491
492                 if (!pollfd->revents)
493                         continue;
494
495                 num_ready--;
496                 list_for_each_entry(handle, &ctx->open_devs, list,
497                     struct libusb_device_handle) {
498                         hpriv = (struct handle_priv *)handle->os_priv;
499
500                         if (hpriv->pipe[0] == pollfd->fd)
501                                 break;
502                 }
503
504                 if (pollfd->revents & POLLERR) {
505                         usbi_remove_pollfd(HANDLE_CTX(handle), hpriv->pipe[0]);
506                         usbi_handle_disconnect(handle);
507                         continue;
508                 }
509
510                 if (read(hpriv->pipe[0], &itransfer, sizeof(itransfer)) < 0) {
511                         err = errno;
512                         break;
513                 }
514
515                 if ((err = usbi_handle_transfer_completion(itransfer,
516                     LIBUSB_TRANSFER_COMPLETED)))
517                         break;
518         }
519         pthread_mutex_unlock(&ctx->open_devs_lock);
520
521         if (err)
522                 return _errno_to_libusb(err);
523
524         return (LIBUSB_SUCCESS);
525 }
526
527 int
528 obsd_clock_gettime(int clkid, struct timespec *tp)
529 {
530         usbi_dbg("clock %d", clkid);
531
532         if (clkid == USBI_CLOCK_REALTIME)
533                 return clock_gettime(CLOCK_REALTIME, tp);
534
535         if (clkid == USBI_CLOCK_MONOTONIC)
536                 return clock_gettime(CLOCK_MONOTONIC, tp);
537
538         return (LIBUSB_ERROR_INVALID_PARAM);
539 }
540
541 int
542 _errno_to_libusb(int err)
543 {
544         switch (err) {
545         case EIO:
546                 return (LIBUSB_ERROR_IO);
547         case EACCES:
548                 return (LIBUSB_ERROR_ACCESS);
549         case ENOENT:
550                 return (LIBUSB_ERROR_NO_DEVICE);
551         case ENOMEM:
552                 return (LIBUSB_ERROR_NO_MEM);
553         }
554
555         usbi_dbg("error: %s", strerror(err));
556
557         return (LIBUSB_ERROR_OTHER);
558 }
559
560 int
561 _cache_active_config_descriptor(struct libusb_device *dev, int fd)
562 {
563         struct device_priv *dpriv = (struct device_priv *)dev->os_priv;
564         struct usb_config_desc ucd;
565         struct usb_full_desc ufd;
566         unsigned char* buf;
567         int len;
568
569         usbi_dbg("fd %d", fd);
570
571         ucd.ucd_config_index = USB_CURRENT_CONFIG_INDEX;
572
573         if ((ioctl(fd, USB_GET_CONFIG_DESC, &ucd)) < 0)
574                 return _errno_to_libusb(errno);
575
576         usbi_dbg("active bLength %d", ucd.ucd_desc.bLength);
577
578         len = UGETW(ucd.ucd_desc.wTotalLength);
579         buf = malloc(len);
580         if (buf == NULL)
581                 return (LIBUSB_ERROR_NO_MEM);
582
583         ufd.ufd_config_index = ucd.ucd_config_index;
584         ufd.ufd_size = len;
585         ufd.ufd_data = buf;
586
587         usbi_dbg("index %d, len %d", ufd.ufd_config_index, len);
588
589         if ((ioctl(fd, USB_GET_FULL_DESC, &ufd)) < 0) {
590                 free(buf);
591                 return _errno_to_libusb(errno);
592         }
593
594         if (dpriv->cdesc)
595                 free(dpriv->cdesc);
596         dpriv->cdesc = buf;
597
598         return (0);
599 }
600
601 int
602 _sync_control_transfer(struct usbi_transfer *itransfer)
603 {
604         struct libusb_transfer *transfer;
605         struct libusb_control_setup *setup;
606         struct device_priv *dpriv;
607         struct usb_ctl_request req;
608
609         transfer = USBI_TRANSFER_TO_LIBUSB_TRANSFER(itransfer);
610         dpriv = (struct device_priv *)transfer->dev_handle->dev->os_priv;
611         setup = (struct libusb_control_setup *)transfer->buffer;
612
613         usbi_dbg("type %d request %d value %d index %d length %d timeout %d",
614             setup->bmRequestType, setup->bRequest,
615             libusb_le16_to_cpu(setup->wValue),
616             libusb_le16_to_cpu(setup->wIndex),
617             libusb_le16_to_cpu(setup->wLength), transfer->timeout);
618
619         req.ucr_request.bmRequestType = setup->bmRequestType;
620         req.ucr_request.bRequest = setup->bRequest;
621         /* Don't use USETW, libusb already deals with the endianness */
622         (*(uint16_t *)req.ucr_request.wValue) = setup->wValue;
623         (*(uint16_t *)req.ucr_request.wIndex) = setup->wIndex;
624         (*(uint16_t *)req.ucr_request.wLength) = setup->wLength;
625         req.ucr_data = transfer->buffer + LIBUSB_CONTROL_SETUP_SIZE;
626
627         if ((transfer->flags & LIBUSB_TRANSFER_SHORT_NOT_OK) == 0)
628                 req.ucr_flags = USBD_SHORT_XFER_OK;
629
630         if ((ioctl(dpriv->fd, USB_SET_TIMEOUT, &transfer->timeout)) < 0)
631                 return _errno_to_libusb(errno);
632
633         if ((ioctl(dpriv->fd, USB_DO_REQUEST, &req)) < 0)
634                 return _errno_to_libusb(errno);
635
636         itransfer->transferred = req.ucr_actlen;
637
638         usbi_dbg("transferred %d", itransfer->transferred);
639
640         return (0);
641 }
642
643 int
644 _access_endpoint(struct libusb_transfer *transfer)
645 {
646         struct handle_priv *hpriv;
647         struct device_priv *dpriv;
648         char *s, devnode[16];
649         int fd, endpt;
650         mode_t mode;
651
652         hpriv = (struct handle_priv *)transfer->dev_handle->os_priv;
653         dpriv = (struct device_priv *)transfer->dev_handle->dev->os_priv;
654
655         endpt = UE_GET_ADDR(transfer->endpoint);
656         mode = (transfer->endpoint & LIBUSB_ENDPOINT_IN) ? O_RDONLY : O_WRONLY;
657
658         usbi_dbg("endpoint %d mode %d", endpt, mode);
659
660         if (hpriv->endpoints[endpt] < 0) {
661                 /* Pick the right node given the control one */
662                 strlcpy(devnode, dpriv->devnode, sizeof(devnode));
663                 s = strchr(devnode, '.');
664                 snprintf(s, 4, ".%02d", endpt);
665
666                 /* We may need to read/write to the same endpoint later. */
667                 if (((fd = open(devnode, O_RDWR)) < 0) && (errno == ENXIO))
668                         if ((fd = open(devnode, mode)) < 0)
669                                 return (-1);
670
671                 hpriv->endpoints[endpt] = fd;
672         }
673
674         return (hpriv->endpoints[endpt]);
675 }
676
677 int
678 _sync_gen_transfer(struct usbi_transfer *itransfer)
679 {
680         struct libusb_transfer *transfer;
681         int fd, nr = 1;
682
683         transfer = USBI_TRANSFER_TO_LIBUSB_TRANSFER(itransfer);
684
685         /*
686          * Bulk, Interrupt or Isochronous transfer depends on the
687          * endpoint and thus the node to open.
688          */
689         if ((fd = _access_endpoint(transfer)) < 0)
690                 return _errno_to_libusb(errno);
691
692         if ((ioctl(fd, USB_SET_TIMEOUT, &transfer->timeout)) < 0)
693                 return _errno_to_libusb(errno);
694
695         if (transfer->endpoint & LIBUSB_ENDPOINT_IN) {
696                 if ((transfer->flags & LIBUSB_TRANSFER_SHORT_NOT_OK) == 0)
697                         if ((ioctl(fd, USB_SET_SHORT_XFER, &nr)) < 0)
698                                 return _errno_to_libusb(errno);
699
700                 nr = read(fd, transfer->buffer, transfer->length);
701         } else {
702                 nr = write(fd, transfer->buffer, transfer->length);
703         }
704
705         if (nr < 0)
706                 return _errno_to_libusb(errno);
707
708         itransfer->transferred = nr;
709
710         return (0);
711 }