diff mbox series

[v3,4/4] usbcore/driver: Accommodate usbip

Message ID 20200922110703.720960-5-m.v.b@runbox.com
State New
Headers show
Series Fixes for usbip and specialised USB driver selection | expand

Commit Message

M. Vefa Bicakci Sept. 22, 2020, 11:07 a.m. UTC
Commit 88b7381a939d ("USB: Select better matching USB drivers when
available") inadvertently broke usbip functionality. The commit in
question allows USB device drivers to be explicitly matched with
USB devices via the use of driver-provided identifier tables and
match functions, which is useful for a specialised device driver
to be chosen for a device that can also be handled by another,
more generic, device driver.

Prior, the USB device section of usb_device_match() had an
unconditional "return 1" statement, which allowed user-space to bind
USB devices to the usbip_host device driver, if desired. However,
the aforementioned commit changed the default/fallback return
value to zero. This breaks device drivers such as usbip_host, so
this commit restores the legacy behaviour, but only if a device
driver does not have an id_table and a match() function.

In addition, if usb_device_match is called for a device driver
and device pair where the device does not match the id_table of the
device driver in question, then the device driver will be disqualified
for the device. This allows avoiding the default case of "return 1",
which prevents undesirable probe() calls to a driver even though
its id_table did not match the device.

Finally, this commit changes the specialised-driver-to-generic-driver
transition code so that when a device driver returns -ENODEV, a more
generic device driver is only considered if the current device driver
does not have an id_table and a match() function. This ensures that
"generic" drivers such as usbip_host will not be considered specialised
device drivers and will not cause the device to be locked in to the
generic device driver, when a more specialised device driver could be
tried.

All of these changes restore usbip functionality without regressions,
ensure that the specialised/generic device driver selection logic works
as expected with the usb and apple-mfi-fastcharge drivers, and do not
negatively affect the use of devices provided by dummy_hcd.

Fixes: 88b7381a939d ("USB: Select better matching USB drivers when available")
Link: https://lore.kernel.org/linux-usb/CAAeHK+zOrHnxjRFs=OE8T=O9208B9HP_oo8RZpyVOZ9AJ54pAA@mail.gmail.com/
Cc: <stable@vger.kernel.org> # 5.8
Cc: Bastien Nocera <hadess@hadess.net>
Cc: Valentina Manea <valentina.manea.m@gmail.com>
Cc: Shuah Khan <shuah@kernel.org>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Alan Stern <stern@rowland.harvard.edu>
Cc: <syzkaller@googlegroups.com>
Signed-off-by: M. Vefa Bicakci <m.v.b@runbox.com>

---
v3: New patch in this patch set.
    For reviewers' awareness, another option for usb_device_match would
    be as follows. This allows the driver's match() function to act
    as a fallback in case the driver has an id_table, but the id_table
    does not include the device.

	if (!udrv->id_table && !udrv->match) {
		/* Allow usbip and similar drivers to bind to
		 * arbitrary devices; let their probe functions
		 * decide.
		 */
		return 1;
	}

	if (udrv->id_table &&
	    usb_device_match_id(udev, udrv->id_table) != NULL)
		return 1;

	if (udrv->match && udrv->match(udev))
		return 1;

	return 0;
---
 drivers/usb/core/driver.c | 37 +++++++++++++++++++++++++++++++------
 1 file changed, 31 insertions(+), 6 deletions(-)

Comments

Shuah Khan Sept. 22, 2020, 11:04 p.m. UTC | #1
On 9/22/20 5:07 AM, M. Vefa Bicakci wrote:
> Commit 88b7381a939d ("USB: Select better matching USB drivers when

> available") inadvertently broke usbip functionality. The commit in

> question allows USB device drivers to be explicitly matched with

> USB devices via the use of driver-provided identifier tables and

> match functions, which is useful for a specialised device driver

> to be chosen for a device that can also be handled by another,

> more generic, device driver.

> 

> Prior, the USB device section of usb_device_match() had an

> unconditional "return 1" statement, which allowed user-space to bind

> USB devices to the usbip_host device driver, if desired. However,

> the aforementioned commit changed the default/fallback return

> value to zero. This breaks device drivers such as usbip_host, so

> this commit restores the legacy behaviour, but only if a device

> driver does not have an id_table and a match() function.

> 

> In addition, if usb_device_match is called for a device driver

> and device pair where the device does not match the id_table of the

> device driver in question, then the device driver will be disqualified

> for the device. This allows avoiding the default case of "return 1",

> which prevents undesirable probe() calls to a driver even though

> its id_table did not match the device.

> 

> Finally, this commit changes the specialised-driver-to-generic-driver

> transition code so that when a device driver returns -ENODEV, a more

> generic device driver is only considered if the current device driver

> does not have an id_table and a match() function. This ensures that

> "generic" drivers such as usbip_host will not be considered specialised

> device drivers and will not cause the device to be locked in to the

> generic device driver, when a more specialised device driver could be

> tried.

> 

> All of these changes restore usbip functionality without regressions,

> ensure that the specialised/generic device driver selection logic works

> as expected with the usb and apple-mfi-fastcharge drivers, and do not

> negatively affect the use of devices provided by dummy_hcd.

> 

> Fixes: 88b7381a939d ("USB: Select better matching USB drivers when available")

> Link: https://lore.kernel.org/linux-usb/CAAeHK+zOrHnxjRFs=OE8T=O9208B9HP_oo8RZpyVOZ9AJ54pAA@mail.gmail.com/

> Cc: <stable@vger.kernel.org> # 5.8

> Cc: Bastien Nocera <hadess@hadess.net>

> Cc: Valentina Manea <valentina.manea.m@gmail.com>

> Cc: Shuah Khan <shuah@kernel.org>

> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

> Cc: Alan Stern <stern@rowland.harvard.edu>

> Cc: <syzkaller@googlegroups.com>

> Signed-off-by: M. Vefa Bicakci <m.v.b@runbox.com>

> 

> ---

> v3: New patch in this patch set.

>      For reviewers' awareness, another option for usb_device_match would

>      be as follows. This allows the driver's match() function to act

>      as a fallback in case the driver has an id_table, but the id_table

>      does not include the device.

> 

> 	if (!udrv->id_table && !udrv->match) {

> 		/* Allow usbip and similar drivers to bind to

> 		 * arbitrary devices; let their probe functions

> 		 * decide.

> 		 */

> 		return 1;

> 	}

> 

> 	if (udrv->id_table &&

> 	    usb_device_match_id(udev, udrv->id_table) != NULL)

> 		return 1;

> 

> 	if (udrv->match && udrv->match(udev))

> 		return 1;

> 

> 	return 0;

> ---

>   drivers/usb/core/driver.c | 37 +++++++++++++++++++++++++++++++------

>   1 file changed, 31 insertions(+), 6 deletions(-)

> 

> diff --git a/drivers/usb/core/driver.c b/drivers/usb/core/driver.c

> index 7d90cbe063ec..98b7449c11f3 100644

> --- a/drivers/usb/core/driver.c

> +++ b/drivers/usb/core/driver.c

> @@ -269,8 +269,30 @@ static int usb_probe_device(struct device *dev)

>   	if (error)

>   		return error;

>   

> +	/* Probe the USB device with the driver in hand, but only

> +	 * defer to a generic driver in case the current USB

> +	 * device driver has an id_table or a match function; i.e.,

> +	 * when the device driver was explicitly matched against

> +	 * a device.

> +	 *

> +	 * If the device driver does not have either of these,

> +	 * then we assume that it can bind to any device and is

> +	 * not truly a more specialized/non-generic driver, so a

> +	 * return value of -ENODEV should not force the device

> +	 * to be handled by the generic USB driver, as there

> +	 * can still be another, more specialized, device driver.

> +	 *

> +	 * This accommodates the usbip driver.

> +	 *

> +	 * TODO: What if, in the future, there are multiple

> +	 * specialized USB device drivers for a particular device?

> +	 * In such cases, there is a need to try all matching

> +	 * specialised device drivers prior to setting the

> +	 * use_generic_driver bit.

> +	 */

>   	error = udriver->probe(udev);

> -	if (error == -ENODEV && udriver != &usb_generic_driver) {

> +	if (error == -ENODEV && udriver != &usb_generic_driver &&

> +	    (udriver->id_table || udriver->match)) {

>   		udev->use_generic_driver = 1;

>   		return -EPROBE_DEFER;

>   	}

> @@ -831,14 +853,17 @@ static int usb_device_match(struct device *dev, struct device_driver *drv)

>   		udev = to_usb_device(dev);

>   		udrv = to_usb_device_driver(drv);

>   

> -		if (udrv->id_table &&

> -		    usb_device_match_id(udev, udrv->id_table) != NULL) {

> -			return 1;

> -		}

> +		if (udrv->id_table)

> +			return usb_device_match_id(udev, udrv->id_table) != NULL;

>   

>   		if (udrv->match)

>   			return udrv->match(udev);

> -		return 0;

> +

> +		/* If the device driver under consideration does not have a

> +		 * id_table or a match function, then let the driver's probe

> +		 * function decide.

> +		 */

> +		return 1;

>   

>   	} else if (is_usb_interface(dev)) {

>   		struct usb_interface *intf;

> 


Thank you for finding a solution that works for usbip case.

Acked-by: Shuah Khan <skhan@linuxfoundation.org>


thanks,
-- Shuah
M. Vefa Bicakci Sept. 23, 2020, 6:08 a.m. UTC | #2
On 23/09/2020 02.04, Shuah Khan wrote:
> On 9/22/20 5:07 AM, M. Vefa Bicakci wrote:

>> Commit 88b7381a939d ("USB: Select better matching USB drivers when

>> available") inadvertently broke usbip functionality. The commit in

>> question allows USB device drivers to be explicitly matched with

>> USB devices via the use of driver-provided identifier tables and

>> match functions, which is useful for a specialised device driver

>> to be chosen for a device that can also be handled by another,

>> more generic, device driver.

>>

>> Prior, the USB device section of usb_device_match() had an

>> unconditional "return 1" statement, which allowed user-space to bind

>> USB devices to the usbip_host device driver, if desired. However,

>> the aforementioned commit changed the default/fallback return

>> value to zero. This breaks device drivers such as usbip_host, so

>> this commit restores the legacy behaviour, but only if a device

>> driver does not have an id_table and a match() function.

>>

>> In addition, if usb_device_match is called for a device driver

>> and device pair where the device does not match the id_table of the

>> device driver in question, then the device driver will be disqualified

>> for the device. This allows avoiding the default case of "return 1",

>> which prevents undesirable probe() calls to a driver even though

>> its id_table did not match the device.

>>

>> Finally, this commit changes the specialised-driver-to-generic-driver

>> transition code so that when a device driver returns -ENODEV, a more

>> generic device driver is only considered if the current device driver

>> does not have an id_table and a match() function. This ensures that

>> "generic" drivers such as usbip_host will not be considered specialised

>> device drivers and will not cause the device to be locked in to the

>> generic device driver, when a more specialised device driver could be

>> tried.

>>

>> All of these changes restore usbip functionality without regressions,

>> ensure that the specialised/generic device driver selection logic works

>> as expected with the usb and apple-mfi-fastcharge drivers, and do not

>> negatively affect the use of devices provided by dummy_hcd.

>>

>> Fixes: 88b7381a939d ("USB: Select better matching USB drivers when available")

>> Link: https://lore.kernel.org/linux-usb/CAAeHK+zOrHnxjRFs=OE8T=O9208B9HP_oo8RZpyVOZ9AJ54pAA@mail.gmail.com/

>> Cc: <stable@vger.kernel.org> # 5.8

>> Cc: Bastien Nocera <hadess@hadess.net>

>> Cc: Valentina Manea <valentina.manea.m@gmail.com>

>> Cc: Shuah Khan <shuah@kernel.org>

>> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

>> Cc: Alan Stern <stern@rowland.harvard.edu>

>> Cc: <syzkaller@googlegroups.com>

>> Signed-off-by: M. Vefa Bicakci <m.v.b@runbox.com>

>>

>> ---

>> v3: New patch in this patch set.

>>      For reviewers' awareness, another option for usb_device_match would

>>      be as follows. This allows the driver's match() function to act

>>      as a fallback in case the driver has an id_table, but the id_table

>>      does not include the device.

>>

>>     if (!udrv->id_table && !udrv->match) {

>>         /* Allow usbip and similar drivers to bind to

>>          * arbitrary devices; let their probe functions

>>          * decide.

>>          */

>>         return 1;

>>     }

>>

>>     if (udrv->id_table &&

>>         usb_device_match_id(udev, udrv->id_table) != NULL)

>>         return 1;

>>

>>     if (udrv->match && udrv->match(udev))

>>         return 1;

>>

>>     return 0;

>> ---

>>   drivers/usb/core/driver.c | 37 +++++++++++++++++++++++++++++++------

>>   1 file changed, 31 insertions(+), 6 deletions(-)

>>

>> diff --git a/drivers/usb/core/driver.c b/drivers/usb/core/driver.c

>> index 7d90cbe063ec..98b7449c11f3 100644

>> --- a/drivers/usb/core/driver.c

>> +++ b/drivers/usb/core/driver.c

>> @@ -269,8 +269,30 @@ static int usb_probe_device(struct device *dev)

>>       if (error)

>>           return error;

>> +    /* Probe the USB device with the driver in hand, but only

>> +     * defer to a generic driver in case the current USB

>> +     * device driver has an id_table or a match function; i.e.,

>> +     * when the device driver was explicitly matched against

>> +     * a device.

>> +     *

>> +     * If the device driver does not have either of these,

>> +     * then we assume that it can bind to any device and is

>> +     * not truly a more specialized/non-generic driver, so a

>> +     * return value of -ENODEV should not force the device

>> +     * to be handled by the generic USB driver, as there

>> +     * can still be another, more specialized, device driver.

>> +     *

>> +     * This accommodates the usbip driver.

>> +     *

>> +     * TODO: What if, in the future, there are multiple

>> +     * specialized USB device drivers for a particular device?

>> +     * In such cases, there is a need to try all matching

>> +     * specialised device drivers prior to setting the

>> +     * use_generic_driver bit.

>> +     */

>>       error = udriver->probe(udev);

>> -    if (error == -ENODEV && udriver != &usb_generic_driver) {

>> +    if (error == -ENODEV && udriver != &usb_generic_driver &&

>> +        (udriver->id_table || udriver->match)) {

>>           udev->use_generic_driver = 1;

>>           return -EPROBE_DEFER;

>>       }

>> @@ -831,14 +853,17 @@ static int usb_device_match(struct device *dev, struct device_driver *drv)

>>           udev = to_usb_device(dev);

>>           udrv = to_usb_device_driver(drv);

>> -        if (udrv->id_table &&

>> -            usb_device_match_id(udev, udrv->id_table) != NULL) {

>> -            return 1;

>> -        }

>> +        if (udrv->id_table)

>> +            return usb_device_match_id(udev, udrv->id_table) != NULL;

>>           if (udrv->match)

>>               return udrv->match(udev);

>> -        return 0;

>> +

>> +        /* If the device driver under consideration does not have a

>> +         * id_table or a match function, then let the driver's probe

>> +         * function decide.

>> +         */

>> +        return 1;

>>       } else if (is_usb_interface(dev)) {

>>           struct usb_interface *intf;

>>

> 

> Thank you for finding a solution that works for usbip case.

> 

> Acked-by: Shuah Khan <skhan@linuxfoundation.org>

> 

> thanks,

> -- Shuah


Thank you for the feedback, Shuah!

Vefa
diff mbox series

Patch

diff --git a/drivers/usb/core/driver.c b/drivers/usb/core/driver.c
index 7d90cbe063ec..98b7449c11f3 100644
--- a/drivers/usb/core/driver.c
+++ b/drivers/usb/core/driver.c
@@ -269,8 +269,30 @@  static int usb_probe_device(struct device *dev)
 	if (error)
 		return error;
 
+	/* Probe the USB device with the driver in hand, but only
+	 * defer to a generic driver in case the current USB
+	 * device driver has an id_table or a match function; i.e.,
+	 * when the device driver was explicitly matched against
+	 * a device.
+	 *
+	 * If the device driver does not have either of these,
+	 * then we assume that it can bind to any device and is
+	 * not truly a more specialized/non-generic driver, so a
+	 * return value of -ENODEV should not force the device
+	 * to be handled by the generic USB driver, as there
+	 * can still be another, more specialized, device driver.
+	 *
+	 * This accommodates the usbip driver.
+	 *
+	 * TODO: What if, in the future, there are multiple
+	 * specialized USB device drivers for a particular device?
+	 * In such cases, there is a need to try all matching
+	 * specialised device drivers prior to setting the
+	 * use_generic_driver bit.
+	 */
 	error = udriver->probe(udev);
-	if (error == -ENODEV && udriver != &usb_generic_driver) {
+	if (error == -ENODEV && udriver != &usb_generic_driver &&
+	    (udriver->id_table || udriver->match)) {
 		udev->use_generic_driver = 1;
 		return -EPROBE_DEFER;
 	}
@@ -831,14 +853,17 @@  static int usb_device_match(struct device *dev, struct device_driver *drv)
 		udev = to_usb_device(dev);
 		udrv = to_usb_device_driver(drv);
 
-		if (udrv->id_table &&
-		    usb_device_match_id(udev, udrv->id_table) != NULL) {
-			return 1;
-		}
+		if (udrv->id_table)
+			return usb_device_match_id(udev, udrv->id_table) != NULL;
 
 		if (udrv->match)
 			return udrv->match(udev);
-		return 0;
+
+		/* If the device driver under consideration does not have a
+		 * id_table or a match function, then let the driver's probe
+		 * function decide.
+		 */
+		return 1;
 
 	} else if (is_usb_interface(dev)) {
 		struct usb_interface *intf;