2 * Copyright (C) 2004 IBM Corporation
3 * Copyright (C) 2014 Intel 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>
11 * Maintained by: <tpmdd-devel@lists.sourceforge.net>
13 * Device driver for TCG/TCPA TPM (trusted platform module).
14 * Specifications at www.trustedcomputinggroup.org
16 * This program is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU General Public License as
18 * published by the Free Software Foundation, version 2 of the
21 * Note, the TPM chip is not interrupt driven (only polling)
22 * and can have very long timeouts (minutes!). Hence the unusual
27 #include <linux/poll.h>
28 #include <linux/slab.h>
29 #include <linux/mutex.h>
30 #include <linux/spinlock.h>
31 #include <linux/freezer.h>
34 #include "tpm_eventlog.h"
36 #define TPM_MAX_ORDINAL 243
37 #define TSC_MAX_ORDINAL 12
38 #define TPM_PROTECTED_COMMAND 0x00
39 #define TPM_CONNECTION_COMMAND 0x40
42 * Bug workaround - some TPM's don't flush the most
43 * recently changed pcr on suspend, so force the flush
44 * with an extend to the selected _unused_ non-volatile pcr.
46 static int tpm_suspend_pcr;
47 module_param_named(suspend_pcr, tpm_suspend_pcr, uint, 0644);
48 MODULE_PARM_DESC(suspend_pcr,
49 "PCR to use for dummy writes to faciltate flush on suspend.");
52 * Array with one entry per ordinal defining the maximum amount
53 * of time the chip could take to return the result. The ordinal
54 * designation of short, medium or long is defined in a table in
55 * TCG Specification TPM Main Part 2 TPM Structures Section 17. The
56 * values of the SHORT, MEDIUM, and LONG durations are retrieved
57 * from the chip during initialization with a call to tpm_get_timeouts.
59 static const u8 tpm_ordinal_duration[TPM_MAX_ORDINAL] = {
60 TPM_UNDEFINED, /* 0 */
65 TPM_UNDEFINED, /* 5 */
115 TPM_UNDEFINED, /* 55 */
135 TPM_UNDEFINED, /* 75 */
145 TPM_UNDEFINED, /* 85 */
155 TPM_UNDEFINED, /* 95 */
160 TPM_MEDIUM, /* 100 */
165 TPM_UNDEFINED, /* 105 */
195 TPM_UNDEFINED, /* 135 */
205 TPM_UNDEFINED, /* 145 */
215 TPM_UNDEFINED, /* 155 */
225 TPM_UNDEFINED, /* 165 */
235 TPM_UNDEFINED, /* 175 */
240 TPM_MEDIUM, /* 180 */
245 TPM_MEDIUM, /* 185 */
250 TPM_UNDEFINED, /* 190 */
255 TPM_UNDEFINED, /* 195 */
270 TPM_MEDIUM, /* 210 */
275 TPM_UNDEFINED, /* 215 */
285 TPM_UNDEFINED, /* 225 */
295 TPM_UNDEFINED, /* 235 */
306 * Returns max number of jiffies to wait
308 unsigned long tpm_calc_ordinal_duration(struct tpm_chip *chip,
311 int duration_idx = TPM_UNDEFINED;
315 * We only have a duration table for protected commands, where the upper
316 * 16 bits are 0. For the few other ordinals the fallback will be used.
318 if (ordinal < TPM_MAX_ORDINAL)
319 duration_idx = tpm_ordinal_duration[ordinal];
321 if (duration_idx != TPM_UNDEFINED)
322 duration = chip->vendor.duration[duration_idx];
328 EXPORT_SYMBOL_GPL(tpm_calc_ordinal_duration);
331 * Internal kernel interface to transmit TPM commands
333 ssize_t tpm_transmit(struct tpm_chip *chip, const char *buf,
340 if (bufsiz > TPM_BUFSIZE)
341 bufsiz = TPM_BUFSIZE;
343 count = be32_to_cpu(*((__be32 *) (buf + 2)));
344 ordinal = be32_to_cpu(*((__be32 *) (buf + 6)));
347 if (count > bufsiz) {
349 "invalid count value %x %zx\n", count, bufsiz);
353 mutex_lock(&chip->tpm_mutex);
355 rc = chip->ops->send(chip, (u8 *) buf, count);
358 "tpm_transmit: tpm_send: error %zd\n", rc);
362 if (chip->vendor.irq)
365 if (chip->flags & TPM_CHIP_FLAG_TPM2)
366 stop = jiffies + tpm2_calc_ordinal_duration(chip, ordinal);
368 stop = jiffies + tpm_calc_ordinal_duration(chip, ordinal);
370 u8 status = chip->ops->status(chip);
371 if ((status & chip->ops->req_complete_mask) ==
372 chip->ops->req_complete_val)
375 if (chip->ops->req_canceled(chip, status)) {
376 dev_err(chip->pdev, "Operation Canceled\n");
381 msleep(TPM_TIMEOUT); /* CHECK */
383 } while (time_before(jiffies, stop));
385 chip->ops->cancel(chip);
386 dev_err(chip->pdev, "Operation Timed out\n");
391 rc = chip->ops->recv(chip, (u8 *) buf, bufsiz);
394 "tpm_transmit: tpm_recv: error %zd\n", rc);
396 mutex_unlock(&chip->tpm_mutex);
400 #define TPM_DIGEST_SIZE 20
401 #define TPM_RET_CODE_IDX 6
403 ssize_t tpm_transmit_cmd(struct tpm_chip *chip, void *cmd,
404 int len, const char *desc)
406 struct tpm_output_header *header;
409 len = tpm_transmit(chip, (u8 *) cmd, len);
412 else if (len < TPM_HEADER_SIZE)
417 err = be32_to_cpu(header->return_code);
418 if (err != 0 && desc)
419 dev_err(chip->pdev, "A TPM error (%d) occurred %s\n", err,
425 #define TPM_INTERNAL_RESULT_SIZE 200
426 #define TPM_ORD_GET_CAP cpu_to_be32(101)
427 #define TPM_ORD_GET_RANDOM cpu_to_be32(70)
429 static const struct tpm_input_header tpm_getcap_header = {
430 .tag = TPM_TAG_RQU_COMMAND,
431 .length = cpu_to_be32(22),
432 .ordinal = TPM_ORD_GET_CAP
435 ssize_t tpm_getcap(struct device *dev, __be32 subcap_id, cap_t *cap,
438 struct tpm_cmd_t tpm_cmd;
440 struct tpm_chip *chip = dev_get_drvdata(dev);
442 tpm_cmd.header.in = tpm_getcap_header;
443 if (subcap_id == CAP_VERSION_1_1 || subcap_id == CAP_VERSION_1_2) {
444 tpm_cmd.params.getcap_in.cap = subcap_id;
445 /*subcap field not necessary */
446 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(0);
447 tpm_cmd.header.in.length -= cpu_to_be32(sizeof(__be32));
449 if (subcap_id == TPM_CAP_FLAG_PERM ||
450 subcap_id == TPM_CAP_FLAG_VOL)
451 tpm_cmd.params.getcap_in.cap = TPM_CAP_FLAG;
453 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
454 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
455 tpm_cmd.params.getcap_in.subcap = subcap_id;
457 rc = tpm_transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE, desc);
459 *cap = tpm_cmd.params.getcap_out.cap;
463 void tpm_gen_interrupt(struct tpm_chip *chip)
465 struct tpm_cmd_t tpm_cmd;
468 tpm_cmd.header.in = tpm_getcap_header;
469 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
470 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
471 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_TIMEOUT;
473 rc = tpm_transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
474 "attempting to determine the timeouts");
476 EXPORT_SYMBOL_GPL(tpm_gen_interrupt);
478 #define TPM_ORD_STARTUP cpu_to_be32(153)
479 #define TPM_ST_CLEAR cpu_to_be16(1)
480 #define TPM_ST_STATE cpu_to_be16(2)
481 #define TPM_ST_DEACTIVATED cpu_to_be16(3)
482 static const struct tpm_input_header tpm_startup_header = {
483 .tag = TPM_TAG_RQU_COMMAND,
484 .length = cpu_to_be32(12),
485 .ordinal = TPM_ORD_STARTUP
488 static int tpm_startup(struct tpm_chip *chip, __be16 startup_type)
490 struct tpm_cmd_t start_cmd;
491 start_cmd.header.in = tpm_startup_header;
493 start_cmd.params.startup_in.startup_type = startup_type;
494 return tpm_transmit_cmd(chip, &start_cmd, TPM_INTERNAL_RESULT_SIZE,
495 "attempting to start the TPM");
498 int tpm_get_timeouts(struct tpm_chip *chip)
500 struct tpm_cmd_t tpm_cmd;
501 unsigned long new_timeout[4];
502 unsigned long old_timeout[4];
503 struct duration_t *duration_cap;
506 tpm_cmd.header.in = tpm_getcap_header;
507 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
508 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
509 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_TIMEOUT;
510 rc = tpm_transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE, NULL);
512 if (rc == TPM_ERR_INVALID_POSTINIT) {
513 /* The TPM is not started, we are the first to talk to it.
514 Execute a startup command. */
515 dev_info(chip->pdev, "Issuing TPM_STARTUP");
516 if (tpm_startup(chip, TPM_ST_CLEAR))
519 tpm_cmd.header.in = tpm_getcap_header;
520 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
521 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
522 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_TIMEOUT;
523 rc = tpm_transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
528 "A TPM error (%zd) occurred attempting to determine the timeouts\n",
533 if (be32_to_cpu(tpm_cmd.header.out.return_code) != 0 ||
534 be32_to_cpu(tpm_cmd.header.out.length)
535 != sizeof(tpm_cmd.header.out) + sizeof(u32) + 4 * sizeof(u32))
538 old_timeout[0] = be32_to_cpu(tpm_cmd.params.getcap_out.cap.timeout.a);
539 old_timeout[1] = be32_to_cpu(tpm_cmd.params.getcap_out.cap.timeout.b);
540 old_timeout[2] = be32_to_cpu(tpm_cmd.params.getcap_out.cap.timeout.c);
541 old_timeout[3] = be32_to_cpu(tpm_cmd.params.getcap_out.cap.timeout.d);
542 memcpy(new_timeout, old_timeout, sizeof(new_timeout));
545 * Provide ability for vendor overrides of timeout values in case
548 if (chip->ops->update_timeouts != NULL)
549 chip->vendor.timeout_adjusted =
550 chip->ops->update_timeouts(chip, new_timeout);
552 if (!chip->vendor.timeout_adjusted) {
553 /* Don't overwrite default if value is 0 */
554 if (new_timeout[0] != 0 && new_timeout[0] < 1000) {
557 /* timeouts in msec rather usec */
558 for (i = 0; i != ARRAY_SIZE(new_timeout); i++)
559 new_timeout[i] *= 1000;
560 chip->vendor.timeout_adjusted = true;
564 /* Report adjusted timeouts */
565 if (chip->vendor.timeout_adjusted) {
567 HW_ERR "Adjusting reported timeouts: A %lu->%luus B %lu->%luus C %lu->%luus D %lu->%luus\n",
568 old_timeout[0], new_timeout[0],
569 old_timeout[1], new_timeout[1],
570 old_timeout[2], new_timeout[2],
571 old_timeout[3], new_timeout[3]);
574 chip->vendor.timeout_a = usecs_to_jiffies(new_timeout[0]);
575 chip->vendor.timeout_b = usecs_to_jiffies(new_timeout[1]);
576 chip->vendor.timeout_c = usecs_to_jiffies(new_timeout[2]);
577 chip->vendor.timeout_d = usecs_to_jiffies(new_timeout[3]);
580 tpm_cmd.header.in = tpm_getcap_header;
581 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
582 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
583 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_DURATION;
585 rc = tpm_transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
586 "attempting to determine the durations");
590 if (be32_to_cpu(tpm_cmd.header.out.return_code) != 0 ||
591 be32_to_cpu(tpm_cmd.header.out.length)
592 != sizeof(tpm_cmd.header.out) + sizeof(u32) + 3 * sizeof(u32))
595 duration_cap = &tpm_cmd.params.getcap_out.cap.duration;
596 chip->vendor.duration[TPM_SHORT] =
597 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_short));
598 chip->vendor.duration[TPM_MEDIUM] =
599 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_medium));
600 chip->vendor.duration[TPM_LONG] =
601 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_long));
603 /* The Broadcom BCM0102 chipset in a Dell Latitude D820 gets the above
604 * value wrong and apparently reports msecs rather than usecs. So we
605 * fix up the resulting too-small TPM_SHORT value to make things work.
606 * We also scale the TPM_MEDIUM and -_LONG values by 1000.
608 if (chip->vendor.duration[TPM_SHORT] < (HZ / 100)) {
609 chip->vendor.duration[TPM_SHORT] = HZ;
610 chip->vendor.duration[TPM_MEDIUM] *= 1000;
611 chip->vendor.duration[TPM_LONG] *= 1000;
612 chip->vendor.duration_adjusted = true;
613 dev_info(chip->pdev, "Adjusting TPM timeout parameters.");
617 EXPORT_SYMBOL_GPL(tpm_get_timeouts);
619 #define TPM_ORD_CONTINUE_SELFTEST 83
620 #define CONTINUE_SELFTEST_RESULT_SIZE 10
622 static struct tpm_input_header continue_selftest_header = {
623 .tag = TPM_TAG_RQU_COMMAND,
624 .length = cpu_to_be32(10),
625 .ordinal = cpu_to_be32(TPM_ORD_CONTINUE_SELFTEST),
629 * tpm_continue_selftest -- run TPM's selftest
630 * @chip: TPM chip to use
632 * Returns 0 on success, < 0 in case of fatal error or a value > 0 representing
635 static int tpm_continue_selftest(struct tpm_chip *chip)
638 struct tpm_cmd_t cmd;
640 cmd.header.in = continue_selftest_header;
641 rc = tpm_transmit_cmd(chip, &cmd, CONTINUE_SELFTEST_RESULT_SIZE,
642 "continue selftest");
646 #define TPM_ORDINAL_PCRREAD cpu_to_be32(21)
647 #define READ_PCR_RESULT_SIZE 30
648 static struct tpm_input_header pcrread_header = {
649 .tag = TPM_TAG_RQU_COMMAND,
650 .length = cpu_to_be32(14),
651 .ordinal = TPM_ORDINAL_PCRREAD
654 int tpm_pcr_read_dev(struct tpm_chip *chip, int pcr_idx, u8 *res_buf)
657 struct tpm_cmd_t cmd;
659 cmd.header.in = pcrread_header;
660 cmd.params.pcrread_in.pcr_idx = cpu_to_be32(pcr_idx);
661 rc = tpm_transmit_cmd(chip, &cmd, READ_PCR_RESULT_SIZE,
662 "attempting to read a pcr value");
665 memcpy(res_buf, cmd.params.pcrread_out.pcr_result,
671 * tpm_is_tpm2 - is the chip a TPM2 chip?
672 * @chip_num: tpm idx # or ANY
674 * Returns < 0 on error, and 1 or 0 on success depending whether the chip
677 int tpm_is_tpm2(u32 chip_num)
679 struct tpm_chip *chip;
682 chip = tpm_chip_find_get(chip_num);
686 rc = (chip->flags & TPM_CHIP_FLAG_TPM2) != 0;
692 EXPORT_SYMBOL_GPL(tpm_is_tpm2);
695 * tpm_pcr_read - read a pcr value
696 * @chip_num: tpm idx # or ANY
697 * @pcr_idx: pcr idx to retrieve
698 * @res_buf: TPM_PCR value
699 * size of res_buf is 20 bytes (or NULL if you don't care)
701 * The TPM driver should be built-in, but for whatever reason it
702 * isn't, protect against the chip disappearing, by incrementing
703 * the module usage count.
705 int tpm_pcr_read(u32 chip_num, int pcr_idx, u8 *res_buf)
707 struct tpm_chip *chip;
710 chip = tpm_chip_find_get(chip_num);
713 if (chip->flags & TPM_CHIP_FLAG_TPM2)
714 rc = tpm2_pcr_read(chip, pcr_idx, res_buf);
716 rc = tpm_pcr_read_dev(chip, pcr_idx, res_buf);
720 EXPORT_SYMBOL_GPL(tpm_pcr_read);
723 * tpm_pcr_extend - extend pcr value with hash
724 * @chip_num: tpm idx # or AN&
725 * @pcr_idx: pcr idx to extend
726 * @hash: hash value used to extend pcr value
728 * The TPM driver should be built-in, but for whatever reason it
729 * isn't, protect against the chip disappearing, by incrementing
730 * the module usage count.
732 #define TPM_ORD_PCR_EXTEND cpu_to_be32(20)
733 #define EXTEND_PCR_RESULT_SIZE 34
734 static struct tpm_input_header pcrextend_header = {
735 .tag = TPM_TAG_RQU_COMMAND,
736 .length = cpu_to_be32(34),
737 .ordinal = TPM_ORD_PCR_EXTEND
740 int tpm_pcr_extend(u32 chip_num, int pcr_idx, const u8 *hash)
742 struct tpm_cmd_t cmd;
744 struct tpm_chip *chip;
746 chip = tpm_chip_find_get(chip_num);
750 if (chip->flags & TPM_CHIP_FLAG_TPM2) {
751 rc = tpm2_pcr_extend(chip, pcr_idx, hash);
756 cmd.header.in = pcrextend_header;
757 cmd.params.pcrextend_in.pcr_idx = cpu_to_be32(pcr_idx);
758 memcpy(cmd.params.pcrextend_in.hash, hash, TPM_DIGEST_SIZE);
759 rc = tpm_transmit_cmd(chip, &cmd, EXTEND_PCR_RESULT_SIZE,
760 "attempting extend a PCR value");
765 EXPORT_SYMBOL_GPL(tpm_pcr_extend);
768 * tpm_do_selftest - have the TPM continue its selftest and wait until it
769 * can receive further commands
770 * @chip: TPM chip to use
772 * Returns 0 on success, < 0 in case of fatal error or a value > 0 representing
775 int tpm_do_selftest(struct tpm_chip *chip)
779 unsigned int delay_msec = 100;
780 unsigned long duration;
781 struct tpm_cmd_t cmd;
783 duration = tpm_calc_ordinal_duration(chip, TPM_ORD_CONTINUE_SELFTEST);
785 loops = jiffies_to_msecs(duration) / delay_msec;
787 rc = tpm_continue_selftest(chip);
788 /* This may fail if there was no TPM driver during a suspend/resume
789 * cycle; some may return 10 (BAD_ORDINAL), others 28 (FAILEDSELFTEST)
795 /* Attempt to read a PCR value */
796 cmd.header.in = pcrread_header;
797 cmd.params.pcrread_in.pcr_idx = cpu_to_be32(0);
798 rc = tpm_transmit(chip, (u8 *) &cmd, READ_PCR_RESULT_SIZE);
799 /* Some buggy TPMs will not respond to tpm_tis_ready() for
800 * around 300ms while the self test is ongoing, keep trying
801 * until the self test duration expires. */
803 dev_info(chip->pdev, HW_ERR "TPM command timed out during continue self test");
808 if (rc < TPM_HEADER_SIZE)
811 rc = be32_to_cpu(cmd.header.out.return_code);
812 if (rc == TPM_ERR_DISABLED || rc == TPM_ERR_DEACTIVATED) {
814 "TPM is disabled/deactivated (0x%X)\n", rc);
815 /* TPM is disabled and/or deactivated; driver can
816 * proceed and TPM does handle commands for
817 * suspend/resume correctly
821 if (rc != TPM_WARN_DOING_SELFTEST)
824 } while (--loops > 0);
828 EXPORT_SYMBOL_GPL(tpm_do_selftest);
830 int tpm_send(u32 chip_num, void *cmd, size_t buflen)
832 struct tpm_chip *chip;
835 chip = tpm_chip_find_get(chip_num);
839 rc = tpm_transmit_cmd(chip, cmd, buflen, "attempting tpm_cmd");
844 EXPORT_SYMBOL_GPL(tpm_send);
846 static bool wait_for_tpm_stat_cond(struct tpm_chip *chip, u8 mask,
847 bool check_cancel, bool *canceled)
849 u8 status = chip->ops->status(chip);
852 if ((status & mask) == mask)
854 if (check_cancel && chip->ops->req_canceled(chip, status)) {
861 int wait_for_tpm_stat(struct tpm_chip *chip, u8 mask, unsigned long timeout,
862 wait_queue_head_t *queue, bool check_cancel)
867 bool canceled = false;
869 /* check current status */
870 status = chip->ops->status(chip);
871 if ((status & mask) == mask)
874 stop = jiffies + timeout;
876 if (chip->vendor.irq) {
878 timeout = stop - jiffies;
879 if ((long)timeout <= 0)
881 rc = wait_event_interruptible_timeout(*queue,
882 wait_for_tpm_stat_cond(chip, mask, check_cancel,
890 if (rc == -ERESTARTSYS && freezing(current)) {
891 clear_thread_flag(TIF_SIGPENDING);
897 status = chip->ops->status(chip);
898 if ((status & mask) == mask)
900 } while (time_before(jiffies, stop));
904 EXPORT_SYMBOL_GPL(wait_for_tpm_stat);
906 #define TPM_ORD_SAVESTATE cpu_to_be32(152)
907 #define SAVESTATE_RESULT_SIZE 10
909 static struct tpm_input_header savestate_header = {
910 .tag = TPM_TAG_RQU_COMMAND,
911 .length = cpu_to_be32(10),
912 .ordinal = TPM_ORD_SAVESTATE
916 * We are about to suspend. Save the TPM state
917 * so that it can be restored.
919 int tpm_pm_suspend(struct device *dev)
921 struct tpm_chip *chip = dev_get_drvdata(dev);
922 struct tpm_cmd_t cmd;
925 u8 dummy_hash[TPM_DIGEST_SIZE] = { 0 };
930 if (chip->flags & TPM_CHIP_FLAG_TPM2) {
931 tpm2_shutdown(chip, TPM2_SU_STATE);
935 /* for buggy tpm, flush pcrs with extend to selected dummy */
936 if (tpm_suspend_pcr) {
937 cmd.header.in = pcrextend_header;
938 cmd.params.pcrextend_in.pcr_idx = cpu_to_be32(tpm_suspend_pcr);
939 memcpy(cmd.params.pcrextend_in.hash, dummy_hash,
941 rc = tpm_transmit_cmd(chip, &cmd, EXTEND_PCR_RESULT_SIZE,
942 "extending dummy pcr before suspend");
945 /* now do the actual savestate */
946 for (try = 0; try < TPM_RETRY; try++) {
947 cmd.header.in = savestate_header;
948 rc = tpm_transmit_cmd(chip, &cmd, SAVESTATE_RESULT_SIZE, NULL);
951 * If the TPM indicates that it is too busy to respond to
952 * this command then retry before giving up. It can take
953 * several seconds for this TPM to be ready.
955 * This can happen if the TPM has already been sent the
956 * SaveState command before the driver has loaded. TCG 1.2
957 * specification states that any communication after SaveState
958 * may cause the TPM to invalidate previously saved state.
960 if (rc != TPM_WARN_RETRY)
962 msleep(TPM_TIMEOUT_RETRY);
967 "Error (%d) sending savestate before suspend\n", rc);
969 dev_warn(chip->pdev, "TPM savestate took %dms\n",
970 try * TPM_TIMEOUT_RETRY);
974 EXPORT_SYMBOL_GPL(tpm_pm_suspend);
977 * Resume from a power safe. The BIOS already restored
980 int tpm_pm_resume(struct device *dev)
982 struct tpm_chip *chip = dev_get_drvdata(dev);
989 EXPORT_SYMBOL_GPL(tpm_pm_resume);
991 #define TPM_GETRANDOM_RESULT_SIZE 18
992 static struct tpm_input_header tpm_getrandom_header = {
993 .tag = TPM_TAG_RQU_COMMAND,
994 .length = cpu_to_be32(14),
995 .ordinal = TPM_ORD_GET_RANDOM
999 * tpm_get_random() - Get random bytes from the tpm's RNG
1000 * @chip_num: A specific chip number for the request or TPM_ANY_NUM
1001 * @out: destination buffer for the random bytes
1002 * @max: the max number of bytes to write to @out
1004 * Returns < 0 on error and the number of bytes read on success
1006 int tpm_get_random(u32 chip_num, u8 *out, size_t max)
1008 struct tpm_chip *chip;
1009 struct tpm_cmd_t tpm_cmd;
1010 u32 recd, num_bytes = min_t(u32, max, TPM_MAX_RNG_DATA);
1011 int err, total = 0, retries = 5;
1014 if (!out || !num_bytes || max > TPM_MAX_RNG_DATA)
1017 chip = tpm_chip_find_get(chip_num);
1021 if (chip->flags & TPM_CHIP_FLAG_TPM2) {
1022 err = tpm2_get_random(chip, out, max);
1028 tpm_cmd.header.in = tpm_getrandom_header;
1029 tpm_cmd.params.getrandom_in.num_bytes = cpu_to_be32(num_bytes);
1031 err = tpm_transmit_cmd(chip, &tpm_cmd,
1032 TPM_GETRANDOM_RESULT_SIZE + num_bytes,
1033 "attempting get random");
1037 recd = be32_to_cpu(tpm_cmd.params.getrandom_out.rng_data_len);
1038 memcpy(dest, tpm_cmd.params.getrandom_out.rng_data, recd);
1043 } while (retries-- && total < max);
1046 return total ? total : -EIO;
1048 EXPORT_SYMBOL_GPL(tpm_get_random);
1051 * tpm_seal_trusted() - seal a trusted key
1052 * @chip_num: A specific chip number for the request or TPM_ANY_NUM
1053 * @options: authentication values and other options
1054 * @payload: the key data in clear and encrypted form
1056 * Returns < 0 on error and 0 on success. At the moment, only TPM 2.0 chips
1059 int tpm_seal_trusted(u32 chip_num, struct trusted_key_payload *payload,
1060 struct trusted_key_options *options)
1062 struct tpm_chip *chip;
1065 chip = tpm_chip_find_get(chip_num);
1066 if (chip == NULL || !(chip->flags & TPM_CHIP_FLAG_TPM2))
1069 rc = tpm2_seal_trusted(chip, payload, options);
1074 EXPORT_SYMBOL_GPL(tpm_seal_trusted);
1077 * tpm_unseal_trusted() - unseal a trusted key
1078 * @chip_num: A specific chip number for the request or TPM_ANY_NUM
1079 * @options: authentication values and other options
1080 * @payload: the key data in clear and encrypted form
1082 * Returns < 0 on error and 0 on success. At the moment, only TPM 2.0 chips
1085 int tpm_unseal_trusted(u32 chip_num, struct trusted_key_payload *payload,
1086 struct trusted_key_options *options)
1088 struct tpm_chip *chip;
1091 chip = tpm_chip_find_get(chip_num);
1092 if (chip == NULL || !(chip->flags & TPM_CHIP_FLAG_TPM2))
1095 rc = tpm2_unseal_trusted(chip, payload, options);
1100 EXPORT_SYMBOL_GPL(tpm_unseal_trusted);
1102 static int __init tpm_init(void)
1106 tpm_class = class_create(THIS_MODULE, "tpm");
1107 if (IS_ERR(tpm_class)) {
1108 pr_err("couldn't create tpm class\n");
1109 return PTR_ERR(tpm_class);
1112 rc = alloc_chrdev_region(&tpm_devt, 0, TPM_NUM_DEVICES, "tpm");
1114 pr_err("tpm: failed to allocate char dev region\n");
1115 class_destroy(tpm_class);
1122 static void __exit tpm_exit(void)
1124 class_destroy(tpm_class);
1125 unregister_chrdev_region(tpm_devt, TPM_NUM_DEVICES);
1128 subsys_initcall(tpm_init);
1129 module_exit(tpm_exit);
1131 MODULE_AUTHOR("Leendert van Doorn (leendert@watson.ibm.com)");
1132 MODULE_DESCRIPTION("TPM Driver");
1133 MODULE_VERSION("2.0");
1134 MODULE_LICENSE("GPL");