DPDK patches and discussions
 help / color / Atom feed
* [dpdk-dev] [PATCH] doc: updates for cycle-count mode in compression perf tool
@ 2020-02-12 12:06 Artur Trybula
  2020-02-12 12:12 ` Dybkowski, AdamX
  0 siblings, 1 reply; 3+ messages in thread
From: Artur Trybula @ 2020-02-12 12:06 UTC (permalink / raw)
  To: dev, fiona.trahe, shallyv, adamx.dybkowski, arturx.trybula, akhil.goyal

This commit adds release notes and updates documentation for
the cycle-count mode added to the compression performance tool.

Fixes: 2695db95a147 ("test/compress: add cycle-count mode to perf tool")

Signed-off-by: Artur Trybula <arturx.trybula@intel.com>
---
 doc/guides/rel_notes/release_20_02.rst |  5 +++++
 doc/guides/tools/comp_perf.rst         | 16 +++++++++++++---
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/doc/guides/rel_notes/release_20_02.rst b/doc/guides/rel_notes/release_20_02.rst
index 786f9b119..2183a8aa8 100644
--- a/doc/guides/rel_notes/release_20_02.rst
+++ b/doc/guides/rel_notes/release_20_02.rst
@@ -188,6 +188,11 @@ New Features
   Add event device support for ``l3fwd`` sample application. It demonstrates
   usage of poll and event mode IO mechanism under a single application.
 
+* **Added cycle-count mode to the compression performance tool.**
+
+  Enhanced the compression performance tool by adding a cycle-count mode
+  which can be used to help measure and tune hardware and software PMDs.
+
 
 Removed Items
 -------------
diff --git a/doc/guides/tools/comp_perf.rst b/doc/guides/tools/comp_perf.rst
index 6c59c8403..ee585d102 100644
--- a/doc/guides/tools/comp_perf.rst
+++ b/doc/guides/tools/comp_perf.rst
@@ -14,8 +14,16 @@ which are passed to compress device with compression operations.
 Then, the output buffers are fed into the decompression stage, and the resulting
 data is compared against the original data (verification phase). After that,
 a number of iterations are performed, compressing first and decompressing later,
-to check the throughput rate
-(showing cycles/iteration, cycles/Byte and Gbps, for compression and decompression).
+to check the throughput rate (showing cycles/iteration, cycles/Byte and Gbps,
+for compression and decompression).
+Another option: ``pmd-cyclecount``, gives the user the opportunity to measure
+the number of cycles per operation for the 3 phases: setup, enqueue_burst and
+dequeue_burst, for both compression and decompression. An optional delay can be
+inserted between enqueue and dequeue so no cycles are wasted in retries while
+waiting for a hardware device to finish. Although artificial, this allows
+to measure the minimum offload cost which could be achieved in a perfectly
+tuned system. Comparing the results of the two tests gives information about
+the trade-off between throughput and cycle-count.
 
 .. Note::
 
@@ -56,7 +64,7 @@ See the DPDK Getting Started Guides for more information on these options.
 Application Options
 ~~~~~~~~~~~~~~~~~~~
 
- ``--ptest [benchmark/verify]``: set test type (default: benchmark)
+ ``--ptest [throughput/verify/pmd-cyclecount]``: set test type (default: throughput)
 
  ``--driver-name NAME``: compress driver to use
 
@@ -84,6 +92,8 @@ Application Options
 
  ``--external-mbufs``: allocate and use memzones as external buffers instead of keeping the data directly in mbuf areas
 
+ ``--cc-delay-us N``: delay between enqueue and dequeue operations in microseconds, valid only for the cyclecount test (default: 500 us)
+
  ``-h``: prints this help
 
 
-- 
2.17.1


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

* Re: [dpdk-dev] [PATCH] doc: updates for cycle-count mode in compression perf tool
  2020-02-12 12:06 [dpdk-dev] [PATCH] doc: updates for cycle-count mode in compression perf tool Artur Trybula
@ 2020-02-12 12:12 ` Dybkowski, AdamX
  2020-02-13  9:28   ` Akhil Goyal
  0 siblings, 1 reply; 3+ messages in thread
From: Dybkowski, AdamX @ 2020-02-12 12:12 UTC (permalink / raw)
  To: dev; +Cc: Trybula, ArturX, Trahe, Fiona

> -----Original Message-----
> From: Trybula, ArturX
> Sent: Wednesday, 12 February, 2020 13:07
> To: dev@dpdk.org; Trahe, Fiona <fiona.trahe@intel.com>;
> shallyv@marvell.com; Dybkowski, AdamX <adamx.dybkowski@intel.com>;
> Trybula, ArturX <arturx.trybula@intel.com>; akhil.goyal@nxp.com
> Subject: [PATCH] doc: updates for cycle-count mode in compression perf tool
> 
> This commit adds release notes and updates documentation for the cycle-
> count mode added to the compression performance tool.
> 
> Fixes: 2695db95a147 ("test/compress: add cycle-count mode to perf tool")
> 
> Signed-off-by: Artur Trybula <arturx.trybula@intel.com>

Acked-by: Adam Dybkowski <adamx.dybkowski@intel.com>


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

* Re: [dpdk-dev] [PATCH] doc: updates for cycle-count mode in compression perf tool
  2020-02-12 12:12 ` Dybkowski, AdamX
@ 2020-02-13  9:28   ` Akhil Goyal
  0 siblings, 0 replies; 3+ messages in thread
From: Akhil Goyal @ 2020-02-13  9:28 UTC (permalink / raw)
  To: Dybkowski, AdamX, dev; +Cc: Trybula, ArturX, Trahe, Fiona


> >
> > This commit adds release notes and updates documentation for the cycle-
> > count mode added to the compression performance tool.
> >
> > Fixes: 2695db95a147 ("test/compress: add cycle-count mode to perf tool")
> >
> > Signed-off-by: Artur Trybula <arturx.trybula@intel.com>
> 
> Acked-by: Adam Dybkowski <adamx.dybkowski@intel.com>
Applied to dpdk-next-crypto

Thanks.

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

end of thread, back to index

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-02-12 12:06 [dpdk-dev] [PATCH] doc: updates for cycle-count mode in compression perf tool Artur Trybula
2020-02-12 12:12 ` Dybkowski, AdamX
2020-02-13  9:28   ` Akhil Goyal

DPDK patches and discussions

Archives are clonable:
	git clone --mirror http://inbox.dpdk.org/dev/0 dev/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 dev dev/ http://inbox.dpdk.org/dev \
		dev@dpdk.org
	public-inbox-index dev


Newsgroup available over NNTP:
	nntp://inbox.dpdk.org/inbox.dpdk.dev


AGPL code for this site: git clone https://public-inbox.org/ public-inbox