aboutsummaryrefslogtreecommitdiff
path: root/docs/system/devices
diff options
context:
space:
mode:
authorStephen Bates <sbates@raithlin.com>2024-11-29 09:27:39 -0700
committerKlaus Jensen <k.jensen@samsung.com>2025-02-25 12:27:21 +0100
commit23a4b3ebc74bbc6b6f44edf2255864042f122b82 (patch)
tree9feb1d83dc8af3342cdd2cd9ee7d1cc08c73c240 /docs/system/devices
parentb69801dd6b1eb4d107f7c2f643adf0a4e3ec9124 (diff)
downloadqemu-23a4b3ebc74bbc6b6f44edf2255864042f122b82.zip
qemu-23a4b3ebc74bbc6b6f44edf2255864042f122b82.tar.gz
qemu-23a4b3ebc74bbc6b6f44edf2255864042f122b82.tar.bz2
hw/nvme: Add OCP SMART / Health Information Extended Log Page
The Open Compute Project [1] includes a Datacenter NVMe SSD Specification [2]. The most recent version of this specification (as of November 2024) is 2.6.1. This specification layers on top of the NVM Express specifications [3] to provide additional functionality. A key part of of this is the 512 Byte OCP SMART / Health Information Extended log page that is defined in Section 4.8.6 of the specification. We add a controller argument (ocp) that toggles on/off the SMART log extended structure. To accommodate different vendor specific specifications like OCP, we add a multiplexing function (nvme_vendor_specific_log) which will route to the different log functions based on arguments and log ids. We only return the OCP extended SMART log when the command is 0xC0 and ocp has been turned on in the nvme argumants. Though we add the whole nvme SMART log extended structure, we only populate the physical_media_units_{read,written}, log_page_version and log_page_uuid. This patch is based on work done by Joel but has been modified enough that he requested a co-developed-by tag rather than a signed-off-by. [1]: https://www.opencompute.org/ [2]: https://www.opencompute.org/documents/datacenter-nvme-ssd-specification-v2-6-1-pdf [3]: https://nvmexpress.org/specifications/ Signed-off-by: Stephen Bates <sbates@raithlin.com> Co-developed-by: Joel Granados <j.granados@samsung.com> Reviewed-by: Klaus Jensen <k.jensen@samsung.com> Signed-off-by: Klaus Jensen <k.jensen@samsung.com>
Diffstat (limited to 'docs/system/devices')
-rw-r--r--docs/system/devices/nvme.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/system/devices/nvme.rst b/docs/system/devices/nvme.rst
index d2b1ca9..6509b35 100644
--- a/docs/system/devices/nvme.rst
+++ b/docs/system/devices/nvme.rst
@@ -53,6 +53,13 @@ parameters.
Vendor ID. Set this to ``on`` to revert to the unallocated Intel ID
previously used.
+``ocp`` (default: ``off``)
+ The Open Compute Project defines the Datacenter NVMe SSD Specification that
+ sits on top of NVMe. It describes additional commands and NVMe behaviors
+ specific for the Datacenter. When this option is ``on`` OCP features such as
+ the SMART / Health information extended log become available in the
+ controller. We emulate version 5 of this log page.
+
Additional Namespaces
---------------------