From 55b11d3090265af26a45f9344b880b2a7ec50b91 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vincent=20Stehl=C3=A9?= <vincent.stehle@arm.com>
Date: Fri, 8 Sep 2023 11:09:43 +0200
Subject: [PATCH] chapter2: recommend smbios
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Strongly recommend SMBIOS, without requiring any specific table or
  structure for now.
- Add a reference to the SMBIOS specification v3.7.0.

Suggested-by: Peter Robinson <pbrobinson@redhat.com>
Signed-off-by: Vincent Stehlé <vincent.stehle@arm.com>
---
 source/chapter2-uefi.rst | 20 ++++++++++++++++++++
 source/references.rst    |  4 ++++
 2 files changed, 24 insertions(+)

diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst
index 851c52f..b5c03d5 100644
--- a/source/chapter2-uefi.rst
+++ b/source/chapter2-uefi.rst
@@ -385,6 +385,26 @@ The DTB must be contained in memory of type `EfiACPIReclaimMemory`.
 .. [#ACPIMemNote] `EfiACPIReclaimMemory` was chosen to match the recommendation
    for ACPI tables which fulfill the same task as the DTB.
 
+SMBIOS
+------
+
+It is strongly recommended that firmware provides SMBIOS tables and structures.
+[#SMBNote]_
+
+If firmware provides SMBIOS tables and structures then it must provide them as
+described in :UEFI:`4.6.1.1` and [SMBIOS]_ § 5 & 6.
+
+.. warning:: A future version of this specification will require firmware to
+   provide SMBIOS tables and strutures and will explicitly list which ones are
+   required.
+
+.. [#SMBNote] Support tools such as sosreport use SMBIOS to provide information
+   to users and collect information for support cases.
+   https://github.com/sosreport/sos
+
+   SMBIOS informations are also useful to identify systems in a fleet of
+   devices.
+
 UEFI Protocols
 ==============
 
diff --git a/source/references.rst b/source/references.rst
index 3631724..e9627a5 100644
--- a/source/references.rst
+++ b/source/references.rst
@@ -56,6 +56,10 @@ Bibliography
 
 .. [RVUEFI] `RISC-V UEFI Protocol Specification <https://github.com/riscv-non-isa/riscv-uefi/releases/download/1.0.0/RISCV_UEFI_PROTOCOL-spec.pdf>`_
 
+.. [SMBIOS] `System Management BIOS (SMBIOS) Reference Specification v3.7.0
+   <https://www.dmtf.org/sites/default/files/standards/documents/DSP0134_3.7.0.pdf>`_,
+   July 2023, `DMTF <https://www.dmtf.org>`_
+
 .. [TCG2] `TCG EFI Protocol Specification, Family “2.0”, Level 00 Revision 00.13.
    <https://trustedcomputinggroup.org/wp-content/uploads/EFI-Protocol-Specification-rev13-160330final.pdf>`_
    March 2016, `Trusted Computing Group <https://trustedcomputinggroup.org/>`_