[PATCH v3 21/31] driver core: Accept device trust policy on the kernel command line
From: Leon Romanovsky
Date: Wed Nov 18 2026 - 14:32:46 EST
From: Leon Romanovsky <leonro@xxxxxxxxxx>
Blocking devices until initrd attestation also blocks the hardware needed
to reach the initrd and perform that attestation. A global policy alone
cannot allow those dependencies while keeping other devices blocked.
Allow boot policy exceptions for specific bus devices before probing,
including devices discovered later. Keep unmatched devices blocked unless
the administrator explicitly chooses another default. This makes the
exceptions usable with built-in drivers and avoids depending on userspace
winning a race against early probing.
Signed-off-by: Leon Romanovsky <leonro@xxxxxxxxxx>
---
Documentation/ABI/testing/sysfs-devices-trust | 2 +
Documentation/admin-guide/kernel-parameters.txt | 13 ++-
drivers/base/base.h | 8 ++
drivers/base/trust.c | 116 +++++++++++++++++++++++-
include/linux/device/trust.h | 1 +
5 files changed, 133 insertions(+), 7 deletions(-)
diff --git a/Documentation/ABI/testing/sysfs-devices-trust b/Documentation/ABI/testing/sysfs-devices-trust
index 154c5577c65e0..130e5b0d712c2 100644
--- a/Documentation/ABI/testing/sysfs-devices-trust
+++ b/Documentation/ABI/testing/sysfs-devices-trust
@@ -15,6 +15,8 @@ Description:
value may be selected by the bus before the device is
registered; otherwise it is "default". The policy is resolved
to an active trust level before the device is probed.
+ A matching device_trust= kernel command-line entry overrides
+ the initial requested policy before registration.
Changes through this attribute require an explicit device
trust boot option. Any such option selects an implicit
diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
index 81f98655f5297..e77ce08ac8f79 100644
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -1262,9 +1262,18 @@ Kernel parameters
device_trust [KNL]
Enable device trust with blocked as the implicit default.
+ device_trust= [KNL]
+ Set initial device trust policy before probing, including
+ for devices added after boot.
+ Format: <bus>:<device>=<policy>[,...]
+ Names match exactly as in /sys/bus/<bus>/devices/<device>.
+ Policies are default, blocked, adversary, and unrestricted.
+ Entries override bus policy and device_trust.default.
+ See Documentation/driver-api/driver-model/device-trust.rst.
+
device_trust.default=
- [KNL] Set initial trust policy for all devices, including
- hotplugged devices.
+ [KNL] Set initial trust policy for devices without a
+ matching device_trust= entry, including hotplugged devices.
Format: { default | blocked | adversary | unrestricted }
No trust options selects legacy unrestricted mode, preserving
bus policy and existing authorization. Otherwise blocked is the
diff --git a/drivers/base/base.h b/drivers/base/base.h
index 1e7ee9856fe6f..e8c24d02a5390 100644
--- a/drivers/base/base.h
+++ b/drivers/base/base.h
@@ -197,6 +197,14 @@ int device_private_init(struct device *dev);
extern const struct attribute_group device_trust_attr_group;
+#if IS_ENABLED(CONFIG_KUNIT)
+int device_trust_parse_cmdline(const char *options, const struct device *dev,
+ enum device_trust_policy *policy);
+void device_trust_apply_boot_policy(struct device *dev,
+ enum device_trust_policy policy,
+ const char *options);
+#endif
+
/* Unrestricted-only manual attachment uses the caller's subsystem serialization. */
void device_trust_init_state(struct device *dev);
int device_trust_prepare_unrestricted(struct device *dev,
diff --git a/drivers/base/trust.c b/drivers/base/trust.c
index 215ea6151ecfc..8211a869fc82e 100644
--- a/drivers/base/trust.c
+++ b/drivers/base/trust.c
@@ -1,11 +1,13 @@
// SPDX-License-Identifier: GPL-2.0
+#include <linux/ctype.h>
#include <linux/device.h>
#include <linux/errno.h>
#include <linux/export.h>
#include <linux/init.h>
#include <linux/string.h>
#include <linux/sysfs.h>
+#include <kunit/visibility.h>
#include "base.h"
@@ -13,6 +15,17 @@ static enum device_trust_policy device_trust_default_policy __ro_after_init =
DEVICE_TRUST_POLICY_UNRESTRICTED;
static bool device_trust_configured __ro_after_init;
+/**
+ * device_trust_enabled - Test whether boot options enabled device trust
+ *
+ * Return: True if any device trust option was supplied at boot.
+ */
+bool device_trust_enabled(void)
+{
+ return device_trust_configured;
+}
+EXPORT_SYMBOL_GPL(device_trust_enabled);
+
static void __init device_trust_configure(void)
{
if (device_trust_configured)
@@ -284,6 +297,88 @@ static struct attribute *device_trust_attrs[] = {
const struct attribute_group device_trust_attr_group = {
.attrs = device_trust_attrs,
};
+
+static const char *device_trust_cmdline __ro_after_init;
+
+static int device_trust_parse_policy(const char *options, const char *target_bus,
+ const char *target_name,
+ enum device_trust_policy *policy)
+{
+ enum device_trust_policy selected = DEVICE_TRUST_POLICY_DEFAULT;
+ const char *entry = options;
+ bool matched = false;
+
+ if (!*entry)
+ return -EINVAL;
+
+ for (;;) {
+ const char *end = entry + strcspn(entry, ",");
+ const char *bus_end, *name, *level, *p;
+ unsigned int i;
+
+ bus_end = memchr(entry, ':', end - entry);
+ if (!bus_end || bus_end == entry ||
+ memchr(entry, '=', bus_end - entry))
+ return -EINVAL;
+ name = bus_end + 1;
+ level = memchr(name, '=', end - name);
+ if (!level || level == name || level + 1 == end)
+ return -EINVAL;
+
+ for (p = entry; p < end; p++)
+ if (isspace(*p) || iscntrl(*p) || *p == '"')
+ return -EINVAL;
+
+ for (i = 0; i < ARRAY_SIZE(device_trust_policy_names); i++)
+ if (strlen(device_trust_policy_names[i]) == end - level - 1 &&
+ !strncmp(level + 1, device_trust_policy_names[i],
+ end - level - 1))
+ break;
+ if (i == ARRAY_SIZE(device_trust_policy_names))
+ return -EINVAL;
+
+ if (target_bus && target_name &&
+ strlen(target_bus) == bus_end - entry &&
+ !strncmp(target_bus, entry, bus_end - entry) &&
+ strlen(target_name) == level - name &&
+ !strncmp(target_name, name, level - name)) {
+ selected = i;
+ matched = true;
+ }
+
+ if (!*end)
+ break;
+ entry = end + 1;
+ }
+
+ if (matched && policy)
+ *policy = selected;
+ return matched;
+}
+
+VISIBLE_IF_KUNIT int device_trust_parse_cmdline(const char *options,
+ const struct device *dev,
+ enum device_trust_policy *policy)
+{
+ return device_trust_parse_policy(options, dev && dev->bus ? dev->bus->name : NULL,
+ dev ? dev_name(dev) : NULL, policy);
+}
+EXPORT_SYMBOL_IF_KUNIT(device_trust_parse_cmdline);
+
+static int __init device_trust_setup(char *str)
+{
+ device_trust_configure();
+ if (device_trust_parse_cmdline(str, NULL, NULL) < 0) {
+ pr_warn("device_trust: ignoring invalid policy list '%s'\n", str);
+ return 1;
+ }
+
+ /* The command-line buffer survives init. */
+ device_trust_cmdline = str;
+ return 1;
+}
+__setup("device_trust=", device_trust_setup);
+
static int __init device_trust_default_setup(char *str)
{
int policy = match_string(device_trust_policy_names,
@@ -300,17 +395,28 @@ static int __init device_trust_default_setup(char *str)
}
__setup("device_trust.default=", device_trust_default_setup);
+VISIBLE_IF_KUNIT void device_trust_apply_boot_policy(struct device *dev,
+ enum device_trust_policy policy,
+ const char *options)
+{
+ if (policy != DEVICE_TRUST_POLICY_DEFAULT)
+ dev->trust_policy = policy;
+ if (options)
+ device_trust_parse_cmdline(options, dev, &dev->trust_policy);
+}
+EXPORT_SYMBOL_IF_KUNIT(device_trust_apply_boot_policy);
+
/**
- * device_trust_init - Apply global boot policy before registration
- * @dev: unregistered device with its initial policy set
+ * device_trust_init - Apply boot policy before registration or bus policy use
+ * @dev: unregistered device with its bus, name, and default policy set
*/
void device_trust_init(struct device *dev)
{
if (dev->trust_committed_level != DEVICE_TRUST_BLOCKED)
return;
- if (device_trust_configured &&
- device_trust_default_policy != DEVICE_TRUST_POLICY_DEFAULT)
- dev->trust_policy = device_trust_default_policy;
+ if (device_trust_configured)
+ device_trust_apply_boot_policy(dev, device_trust_default_policy,
+ device_trust_cmdline);
}
EXPORT_SYMBOL_GPL(device_trust_init);
diff --git a/include/linux/device/trust.h b/include/linux/device/trust.h
index b940dddf10e46..0258e07f938d1 100644
--- a/include/linux/device/trust.h
+++ b/include/linux/device/trust.h
@@ -40,6 +40,7 @@ enum device_trust_policy {
DEVICE_TRUST_POLICY_UNRESTRICTED,
};
+bool device_trust_enabled(void);
void device_trust_init(struct device *dev);
int device_trust_prepare(struct device *dev, const struct device_driver *drv);
void device_trust_clear(struct device *dev);
--
2.56.1