| What: /sys/kernel/config/tsm/report/$name/inblob |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (WO) Up to 64 bytes of user specified binary data. For replay |
| protection this should include a nonce, but the kernel does not |
| place any restrictions on the content. |
| |
| What: /sys/kernel/config/tsm/report/$name/outblob |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) Binary attestation report generated from @inblob and other |
| options The format of the report is implementation specific |
| where the implementation is conveyed via the @provider |
| attribute. |
| |
| What: /sys/kernel/config/tsm/report/$name/auxblob |
| Date: October, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) Optional supplemental data that a TSM may emit, visibility |
| of this attribute depends on TSM, and may be empty if no |
| auxiliary data is available. |
| |
| When @provider is "sev_guest" this file contains the |
| "cert_table" from SEV-ES Guest-Hypervisor Communication Block |
| Standardization v2.03 Section 4.1.8.1 MSG_REPORT_REQ. |
| https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56421.pdf |
| |
| What: /sys/kernel/config/tsm/report/$name/manifestblob |
| Date: January, 2024 |
| KernelVersion: v6.10 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) Optional supplemental data that a TSM may emit, visibility |
| of this attribute depends on TSM, and may be empty if no |
| manifest data is available. |
| |
| See 'service_provider' for information on the format of the |
| manifest blob. |
| |
| What: /sys/kernel/config/tsm/report/$name/provider |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) A name for the format-specification of @outblob like |
| "sev_guest" [1] or "tdx_guest" [2] in the near term, or a |
| common standard format in the future. |
| |
| [1]: SEV Secure Nested Paging Firmware ABI Specification |
| Revision 1.55 Table 22 |
| https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56860.pdf |
| |
| [2]: Intel® Trust Domain Extensions Data Center Attestation |
| Primitives : Quote Generation Library and Quote Verification |
| Library Revision 0.8 Appendix 4,5 |
| https://download.01.org/intel-sgx/latest/dcap-latest/linux/docs/Intel_TDX_DCAP_Quoting_Library_API.pdf |
| |
| What: /sys/kernel/config/tsm/report/$name/generation |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) The value in this attribute increments each time @inblob or |
| any option is written. Userspace can detect conflicts by |
| checking generation before writing to any attribute and making |
| sure the number of writes matches expectations after reading |
| @outblob, or it can prevent conflicts by creating a report |
| instance per requesting context. |
| |
| What: /sys/kernel/config/tsm/report/$name/privlevel |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (WO) Attribute is visible if a TSM implementation provider |
| supports the concept of attestation reports for TVMs running at |
| different privilege levels, like SEV-SNP "VMPL", specify the |
| privilege level via this attribute. The minimum acceptable |
| value is conveyed via @privlevel_floor and the maximum |
| acceptable value is TSM_PRIVLEVEL_MAX (3). |
| |
| What: /sys/kernel/config/tsm/report/$name/privlevel_floor |
| Date: September, 2023 |
| KernelVersion: v6.7 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (RO) Indicates the minimum permissible value that can be written |
| to @privlevel. |
| |
| What: /sys/kernel/config/tsm/report/$name/service_provider |
| Date: January, 2024 |
| KernelVersion: v6.10 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (WO) Attribute is visible if a TSM implementation provider |
| supports the concept of attestation reports from a service |
| provider for TVMs, like SEV-SNP running under an SVSM. |
| Specifying the service provider via this attribute will create |
| an attestation report as specified by the service provider. |
| The only currently supported service provider is "svsm". |
| |
| For the "svsm" service provider, see the Secure VM Service Module |
| for SEV-SNP Guests v1.00 Section 7. For the doc, search for |
| "site:amd.com "Secure VM Service Module for SEV-SNP |
| Guests", docID: 58019" |
| |
| What: /sys/kernel/config/tsm/report/$name/service_guid |
| Date: January, 2024 |
| KernelVersion: v6.10 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (WO) Attribute is visible if a TSM implementation provider |
| supports the concept of attestation reports from a service |
| provider for TVMs, like SEV-SNP running under an SVSM. |
| Specifying an empty/null GUID (00000000-0000-0000-0000-000000) |
| requests all active services within the service provider be |
| part of the attestation report. Specifying a GUID request |
| an attestation report of just the specified service using the |
| manifest form specified by the service_manifest_version |
| attribute. |
| |
| See 'service_provider' for information on the format of the |
| service guid. |
| |
| What: /sys/kernel/config/tsm/report/$name/service_manifest_version |
| Date: January, 2024 |
| KernelVersion: v6.10 |
| Contact: linux-coco@lists.linux.dev |
| Description: |
| (WO) Attribute is visible if a TSM implementation provider |
| supports the concept of attestation reports from a service |
| provider for TVMs, like SEV-SNP running under an SVSM. |
| Indicates the service manifest version requested for the |
| attestation report (default 0). If this field is not set by |
| the user, the default manifest version of the service (the |
| service's initial/first manifest version) is returned. |
| |
| See 'service_provider' for information on the format of the |
| service manifest version. |
