Skip to content

Commit 5f48695

Browse files
Kuppuswamy Sathyanarayanandjbw
authored andcommitted
configfs-tsm-report: Document size limits for outblob attributes
The configfs-tsm-report interface can fail with -EFBIG when the attestation report generated by a TSM provider exceeds internal maximums (TSM_REPORT_OUTBLOB_MAX). However, this error condition and its handling are not currently documented in the ABI. Userspace tools need to understand how to interpret various error conditions when reading attestation reports. Document that reads fail with -EFBIG when reports exceed size limits, with guidance on how to resolve them. Reviewed-by: Fang Peter <peter.fang@intel.com> Signed-off-by: Kuppuswamy Sathyanarayanan <sathyanarayanan.kuppuswamy@linux.intel.com> Link: https://patch.msgid.link/20260211001712.1531955-2-sathyanarayanan.kuppuswamy@linux.intel.com Signed-off-by: Dan Williams <dan.j.williams@intel.com>
1 parent 18f7fcd commit 5f48695

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

Documentation/ABI/testing/configfs-tsm-report

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,12 @@ Description:
1717
where the implementation is conveyed via the @provider
1818
attribute.
1919

20+
This interface fails reads and sets errno to EFBIG when the
21+
report generated by @provider exceeds the configfs-tsm-report
22+
internal maximums. Contact the platform provider for the
23+
compatible security module, driver, and attestation library
24+
combination.
25+
2026
What: /sys/kernel/config/tsm/report/$name/auxblob
2127
Date: October, 2023
2228
KernelVersion: v6.7
@@ -31,6 +37,9 @@ Description:
3137
Standardization v2.03 Section 4.1.8.1 MSG_REPORT_REQ.
3238
https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56421.pdf
3339

40+
See "EFBIG" comment in the @outblob description for potential
41+
error conditions.
42+
3443
What: /sys/kernel/config/tsm/report/$name/manifestblob
3544
Date: January, 2024
3645
KernelVersion: v6.10
@@ -43,6 +52,9 @@ Description:
4352
See 'service_provider' for information on the format of the
4453
manifest blob.
4554

55+
See "EFBIG" comment in the @outblob description for potential
56+
error conditions.
57+
4658
What: /sys/kernel/config/tsm/report/$name/provider
4759
Date: September, 2023
4860
KernelVersion: v6.7

0 commit comments

Comments
 (0)