Skip to contentSkip to conversation

examples: add example and fiograph for protection information options

PATCH Applied Ankit Kumar 2 participants 2 messages Aug 16, 2023 1 message not in the archive

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): CGME20230816042708epcas5p293b76e5b342877751083b0bcae448c5d@epcas5p2.samsung.com

#1 lore raw

PATCH 1/1 examples: add example and fiograph for protection information options

Add missing io_uring_cmd ioengine options to fiograph config. Add two example job files for the protection information options. These include one for DIF i.e. extended LBA data size, and the other for DIX i.e. separate metadata buffer case.
Add the corresponding fiograph diagram for these.

---
 examples/uring-cmd-pi-ext.fio |  31 +++++++++++++++++++++++++++++++
 examples/uring-cmd-pi-ext.png | Bin 0 -> 81014 bytes
 examples/uring-cmd-pi-sb.fio  |  32 ++++++++++++++++++++++++++++++++
 examples/uring-cmd-pi-sb.png  | Bin 0 -> 87357 bytes
 tools/fiograph/fiograph.conf  |   2 +-
 5 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 examples/uring-cmd-pi-ext.fio
 create mode 100644 examples/uring-cmd-pi-ext.png
 create mode 100644 examples/uring-cmd-pi-sb.fio
 create mode 100644 examples/uring-cmd-pi-sb.png
examples/uring-cmd-pi-ext.fio new file +31 -0
new file mode 100644
index 00000000..e22ec062
@@ -0,0 +1,31 @@
+# Protection information test with io_uring_cmd I/O engine for nvme-ns generic
+# character device.
+#
+# This requires nvme device to be formatted with extended LBA data size and
+# protection information enabled. This can be done with nvme-cli utility.
+# Replace bs below with the correct extended LBA size.
+#
+# First we sequentially write to the device, without protection information
+# action being set. FIO will generate and send necessary protection
+# information data as per the protection information check option. Later on we
+# sequentially read and verify the device returned protection information data.
+#
+[global]
+filename=/dev/ng0n1
+ioengine=io_uring_cmd
+cmd_type=nvme
+size=1G
+iodepth=32
+bs=4160
+pi_act=0
+pi_chk=GUARD,APPTAG,REFTAG
+apptag=0x0888
+apptag_mask=0xFFFF
+thread=1
+stonewall=1
+
+[write]
+rw=write
+
+[read]
+rw=read
examples/uring-cmd-pi-ext.png new file binary +0 -0
new file mode 100644
index 0000000000000000000000000000000000000000..a102fc1a7ac4165534302611939934a2ff03b56b
GIT binary patch
examples/uring-cmd-pi-sb.fio new file +32 -0
new file mode 100644
index 00000000..b201a7ce
@@ -0,0 +1,32 @@
+# Protection information test with io_uring_cmd I/O engine for nvme-ns generic
+# character device.
+#
+# This requires nvme device to be formatted with separate metadata buffer and
+# protection information enabled. This can be done with nvme-cli utility.
+# Replace md_per_io_size as per the required metadata buffer size for each IO.
+#
+# First we sequentially write to the device, without protection information
+# action being set. FIO will generate and send necessary protection
+# information data as per the protection information check option. Later on we
+# sequentially read and verify the device returned protection information data.
+#
+[global]
+filename=/dev/ng0n1
+ioengine=io_uring_cmd
+cmd_type=nvme
+size=1G
+iodepth=32
+bs=4096
+md_per_io_size=64
+pi_act=0
+pi_chk=GUARD,APPTAG,REFTAG
+apptag=0x0888
+apptag_mask=0xFFFF
+thread=1
+stonewall=1
+
+[write]
+rw=write
+
+[read]
+rw=read
examples/uring-cmd-pi-sb.png new file binary +0 -0
new file mode 100644
index 0000000000000000000000000000000000000000..dcdda8cdab7fd9f46f48d3033994a282e6a1e0bf
GIT binary patch
tools/fiograph/fiograph.conf +1 -1
index 91c5fcfe..123c39ae 100644
@@ -54,7 +54,7 @@ specific_options=ime_psync  ime_psyncv
 specific_options=hipri  cmdprio_percentage  cmdprio_class  cmdprio  cmdprio_bssplit  fixedbufs  registerfiles  sqthread_poll  sqthread_poll_cpu  nonvectored  uncached  nowait  force_async
 
 [ioengine_io_uring_cmd]
-specific_options=hipri  cmdprio_percentage  cmdprio_class  cmdprio  cmdprio_bssplit  fixedbufs  registerfiles  sqthread_poll  sqthread_poll_cpu  nonvectored  uncached  nowait  force_async  cmd_type
+specific_options=hipri  cmdprio_percentage  cmdprio_class  cmdprio  cmdprio_bssplit  fixedbufs  registerfiles  sqthread_poll  sqthread_poll_cpu  nonvectored  uncached  nowait  force_async  cmd_type  md_per_io_size  pi_act  pi_chk  apptag  apptag_mask
 
 [ioengine_libaio]
 specific_options=userspace_reap  cmdprio_percentage  cmdprio_class  cmdprio  cmdprio_bssplit  nowait
Signature · 1 line
2.25.1
Applied
#2 lore raw
Quoted 8 lines · Ankit Kumar

Add missing io_uring_cmd ioengine options to fiograph config. Add two example job files for the protection information options. These include one for DIF i.e. extended LBA data size, and the other for DIX i.e. separate metadata buffer case.
Add the corresponding fiograph diagram for these.

---

Applied. Thanks.

Vincent