Skip to content

Commit cdefe6c

Browse files
committed
docs: document new manifest field APEIP
1 parent 0356a3c commit cdefe6c

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/docs/architecture/components/manifest.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ The manifest has the following higher level structure:
2020
{
2121
"ProductName": "<product-name>",
2222
"TrustedMeasurement": "<trusted-measurement>",
23+
"APEIP": "<ap-eip>",
2324
"MinimumTCB": { },
2425
"GuestPolicy": { },
2526
"PlatformInfo": { }
@@ -134,6 +135,15 @@ The kernel command line contains the dm-verity hash of the root filesystem, whic
134135
It's the (launch) `MEASUREMENT` from the SNP `ATTESTATION_REPORT`, according to Table 23 in the [SEV ABI Spec].
135136
Contrast is able to extrapolate from this single-vCPU measurement to those for up to 220 vCPUs.
136137

138+
### `ReferenceValues.snp.*.APEIP` {#snp-ap-eip}
139+
140+
The `APEIP` is the SEV-ES reset vector read from the OVMF firmware's footer GUID table.
141+
It's used together with [`TrustedMeasurement`](#snp-trusted-measurement) to derive the expected launch measurement for any vCPU count between 2 and 220.
142+
143+
This field is injected automatically by `contrast generate` from the OVMF binary embedded in the CLI build and doesn't need to be set manually.
144+
145+
When absent (manifests generated by older CLI versions), verification falls back to treating `TrustedMeasurement` as an exact vCPU measurement.
146+
137147
### `ReferenceValues.snp.*.MinimumTCB` {#snp-minimum-tcb}
138148

139149
The `MinimumTCB` defines the minimum secure version numbers (SVNs) for the platform components.

0 commit comments

Comments
 (0)