Re: USB4BSD - release candidate 2 - coming to FreeBSD this week.

Alfred Perlstein wrote:
> Guys, I'm planning on giving integration of Han's MPSAFE
> and fast usb stack this coming week.
>
> Code is referenced in the below message.
>
> Please give feedback now so that I can be prepared.
>
> ----- Forwarded message from Hans Petter Selasky <hselasky_at_c2i.net> -----
>
> From: Hans Petter Selasky <hselasky_at_c2i.net>
> To: Alfred Perlstein <alfred_at_freebsd.org>
> Cc: Andrew Thompson <thompsa_at_freebsd.org>
> Subject: Re: USB4BSD - release candidate 2
> Date: Sun, 28 Sep 2008 22:23:01 +0200
> Message-Id: <200809282223.02055.hselasky_at_c2i.net>
> User-Agent: KMail/1.9.7
>
> NOTE: The following file has been deleted:
>
> src/sys/dev/usb2/controller/uss820dci_pccard.c
>
> And the patch for the kernel config file is different.
>
> --HPS
>
> %md5 usb2_release_002.*
> MD5 (usb2_release_002.diff) = 0209262b6df3a1e2aecac1c4fd553c41
> MD5 (usb2_release_002.tar.gz) = a8f9dd0ce9e3191d6446dc07c2151432
> %sha256 usb2_release_002.*
> SHA256 (usb2_release_002.diff) = 
> 5d5d0c8ea2a4cf1ea631bd45082b56da1bf12cfc85b6e613bf881dca3949111b
> SHA256 (usb2_release_002.tar.gz) = 
> 6d9001f4baf56e6a85c4e147de24b6c7d00c052e3840088b93a53ef4e4c92fb9
> %
>
> http://www.selasky.org/hans_petter/usb4bsd/for_review
>
> --HPS
>
> ----- End forwarded message -----
>
>   

1. libusb_20 appears to be undocumented (the manual page looks to be a 
placeholder) and the only example of use (usbconfig) has zero comments.

2. is there any way to list the set of quirks in the usb2_quirk module?  
I don't think going back to the source is sufficient as you may only 
have a binary to work with.

3. similarly for the driver container modules can one see the set of 
drivers bundled?

4. I'm interested to understand why these container modules exist 
instead of individual drivers.  I don't see anything in the manual pages 
that references the drivers, can one still configure a kernel w/ only 
the specific drivers present on a system? (e.g. for embedded use)  If so 
please fix the manual pages.

5. The man page description of the usb2_template module is unclear to 
me.  I suspect an example would help.

6. Many files lack a copyright/license (e.g. modules/*).

    Sam