DRTM needs to be able to set the locality used by kernel. Provide TPM_IOC_SET_LOCALITY operation for this purpose. It is enabled only if the kernel command-line has 'tpm.set_locality_enabled=1'. The operation is one-shot allowed only for tpm_tis for the moment. Signed-off-by: Jarkko Sakkinen <jarkko@xxxxxxxxxx> --- v2: - Do not ignore the return value of tpm_ioc_set_locality(). - if (!(chip->flags & TPM_CHIP_FLAG_SET_LOCALITY_ENABLED)) - Refined kernel-parameters.txt description. - Use __u8 instead of u8 in the uapi. - Tested with https://codeberg.org/jarkko/tpm-set-locality-test/src/branch/main/src/main.rs v1: - NOTE: Only compile-tested. --- .../admin-guide/kernel-parameters.txt | 5 ++ .../userspace-api/ioctl/ioctl-number.rst | 2 + drivers/char/tpm/tpm-chip.c | 2 +- drivers/char/tpm/tpm-dev.c | 70 +++++++++++++++++++ drivers/char/tpm/tpm_tis_core.c | 2 + include/linux/tpm.h | 10 +++ include/uapi/linux/tpm.h | 11 +++ 7 files changed, 101 insertions(+), 1 deletion(-) create mode 100644 include/uapi/linux/tpm.h diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt index 1518343bbe22..8fd9fc94c883 100644 --- a/Documentation/admin-guide/kernel-parameters.txt +++ b/Documentation/admin-guide/kernel-parameters.txt @@ -6727,6 +6727,11 @@ torture.verbose_sleep_duration= [KNL] Duration of each verbose-printk() sleep in jiffies. + tpm.set_locality_enabled= [HW,TPM] + Enable one-shot locality setting after the boot. The + operation can be performed with TPM_IOC_SET_LOCALITY + applied to /dev/tpm0. The default value is 0. + tpm_suspend_pcr=[HW,TPM] Format: integer pcr id Specify that at suspend time, the tpm driver diff --git a/Documentation/userspace-api/ioctl/ioctl-number.rst b/Documentation/userspace-api/ioctl/ioctl-number.rst index e4be1378ba26..3eba57ab2fb1 100644 --- a/Documentation/userspace-api/ioctl/ioctl-number.rst +++ b/Documentation/userspace-api/ioctl/ioctl-number.rst @@ -338,6 +338,8 @@ Code Seq# Include File Comments 0xA3 90-9F linux/dtlk.h 0xA4 00-1F uapi/linux/tee.h Generic TEE subsystem 0xA4 00-1F uapi/asm/sgx.h <mailto:linux-sgx@xxxxxxxxxxxxxxx> +0xA4 00-1F uapi/linux/tpm.h TPM + <mailto:linux-integrity@xxxxxxxxxxxxxxx> 0xA5 01-05 linux/surface_aggregator/cdev.h Microsoft Surface Platform System Aggregator <mailto:luzmaximilian@xxxxxxxxx> 0xA5 20-2F linux/surface_aggregator/dtx.h Microsoft Surface DTX driver diff --git a/drivers/char/tpm/tpm-chip.c b/drivers/char/tpm/tpm-chip.c index 7df7abaf3e52..c8016342352a 100644 --- a/drivers/char/tpm/tpm-chip.c +++ b/drivers/char/tpm/tpm-chip.c @@ -44,7 +44,7 @@ static int tpm_request_locality(struct tpm_chip *chip) if (!chip->ops->request_locality) return 0; - rc = chip->ops->request_locality(chip, 0); + rc = chip->ops->request_locality(chip, chip->default_locality); if (rc < 0) return rc; diff --git a/drivers/char/tpm/tpm-dev.c b/drivers/char/tpm/tpm-dev.c index 97c94b5e9340..d07aec98f894 100644 --- a/drivers/char/tpm/tpm-dev.c +++ b/drivers/char/tpm/tpm-dev.c @@ -13,8 +13,74 @@ * Device file system interface to the TPM */ #include <linux/slab.h> +#include <uapi/linux/tpm.h> #include "tpm-dev.h" +static bool set_locality_enabled; +module_param(set_locality_enabled, bool, 0644); + +/* + * Set a locality as a one-shot operation. A chip must declare support for it + * with %TPM_CHIP_FLAG_SET_LOCALITY_ENABLED, which will cleared after setting + * the locality. + */ +static long tpm_ioc_set_locality(struct tpm_chip *chip, u8 __user *localityp) +{ + u8 locality; + + if (!set_locality_enabled) + return -ENOIOCTLCMD; + + if (!(chip->flags & TPM_CHIP_FLAG_SET_LOCALITY_ENABLED)) + return -EOPNOTSUPP; + + if (copy_from_user(&locality, localityp, sizeof(locality))) + return -EFAULT; + + if (locality >= TPM_MAX_LOCALITY) + return -EINVAL; + + chip->default_locality = locality; + chip->flags &= ~TPM_CHIP_FLAG_SET_LOCALITY_ENABLED; + return 0; +} + +static long tpm_ioctl(struct file *file, unsigned int cmd, unsigned long arg) +{ + struct file_priv *priv = file->private_data; + void __user *argp = (void __user *)arg; + struct tpm_chip *chip = priv->chip; + int ret; + + mutex_lock(&priv->buffer_mutex); + + ret = tpm_try_get_ops(chip); + if (ret) + goto out; + + switch (cmd) { + case TPM_IOC_SET_LOCALITY: + ret = tpm_ioc_set_locality(chip, argp); + break; + default: + ret = -ENOIOCTLCMD; + break; + } + + tpm_put_ops(chip); + +out: + mutex_unlock(&priv->buffer_mutex); + return 0; +} + +#ifdef CONFIG_COMPAT +static long tpm_compat_ioctl(struct file *filep, unsigned int cmd, unsigned long arg) +{ + return tpm_ioctl(filep, cmd, arg); +} +#endif + static int tpm_open(struct inode *inode, struct file *file) { struct tpm_chip *chip; @@ -59,6 +125,10 @@ static int tpm_release(struct inode *inode, struct file *file) const struct file_operations tpm_fops = { .owner = THIS_MODULE, + .unlocked_ioctl = tpm_ioctl, +#ifdef CONFIG_COMPAT + .compat_ioctl = tpm_compat_ioctl, +#endif .open = tpm_open, .read = tpm_common_read, .write = tpm_common_write, diff --git a/drivers/char/tpm/tpm_tis_core.c b/drivers/char/tpm/tpm_tis_core.c index fdef214b9f6b..3517db710423 100644 --- a/drivers/char/tpm/tpm_tis_core.c +++ b/drivers/char/tpm/tpm_tis_core.c @@ -1111,6 +1111,8 @@ int tpm_tis_core_init(struct device *dev, struct tpm_tis_data *priv, int irq, if (IS_ERR(chip)) return PTR_ERR(chip); + chip->flags |= TPM_CHIP_FLAG_SET_LOCALITY_ENABLED; + #ifdef CONFIG_ACPI chip->acpi_dev_handle = acpi_dev_handle; #endif diff --git a/include/linux/tpm.h b/include/linux/tpm.h index 587b96b4418e..27071ef13b7a 100644 --- a/include/linux/tpm.h +++ b/include/linux/tpm.h @@ -147,6 +147,12 @@ struct tpm_chip_seqops { */ #define TPM2_MAX_CONTEXT_SIZE 4096 +/* + * The maximum locality (0 - 4) for a TPM, as defined in section 3.2 of the + * Client Platform Profile Specification. + */ +#define TPM_MAX_LOCALITY 4 + struct tpm_chip { struct device dev; struct device devs; @@ -202,6 +208,9 @@ struct tpm_chip { /* active locality */ int locality; + /* the default locality used by the kernel (default 0) */ + u8 default_locality; + #ifdef CONFIG_TCG_TPM2_HMAC /* details for communication security via sessions */ @@ -348,6 +357,7 @@ enum tpm_chip_flags { TPM_CHIP_FLAG_SUSPENDED = BIT(8), TPM_CHIP_FLAG_HWRNG_DISABLED = BIT(9), TPM_CHIP_FLAG_DISABLE = BIT(10), + TPM_CHIP_FLAG_SET_LOCALITY_ENABLED = BIT(11), }; #define to_tpm_chip(d) container_of(d, struct tpm_chip, dev) diff --git a/include/uapi/linux/tpm.h b/include/uapi/linux/tpm.h new file mode 100644 index 000000000000..73485a184f14 --- /dev/null +++ b/include/uapi/linux/tpm.h @@ -0,0 +1,11 @@ +/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ +#ifndef _UAPI_TPM_H +#define _UAPI_TPM_H + +#include <linux/types.h> +#include <linux/ioctl.h> + +#define TPM_MAGIC 0xA4 +#define TPM_IOC_SET_LOCALITY _IOW(TPM_MAGIC, 0x00, __u8) + +#endif /* _UAPI_TPM_H */ -- 2.47.0
