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 ); 724
