usb/150546: libusb(3) libusb_control_transfer() prototype is incorrect

[Robert Jenssen]

>Number:         150546
>Category:       usb
>Synopsis:       libusb(3) libusb_control_transfer() prototype is incorrect
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-usb
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Sep 14 01:00:03 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Robert Jenssen
>Release:        8-Stable
>Organization:
IPS radio and space services
>Environment:
FreeBSD xxxx 8.1-STABLE FreeBSD 8.1-STABLE #0: Thu Sep  9 09:41:10 EST 2010 root at xxxx:/usr/obj/usr/src/sys/ECLIPSE i386
>Description:
In the libusb(3) man page the prototype of libusb_control_transfer is:

int libusb_control_transfer(libusb_device_handle *devh, uint8_t
     bmRequestType, uint16_t wIndex, unsigned char *data, uint16_t wLength,
     unsigned int timeout)

In /usr/include/libusb.h the prototype of libusb_control_transfer is:

int	libusb_control_transfer(libusb_device_handle * devh, uint8_t bmRequestType, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, uint8_t *data, uint16_t wLength, uint32_t timeout);
>How-To-Repeat:

>Fix:
diff -C 3 libusb.3.orig libusb.3
*** libusb.3.orig	Tue Sep 14 10:48:23 2010
--- libusb.3	Tue Sep 14 10:48:51 2010
***************
*** 337,343 ****
  .
  .Pp
  .Ft int
! .Fn libusb_control_transfer "libusb_device_handle *devh" "uint8_t bmRequestType" "uint16_t wIndex" "unsigned char *data" "uint16_t wLength" "unsigned int timeout"
  Perform a USB control transfer. Returns 0 on success, LIBUSB_ERROR_TIMEOUT 
  if the transfer timeout, LIBUSB_ERROR_PIPE if the control request was not 
  supported, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected and 
--- 337,343 ----
  .
  .Pp
  .Ft int
! .Fn libusb_control_transfer "libusb_device_handle *devh" "uint8_t bmRequestType" "uint8_t bRequest" "uint16_t wValue" "uint16_t wIndex" "unsigned char *data" "uint16_t wLength" "unsigned int timeout"
  Perform a USB control transfer. Returns 0 on success, LIBUSB_ERROR_TIMEOUT 
  if the transfer timeout, LIBUSB_ERROR_PIPE if the control request was not 
  supported, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected and 

>Release-Note:
>Audit-Trail:
>Unformatted: