Bug#730065: document new_id interface

[Bjørn Mork <bjorn@mork.no>]

Geert Stappers <stappers@stappers.nl> writes:

> Package: debian-kernel-handbook
> Version: 1.0.15
> Severity: wishlist
>
> Op 2013-11-17 om 12:28 schreef Bastian Blank:
>> 
>> <snip/>  Also you want to use new_id interface[1] if possible.
>> 
>> Bastian
>> 
>> [1]: /sys/class/usb/drivers/*/new_id
>>      http://www.ha19.no/usb/
>
> Adding that URL to the kernel-handbook would be an improvement.
>
> Now filed as a separate bugreport.

well, you should note that this interface will not necessarily work for
all drivers despite being available.  If you take a look at the
sunplus.c file for example, you'll notice that the struct usb_device_id
table sets the .driver_info field.  This field will be 0 for dynamically
added device IDs.  Whether or not the driver does anything useful in
this case depends on how the driver probe is written.

But other than that, I am fully in favour of documenting the new_id
interface, preferably with a note to contact the upstream driver
maintainer with information about the devices you add.  Or maybe a
wishlist bug if the new_id interface is there but unsupported.



Bjørn