Skip to content

Commit 35a82d0

Browse files
committed
docs/guides/intel-txt.md: TPM clear does not clear indices
Signed-off-by: Michał Kopeć <michal.kopec@3mdeb.com>
1 parent 6fe7aa5 commit 35a82d0

1 file changed

Lines changed: 5 additions & 12 deletions

File tree

docs/guides/intel-txt.md

Lines changed: 5 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -76,9 +76,9 @@ and survive reboots:
7676
| `0x01c10103` | PS | Platform Supplier policy, written by the platform manufacturer
7777
| `0x01c10102` | AUX | Auxiliary index used by the ACM to store TXT state
7878

79-
A TPM that has never been provisioned, or that has been cleared, has neither
80-
index defined. A measured launch on such a platform fails in the SINIT ACM with
81-
an LCP or TPM error (see [Reading the TXT error code](#reading-the-txt-error-code)).
79+
A TPM that has never been provisioned, has neither index defined. A measured
80+
launch on such a platform fails in the SINIT ACM with an LCP or TPM error (see
81+
[Reading the TXT error code](#reading-the-txt-error-code)).
8282

8383
Provisioning is done from the running OS with `txt-prov` from the
8484
[Converged Security Suite][css]. Build it:
@@ -135,7 +135,7 @@ The command prompts for a password, which is mandatory and not echoed. Its
135135
SHA-256 hash becomes the authorization policy protecting the PS index, so
136136
writing or deleting that index later - with `ps-update` or `ps-delete` -
137137
requires the same password. Record it somewhere safe; there is no recovery
138-
path short of clearing the TPM.
138+
path, and even a TPM clear does not remove the indices.
139139

140140
Verify the result:
141141

@@ -174,12 +174,6 @@ The PS index `AuthPolicy` above is an example: it is derived from the password
174174
entered during provisioning and will differ on your platform. The AUX index
175175
`AuthPolicy` is a fixed Intel-defined value and should match exactly.
176176

177-
!!! warning
178-
179-
Clearing the TPM (from the setup menu, or with `tpm2_clear`) removes the
180-
AUX index and breaks measured launch until the platform is provisioned
181-
again. Do not clear the TPM without planning to re-run `txt-prov`.
182-
183177
[css]: https://github.com/9elements/converged-security-suite
184178

185179
## Verifying that the firmware brought TXT up
@@ -597,8 +591,7 @@ Two combinations carry a decodable sub-field:
597591

598592
- **Class `0x0d` with major error `0x0a`** - the ACM hit a TPM error, and bits
599593
24:16 hold the TPM return code. This is the signature to look for when the
600-
TPM is not [provisioned](#tpm-provisioning), has been cleared, or is
601-
unresponsive.
594+
TPM is not [provisioned](#tpm-provisioning) or is unresponsive.
602595
- **Class `0x10`** - an LCP version 2 error. Bits 21:16 hold the minor error
603596
code and bits 24:22 the index of the policy list element that failed. Expect
604597
this when the PS index holds a policy the current MLE does not satisfy.

0 commit comments

Comments
 (0)