[PATCH] usb: core: Kconfig: Improve USB authorization mode help

From: niko . mauno
Date: Fri Feb 09 2024 - 09:32:47 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.

Signed-off-by: Niko Mauno <niko.mauno@xxxxxxxxxxx>
---
drivers/usb/core/Kconfig | 19 +++++++++++++++----
1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/drivers/usb/core/Kconfig b/drivers/usb/core/Kconfig
index f337aaea7604..4665df550d36 100644
--- a/drivers/usb/core/Kconfig
+++ b/drivers/usb/core/Kconfig
@@ -126,10 +126,21 @@ 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.
+
+ 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 the default value is too permissive but you are unsure which mode
to use, say 2.
--
2.39.2