patches for DPDK stable branches
 help / color / mirror / Atom feed
* [PATCH] doc: update size parameter details
@ 2023-12-12 10:45 Vipin Varghese
  2024-03-06  6:08 ` Varghese, Vipin
  2024-03-07 13:27 ` fengchengwen
  0 siblings, 2 replies; 4+ messages in thread
From: Vipin Varghese @ 2023-12-12 10:45 UTC (permalink / raw)
  To: dev, stable, honest.jiang

For configuration parameters `mem_size` and `buf_size` are represented
as megabytes and bytes respectively in application. Update the
documentation to represent the same.

Signed-off-by: Vipin Varghese <vipin.varghese@amd.com>
---
 doc/guides/tools/dmaperf.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guides/tools/dmaperf.rst b/doc/guides/tools/dmaperf.rst
index 9e3e78a6b7..6f85fceb8a 100644
--- a/doc/guides/tools/dmaperf.rst
+++ b/doc/guides/tools/dmaperf.rst
@@ -74,10 +74,10 @@ Configuration Parameters
   Currently supported types are ``DMA_MEM_COPY`` and ``CPU_MEM_COPY``.
 
 ``mem_size``
-  The size of the memory footprint.
+  The size of the memory footprint in megabytes (MB) for source and destination.
 
 ``buf_size``
-  The memory size of a single operation.
+  The memory size of a single operation in bytes (B).
 
 ``dma_ring_size``
   The DMA ring buffer size. Must be a power of two, and between ``64`` and ``4096``.
-- 
2.34.1


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: update size parameter details
  2023-12-12 10:45 [PATCH] doc: update size parameter details Vipin Varghese
@ 2024-03-06  6:08 ` Varghese, Vipin
  2024-03-07 13:27 ` fengchengwen
  1 sibling, 0 replies; 4+ messages in thread
From: Varghese, Vipin @ 2024-03-06  6:08 UTC (permalink / raw)
  To: dev, stable, honest.jiang, fengchengwen


> Caution: This message originated from an External Source. Use proper caution when opening attachments, clicking links, or responding.
>
>
> For configuration parameters `mem_size` and `buf_size` are represented
> as megabytes and bytes respectively in application. Update the
> documentation to represent the same.
>
> Signed-off-by: Vipin Varghese <vipin.varghese@amd.com>
> ---
>   doc/guides/tools/dmaperf.rst | 4 ++--
>   1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/doc/guides/tools/dmaperf.rst b/doc/guides/tools/dmaperf.rst
> index 9e3e78a6b7..6f85fceb8a 100644
> --- a/doc/guides/tools/dmaperf.rst
> +++ b/doc/guides/tools/dmaperf.rst
> @@ -74,10 +74,10 @@ Configuration Parameters
>     Currently supported types are ``DMA_MEM_COPY`` and ``CPU_MEM_COPY``.
>
>   ``mem_size``
> -  The size of the memory footprint.
> +  The size of the memory footprint in megabytes (MB) for source and destination.
>
>   ``buf_size``
> -  The memory size of a single operation.
> +  The memory size of a single operation in bytes (B).
>
>   ``dma_ring_size``
>     The DMA ring buffer size. Must be a power of two, and between ``64`` and ``4096``.
Hi Chengwen, can you please help us to review the changes ?
> --
> 2.34.1
>

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: update size parameter details
  2023-12-12 10:45 [PATCH] doc: update size parameter details Vipin Varghese
  2024-03-06  6:08 ` Varghese, Vipin
@ 2024-03-07 13:27 ` fengchengwen
  2024-03-07 15:50   ` Varghese, Vipin
  1 sibling, 1 reply; 4+ messages in thread
From: fengchengwen @ 2024-03-07 13:27 UTC (permalink / raw)
  To: Vipin Varghese, dev, stable, honest.jiang

Hi Vipin,

On 2023/12/12 18:45, Vipin Varghese wrote:
> For configuration parameters `mem_size` and `buf_size` are represented
> as megabytes and bytes respectively in application. Update the
> documentation to represent the same.
> 
> Signed-off-by: Vipin Varghese <vipin.varghese@amd.com>
> ---
>  doc/guides/tools/dmaperf.rst | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/doc/guides/tools/dmaperf.rst b/doc/guides/tools/dmaperf.rst
> index 9e3e78a6b7..6f85fceb8a 100644
> --- a/doc/guides/tools/dmaperf.rst
> +++ b/doc/guides/tools/dmaperf.rst
> @@ -74,10 +74,10 @@ Configuration Parameters
>    Currently supported types are ``DMA_MEM_COPY`` and ``CPU_MEM_COPY``.
>  
>  ``mem_size``
> -  The size of the memory footprint.
> +  The size of the memory footprint in megabytes (MB) for source and destination.

I prefer not add "for source and destination", it makes sense without this, and maybe future test like fill don't have source buffer.

>  
>  ``buf_size``
> -  The memory size of a single operation.
> +  The memory size of a single operation in bytes (B).
>  
>  ``dma_ring_size``
>    The DMA ring buffer size. Must be a power of two, and between ``64`` and ``4096``.
> 

BTW: Could you please also modify the app/test-dma-perf/config.ini (which also missing this)

Thanks

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: update size parameter details
  2024-03-07 13:27 ` fengchengwen
@ 2024-03-07 15:50   ` Varghese, Vipin
  0 siblings, 0 replies; 4+ messages in thread
From: Varghese, Vipin @ 2024-03-07 15:50 UTC (permalink / raw)
  To: fengchengwen, dev, stable, honest.jiang

[-- Attachment #1: Type: text/plain, Size: 1390 bytes --]


<snipped>
>> -  The size of the memory footprint.
>> +  The size of the memory footprint in megabytes (MB) for source and destination.
> I prefer not add "for source and destination", it makes sense without this, and maybe future test like fill don't have source buffer.

The current dma-perf application, makes use of memory in MegaBytes for 
combined buffer of source and destination. That is, if the total memory 
is 10MB

this is split into 5MB for source buffer and 5MB for destination buffer.


dma-fill option is not enabled or used in dma-test-perf yet. I would 
recommend, once the feature is added `both fill-pattern and mem_size 
will get added`.

As it is not available this is  not applicable. Hence I am do not agree 
`it makes sense without this` instead it is needed to be clear.

>
>>   ``buf_size``
>> -  The memory size of a single operation.
>> +  The memory size of a single operation in bytes (B).
>>
>>   ``dma_ring_size``
>>     The DMA ring buffer size. Must be a power of two, and between ``64`` and ``4096``.
>>
> BTW: Could you please also modify the app/test-dma-perf/config.ini (which also missing this)

dma-perf documentation is updated with right message. Yes, I can 
understand end-user may also refer to the comments in `config.ini`.  So 
yes i can shared v2 with same message as v1

`memsize is combination of source and destination in MB`

>
> Thanks

[-- Attachment #2: Type: text/html, Size: 2508 bytes --]

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2024-03-07 15:50 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-12-12 10:45 [PATCH] doc: update size parameter details Vipin Varghese
2024-03-06  6:08 ` Varghese, Vipin
2024-03-07 13:27 ` fengchengwen
2024-03-07 15:50   ` Varghese, Vipin

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).