Skip to contentSkip to conversation

doc/dmadevs: add note clarifying naming of idxd devices

PATCH In review Bruce Richardson 3 participants 4 messages Jul 25, 2023 – Jul 27, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc/dmadevs: add note clarifying naming of idxd devices

Since the test-dma-perf application identifies devices by name, include in the idxd driver documentation a note on device naming when vfio-pci. See also discussion in bugzilla[1].

[1] https://bugs.dpdk.org/show_bug.cgi?id=1268

---
 doc/guides/dmadevs/idxd.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/dmadevs/idxd.rst +7 -0
index ea101031bf..a9a788ac56 100644
@@ -123,6 +123,13 @@ For example::
 
 	$ dpdk-devbind.py -b vfio-pci 6a:01.0
 
+.. note::
+
+  Since each individual queue on the HW device is its own separate dmadev instance,
+  the internal DMA device name includes the HW queue id as a suffix on the PCI id.
+  The above device when used by a DPDK application will be accessible via dmadevs with names:
+  ``0000:6a:01.0-q0``, ``00006a:01.0-q1``, etc.
+
 Device Probing and Initialization
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
Signature · 1 line
2.39.2
#1 lore raw
Quoted 8 lines · Bruce Richardson

Since the test-dma-perf application identifies devices by name, include in the idxd driver documentation a note on device naming when vfio-pci. See also discussion in bugzilla[1].

[1] https://bugs.dpdk.org/show_bug.cgi?id=1268

---

Note, although I reference bugzilla here, I don't consider this a bugfix, so I've not included a fixes tag and official bugzilla id etc. It's instead a note clarifying the expected behaviour.

/Bruce

#2 lore raw

[AMD Official Use Only - General]

Quoted 17 lines

-----Original Message-----
From: Bruce Richardson <[email protected]>
Sent: Tuesday, July 25, 2023 9:49 PM
To: [email protected]
Cc: Varghese, Vipin <[email protected]>
Subject: Re: [PATCH] doc/dmadevs: add note clarifying naming of idxd devices

Caution: This message originated from an External Source. Use proper caution when opening attachments, clicking links, or responding.

Quoted 2 lines · Bruce Richardson

Since the test-dma-perf application identifies devices by name, include in the idxd driver documentation a note on device naming when

vfio-pci.

Quoted 2 lines

See also discussion in bugzilla[1].

Quoted 7 lines
Quoted 4 lines

[1] https://bugs.dpdk.org/show_bug.cgi?id=1268

---

Note, although I reference bugzilla here, I don't consider this a bugfix, so I've not included a fixes tag and official bugzilla id etc. It's instead a note clarifying the expected behaviour.

App/dma-perf got integrated into DPDK via https://patches.dpdk.org/project/dpdk/patch/[email protected]/. The expectation is that, it is tried and tested for hardware dma, sw skeleton dma and cpu memcpy. Happy to acknowledge the change as it helps the DPDK community.

Quoted 2 lines

/Bruce

#3 lore raw
Quoted 6 lines
Quoted 6 lines
Quoted 2 lines

Since the test-dma-perf application identifies devices by name, include in the idxd driver documentation a note on device naming when

vfio-pci.

Quoted 3 lines

See also discussion in bugzilla[1].

[1] https://bugs.dpdk.org/show_bug.cgi?id=1268

Bugzilla ID: 1268

Quoted 11 lines
Quoted 6 lines
Quoted 3 lines

---

Note, although I reference bugzilla here, I don't consider this a bugfix, so I've not included a fixes tag and official bugzilla id etc. It's instead a note clarifying the expected behaviour.

App/dma-perf got integrated into DPDK via https://patches.dpdk.org/project/dpdk/patch/[email protected]/. The expectation is that, it is tried and tested for hardware dma, sw skeleton dma and cpu memcpy. Happy to acknowledge the change as it helps the DPDK community.

Replaced PCI id with PCI address,
and applied, thanks.