File docs-nvme-add-documentation.patch of Package qemu

Overview Repositories Revisions Requests Users Attributes Meta

File docs-nvme-add-documentation.patch of Package qemu

From: Dmitry Tihov <d.tihov@yadro.com>
Date: Wed, 11 May 2022 13:41:43 +0000
Subject: docs/nvme: add documentation

Describe new protection info pass nvme feature.

Signed-off-by: Dmitry Tihov <d.tihov@yadro.com>
---
 docs/system/devices/nvme.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/system/devices/nvme.rst b/docs/system/devices/nvme.rst
index b5acb2a9c19dab27264a2bc65023..8a7d6c5de64aa067cc867fb33e4f 100644
--- a/docs/system/devices/nvme.rst
+++ b/docs/system/devices/nvme.rst
@@ -239,3 +239,20 @@ The virtual namespace device supports DIF- and DIX-based protection information
   to ``1`` to transfer protection information as the first eight bytes of
   metadata. Otherwise, the protection information is transferred as the last
   eight bytes.
+
+
+Virtual namespace device can also be backed by integrity capable host block
+device. This way protection information is passed through to/from the host block
+device from/to guest and checked by the host block device itself instead of QEMU.
+
+``pip=BOOL`` (default: ``off``)
+  Set to ``on`` to allow host block device protection information passthrough.
+
+To use this feature nvme-ns backend drive must have Linux io_uring AIO backend
+and host page cache must be avoided. E.g. the following parameters should be used:
+
+.. code-block:: console
+
+   -drive file=/dev/nvme0n1,cache.direct=on,aio=io_uring,format=raw,if=none,id=dif_drive_0
+   -device nvme-ns,logical_block_size=4096,physical_block_size=4096,drive=dif_drive_0,pip=on
+

Places

File docs-nvme-add-documentation.patch of Package qemu

Places