doc/dmadevs: add note clarifying naming of idxd devices
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
@@ -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
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
Signed-off-by Bruce Richardson <[email protected]>---
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
Varghese, Vipin
Acked-by[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 devicesCaution: 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
Signed-off-by Bruce Richardson <[email protected]>---
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
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].
Bugzilla ID: 1268
Quoted 11 lines
Quoted 6 lines
Quoted 3 lines
Signed-off-by Bruce Richardson <[email protected]>---
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.Acked-by Vipin Varghese <[email protected]>
Replaced PCI id with PCI address,
and applied, thanks.