[PATCH v2] usb: core: Kconfig: Improve USB authorization mode help
From: niko . mauno
Date: Tue Feb 13 2024 - 07:46:27 EST
From: Niko Mauno <niko.mauno@xxxxxxxxxxx>
Update the default USB device authorization mode help text so that the
meaning of the option and it's available values are described more
accurately.
Reported-by: Geert Uytterhoeven <geert@xxxxxxxxxxxxxx>
Closes: https://lore.kernel.org/linux-usb/CAMuHMdUy793gzDVR0jfNnx5TUdJ_2MKH5NPGSgHkytAhArtqmw@xxxxxxxxxxxxxx/
Signed-off-by: Niko Mauno <niko.mauno@xxxxxxxxxxx>
---
drivers/usb/core/Kconfig | 22 ++++++++++++++++------
1 file changed, 16 insertions(+), 6 deletions(-)
diff --git a/drivers/usb/core/Kconfig b/drivers/usb/core/Kconfig
index f337aaea7604..58e3ca7e4793 100644
--- a/drivers/usb/core/Kconfig
+++ b/drivers/usb/core/Kconfig
@@ -126,10 +126,20 @@ config USB_DEFAULT_AUTHORIZATION_MODE
Select the default USB device authorization mode. Can be overridden
with usbcore.authorized_default command line or module parameter.
- The available values have the following meanings:
- 0 is unauthorized for all devices
- 1 is authorized for all devices (default)
- 2 is authorized for internal devices
+ This option allows you to choose whether USB devices that are
+ connected to the system can be used by default, or if they are
+ locked down.
- If the default value is too permissive but you are unsure which mode
- to use, say 2.
+ With value 0 all connected USB devices with the exception of root
+ hub require user space authorization before they can be used.
+
+ With value 1 (default) no user space authorization is required to
+ use connected USB devices.
+
+ With value 2 all connected USB devices with exception of internal
+ USB devices require user space authorization before they can be
+ used. Note that in this mode the differentiation between internal
+ and external USB devices relies on ACPI, and on systems without
+ ACPI selecting value 2 is analogous to selecting value 0.
+
+ If unsure, keep the default value.
--
2.39.2