Thread (339 messages) 339 messages, 17 authors, 2021-10-17

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 completed
which
quoted
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 successfully
completed operations.
quoted
``rte_dmadev_completed_status`` will return the total number of
completed operations

I remove the 'total' because the return limited by nb_cpls.
quoted
along with the status of each operation (filled into the ``status`` array
passed by user)>
quoted
quoted
Also these two
+APIs could return the last completed operation's ring_idx which will help
to
quoted
quoted
+track application-defined circular ring.
Replace the last line with this:
"These two APIs can also return the last completed operations ``ring_idx``
which
quoted
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.
.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help