Received-SPF: pass (google.com: domain of linux-kernel+bounces-63535-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1;
From: niko.mauno@vaisala.com
To: gregkh@linuxfoundation.org
Cc: linux-usb@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	vesa.jaaskelainen@vaisala.com,
	geert@linux-m68k.org,
	Niko Mauno <niko.mauno@vaisala.com>
Subject: [PATCH v2] usb: core: Kconfig: Improve USB authorization mode help
Date: Tue, 13 Feb 2024 14:45:18 +0200
Message-Id: <20240213124518.20231-1-niko.mauno@vaisala.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?z9v/U/bvvkTqi+Seqwqw99m1hrUtlUduz72G7g1UuoDVUH9Nv1ESPk1pBo3q?=
 =?us-ascii?Q?SMtuv/WeX3hIx5OBB+LboloIYsFcnql7VHnab63OUzxzRC1LUKNlH0PZxHm8?=
 =?us-ascii?Q?dUhnzESdkO+Phd9N2U+kbr5Te2+n4AtS8AXlRBbpD7ztYLYQ0Q3vUdbwOkGG?=
 =?us-ascii?Q?ttJReMfELMCOUAGKr0pI0UDqSrxK0oAAJ5cYL6UHsZ4nZoKv9Dquwn+ElQ72?=
 =?us-ascii?Q?w6POEuZJq7yx8gj9A44g7C2KOJkM5gR0zlxejIJJW5qEh6jsCf5AGbYAfKQ5?=
 =?us-ascii?Q?z8vd0esg9SeUKt8gfoDlfRuG8jIJ2cbZsA6I80YJA38+VTw1CXJCW1wTbWSZ?=
 =?us-ascii?Q?9b3o8+qUYcgmJ3YdZ/ddCJFTFoOlu06DMVPwhoGe2KAADp00ZLHcCg4xLSyj?=
 =?us-ascii?Q?D/sJ7btfyGss4q9dX23hUm8hw7ssIhTFChvswvAMBbxULJNeTuTlHJWii7qZ?=
 =?us-ascii?Q?i/thFy8Tlzd+z6eaONSzNeXriAJrHI6nm0GLOhZkpcVcOXTriDRnD3HVR+aJ?=
 =?us-ascii?Q?MgyfFBuV9CUE2yjW9Jueam+SRGe+s1Sw2w+Yxp0BBrjaZe3/MO+dT9SJFXO7?=
 =?us-ascii?Q?fzZi+5yC3OQdP3YgiiGSCT5kNzjVD3mbzzQYoqSghrEbQvV0oygP9d0ZtIAo?=
 =?us-ascii?Q?U9Kh70qPGaxrS69+kgkBpVJZW5mQ813Vt98IMaWOV8hvF7HaHCXH51RyvjO3?=
 =?us-ascii?Q?1uG5Ogf95/wa+q956K0lTDqTcucJxFBfYr/NsfNCP6G0g2vTgwIUCKwsuGvI?=
 =?us-ascii?Q?fux5+Pzjx8WkAx28U6vl9lNSJUUSaf3PN3515GbEJZs+r/ZktdbDxL4mG9MX?=
 =?us-ascii?Q?fcM3Plnql9AseqLxtn6zMe9nCHvCXyUuEttULR5CsSdp9IwwGvGER/pKhz0c?=
 =?us-ascii?Q?zshmQZKX9qgOtpqxRZnk1bsZjOvHzL98SbRtbnnutZhFYcjJBZrq0WY8XKjC?=
 =?us-ascii?Q?mFLruAOJsmHjk6GKDoytpyh0s0Vnp47DWxpy82N6L8rVqXw2c12XTnVGpkl+?=
 =?us-ascii?Q?0Fv9UbWaSmHTbhrTMCTO4yh+as0O32ZvDBAa01/0k9ZoZ0OseCvgRwJ7ErOX?=
 =?us-ascii?Q?SFv7ztItZ7/3mlzzPUoLDDTQe6NcW0inw26jooIkqO/aiudRyVpTX2Wq+pYv?=
 =?us-ascii?Q?ZuR7MTbCh3In2obySWyoTenKCqg5sJx6WfVhu2+fBWS0vfAnnk3D9EMeEmA4?=
 =?us-ascii?Q?m+EZDupJNSUF9Nu+QJn6cIG5OpyQF1FtKQgoqhAmEjmvwF9UiNW7sn0AuFB5?=
 =?us-ascii?Q?JdRlxIa0KVW48hR4Bj5g54FebqN9Ffcio5eDf/WWx1LnLWuRCGmm8R/WsPg6?=
 =?us-ascii?Q?rYbCaBCh+H4n4/72ns2O0RvuWBMMF6NHm7Dz2EGtxRikPGWXbSKq4PcNqEoB?=
 =?us-ascii?Q?AW927bNZwTSXfOMhfvC843nmDV3di3ZmXGVG9pG2io9JAo33nye5QbvXOPvf?=
 =?us-ascii?Q?u1LzYoJXfjopDkirEaH+xryMAgpzZwKLSD7mC/nOYL/nnd2JXbH0YZZlxX92?=
 =?us-ascii?Q?e2eKDg9j1qjUi9ITGksVCt1fCAtGro1TiyV4JV2Zua8yS0V+RQ/a6Ra3Lv5w?=
 =?us-ascii?Q?jRlBDNyYGfSyim5rpx+nB8zYoRQt9KeMfds7idJMGkGHFmtModfd2itPRSK+?=
 =?us-ascii?Q?aw=3D=3D?=
X-OriginatorOrg: vaisala.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 454384b3-4b54-48e4-7375-08dc2c91b304
X-MS-Exchange-CrossTenant-AuthSource: AS4PR06MB8447.eurprd06.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Feb 2024 12:45:46.6079
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 6d7393e0-41f5-4c2e-9b12-4c2be5da5c57
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: YuLX7Px8F+hTE+ifJos/7Cxm6X1eLUDYQcqLqHo+P1d354wHI64P/Mef4/Wz1PtYjsWabLy9CTreDwTgoRESVQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR06MB8330

From: Niko Mauno <niko.mauno@vaisala.com>

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@linux-m68k.org>
Closes: https://lore.kernel.org/linux-usb/CAMuHMdUy793gzDVR0jfNnx5TUdJ_2MKH5NPGSgHkytAhArtqmw@mail.gmail.com/
Signed-off-by: Niko Mauno <niko.mauno@vaisala.com>
---
 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