git.sur5r.net Git - u-boot/blob - cmd/tpm-v1.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * Copyright (c) 2013 The Chromium OS Authors.
   4  */
   5
   6 #include <common.h>
   7 #include <malloc.h>
   8 #include <asm/unaligned.h>
   9 #include <tpm-common.h>
  10 #include <tpm-v1.h>
  11 #include "tpm-user-utils.h"
  12
  13 static int do_tpm_startup(cmd_tbl_t *cmdtp, int flag, int argc,
  14                           char * const argv[])
  15 {
  16         enum tpm_startup_type mode;
  17
  18         if (argc != 2)
  19                 return CMD_RET_USAGE;
  20         if (!strcasecmp("TPM_ST_CLEAR", argv[1])) {
  21                 mode = TPM_ST_CLEAR;
  22         } else if (!strcasecmp("TPM_ST_STATE", argv[1])) {
  23                 mode = TPM_ST_STATE;
  24         } else if (!strcasecmp("TPM_ST_DEACTIVATED", argv[1])) {
  25                 mode = TPM_ST_DEACTIVATED;
  26         } else {
  27                 printf("Couldn't recognize mode string: %s\n", argv[1]);
  28                 return CMD_RET_FAILURE;
  29         }
  30
  31         return report_return_code(tpm_startup(mode));
  32 }
  33
  34 static int do_tpm_nv_define_space(cmd_tbl_t *cmdtp, int flag, int argc,
  35                                   char * const argv[])
  36 {
  37         u32 index, perm, size;
  38
  39         if (argc != 4)
  40                 return CMD_RET_USAGE;
  41         index = simple_strtoul(argv[1], NULL, 0);
  42         perm = simple_strtoul(argv[2], NULL, 0);
  43         size = simple_strtoul(argv[3], NULL, 0);
  44
  45         return report_return_code(tpm_nv_define_space(index, perm, size));
  46 }
  47
  48 static int do_tpm_nv_read_value(cmd_tbl_t *cmdtp, int flag, int argc,
  49                                 char * const argv[])
  50 {
  51         u32 index, count, rc;
  52         void *data;
  53
  54         if (argc != 4)
  55                 return CMD_RET_USAGE;
  56         index = simple_strtoul(argv[1], NULL, 0);
  57         data = (void *)simple_strtoul(argv[2], NULL, 0);
  58         count = simple_strtoul(argv[3], NULL, 0);
  59
  60         rc = tpm_nv_read_value(index, data, count);
  61         if (!rc) {
  62                 puts("area content:\n");
  63                 print_byte_string(data, count);
  64         }
  65
  66         return report_return_code(rc);
  67 }
  68
  69 static int do_tpm_nv_write_value(cmd_tbl_t *cmdtp, int flag, int argc,
  70                                  char * const argv[])
  71 {
  72         u32 index, rc;
  73         size_t count;
  74         void *data;
  75
  76         if (argc != 3)
  77                 return CMD_RET_USAGE;
  78         index = simple_strtoul(argv[1], NULL, 0);
  79         data = parse_byte_string(argv[2], NULL, &count);
  80         if (!data) {
  81                 printf("Couldn't parse byte string %s\n", argv[2]);
  82                 return CMD_RET_FAILURE;
  83         }
  84
  85         rc = tpm_nv_write_value(index, data, count);
  86         free(data);
  87
  88         return report_return_code(rc);
  89 }
  90
  91 static int do_tpm_extend(cmd_tbl_t *cmdtp, int flag, int argc,
  92                          char * const argv[])
  93 {
  94         u32 index, rc;
  95         u8 in_digest[20], out_digest[20];
  96
  97         if (argc != 3)
  98                 return CMD_RET_USAGE;
  99         index = simple_strtoul(argv[1], NULL, 0);
 100         if (!parse_byte_string(argv[2], in_digest, NULL)) {
 101                 printf("Couldn't parse byte string %s\n", argv[2]);
 102                 return CMD_RET_FAILURE;
 103         }
 104
 105         rc = tpm_extend(index, in_digest, out_digest);
 106         if (!rc) {
 107                 puts("PCR value after execution of the command:\n");
 108                 print_byte_string(out_digest, sizeof(out_digest));
 109         }
 110
 111         return report_return_code(rc);
 112 }
 113
 114 static int do_tpm_pcr_read(cmd_tbl_t *cmdtp, int flag, int argc,
 115                            char * const argv[])
 116 {
 117         u32 index, count, rc;
 118         void *data;
 119
 120         if (argc != 4)
 121                 return CMD_RET_USAGE;
 122         index = simple_strtoul(argv[1], NULL, 0);
 123         data = (void *)simple_strtoul(argv[2], NULL, 0);
 124         count = simple_strtoul(argv[3], NULL, 0);
 125
 126         rc = tpm_pcr_read(index, data, count);
 127         if (!rc) {
 128                 puts("Named PCR content:\n");
 129                 print_byte_string(data, count);
 130         }
 131
 132         return report_return_code(rc);
 133 }
 134
 135 static int do_tpm_tsc_physical_presence(cmd_tbl_t *cmdtp, int flag, int argc,
 136                                         char * const argv[])
 137 {
 138         u16 presence;
 139
 140         if (argc != 2)
 141                 return CMD_RET_USAGE;
 142         presence = (u16)simple_strtoul(argv[1], NULL, 0);
 143
 144         return report_return_code(tpm_tsc_physical_presence(presence));
 145 }
 146
 147 static int do_tpm_read_pubek(cmd_tbl_t *cmdtp, int flag, int argc,
 148                              char * const argv[])
 149 {
 150         u32 count, rc;
 151         void *data;
 152
 153         if (argc != 3)
 154                 return CMD_RET_USAGE;
 155         data = (void *)simple_strtoul(argv[1], NULL, 0);
 156         count = simple_strtoul(argv[2], NULL, 0);
 157
 158         rc = tpm_read_pubek(data, count);
 159         if (!rc) {
 160                 puts("pubek value:\n");
 161                 print_byte_string(data, count);
 162         }
 163
 164         return report_return_code(rc);
 165 }
 166
 167 static int do_tpm_physical_set_deactivated(cmd_tbl_t *cmdtp, int flag, int argc,
 168                                            char * const argv[])
 169 {
 170         u8 state;
 171
 172         if (argc != 2)
 173                 return CMD_RET_USAGE;
 174         state = (u8)simple_strtoul(argv[1], NULL, 0);
 175
 176         return report_return_code(tpm_physical_set_deactivated(state));
 177 }
 178
 179 static int do_tpm_get_capability(cmd_tbl_t *cmdtp, int flag, int argc,
 180                                  char * const argv[])
 181 {
 182         u32 cap_area, sub_cap, rc;
 183         void *cap;
 184         size_t count;
 185
 186         if (argc != 5)
 187                 return CMD_RET_USAGE;
 188         cap_area = simple_strtoul(argv[1], NULL, 0);
 189         sub_cap = simple_strtoul(argv[2], NULL, 0);
 190         cap = (void *)simple_strtoul(argv[3], NULL, 0);
 191         count = simple_strtoul(argv[4], NULL, 0);
 192
 193         rc = tpm_get_capability(cap_area, sub_cap, cap, count);
 194         if (!rc) {
 195                 puts("capability information:\n");
 196                 print_byte_string(cap, count);
 197         }
 198
 199         return report_return_code(rc);
 200 }
 201
 202 static int do_tpm_raw_transfer(cmd_tbl_t *cmdtp, int flag, int argc,
 203                                char * const argv[])
 204 {
 205         struct udevice *dev;
 206         void *command;
 207         u8 response[1024];
 208         size_t count, response_length = sizeof(response);
 209         u32 rc;
 210
 211         command = parse_byte_string(argv[1], NULL, &count);
 212         if (!command) {
 213                 printf("Couldn't parse byte string %s\n", argv[1]);
 214                 return CMD_RET_FAILURE;
 215         }
 216
 217         rc = get_tpm(&dev);
 218         if (rc)
 219                 return rc;
 220
 221         rc = tpm_xfer(dev, command, count, response, &response_length);
 222         free(command);
 223         if (!rc) {
 224                 puts("tpm response:\n");
 225                 print_byte_string(response, response_length);
 226         }
 227
 228         return report_return_code(rc);
 229 }
 230
 231 static int do_tpm_nv_define(cmd_tbl_t *cmdtp, int flag, int argc,
 232                             char * const argv[])
 233 {
 234         u32 index, perm, size;
 235
 236         if (argc != 4)
 237                 return CMD_RET_USAGE;
 238         size = type_string_get_space_size(argv[1]);
 239         if (!size) {
 240                 printf("Couldn't parse arguments\n");
 241                 return CMD_RET_USAGE;
 242         }
 243         index = simple_strtoul(argv[2], NULL, 0);
 244         perm = simple_strtoul(argv[3], NULL, 0);
 245
 246         return report_return_code(tpm_nv_define_space(index, perm, size));
 247 }
 248
 249 static int do_tpm_nv_read(cmd_tbl_t *cmdtp, int flag, int argc,
 250                           char * const argv[])
 251 {
 252         u32 index, count, err;
 253         void *data;
 254
 255         if (argc < 3)
 256                 return CMD_RET_USAGE;
 257         if (argc != 3 + type_string_get_num_values(argv[1]))
 258                 return CMD_RET_USAGE;
 259         index = simple_strtoul(argv[2], NULL, 0);
 260         data = type_string_alloc(argv[1], &count);
 261         if (!data) {
 262                 printf("Couldn't parse arguments\n");
 263                 return CMD_RET_USAGE;
 264         }
 265
 266         err = tpm_nv_read_value(index, data, count);
 267         if (!err) {
 268                 if (type_string_write_vars(argv[1], data, argv + 3)) {
 269                         printf("Couldn't write to variables\n");
 270                         err = ~0;
 271                 }
 272         }
 273         free(data);
 274
 275         return report_return_code(err);
 276 }
 277
 278 static int do_tpm_nv_write(cmd_tbl_t *cmdtp, int flag, int argc,
 279                            char * const argv[])
 280 {
 281         u32 index, count, err;
 282         void *data;
 283
 284         if (argc < 3)
 285                 return CMD_RET_USAGE;
 286         if (argc != 3 + type_string_get_num_values(argv[1]))
 287                 return CMD_RET_USAGE;
 288         index = simple_strtoul(argv[2], NULL, 0);
 289         data = type_string_alloc(argv[1], &count);
 290         if (!data) {
 291                 printf("Couldn't parse arguments\n");
 292                 return CMD_RET_USAGE;
 293         }
 294         if (type_string_pack(argv[1], argv + 3, data)) {
 295                 printf("Couldn't parse arguments\n");
 296                 free(data);
 297                 return CMD_RET_USAGE;
 298         }
 299
 300         err = tpm_nv_write_value(index, data, count);
 301         free(data);
 302
 303         return report_return_code(err);
 304 }
 305
 306 #ifdef CONFIG_TPM_AUTH_SESSIONS
 307
 308 static int do_tpm_oiap(cmd_tbl_t *cmdtp, int flag, int argc,
 309                        char * const argv[])
 310 {
 311         u32 auth_handle, err;
 312
 313         err = tpm_oiap(&auth_handle);
 314
 315         return report_return_code(err);
 316 }
 317
 318 #ifdef CONFIG_TPM_LOAD_KEY_BY_SHA1
 319 static int do_tpm_load_key_by_sha1(cmd_tbl_t *cmdtp, int flag, int argc, char *
 320                                    const argv[])
 321 {
 322         u32 parent_handle = 0;
 323         u32 key_len, key_handle, err;
 324         u8 usage_auth[DIGEST_LENGTH];
 325         u8 parent_hash[DIGEST_LENGTH];
 326         void *key;
 327
 328         if (argc < 5)
 329                 return CMD_RET_USAGE;
 330
 331         parse_byte_string(argv[1], parent_hash, NULL);
 332         key = (void *)simple_strtoul(argv[2], NULL, 0);
 333         key_len = simple_strtoul(argv[3], NULL, 0);
 334         if (strlen(argv[4]) != 2 * DIGEST_LENGTH)
 335                 return CMD_RET_FAILURE;
 336         parse_byte_string(argv[4], usage_auth, NULL);
 337
 338         err = tpm_find_key_sha1(usage_auth, parent_hash, &parent_handle);
 339         if (err) {
 340                 printf("Could not find matching parent key (err = %d)\n", err);
 341                 return CMD_RET_FAILURE;
 342         }
 343
 344         printf("Found parent key %08x\n", parent_handle);
 345
 346         err = tpm_load_key2_oiap(parent_handle, key, key_len, usage_auth,
 347                                  &key_handle);
 348         if (!err) {
 349                 printf("Key handle is 0x%x\n", key_handle);
 350                 env_set_hex("key_handle", key_handle);
 351         }
 352
 353         return report_return_code(err);
 354 }
 355 #endif /* CONFIG_TPM_LOAD_KEY_BY_SHA1 */
 356
 357 static int do_tpm_load_key2_oiap(cmd_tbl_t *cmdtp, int flag, int argc,
 358                                  char * const argv[])
 359 {
 360         u32 parent_handle, key_len, key_handle, err;
 361         u8 usage_auth[DIGEST_LENGTH];
 362         void *key;
 363
 364         if (argc < 5)
 365                 return CMD_RET_USAGE;
 366
 367         parent_handle = simple_strtoul(argv[1], NULL, 0);
 368         key = (void *)simple_strtoul(argv[2], NULL, 0);
 369         key_len = simple_strtoul(argv[3], NULL, 0);
 370         if (strlen(argv[4]) != 2 * DIGEST_LENGTH)
 371                 return CMD_RET_FAILURE;
 372         parse_byte_string(argv[4], usage_auth, NULL);
 373
 374         err = tpm_load_key2_oiap(parent_handle, key, key_len, usage_auth,
 375                                  &key_handle);
 376         if (!err)
 377                 printf("Key handle is 0x%x\n", key_handle);
 378
 379         return report_return_code(err);
 380 }
 381
 382 static int do_tpm_get_pub_key_oiap(cmd_tbl_t *cmdtp, int flag, int argc,
 383                                    char * const argv[])
 384 {
 385         u32 key_handle, err;
 386         u8 usage_auth[DIGEST_LENGTH];
 387         u8 pub_key_buffer[TPM_PUBKEY_MAX_LENGTH];
 388         size_t pub_key_len = sizeof(pub_key_buffer);
 389
 390         if (argc < 3)
 391                 return CMD_RET_USAGE;
 392
 393         key_handle = simple_strtoul(argv[1], NULL, 0);
 394         if (strlen(argv[2]) != 2 * DIGEST_LENGTH)
 395                 return CMD_RET_FAILURE;
 396         parse_byte_string(argv[2], usage_auth, NULL);
 397
 398         err = tpm_get_pub_key_oiap(key_handle, usage_auth, pub_key_buffer,
 399                                    &pub_key_len);
 400         if (!err) {
 401                 printf("dump of received pub key structure:\n");
 402                 print_byte_string(pub_key_buffer, pub_key_len);
 403         }
 404         return report_return_code(err);
 405 }
 406
 407 TPM_COMMAND_NO_ARG(tpm_end_oiap)
 408
 409 #endif /* CONFIG_TPM_AUTH_SESSIONS */
 410
 411 #ifdef CONFIG_TPM_FLUSH_RESOURCES
 412 static int do_tpm_flush(cmd_tbl_t *cmdtp, int flag, int argc,
 413                         char * const argv[])
 414 {
 415         int type = 0;
 416
 417         if (argc != 3)
 418                 return CMD_RET_USAGE;
 419
 420         if (!strcasecmp(argv[1], "key"))
 421                 type = TPM_RT_KEY;
 422         else if (!strcasecmp(argv[1], "auth"))
 423                 type = TPM_RT_AUTH;
 424         else if (!strcasecmp(argv[1], "hash"))
 425                 type = TPM_RT_HASH;
 426         else if (!strcasecmp(argv[1], "trans"))
 427                 type = TPM_RT_TRANS;
 428         else if (!strcasecmp(argv[1], "context"))
 429                 type = TPM_RT_CONTEXT;
 430         else if (!strcasecmp(argv[1], "counter"))
 431                 type = TPM_RT_COUNTER;
 432         else if (!strcasecmp(argv[1], "delegate"))
 433                 type = TPM_RT_DELEGATE;
 434         else if (!strcasecmp(argv[1], "daa_tpm"))
 435                 type = TPM_RT_DAA_TPM;
 436         else if (!strcasecmp(argv[1], "daa_v0"))
 437                 type = TPM_RT_DAA_V0;
 438         else if (!strcasecmp(argv[1], "daa_v1"))
 439                 type = TPM_RT_DAA_V1;
 440
 441         if (!type) {
 442                 printf("Resource type %s unknown.\n", argv[1]);
 443                 return -1;
 444         }
 445
 446         if (!strcasecmp(argv[2], "all")) {
 447                 u16 res_count;
 448                 u8 buf[288];
 449                 u8 *ptr;
 450                 int err;
 451                 uint i;
 452
 453                 /* fetch list of already loaded resources in the TPM */
 454                 err = tpm_get_capability(TPM_CAP_HANDLE, type, buf,
 455                                          sizeof(buf));
 456                 if (err) {
 457                         printf("tpm_get_capability returned error %d.\n", err);
 458                         return -1;
 459                 }
 460                 res_count = get_unaligned_be16(buf);
 461                 ptr = buf + 2;
 462                 for (i = 0; i < res_count; ++i, ptr += 4)
 463                         tpm_flush_specific(get_unaligned_be32(ptr), type);
 464         } else {
 465                 u32 handle = simple_strtoul(argv[2], NULL, 0);
 466
 467                 if (!handle) {
 468                         printf("Illegal resource handle %s\n", argv[2]);
 469                         return -1;
 470                 }
 471                 tpm_flush_specific(cpu_to_be32(handle), type);
 472         }
 473
 474         return 0;
 475 }
 476 #endif /* CONFIG_TPM_FLUSH_RESOURCES */
 477
 478 #ifdef CONFIG_TPM_LIST_RESOURCES
 479 static int do_tpm_list(cmd_tbl_t *cmdtp, int flag, int argc,
 480                        char * const argv[])
 481 {
 482         int type = 0;
 483         u16 res_count;
 484         u8 buf[288];
 485         u8 *ptr;
 486         int err;
 487         uint i;
 488
 489         if (argc != 2)
 490                 return CMD_RET_USAGE;
 491
 492         if (!strcasecmp(argv[1], "key"))
 493                 type = TPM_RT_KEY;
 494         else if (!strcasecmp(argv[1], "auth"))
 495                 type = TPM_RT_AUTH;
 496         else if (!strcasecmp(argv[1], "hash"))
 497                 type = TPM_RT_HASH;
 498         else if (!strcasecmp(argv[1], "trans"))
 499                 type = TPM_RT_TRANS;
 500         else if (!strcasecmp(argv[1], "context"))
 501                 type = TPM_RT_CONTEXT;
 502         else if (!strcasecmp(argv[1], "counter"))
 503                 type = TPM_RT_COUNTER;
 504         else if (!strcasecmp(argv[1], "delegate"))
 505                 type = TPM_RT_DELEGATE;
 506         else if (!strcasecmp(argv[1], "daa_tpm"))
 507                 type = TPM_RT_DAA_TPM;
 508         else if (!strcasecmp(argv[1], "daa_v0"))
 509                 type = TPM_RT_DAA_V0;
 510         else if (!strcasecmp(argv[1], "daa_v1"))
 511                 type = TPM_RT_DAA_V1;
 512
 513         if (!type) {
 514                 printf("Resource type %s unknown.\n", argv[1]);
 515                 return -1;
 516         }
 517
 518         /* fetch list of already loaded resources in the TPM */
 519         err = tpm_get_capability(TPM_CAP_HANDLE, type, buf,
 520                                  sizeof(buf));
 521         if (err) {
 522                 printf("tpm_get_capability returned error %d.\n", err);
 523                 return -1;
 524         }
 525         res_count = get_unaligned_be16(buf);
 526         ptr = buf + 2;
 527
 528         printf("Resources of type %s (%02x):\n", argv[1], type);
 529         if (!res_count) {
 530                 puts("None\n");
 531         } else {
 532                 for (i = 0; i < res_count; ++i, ptr += 4)
 533                         printf("Index %d: %08x\n", i, get_unaligned_be32(ptr));
 534         }
 535
 536         return 0;
 537 }
 538 #endif /* CONFIG_TPM_LIST_RESOURCES */
 539
 540 TPM_COMMAND_NO_ARG(tpm_self_test_full)
 541 TPM_COMMAND_NO_ARG(tpm_continue_self_test)
 542 TPM_COMMAND_NO_ARG(tpm_force_clear)
 543 TPM_COMMAND_NO_ARG(tpm_physical_enable)
 544 TPM_COMMAND_NO_ARG(tpm_physical_disable)
 545
 546 static cmd_tbl_t tpm1_commands[] = {
 547         U_BOOT_CMD_MKENT(info, 0, 1, do_tpm_info, "", ""),
 548         U_BOOT_CMD_MKENT(init, 0, 1, do_tpm_init, "", ""),
 549         U_BOOT_CMD_MKENT(startup, 0, 1,
 550                          do_tpm_startup, "", ""),
 551         U_BOOT_CMD_MKENT(self_test_full, 0, 1,
 552                          do_tpm_self_test_full, "", ""),
 553         U_BOOT_CMD_MKENT(continue_self_test, 0, 1,
 554                          do_tpm_continue_self_test, "", ""),
 555         U_BOOT_CMD_MKENT(force_clear, 0, 1,
 556                          do_tpm_force_clear, "", ""),
 557         U_BOOT_CMD_MKENT(physical_enable, 0, 1,
 558                          do_tpm_physical_enable, "", ""),
 559         U_BOOT_CMD_MKENT(physical_disable, 0, 1,
 560                          do_tpm_physical_disable, "", ""),
 561         U_BOOT_CMD_MKENT(nv_define_space, 0, 1,
 562                          do_tpm_nv_define_space, "", ""),
 563         U_BOOT_CMD_MKENT(nv_read_value, 0, 1,
 564                          do_tpm_nv_read_value, "", ""),
 565         U_BOOT_CMD_MKENT(nv_write_value, 0, 1,
 566                          do_tpm_nv_write_value, "", ""),
 567         U_BOOT_CMD_MKENT(extend, 0, 1,
 568                          do_tpm_extend, "", ""),
 569         U_BOOT_CMD_MKENT(pcr_read, 0, 1,
 570                          do_tpm_pcr_read, "", ""),
 571         U_BOOT_CMD_MKENT(tsc_physical_presence, 0, 1,
 572                          do_tpm_tsc_physical_presence, "", ""),
 573         U_BOOT_CMD_MKENT(read_pubek, 0, 1,
 574                          do_tpm_read_pubek, "", ""),
 575         U_BOOT_CMD_MKENT(physical_set_deactivated, 0, 1,
 576                          do_tpm_physical_set_deactivated, "", ""),
 577         U_BOOT_CMD_MKENT(get_capability, 0, 1,
 578                          do_tpm_get_capability, "", ""),
 579         U_BOOT_CMD_MKENT(raw_transfer, 0, 1,
 580                          do_tpm_raw_transfer, "", ""),
 581         U_BOOT_CMD_MKENT(nv_define, 0, 1,
 582                          do_tpm_nv_define, "", ""),
 583         U_BOOT_CMD_MKENT(nv_read, 0, 1,
 584                          do_tpm_nv_read, "", ""),
 585         U_BOOT_CMD_MKENT(nv_write, 0, 1,
 586                          do_tpm_nv_write, "", ""),
 587 #ifdef CONFIG_TPM_AUTH_SESSIONS
 588         U_BOOT_CMD_MKENT(oiap, 0, 1,
 589                          do_tpm_oiap, "", ""),
 590         U_BOOT_CMD_MKENT(end_oiap, 0, 1,
 591                          do_tpm_end_oiap, "", ""),
 592         U_BOOT_CMD_MKENT(load_key2_oiap, 0, 1,
 593                          do_tpm_load_key2_oiap, "", ""),
 594 #ifdef CONFIG_TPM_LOAD_KEY_BY_SHA1
 595         U_BOOT_CMD_MKENT(load_key_by_sha1, 0, 1,
 596                          do_tpm_load_key_by_sha1, "", ""),
 597 #endif /* CONFIG_TPM_LOAD_KEY_BY_SHA1 */
 598         U_BOOT_CMD_MKENT(get_pub_key_oiap, 0, 1,
 599                          do_tpm_get_pub_key_oiap, "", ""),
 600 #endif /* CONFIG_TPM_AUTH_SESSIONS */
 601 #ifdef CONFIG_TPM_FLUSH_RESOURCES
 602         U_BOOT_CMD_MKENT(flush, 0, 1,
 603                          do_tpm_flush, "", ""),
 604 #endif /* CONFIG_TPM_FLUSH_RESOURCES */
 605 #ifdef CONFIG_TPM_LIST_RESOURCES
 606         U_BOOT_CMD_MKENT(list, 0, 1,
 607                          do_tpm_list, "", ""),
 608 #endif /* CONFIG_TPM_LIST_RESOURCES */
 609 };
 610
 611 cmd_tbl_t *get_tpm_commands(unsigned int *size)
 612 {
 613         *size = ARRAY_SIZE(tpm1_commands);
 614
 615         return tpm1_commands;
 616 }
 617
 618 U_BOOT_CMD(tpm, CONFIG_SYS_MAXARGS, 1, do_tpm,
 619 "Issue a TPMv1.x command",
 620 "cmd args...\n"
 621 "    - Issue TPM command <cmd> with arguments <args...>.\n"
 622 "Admin Startup and State Commands:\n"
 623 "  info - Show information about the TPM\n"
 624 "  init\n"
 625 "    - Put TPM into a state where it waits for 'startup' command.\n"
 626 "  startup mode\n"
 627 "    - Issue TPM_Starup command.  <mode> is one of TPM_ST_CLEAR,\n"
 628 "      TPM_ST_STATE, and TPM_ST_DEACTIVATED.\n"
 629 "Admin Testing Commands:\n"
 630 "  self_test_full\n"
 631 "    - Test all of the TPM capabilities.\n"
 632 "  continue_self_test\n"
 633 "    - Inform TPM that it should complete the self-test.\n"
 634 "Admin Opt-in Commands:\n"
 635 "  physical_enable\n"
 636 "    - Set the PERMANENT disable flag to FALSE using physical presence as\n"
 637 "      authorization.\n"
 638 "  physical_disable\n"
 639 "    - Set the PERMANENT disable flag to TRUE using physical presence as\n"
 640 "      authorization.\n"
 641 "  physical_set_deactivated 0|1\n"
 642 "    - Set deactivated flag.\n"
 643 "Admin Ownership Commands:\n"
 644 "  force_clear\n"
 645 "    - Issue TPM_ForceClear command.\n"
 646 "  tsc_physical_presence flags\n"
 647 "    - Set TPM device's Physical Presence flags to <flags>.\n"
 648 "The Capability Commands:\n"
 649 "  get_capability cap_area sub_cap addr count\n"
 650 "    - Read <count> bytes of TPM capability indexed by <cap_area> and\n"
 651 "      <sub_cap> to memory address <addr>.\n"
 652 #if defined(CONFIG_TPM_FLUSH_RESOURCES) || defined(CONFIG_TPM_LIST_RESOURCES)
 653 "Resource management functions\n"
 654 #endif
 655 #ifdef CONFIG_TPM_FLUSH_RESOURCES
 656 "  flush resource_type id\n"
 657 "    - flushes a resource of type <resource_type> (may be one of key, auth,\n"
 658 "      hash, trans, context, counter, delegate, daa_tpm, daa_v0, daa_v1),\n"
 659 "      and id <id> from the TPM. Use an <id> of \"all\" to flush all\n"
 660 "      resources of that type.\n"
 661 #endif /* CONFIG_TPM_FLUSH_RESOURCES */
 662 #ifdef CONFIG_TPM_LIST_RESOURCES
 663 "  list resource_type\n"
 664 "    - lists resources of type <resource_type> (may be one of key, auth,\n"
 665 "      hash, trans, context, counter, delegate, daa_tpm, daa_v0, daa_v1),\n"
 666 "      contained in the TPM.\n"
 667 #endif /* CONFIG_TPM_LIST_RESOURCES */
 668 #ifdef CONFIG_TPM_AUTH_SESSIONS
 669 "Storage functions\n"
 670 "  loadkey2_oiap parent_handle key_addr key_len usage_auth\n"
 671 "    - loads a key data from memory address <key_addr>, <key_len> bytes\n"
 672 "      into TPM using the parent key <parent_handle> with authorization\n"
 673 "      <usage_auth> (20 bytes hex string).\n"
 674 #ifdef CONFIG_TPM_LOAD_KEY_BY_SHA1
 675 "  load_key_by_sha1 parent_hash key_addr key_len usage_auth\n"
 676 "    - loads a key data from memory address <key_addr>, <key_len> bytes\n"
 677 "      into TPM using the parent hash <parent_hash> (20 bytes hex string)\n"
 678 "      with authorization <usage_auth> (20 bytes hex string).\n"
 679 #endif /* CONFIG_TPM_LOAD_KEY_BY_SHA1 */
 680 "  get_pub_key_oiap key_handle usage_auth\n"
 681 "    - get the public key portion of a loaded key <key_handle> using\n"
 682 "      authorization <usage auth> (20 bytes hex string)\n"
 683 #endif /* CONFIG_TPM_AUTH_SESSIONS */
 684 "Endorsement Key Handling Commands:\n"
 685 "  read_pubek addr count\n"
 686 "    - Read <count> bytes of the public endorsement key to memory\n"
 687 "      address <addr>\n"
 688 "Integrity Collection and Reporting Commands:\n"
 689 "  extend index digest_hex_string\n"
 690 "    - Add a new measurement to a PCR.  Update PCR <index> with the 20-bytes\n"
 691 "      <digest_hex_string>\n"
 692 "  pcr_read index addr count\n"
 693 "    - Read <count> bytes from PCR <index> to memory address <addr>.\n"
 694 #ifdef CONFIG_TPM_AUTH_SESSIONS
 695 "Authorization Sessions\n"
 696 "  oiap\n"
 697 "    - setup an OIAP session\n"
 698 "  end_oiap\n"
 699 "    - terminates an active OIAP session\n"
 700 #endif /* CONFIG_TPM_AUTH_SESSIONS */
 701 "Non-volatile Storage Commands:\n"
 702 "  nv_define_space index permission size\n"
 703 "    - Establish a space at index <index> with <permission> of <size> bytes.\n"
 704 "  nv_read_value index addr count\n"
 705 "    - Read <count> bytes from space <index> to memory address <addr>.\n"
 706 "  nv_write_value index addr count\n"
 707 "    - Write <count> bytes from memory address <addr> to space <index>.\n"
 708 "Miscellaneous helper functions:\n"
 709 "  raw_transfer byte_string\n"
 710 "    - Send a byte string <byte_string> to TPM and print the response.\n"
 711 " Non-volatile storage helper functions:\n"
 712 "    These helper functions treat a non-volatile space as a non-padded\n"
 713 "    sequence of integer values.  These integer values are defined by a type\n"
 714 "    string, which is a text string of 'bwd' characters: 'b' means a 8-bit\n"
 715 "    value, 'w' 16-bit value, 'd' 32-bit value.  All helper functions take\n"
 716 "    a type string as their first argument.\n"
 717 "  nv_define type_string index perm\n"
 718 "    - Define a space <index> with permission <perm>.\n"
 719 "  nv_read types_string index vars...\n"
 720 "    - Read from space <index> to environment variables <vars...>.\n"
 721 "  nv_write types_string index values...\n"
 722 "    - Write to space <index> from values <values...>.\n"
 723 );