Re: [dpdk-dev] [PATCH v14 5/6] doc: add DMA device library guide
From: Walsh, Conor <hidden>
Date: 2021-08-13 10:12:53
Hi Chengwen, v15 looks good to me. Thanks for the changes, Conor.
Hi Conor, Already sent v15, Most of feedback modified, unmodified inline Thanks. On 2021/8/10 23:27, Walsh, Conor wrote:quoted
[snip] Hi Chengwen, I have included some feedback to improve the grammar and readability of the docs inline.[snip]quoted
quoted
+the EAL command line options. + +And then dmadevs are dynamically allocated by^ Change "And then" to "After DPDK initialization".It is part of DPDK initialization, I modify by other ways.quoted
quoted
rte_dmadev_pmd_allocate() based on +the number of hardware DMA channels.[snip]quoted
quoted
+The first API returns the number of operation requests completed successfully, +the second API returns the number of operation requests completedwhichquoted
quoted
may +successfully or failed and also with meaningful status code.Replace above line with the following: "``rte_dmadev_completed`` will return the number of successfullycompleted operations.quoted
``rte_dmadev_completed_status`` will return the total number ofcompleted operations I remove the 'total' because the return limited by nb_cpls.quoted
along with the status of each operation (filled into the ``status`` arraypassed by user)>quoted
quoted
Also these two +APIs could return the last completed operation's ring_idx which will helptoquoted
quoted
+track application-defined circular ring.Replace the last line with this: "These two APIs can also return the last completed operations ``ring_idx``whichquoted
could help developers track operations within their own application-defined rings." I change the developers to user.quoted
With the improvements suggested above, Acked-by: Conor Walsh <redacted> Thanks, Conor. .