blob: 2f8026b719339f215ad8f1ae40526498b60e5e3d [file] [log] [blame]
Googler9398cc32022-12-02 17:21:52 +08001// SPDX-License-Identifier: GPL-2.0-only
Googleraf606d22022-10-26 21:40:12 -07002/*
3 * Copyright (C) 2014, 2015 Intel Corporation
4 *
5 * Authors:
6 * Jarkko Sakkinen <jarkko.sakkinen@linux.intel.com>
7 *
8 * Maintained by: <tpmdd-devel@lists.sourceforge.net>
9 *
10 * This file contains TPM2 protocol implementations of the commands
11 * used by the kernel internally.
12 */
13
14#include "tpm.h"
15#include <crypto/hash_info.h>
16#include <keys/trusted-type.h>
17
18enum tpm2_object_attributes {
19 TPM2_OA_USER_WITH_AUTH = BIT(6),
20};
21
22enum tpm2_session_attributes {
23 TPM2_SA_CONTINUE_SESSION = BIT(0),
24};
25
Googler9398cc32022-12-02 17:21:52 +080026struct tpm2_hash {
27 unsigned int crypto_id;
28 unsigned int tpm_id;
29};
Googler9726be62022-12-14 05:53:31 +000030
Googler9398cc32022-12-02 17:21:52 +080031static struct tpm2_hash tpm2_hash_map[] = {
32 {HASH_ALGO_SHA1, TPM_ALG_SHA1},
33 {HASH_ALGO_SHA256, TPM_ALG_SHA256},
34 {HASH_ALGO_SHA384, TPM_ALG_SHA384},
35 {HASH_ALGO_SHA512, TPM_ALG_SHA512},
36 {HASH_ALGO_SM3_256, TPM_ALG_SM3_256},
37};
Googler9726be62022-12-14 05:53:31 +000038
Googler9398cc32022-12-02 17:21:52 +080039int tpm2_get_timeouts(struct tpm_chip *chip)
40{
41 /* Fixed timeouts for TPM2 */
42 chip->timeout_a = msecs_to_jiffies(TPM2_TIMEOUT_A);
43 chip->timeout_b = msecs_to_jiffies(TPM2_TIMEOUT_B);
44 chip->timeout_c = msecs_to_jiffies(TPM2_TIMEOUT_C);
45 chip->timeout_d = msecs_to_jiffies(TPM2_TIMEOUT_D);
46
47 /* PTP spec timeouts */
48 chip->duration[TPM_SHORT] = msecs_to_jiffies(TPM2_DURATION_SHORT);
49 chip->duration[TPM_MEDIUM] = msecs_to_jiffies(TPM2_DURATION_MEDIUM);
50 chip->duration[TPM_LONG] = msecs_to_jiffies(TPM2_DURATION_LONG);
51
52 /* Key creation commands long timeouts */
53 chip->duration[TPM_LONG_LONG] =
54 msecs_to_jiffies(TPM2_DURATION_LONG_LONG);
55
56 chip->flags |= TPM_CHIP_FLAG_HAVE_TIMEOUTS;
57
58 return 0;
59}
60
61/**
62 * tpm2_ordinal_duration_index() - returns an index to the chip duration table
63 * @ordinal: TPM command ordinal.
64 *
65 * The function returns an index to the chip duration table
66 * (enum tpm_duration), that describes the maximum amount of
67 * time the chip could take to return the result for a particular ordinal.
68 *
69 * The values of the MEDIUM, and LONG durations are taken
70 * from the PC Client Profile (PTP) specification (750, 2000 msec)
71 *
72 * LONG_LONG is for commands that generates keys which empirically takes
73 * a longer time on some systems.
74 *
75 * Return:
76 * * TPM_MEDIUM
77 * * TPM_LONG
78 * * TPM_LONG_LONG
79 * * TPM_UNDEFINED
80 */
81static u8 tpm2_ordinal_duration_index(u32 ordinal)
82{
83 switch (ordinal) {
84 /* Startup */
85 case TPM2_CC_STARTUP: /* 144 */
86 return TPM_MEDIUM;
87
88 case TPM2_CC_SELF_TEST: /* 143 */
89 return TPM_LONG;
90
91 case TPM2_CC_GET_RANDOM: /* 17B */
92 return TPM_LONG;
93
94 case TPM2_CC_SEQUENCE_UPDATE: /* 15C */
95 return TPM_MEDIUM;
96 case TPM2_CC_SEQUENCE_COMPLETE: /* 13E */
97 return TPM_MEDIUM;
98 case TPM2_CC_EVENT_SEQUENCE_COMPLETE: /* 185 */
99 return TPM_MEDIUM;
100 case TPM2_CC_HASH_SEQUENCE_START: /* 186 */
101 return TPM_MEDIUM;
102
103 case TPM2_CC_VERIFY_SIGNATURE: /* 177 */
104 return TPM_LONG;
105
106 case TPM2_CC_PCR_EXTEND: /* 182 */
107 return TPM_MEDIUM;
108
109 case TPM2_CC_HIERARCHY_CONTROL: /* 121 */
110 return TPM_LONG;
111 case TPM2_CC_HIERARCHY_CHANGE_AUTH: /* 129 */
112 return TPM_LONG;
113
114 case TPM2_CC_GET_CAPABILITY: /* 17A */
115 return TPM_MEDIUM;
116
117 case TPM2_CC_NV_READ: /* 14E */
118 return TPM_LONG;
119
120 case TPM2_CC_CREATE_PRIMARY: /* 131 */
121 return TPM_LONG_LONG;
122 case TPM2_CC_CREATE: /* 153 */
123 return TPM_LONG_LONG;
124 case TPM2_CC_CREATE_LOADED: /* 191 */
125 return TPM_LONG_LONG;
126
127 default:
128 return TPM_UNDEFINED;
129 }
130}
131
132/**
133 * tpm2_calc_ordinal_duration() - calculate the maximum command duration
134 * @chip: TPM chip to use.
135 * @ordinal: TPM command ordinal.
136 *
137 * The function returns the maximum amount of time the chip could take
138 * to return the result for a particular ordinal in jiffies.
139 *
140 * Return: A maximal duration time for an ordinal in jiffies.
141 */
142unsigned long tpm2_calc_ordinal_duration(struct tpm_chip *chip, u32 ordinal)
143{
144 unsigned int index;
145
146 index = tpm2_ordinal_duration_index(ordinal);
147
148 if (index != TPM_UNDEFINED)
149 return chip->duration[index];
150 else
151 return msecs_to_jiffies(TPM2_DURATION_DEFAULT);
152}
153
Googler9726be62022-12-14 05:53:31 +0000154
155struct tpm2_pcr_read_out {
156 __be32 update_cnt;
157 __be32 pcr_selects_cnt;
158 __be16 hash_alg;
159 u8 pcr_select_size;
160 u8 pcr_select[TPM2_PCR_SELECT_MIN];
161 __be32 digests_cnt;
162 __be16 digest_size;
Googler9398cc32022-12-02 17:21:52 +0800163 u8 digest[];
Googler9726be62022-12-14 05:53:31 +0000164} __packed;
165
Googleraf606d22022-10-26 21:40:12 -0700166/**
167 * tpm2_pcr_read() - read a PCR value
168 * @chip: TPM chip to use.
169 * @pcr_idx: index of the PCR to read.
Googler9398cc32022-12-02 17:21:52 +0800170 * @digest: PCR bank and buffer current PCR value is written to.
171 * @digest_size_ptr: pointer to variable that stores the digest size.
Googleraf606d22022-10-26 21:40:12 -0700172 *
Googler9398cc32022-12-02 17:21:52 +0800173 * Return: Same as with tpm_transmit_cmd.
Googleraf606d22022-10-26 21:40:12 -0700174 */
Googler9398cc32022-12-02 17:21:52 +0800175int tpm2_pcr_read(struct tpm_chip *chip, u32 pcr_idx,
176 struct tpm_digest *digest, u16 *digest_size_ptr)
Googleraf606d22022-10-26 21:40:12 -0700177{
Googler9398cc32022-12-02 17:21:52 +0800178 int i;
Googleraf606d22022-10-26 21:40:12 -0700179 int rc;
Googler9398cc32022-12-02 17:21:52 +0800180 struct tpm_buf buf;
181 struct tpm2_pcr_read_out *out;
182 u8 pcr_select[TPM2_PCR_SELECT_MIN] = {0};
183 u16 digest_size;
184 u16 expected_digest_size = 0;
Googleraf606d22022-10-26 21:40:12 -0700185
186 if (pcr_idx >= TPM2_PLATFORM_PCR)
187 return -EINVAL;
188
Googler9398cc32022-12-02 17:21:52 +0800189 if (!digest_size_ptr) {
190 for (i = 0; i < chip->nr_allocated_banks &&
191 chip->allocated_banks[i].alg_id != digest->alg_id; i++)
192 ;
Googleraf606d22022-10-26 21:40:12 -0700193
Googler9398cc32022-12-02 17:21:52 +0800194 if (i == chip->nr_allocated_banks)
195 return -EINVAL;
Googleraf606d22022-10-26 21:40:12 -0700196
Googler9398cc32022-12-02 17:21:52 +0800197 expected_digest_size = chip->allocated_banks[i].digest_size;
Googleraf606d22022-10-26 21:40:12 -0700198 }
199
Googler9398cc32022-12-02 17:21:52 +0800200 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_PCR_READ);
201 if (rc)
202 return rc;
203
204 pcr_select[pcr_idx >> 3] = 1 << (pcr_idx & 0x7);
205
206 tpm_buf_append_u32(&buf, 1);
207 tpm_buf_append_u16(&buf, digest->alg_id);
208 tpm_buf_append_u8(&buf, TPM2_PCR_SELECT_MIN);
209 tpm_buf_append(&buf, (const unsigned char *)pcr_select,
210 sizeof(pcr_select));
211
212 rc = tpm_transmit_cmd(chip, &buf, 0, "attempting to read a pcr value");
213 if (rc)
214 goto out;
215
216 out = (struct tpm2_pcr_read_out *)&buf.data[TPM_HEADER_SIZE];
217 digest_size = be16_to_cpu(out->digest_size);
218 if (digest_size > sizeof(digest->digest) ||
219 (!digest_size_ptr && digest_size != expected_digest_size)) {
220 rc = -EINVAL;
221 goto out;
222 }
223
224 if (digest_size_ptr)
225 *digest_size_ptr = digest_size;
226
227 memcpy(digest->digest, out->digest, digest_size);
228out:
229 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700230 return rc;
231}
232
Googler9398cc32022-12-02 17:21:52 +0800233struct tpm2_null_auth_area {
234 __be32 handle;
235 __be16 nonce_size;
236 u8 attributes;
237 __be16 auth_size;
238} __packed;
Googleraf606d22022-10-26 21:40:12 -0700239
240/**
241 * tpm2_pcr_extend() - extend a PCR value
Googler9398cc32022-12-02 17:21:52 +0800242 *
Googleraf606d22022-10-26 21:40:12 -0700243 * @chip: TPM chip to use.
244 * @pcr_idx: index of the PCR.
Googler9398cc32022-12-02 17:21:52 +0800245 * @digests: list of pcr banks and corresponding digest values to extend.
Googleraf606d22022-10-26 21:40:12 -0700246 *
Googler9398cc32022-12-02 17:21:52 +0800247 * Return: Same as with tpm_transmit_cmd.
Googleraf606d22022-10-26 21:40:12 -0700248 */
Googler9398cc32022-12-02 17:21:52 +0800249int tpm2_pcr_extend(struct tpm_chip *chip, u32 pcr_idx,
250 struct tpm_digest *digests)
Googleraf606d22022-10-26 21:40:12 -0700251{
Googler9398cc32022-12-02 17:21:52 +0800252 struct tpm_buf buf;
253 struct tpm2_null_auth_area auth_area;
Googleraf606d22022-10-26 21:40:12 -0700254 int rc;
Googler9398cc32022-12-02 17:21:52 +0800255 int i;
Googleraf606d22022-10-26 21:40:12 -0700256
Googler9398cc32022-12-02 17:21:52 +0800257 rc = tpm_buf_init(&buf, TPM2_ST_SESSIONS, TPM2_CC_PCR_EXTEND);
258 if (rc)
259 return rc;
Googleraf606d22022-10-26 21:40:12 -0700260
Googler9398cc32022-12-02 17:21:52 +0800261 tpm_buf_append_u32(&buf, pcr_idx);
262
263 auth_area.handle = cpu_to_be32(TPM2_RS_PW);
264 auth_area.nonce_size = 0;
265 auth_area.attributes = 0;
266 auth_area.auth_size = 0;
267
268 tpm_buf_append_u32(&buf, sizeof(struct tpm2_null_auth_area));
269 tpm_buf_append(&buf, (const unsigned char *)&auth_area,
270 sizeof(auth_area));
271 tpm_buf_append_u32(&buf, chip->nr_allocated_banks);
272
273 for (i = 0; i < chip->nr_allocated_banks; i++) {
274 tpm_buf_append_u16(&buf, digests[i].alg_id);
275 tpm_buf_append(&buf, (const unsigned char *)&digests[i].digest,
276 chip->allocated_banks[i].digest_size);
277 }
278
279 rc = tpm_transmit_cmd(chip, &buf, 0, "attempting extend a PCR value");
280
281 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700282
283 return rc;
284}
285
Googler9398cc32022-12-02 17:21:52 +0800286struct tpm2_get_random_out {
287 __be16 size;
288 u8 buffer[TPM_MAX_RNG_DATA];
289} __packed;
Googleraf606d22022-10-26 21:40:12 -0700290
291/**
292 * tpm2_get_random() - get random bytes from the TPM RNG
293 *
Googler9398cc32022-12-02 17:21:52 +0800294 * @chip: a &tpm_chip instance
295 * @dest: destination buffer
296 * @max: the max number of random bytes to pull
297 *
298 * Return:
299 * size of the buffer on success,
300 * -errno otherwise (positive TPM return codes are masked to -EIO)
Googleraf606d22022-10-26 21:40:12 -0700301 */
Googler9398cc32022-12-02 17:21:52 +0800302int tpm2_get_random(struct tpm_chip *chip, u8 *dest, size_t max)
Googleraf606d22022-10-26 21:40:12 -0700303{
Googler9398cc32022-12-02 17:21:52 +0800304 struct tpm2_get_random_out *out;
305 struct tpm_buf buf;
Googleraf606d22022-10-26 21:40:12 -0700306 u32 recd;
Googler9398cc32022-12-02 17:21:52 +0800307 u32 num_bytes = max;
Googleraf606d22022-10-26 21:40:12 -0700308 int err;
309 int total = 0;
310 int retries = 5;
Googler9398cc32022-12-02 17:21:52 +0800311 u8 *dest_ptr = dest;
Googleraf606d22022-10-26 21:40:12 -0700312
Googler9398cc32022-12-02 17:21:52 +0800313 if (!num_bytes || max > TPM_MAX_RNG_DATA)
Googleraf606d22022-10-26 21:40:12 -0700314 return -EINVAL;
315
Googler9398cc32022-12-02 17:21:52 +0800316 err = tpm_buf_init(&buf, 0, 0);
317 if (err)
318 return err;
319
Googleraf606d22022-10-26 21:40:12 -0700320 do {
Googler9398cc32022-12-02 17:21:52 +0800321 tpm_buf_reset(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_GET_RANDOM);
322 tpm_buf_append_u16(&buf, num_bytes);
323 err = tpm_transmit_cmd(chip, &buf,
324 offsetof(struct tpm2_get_random_out,
325 buffer),
Googler9726be62022-12-14 05:53:31 +0000326 "attempting get random");
Googler9398cc32022-12-02 17:21:52 +0800327 if (err) {
328 if (err > 0)
329 err = -EIO;
330 goto out;
331 }
Googleraf606d22022-10-26 21:40:12 -0700332
Googler9398cc32022-12-02 17:21:52 +0800333 out = (struct tpm2_get_random_out *)
334 &buf.data[TPM_HEADER_SIZE];
335 recd = min_t(u32, be16_to_cpu(out->size), num_bytes);
336 if (tpm_buf_length(&buf) <
337 TPM_HEADER_SIZE +
338 offsetof(struct tpm2_get_random_out, buffer) +
339 recd) {
340 err = -EFAULT;
341 goto out;
342 }
343 memcpy(dest_ptr, out->buffer, recd);
Googleraf606d22022-10-26 21:40:12 -0700344
Googler9398cc32022-12-02 17:21:52 +0800345 dest_ptr += recd;
Googleraf606d22022-10-26 21:40:12 -0700346 total += recd;
347 num_bytes -= recd;
348 } while (retries-- && total < max);
349
Googler9398cc32022-12-02 17:21:52 +0800350 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700351 return total ? total : -EIO;
Googler9398cc32022-12-02 17:21:52 +0800352out:
353 tpm_buf_destroy(&buf);
354 return err;
Googleraf606d22022-10-26 21:40:12 -0700355}
356
Googler9398cc32022-12-02 17:21:52 +0800357/**
358 * tpm2_flush_context() - execute a TPM2_FlushContext command
359 * @chip: TPM chip to use
360 * @handle: context handle
361 */
362void tpm2_flush_context(struct tpm_chip *chip, u32 handle)
363{
364 struct tpm_buf buf;
365 int rc;
Googleraf606d22022-10-26 21:40:12 -0700366
Googler9398cc32022-12-02 17:21:52 +0800367 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_FLUSH_CONTEXT);
368 if (rc) {
369 dev_warn(&chip->dev, "0x%08x was not flushed, out of memory\n",
370 handle);
371 return;
372 }
373
374 tpm_buf_append_u32(&buf, handle);
375
376 tpm_transmit_cmd(chip, &buf, 0, "flushing context");
377 tpm_buf_destroy(&buf);
378}
Googleraf606d22022-10-26 21:40:12 -0700379
380/**
Googler9398cc32022-12-02 17:21:52 +0800381 * tpm_buf_append_auth() - append TPMS_AUTH_COMMAND to the buffer.
Googleraf606d22022-10-26 21:40:12 -0700382 *
Googler9398cc32022-12-02 17:21:52 +0800383 * @buf: an allocated tpm_buf instance
384 * @session_handle: session handle
385 * @nonce: the session nonce, may be NULL if not used
386 * @nonce_len: the session nonce length, may be 0 if not used
387 * @attributes: the session attributes
388 * @hmac: the session HMAC or password, may be NULL if not used
389 * @hmac_len: the session HMAC or password length, maybe 0 if not used
Googleraf606d22022-10-26 21:40:12 -0700390 */
391static void tpm2_buf_append_auth(struct tpm_buf *buf, u32 session_handle,
392 const u8 *nonce, u16 nonce_len,
393 u8 attributes,
394 const u8 *hmac, u16 hmac_len)
395{
396 tpm_buf_append_u32(buf, 9 + nonce_len + hmac_len);
397 tpm_buf_append_u32(buf, session_handle);
398 tpm_buf_append_u16(buf, nonce_len);
399
400 if (nonce && nonce_len)
401 tpm_buf_append(buf, nonce, nonce_len);
402
403 tpm_buf_append_u8(buf, attributes);
404 tpm_buf_append_u16(buf, hmac_len);
405
406 if (hmac && hmac_len)
407 tpm_buf_append(buf, hmac, hmac_len);
408}
409
410/**
411 * tpm2_seal_trusted() - seal the payload of a trusted key
Googler9398cc32022-12-02 17:21:52 +0800412 *
413 * @chip: TPM chip to use
Googleraf606d22022-10-26 21:40:12 -0700414 * @payload: the key data in clear and encrypted form
415 * @options: authentication values and other options
416 *
417 * Return: < 0 on error and 0 on success.
418 */
419int tpm2_seal_trusted(struct tpm_chip *chip,
420 struct trusted_key_payload *payload,
421 struct trusted_key_options *options)
422{
423 unsigned int blob_len;
424 struct tpm_buf buf;
425 u32 hash;
426 int i;
427 int rc;
428
429 for (i = 0; i < ARRAY_SIZE(tpm2_hash_map); i++) {
430 if (options->hash == tpm2_hash_map[i].crypto_id) {
431 hash = tpm2_hash_map[i].tpm_id;
432 break;
433 }
434 }
435
436 if (i == ARRAY_SIZE(tpm2_hash_map))
437 return -EINVAL;
438
439 rc = tpm_buf_init(&buf, TPM2_ST_SESSIONS, TPM2_CC_CREATE);
440 if (rc)
441 return rc;
442
443 tpm_buf_append_u32(&buf, options->keyhandle);
444 tpm2_buf_append_auth(&buf, TPM2_RS_PW,
445 NULL /* nonce */, 0,
446 0 /* session_attributes */,
447 options->keyauth /* hmac */,
448 TPM_DIGEST_SIZE);
449
450 /* sensitive */
451 tpm_buf_append_u16(&buf, 4 + TPM_DIGEST_SIZE + payload->key_len + 1);
452
453 tpm_buf_append_u16(&buf, TPM_DIGEST_SIZE);
454 tpm_buf_append(&buf, options->blobauth, TPM_DIGEST_SIZE);
455 tpm_buf_append_u16(&buf, payload->key_len + 1);
456 tpm_buf_append(&buf, payload->key, payload->key_len);
457 tpm_buf_append_u8(&buf, payload->migratable);
458
459 /* public */
460 tpm_buf_append_u16(&buf, 14 + options->policydigest_len);
Googler9398cc32022-12-02 17:21:52 +0800461 tpm_buf_append_u16(&buf, TPM_ALG_KEYEDHASH);
Googleraf606d22022-10-26 21:40:12 -0700462 tpm_buf_append_u16(&buf, hash);
463
464 /* policy */
465 if (options->policydigest_len) {
466 tpm_buf_append_u32(&buf, 0);
467 tpm_buf_append_u16(&buf, options->policydigest_len);
468 tpm_buf_append(&buf, options->policydigest,
469 options->policydigest_len);
470 } else {
471 tpm_buf_append_u32(&buf, TPM2_OA_USER_WITH_AUTH);
472 tpm_buf_append_u16(&buf, 0);
473 }
474
475 /* public parameters */
Googler9398cc32022-12-02 17:21:52 +0800476 tpm_buf_append_u16(&buf, TPM_ALG_NULL);
Googleraf606d22022-10-26 21:40:12 -0700477 tpm_buf_append_u16(&buf, 0);
478
479 /* outside info */
480 tpm_buf_append_u16(&buf, 0);
481
482 /* creation PCR */
483 tpm_buf_append_u32(&buf, 0);
484
485 if (buf.flags & TPM_BUF_OVERFLOW) {
486 rc = -E2BIG;
487 goto out;
488 }
489
Googler9398cc32022-12-02 17:21:52 +0800490 rc = tpm_transmit_cmd(chip, &buf, 4, "sealing data");
Googleraf606d22022-10-26 21:40:12 -0700491 if (rc)
492 goto out;
493
494 blob_len = be32_to_cpup((__be32 *) &buf.data[TPM_HEADER_SIZE]);
495 if (blob_len > MAX_BLOB_SIZE) {
496 rc = -E2BIG;
497 goto out;
498 }
Googler9398cc32022-12-02 17:21:52 +0800499 if (tpm_buf_length(&buf) < TPM_HEADER_SIZE + 4 + blob_len) {
500 rc = -EFAULT;
501 goto out;
502 }
Googleraf606d22022-10-26 21:40:12 -0700503
504 memcpy(payload->blob, &buf.data[TPM_HEADER_SIZE + 4], blob_len);
505 payload->blob_len = blob_len;
506
507out:
508 tpm_buf_destroy(&buf);
509
510 if (rc > 0) {
511 if (tpm2_rc_value(rc) == TPM2_RC_HASH)
512 rc = -EINVAL;
513 else
514 rc = -EPERM;
515 }
516
517 return rc;
518}
519
520/**
521 * tpm2_load_cmd() - execute a TPM2_Load command
Googler9398cc32022-12-02 17:21:52 +0800522 *
523 * @chip: TPM chip to use
Googleraf606d22022-10-26 21:40:12 -0700524 * @payload: the key data in clear and encrypted form
525 * @options: authentication values and other options
Googler9398cc32022-12-02 17:21:52 +0800526 * @blob_handle: returned blob handle
Googleraf606d22022-10-26 21:40:12 -0700527 *
Googler9398cc32022-12-02 17:21:52 +0800528 * Return: 0 on success.
529 * -E2BIG on wrong payload size.
530 * -EPERM on tpm error status.
531 * < 0 error from tpm_transmit_cmd.
Googleraf606d22022-10-26 21:40:12 -0700532 */
533static int tpm2_load_cmd(struct tpm_chip *chip,
534 struct trusted_key_payload *payload,
535 struct trusted_key_options *options,
Googler9398cc32022-12-02 17:21:52 +0800536 u32 *blob_handle)
Googleraf606d22022-10-26 21:40:12 -0700537{
538 struct tpm_buf buf;
539 unsigned int private_len;
540 unsigned int public_len;
541 unsigned int blob_len;
542 int rc;
543
544 private_len = be16_to_cpup((__be16 *) &payload->blob[0]);
545 if (private_len > (payload->blob_len - 2))
546 return -E2BIG;
547
548 public_len = be16_to_cpup((__be16 *) &payload->blob[2 + private_len]);
549 blob_len = private_len + public_len + 4;
550 if (blob_len > payload->blob_len)
551 return -E2BIG;
552
553 rc = tpm_buf_init(&buf, TPM2_ST_SESSIONS, TPM2_CC_LOAD);
554 if (rc)
555 return rc;
556
557 tpm_buf_append_u32(&buf, options->keyhandle);
558 tpm2_buf_append_auth(&buf, TPM2_RS_PW,
559 NULL /* nonce */, 0,
560 0 /* session_attributes */,
561 options->keyauth /* hmac */,
562 TPM_DIGEST_SIZE);
563
564 tpm_buf_append(&buf, payload->blob, blob_len);
565
566 if (buf.flags & TPM_BUF_OVERFLOW) {
567 rc = -E2BIG;
568 goto out;
569 }
570
Googler9398cc32022-12-02 17:21:52 +0800571 rc = tpm_transmit_cmd(chip, &buf, 4, "loading blob");
Googleraf606d22022-10-26 21:40:12 -0700572 if (!rc)
573 *blob_handle = be32_to_cpup(
574 (__be32 *) &buf.data[TPM_HEADER_SIZE]);
575
576out:
577 tpm_buf_destroy(&buf);
578
579 if (rc > 0)
580 rc = -EPERM;
581
582 return rc;
583}
584
585/**
Googler9726be62022-12-14 05:53:31 +0000586 * tpm2_unseal_cmd() - execute a TPM2_Unload command
Googler9398cc32022-12-02 17:21:52 +0800587 *
588 * @chip: TPM chip to use
Googler9726be62022-12-14 05:53:31 +0000589 * @payload: the key data in clear and encrypted form
590 * @options: authentication values and other options
Googler9398cc32022-12-02 17:21:52 +0800591 * @blob_handle: blob handle
Googler9726be62022-12-14 05:53:31 +0000592 *
Googler9398cc32022-12-02 17:21:52 +0800593 * Return: 0 on success
594 * -EPERM on tpm error status
595 * < 0 error from tpm_transmit_cmd
Googleraf606d22022-10-26 21:40:12 -0700596 */
597static int tpm2_unseal_cmd(struct tpm_chip *chip,
598 struct trusted_key_payload *payload,
599 struct trusted_key_options *options,
Googler9398cc32022-12-02 17:21:52 +0800600 u32 blob_handle)
Googleraf606d22022-10-26 21:40:12 -0700601{
602 struct tpm_buf buf;
603 u16 data_len;
604 u8 *data;
605 int rc;
606
607 rc = tpm_buf_init(&buf, TPM2_ST_SESSIONS, TPM2_CC_UNSEAL);
608 if (rc)
609 return rc;
610
611 tpm_buf_append_u32(&buf, blob_handle);
612 tpm2_buf_append_auth(&buf,
613 options->policyhandle ?
614 options->policyhandle : TPM2_RS_PW,
615 NULL /* nonce */, 0,
616 TPM2_SA_CONTINUE_SESSION,
617 options->blobauth /* hmac */,
618 TPM_DIGEST_SIZE);
619
Googler9398cc32022-12-02 17:21:52 +0800620 rc = tpm_transmit_cmd(chip, &buf, 6, "unsealing");
Googleraf606d22022-10-26 21:40:12 -0700621 if (rc > 0)
622 rc = -EPERM;
623
624 if (!rc) {
625 data_len = be16_to_cpup(
626 (__be16 *) &buf.data[TPM_HEADER_SIZE + 4]);
627 if (data_len < MIN_KEY_SIZE || data_len > MAX_KEY_SIZE + 1) {
628 rc = -EFAULT;
629 goto out;
630 }
631
Googler9398cc32022-12-02 17:21:52 +0800632 if (tpm_buf_length(&buf) < TPM_HEADER_SIZE + 6 + data_len) {
633 rc = -EFAULT;
634 goto out;
635 }
Googleraf606d22022-10-26 21:40:12 -0700636 data = &buf.data[TPM_HEADER_SIZE + 6];
637
638 memcpy(payload->key, data, data_len - 1);
639 payload->key_len = data_len - 1;
640 payload->migratable = data[data_len - 1];
641 }
642
643out:
644 tpm_buf_destroy(&buf);
645 return rc;
646}
647
648/**
Googler9398cc32022-12-02 17:21:52 +0800649 * tpm2_unseal_trusted() - unseal the payload of a trusted key
650 *
651 * @chip: TPM chip to use
Googleraf606d22022-10-26 21:40:12 -0700652 * @payload: the key data in clear and encrypted form
653 * @options: authentication values and other options
654 *
Googler9398cc32022-12-02 17:21:52 +0800655 * Return: Same as with tpm_transmit_cmd.
Googleraf606d22022-10-26 21:40:12 -0700656 */
657int tpm2_unseal_trusted(struct tpm_chip *chip,
658 struct trusted_key_payload *payload,
659 struct trusted_key_options *options)
660{
661 u32 blob_handle;
662 int rc;
663
Googler9398cc32022-12-02 17:21:52 +0800664 rc = tpm2_load_cmd(chip, payload, options, &blob_handle);
Googleraf606d22022-10-26 21:40:12 -0700665 if (rc)
Googler9398cc32022-12-02 17:21:52 +0800666 return rc;
Googleraf606d22022-10-26 21:40:12 -0700667
Googler9398cc32022-12-02 17:21:52 +0800668 rc = tpm2_unseal_cmd(chip, payload, options, blob_handle);
669 tpm2_flush_context(chip, blob_handle);
Googleraf606d22022-10-26 21:40:12 -0700670 return rc;
671}
672
Googler9398cc32022-12-02 17:21:52 +0800673struct tpm2_get_cap_out {
674 u8 more_data;
675 __be32 subcap_id;
676 __be32 property_cnt;
677 __be32 property_id;
678 __be32 value;
679} __packed;
680
Googleraf606d22022-10-26 21:40:12 -0700681/**
682 * tpm2_get_tpm_pt() - get value of a TPM_CAP_TPM_PROPERTIES type property
Googler9398cc32022-12-02 17:21:52 +0800683 * @chip: a &tpm_chip instance
Googleraf606d22022-10-26 21:40:12 -0700684 * @property_id: property ID.
685 * @value: output variable.
686 * @desc: passed to tpm_transmit_cmd()
687 *
Googler9398cc32022-12-02 17:21:52 +0800688 * Return:
689 * 0 on success,
690 * -errno or a TPM return code otherwise
Googleraf606d22022-10-26 21:40:12 -0700691 */
692ssize_t tpm2_get_tpm_pt(struct tpm_chip *chip, u32 property_id, u32 *value,
693 const char *desc)
694{
Googler9398cc32022-12-02 17:21:52 +0800695 struct tpm2_get_cap_out *out;
696 struct tpm_buf buf;
Googleraf606d22022-10-26 21:40:12 -0700697 int rc;
698
Googler9398cc32022-12-02 17:21:52 +0800699 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_GET_CAPABILITY);
700 if (rc)
701 return rc;
702 tpm_buf_append_u32(&buf, TPM2_CAP_TPM_PROPERTIES);
703 tpm_buf_append_u32(&buf, property_id);
704 tpm_buf_append_u32(&buf, 1);
705 rc = tpm_transmit_cmd(chip, &buf, 0, NULL);
706 if (!rc) {
707 out = (struct tpm2_get_cap_out *)
708 &buf.data[TPM_HEADER_SIZE];
Googlerb48fa912023-03-17 12:40:29 +0530709 *value = be32_to_cpu(out->value);
Googler9398cc32022-12-02 17:21:52 +0800710 }
711 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700712 return rc;
713}
714EXPORT_SYMBOL_GPL(tpm2_get_tpm_pt);
715
716/**
Googler9398cc32022-12-02 17:21:52 +0800717 * tpm2_shutdown() - send a TPM shutdown command
Googleraf606d22022-10-26 21:40:12 -0700718 *
Googler9398cc32022-12-02 17:21:52 +0800719 * Sends a TPM shutdown command. The shutdown command is used in call
720 * sites where the system is going down. If it fails, there is not much
721 * that can be done except print an error message.
722 *
723 * @chip: a &tpm_chip instance
724 * @shutdown_type: TPM_SU_CLEAR or TPM_SU_STATE.
Googleraf606d22022-10-26 21:40:12 -0700725 */
726void tpm2_shutdown(struct tpm_chip *chip, u16 shutdown_type)
727{
Googler9398cc32022-12-02 17:21:52 +0800728 struct tpm_buf buf;
Googleraf606d22022-10-26 21:40:12 -0700729 int rc;
730
Googler9398cc32022-12-02 17:21:52 +0800731 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_SHUTDOWN);
732 if (rc)
733 return;
734 tpm_buf_append_u16(&buf, shutdown_type);
735 tpm_transmit_cmd(chip, &buf, 0, "stopping the TPM");
736 tpm_buf_destroy(&buf);
Googler9726be62022-12-14 05:53:31 +0000737}
738
739/**
Googler9398cc32022-12-02 17:21:52 +0800740 * tpm2_do_selftest() - ensure that all self tests have passed
741 *
Googleraf606d22022-10-26 21:40:12 -0700742 * @chip: TPM chip to use
743 *
Googler9398cc32022-12-02 17:21:52 +0800744 * Return: Same as with tpm_transmit_cmd.
Googleraf606d22022-10-26 21:40:12 -0700745 *
Googler9398cc32022-12-02 17:21:52 +0800746 * The TPM can either run all self tests synchronously and then return
747 * RC_SUCCESS once all tests were successful. Or it can choose to run the tests
748 * asynchronously and return RC_TESTING immediately while the self tests still
749 * execute in the background. This function handles both cases and waits until
750 * all tests have completed.
Googleraf606d22022-10-26 21:40:12 -0700751 */
752static int tpm2_do_selftest(struct tpm_chip *chip)
753{
Googler9398cc32022-12-02 17:21:52 +0800754 struct tpm_buf buf;
755 int full;
Googleraf606d22022-10-26 21:40:12 -0700756 int rc;
757
Googler9398cc32022-12-02 17:21:52 +0800758 for (full = 0; full < 2; full++) {
759 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_SELF_TEST);
760 if (rc)
761 return rc;
Googleraf606d22022-10-26 21:40:12 -0700762
Googler9398cc32022-12-02 17:21:52 +0800763 tpm_buf_append_u8(&buf, full);
764 rc = tpm_transmit_cmd(chip, &buf, 0,
765 "attempting the self test");
766 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700767
Googler9398cc32022-12-02 17:21:52 +0800768 if (rc == TPM2_RC_TESTING)
769 rc = TPM2_RC_SUCCESS;
770 if (rc == TPM2_RC_INITIALIZE || rc == TPM2_RC_SUCCESS)
771 return rc;
Googleraf606d22022-10-26 21:40:12 -0700772 }
773
774 return rc;
775}
776
777/**
Googler9398cc32022-12-02 17:21:52 +0800778 * tpm2_probe() - probe for the TPM 2.0 protocol
779 * @chip: a &tpm_chip instance
Googleraf606d22022-10-26 21:40:12 -0700780 *
Googler9398cc32022-12-02 17:21:52 +0800781 * Send an idempotent TPM 2.0 command and see whether there is TPM2 chip in the
782 * other end based on the response tag. The flag TPM_CHIP_FLAG_TPM2 is set by
783 * this function if this is the case.
784 *
785 * Return:
786 * 0 on success,
787 * -errno otherwise
Googleraf606d22022-10-26 21:40:12 -0700788 */
789int tpm2_probe(struct tpm_chip *chip)
790{
Googler9398cc32022-12-02 17:21:52 +0800791 struct tpm_header *out;
792 struct tpm_buf buf;
Googleraf606d22022-10-26 21:40:12 -0700793 int rc;
794
Googler9398cc32022-12-02 17:21:52 +0800795 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_GET_CAPABILITY);
796 if (rc)
Googleraf606d22022-10-26 21:40:12 -0700797 return rc;
Googler9398cc32022-12-02 17:21:52 +0800798 tpm_buf_append_u32(&buf, TPM2_CAP_TPM_PROPERTIES);
799 tpm_buf_append_u32(&buf, TPM_PT_TOTAL_COMMANDS);
800 tpm_buf_append_u32(&buf, 1);
801 rc = tpm_transmit_cmd(chip, &buf, 0, NULL);
802 /* We ignore TPM return codes on purpose. */
803 if (rc >= 0) {
804 out = (struct tpm_header *)buf.data;
805 if (be16_to_cpu(out->tag) == TPM2_ST_NO_SESSIONS)
806 chip->flags |= TPM_CHIP_FLAG_TPM2;
807 }
808 tpm_buf_destroy(&buf);
Googleraf606d22022-10-26 21:40:12 -0700809 return 0;
810}
811EXPORT_SYMBOL_GPL(tpm2_probe);
812
Googler9398cc32022-12-02 17:21:52 +0800813static int tpm2_init_bank_info(struct tpm_chip *chip, u32 bank_index)
814{
815 struct tpm_bank_info *bank = chip->allocated_banks + bank_index;
816 struct tpm_digest digest = { .alg_id = bank->alg_id };
817 int i;
818
819 /*
820 * Avoid unnecessary PCR read operations to reduce overhead
821 * and obtain identifiers of the crypto subsystem.
822 */
823 for (i = 0; i < ARRAY_SIZE(tpm2_hash_map); i++) {
824 enum hash_algo crypto_algo = tpm2_hash_map[i].crypto_id;
825
826 if (bank->alg_id != tpm2_hash_map[i].tpm_id)
827 continue;
828
829 bank->digest_size = hash_digest_size[crypto_algo];
830 bank->crypto_id = crypto_algo;
831 return 0;
832 }
833
834 bank->crypto_id = HASH_ALGO__LAST;
835
836 return tpm2_pcr_read(chip, 0, &digest, &bank->digest_size);
837}
838
839struct tpm2_pcr_selection {
840 __be16 hash_alg;
841 u8 size_of_select;
842 u8 pcr_select[3];
843} __packed;
844
845ssize_t tpm2_get_pcr_allocation(struct tpm_chip *chip)
846{
847 struct tpm2_pcr_selection pcr_selection;
848 struct tpm_buf buf;
849 void *marker;
850 void *end;
851 void *pcr_select_offset;
852 u32 sizeof_pcr_selection;
853 u32 nr_possible_banks;
854 u32 nr_alloc_banks = 0;
855 u16 hash_alg;
856 u32 rsp_len;
857 int rc;
858 int i = 0;
859
860 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_GET_CAPABILITY);
861 if (rc)
862 return rc;
863
864 tpm_buf_append_u32(&buf, TPM2_CAP_PCRS);
865 tpm_buf_append_u32(&buf, 0);
866 tpm_buf_append_u32(&buf, 1);
867
868 rc = tpm_transmit_cmd(chip, &buf, 9, "get tpm pcr allocation");
869 if (rc)
870 goto out;
871
872 nr_possible_banks = be32_to_cpup(
873 (__be32 *)&buf.data[TPM_HEADER_SIZE + 5]);
874
875 chip->allocated_banks = kcalloc(nr_possible_banks,
876 sizeof(*chip->allocated_banks),
877 GFP_KERNEL);
878 if (!chip->allocated_banks) {
879 rc = -ENOMEM;
880 goto out;
881 }
882
883 marker = &buf.data[TPM_HEADER_SIZE + 9];
884
885 rsp_len = be32_to_cpup((__be32 *)&buf.data[2]);
886 end = &buf.data[rsp_len];
887
888 for (i = 0; i < nr_possible_banks; i++) {
889 pcr_select_offset = marker +
890 offsetof(struct tpm2_pcr_selection, size_of_select);
891 if (pcr_select_offset >= end) {
892 rc = -EFAULT;
893 break;
894 }
895
896 memcpy(&pcr_selection, marker, sizeof(pcr_selection));
897 hash_alg = be16_to_cpu(pcr_selection.hash_alg);
898
899 pcr_select_offset = memchr_inv(pcr_selection.pcr_select, 0,
900 pcr_selection.size_of_select);
901 if (pcr_select_offset) {
902 chip->allocated_banks[nr_alloc_banks].alg_id = hash_alg;
903
904 rc = tpm2_init_bank_info(chip, nr_alloc_banks);
905 if (rc < 0)
906 break;
907
908 nr_alloc_banks++;
909 }
910
911 sizeof_pcr_selection = sizeof(pcr_selection.hash_alg) +
912 sizeof(pcr_selection.size_of_select) +
913 pcr_selection.size_of_select;
914 marker = marker + sizeof_pcr_selection;
915 }
916
917 chip->nr_allocated_banks = nr_alloc_banks;
918out:
919 tpm_buf_destroy(&buf);
920
921 return rc;
922}
923
924static int tpm2_get_cc_attrs_tbl(struct tpm_chip *chip)
925{
926 struct tpm_buf buf;
927 u32 nr_commands;
928 __be32 *attrs;
929 u32 cc;
930 int i;
931 int rc;
932
933 rc = tpm2_get_tpm_pt(chip, TPM_PT_TOTAL_COMMANDS, &nr_commands, NULL);
934 if (rc)
935 goto out;
936
937 if (nr_commands > 0xFFFFF) {
938 rc = -EFAULT;
939 goto out;
940 }
941
942 chip->cc_attrs_tbl = devm_kcalloc(&chip->dev, 4, nr_commands,
943 GFP_KERNEL);
944 if (!chip->cc_attrs_tbl) {
945 rc = -ENOMEM;
946 goto out;
947 }
948
949 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_GET_CAPABILITY);
950 if (rc)
951 goto out;
952
953 tpm_buf_append_u32(&buf, TPM2_CAP_COMMANDS);
954 tpm_buf_append_u32(&buf, TPM2_CC_FIRST);
955 tpm_buf_append_u32(&buf, nr_commands);
956
957 rc = tpm_transmit_cmd(chip, &buf, 9 + 4 * nr_commands, NULL);
958 if (rc) {
959 tpm_buf_destroy(&buf);
960 goto out;
961 }
962
963 if (nr_commands !=
964 be32_to_cpup((__be32 *)&buf.data[TPM_HEADER_SIZE + 5])) {
Googler9398cc32022-12-02 17:21:52 +0800965 tpm_buf_destroy(&buf);
966 goto out;
967 }
968
969 chip->nr_commands = nr_commands;
970
971 attrs = (__be32 *)&buf.data[TPM_HEADER_SIZE + 9];
972 for (i = 0; i < nr_commands; i++, attrs++) {
973 chip->cc_attrs_tbl[i] = be32_to_cpup(attrs);
974 cc = chip->cc_attrs_tbl[i] & 0xFFFF;
975
976 if (cc == TPM2_CC_CONTEXT_SAVE || cc == TPM2_CC_FLUSH_CONTEXT) {
977 chip->cc_attrs_tbl[i] &=
978 ~(GENMASK(2, 0) << TPM2_CC_ATTR_CHANDLES);
979 chip->cc_attrs_tbl[i] |= 1 << TPM2_CC_ATTR_CHANDLES;
980 }
981 }
982
983 tpm_buf_destroy(&buf);
984
985out:
986 if (rc > 0)
987 rc = -ENODEV;
988 return rc;
989}
990
991/**
992 * tpm2_startup - turn on the TPM
993 * @chip: TPM chip to use
994 *
995 * Normally the firmware should start the TPM. This function is provided as a
996 * workaround if this does not happen. A legal case for this could be for
997 * example when a TPM emulator is used.
998 *
999 * Return: same as tpm_transmit_cmd()
1000 */
1001
1002static int tpm2_startup(struct tpm_chip *chip)
1003{
1004 struct tpm_buf buf;
1005 int rc;
1006
1007 dev_info(&chip->dev, "starting up the TPM manually\n");
1008
1009 rc = tpm_buf_init(&buf, TPM2_ST_NO_SESSIONS, TPM2_CC_STARTUP);
1010 if (rc < 0)
1011 return rc;
1012
1013 tpm_buf_append_u16(&buf, TPM2_SU_CLEAR);
1014 rc = tpm_transmit_cmd(chip, &buf, 0, "attempting to start the TPM");
1015 tpm_buf_destroy(&buf);
1016
1017 return rc;
1018}
1019
Googleraf606d22022-10-26 21:40:12 -07001020/**
1021 * tpm2_auto_startup - Perform the standard automatic TPM initialization
1022 * sequence
1023 * @chip: TPM chip to use
1024 *
1025 * Returns 0 on success, < 0 in case of fatal error.
1026 */
1027int tpm2_auto_startup(struct tpm_chip *chip)
1028{
1029 int rc;
1030
Googler9398cc32022-12-02 17:21:52 +08001031 rc = tpm2_get_timeouts(chip);
Googleraf606d22022-10-26 21:40:12 -07001032 if (rc)
1033 goto out;
1034
1035 rc = tpm2_do_selftest(chip);
Googler9398cc32022-12-02 17:21:52 +08001036 if (rc && rc != TPM2_RC_INITIALIZE)
Googleraf606d22022-10-26 21:40:12 -07001037 goto out;
1038
1039 if (rc == TPM2_RC_INITIALIZE) {
Googler9398cc32022-12-02 17:21:52 +08001040 rc = tpm2_startup(chip);
Googleraf606d22022-10-26 21:40:12 -07001041 if (rc)
1042 goto out;
1043
1044 rc = tpm2_do_selftest(chip);
Googler9398cc32022-12-02 17:21:52 +08001045 if (rc)
Googleraf606d22022-10-26 21:40:12 -07001046 goto out;
1047 }
1048
Googler9398cc32022-12-02 17:21:52 +08001049 rc = tpm2_get_cc_attrs_tbl(chip);
1050
Googleraf606d22022-10-26 21:40:12 -07001051out:
1052 if (rc > 0)
1053 rc = -ENODEV;
1054 return rc;
1055}
Googler9398cc32022-12-02 17:21:52 +08001056
1057int tpm2_find_cc(struct tpm_chip *chip, u32 cc)
1058{
1059 int i;
1060
1061 for (i = 0; i < chip->nr_commands; i++)
1062 if (cc == (chip->cc_attrs_tbl[i] & GENMASK(15, 0)))
1063 return i;
1064
1065 return -1;
1066}