1 /* SPDX-License-Identifier: GPL-2.0-only */
3 * Copyright (C) 2004,2007,2008 IBM Corporation
6 * Leendert van Doorn <leendert@watson.ibm.com>
7 * Dave Safford <safford@watson.ibm.com>
8 * Reiner Sailer <sailer@watson.ibm.com>
9 * Kylene Hall <kjhall@us.ibm.com>
10 * Debora Velarde <dvelarde@us.ibm.com>
12 * Maintained by: <tpmdd_devel@lists.sourceforge.net>
14 * Device driver for TCG/TCPA TPM (trusted platform module).
15 * Specifications at www.trustedcomputinggroup.org
17 #ifndef __LINUX_TPM_H__
18 #define __LINUX_TPM_H__
20 #include <linux/hw_random.h>
21 #include <linux/acpi.h>
22 #include <linux/cdev.h>
24 #include <crypto/hash_info.h>
26 #define TPM_DIGEST_SIZE 20 /* Max TPM v1.2 PCR size */
27 #define TPM_MAX_DIGEST_SIZE SHA512_DIGEST_SIZE
30 struct trusted_key_payload;
31 struct trusted_key_options;
34 TPM_ALG_ERROR = 0x0000,
35 TPM_ALG_SHA1 = 0x0004,
36 TPM_ALG_KEYEDHASH = 0x0008,
37 TPM_ALG_SHA256 = 0x000B,
38 TPM_ALG_SHA384 = 0x000C,
39 TPM_ALG_SHA512 = 0x000D,
40 TPM_ALG_NULL = 0x0010,
41 TPM_ALG_SM3_256 = 0x0012,
46 u8 digest[TPM_MAX_DIGEST_SIZE];
49 struct tpm_bank_info {
56 TPM_OPS_AUTO_STARTUP = BIT(0),
59 struct tpm_class_ops {
61 const u8 req_complete_mask;
62 const u8 req_complete_val;
63 bool (*req_canceled)(struct tpm_chip *chip, u8 status);
64 int (*recv) (struct tpm_chip *chip, u8 *buf, size_t len);
65 int (*send) (struct tpm_chip *chip, u8 *buf, size_t len);
66 void (*cancel) (struct tpm_chip *chip);
67 u8 (*status) (struct tpm_chip *chip);
68 void (*update_timeouts)(struct tpm_chip *chip,
69 unsigned long *timeout_cap);
70 int (*go_idle)(struct tpm_chip *chip);
71 int (*cmd_ready)(struct tpm_chip *chip);
72 int (*request_locality)(struct tpm_chip *chip, int loc);
73 int (*relinquish_locality)(struct tpm_chip *chip, int loc);
74 void (*clk_enable)(struct tpm_chip *chip, bool value);
77 #define TPM_NUM_EVENT_LOG_FILES 3
79 /* Indexes the duration array */
86 TPM_NUM_DURATIONS = TPM_UNDEFINED,
89 #define TPM_PPI_VERSION_LEN 3
100 void *bios_event_log;
101 void *bios_event_log_end;
104 struct tpm_chip_seqops {
105 struct tpm_chip *chip;
106 const struct seq_operations *seqops;
115 /* A driver callback under ops cannot be run unless ops_sem is held
116 * (sometimes implicitly, eg for the sysfs code). ops becomes null
117 * when the driver is unregistered, see tpm_try_get_ops.
119 struct rw_semaphore ops_sem;
120 const struct tpm_class_ops *ops;
122 struct tpm_bios_log log;
123 struct tpm_chip_seqops bin_log_seqops;
124 struct tpm_chip_seqops ascii_log_seqops;
128 int dev_num; /* /dev/tpm# */
129 unsigned long is_open; /* only one allowed */
134 struct mutex tpm_mutex; /* tpm is processing */
136 unsigned long timeout_a; /* jiffies */
137 unsigned long timeout_b; /* jiffies */
138 unsigned long timeout_c; /* jiffies */
139 unsigned long timeout_d; /* jiffies */
140 bool timeout_adjusted;
141 unsigned long duration[TPM_NUM_DURATIONS]; /* jiffies */
142 bool duration_adjusted;
144 struct dentry *bios_dir[TPM_NUM_EVENT_LOG_FILES];
146 const struct attribute_group *groups[3];
147 unsigned int groups_cnt;
149 u32 nr_allocated_banks;
150 struct tpm_bank_info *allocated_banks;
152 acpi_handle acpi_dev_handle;
153 char ppi_version[TPM_PPI_VERSION_LEN + 1];
154 #endif /* CONFIG_ACPI */
156 struct tpm_space work_space;
161 /* active locality */
165 #if defined(CONFIG_TCG_TPM) || defined(CONFIG_TCG_TPM_MODULE)
167 extern int tpm_is_tpm2(struct tpm_chip *chip);
168 extern int tpm_pcr_read(struct tpm_chip *chip, u32 pcr_idx,
169 struct tpm_digest *digest);
170 extern int tpm_pcr_extend(struct tpm_chip *chip, u32 pcr_idx,
171 struct tpm_digest *digests);
172 extern int tpm_send(struct tpm_chip *chip, void *cmd, size_t buflen);
173 extern int tpm_get_random(struct tpm_chip *chip, u8 *data, size_t max);
174 extern int tpm_seal_trusted(struct tpm_chip *chip,
175 struct trusted_key_payload *payload,
176 struct trusted_key_options *options);
177 extern int tpm_unseal_trusted(struct tpm_chip *chip,
178 struct trusted_key_payload *payload,
179 struct trusted_key_options *options);
180 extern struct tpm_chip *tpm_default_chip(void);
182 static inline int tpm_is_tpm2(struct tpm_chip *chip)
187 static inline int tpm_pcr_read(struct tpm_chip *chip, int pcr_idx,
188 struct tpm_digest *digest)
193 static inline int tpm_pcr_extend(struct tpm_chip *chip, u32 pcr_idx,
194 struct tpm_digest *digests)
199 static inline int tpm_send(struct tpm_chip *chip, void *cmd, size_t buflen)
203 static inline int tpm_get_random(struct tpm_chip *chip, u8 *data, size_t max)
208 static inline int tpm_seal_trusted(struct tpm_chip *chip,
209 struct trusted_key_payload *payload,
210 struct trusted_key_options *options)
214 static inline int tpm_unseal_trusted(struct tpm_chip *chip,
215 struct trusted_key_payload *payload,
216 struct trusted_key_options *options)
220 static inline struct tpm_chip *tpm_default_chip(void)