From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 2F4CEA034E; Wed, 6 May 2020 23:59:58 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 2A4C41DB5D; Wed, 6 May 2020 23:59:35 +0200 (CEST) Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by dpdk.org (Postfix) with ESMTP id C8F5E1DB39 for ; Wed, 6 May 2020 23:59:28 +0200 (CEST) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 455381042; Wed, 6 May 2020 14:59:28 -0700 (PDT) Received: from dp6132.usa.Arm.com (dp6132.usa.arm.com [10.118.91.150]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 3EC803F305; Wed, 6 May 2020 14:59:28 -0700 (PDT) From: Dharmik Thakkar To: Wenzhuo Lu , Jingjing Wu , Bernard Iremonger , John McNamara , Marko Kovacevic Cc: dev@dpdk.org, nd@arm.com, Dharmik Thakkar Date: Wed, 6 May 2020 21:58:45 +0000 Message-Id: <20200506215847.7628-3-dharmik.thakkar@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20200506215847.7628-1-dharmik.thakkar@arm.com> References: <20200506215847.7628-1-dharmik.thakkar@arm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH 3/5] doc: add cycles per packet in testpmd user guide X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Update documentation for 'show fwd' testpmd runtime function to show CPU cycles/packet example. Signed-off-by: Dharmik Thakkar Reviewed-by: Honnappa Nagarahalli Reviewed-by: Phil Yang --- doc/guides/testpmd_app_ug/testpmd_funcs.rst | 51 +++++++++++++-------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index a360ecccfd3f..2e565ccdbcd4 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -351,26 +351,37 @@ Example for the io forwarding engine, with some packet drops on the tx side:: testpmd> show fwd stats all - ------- Forward Stats for RX Port= 0/Queue= 0 -> TX Port= 1/Queue= 0 ------- - RX-packets: 274293770 TX-packets: 274293642 TX-dropped: 128 - - ------- Forward Stats for RX Port= 1/Queue= 0 -> TX Port= 0/Queue= 0 ------- - RX-packets: 274301850 TX-packets: 274301850 TX-dropped: 0 - - ---------------------- Forward statistics for port 0 ---------------------- - RX-packets: 274293802 RX-dropped: 0 RX-total: 274293802 - TX-packets: 274301862 TX-dropped: 0 TX-total: 274301862 - ---------------------------------------------------------------------------- - - ---------------------- Forward statistics for port 1 ---------------------- - RX-packets: 274301894 RX-dropped: 0 RX-total: 274301894 - TX-packets: 274293706 TX-dropped: 128 TX-total: 274293834 - ---------------------------------------------------------------------------- - - +++++++++++++++ Accumulated forward statistics for all ports+++++++++++++++ - RX-packets: 548595696 RX-dropped: 0 RX-total: 548595696 - TX-packets: 548595568 TX-dropped: 128 TX-total: 548595696 - ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +   ------- Forward Stats for RX Port= 0/Queue= 0 -> TX Port= 1/Queue= 0 ------- +   RX-packets: 43536504       TX-packets: 43536488       TX-dropped: 0 + +   ------- Forward Stats for RX Port= 1/Queue= 0 -> TX Port= 0/Queue= 0 ------- +   RX-packets: 149738504      TX-packets: 149738504      TX-dropped: 0 + +   ------- Forward Stats for RX Port= 1/Queue= 1 -> TX Port= 0/Queue= 1 ------- +   RX-packets: 149753052      TX-packets: 149753052      TX-dropped: 0 + +   ---------------------- Forward statistics for port 0  ---------------------- +   RX-packets: 43538881       RX-dropped: 72            RX-total: 43538953 +   TX-packets: 299491753      TX-dropped: 0             TX-total: 299491753 +   ---------------------------------------------------------------------------- + +   ---------------------- Forward statistics for port 1  ---------------------- +   RX-packets: 299493085      RX-dropped: 8357          RX-total: 299501442 +   TX-packets: 43539683       TX-dropped: 0             TX-total: 43539683 +   ---------------------------------------------------------------------------- + +   +++++++++++++++ Accumulated forward statistics for all ports+++++++++++++++ +   RX-packets: 343031966      RX-dropped: 8429          RX-total: 343040395 +   TX-packets: 343031436      TX-dropped: 0             TX-total: 343031436 +   ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +   CPU cycles/packet=14.28 (total cycles=4899533541 / total RX packets=343031966) at 200 MHz + +.. note:: + + Measuring CPU cycles/packet requires enabling CONFIG_RTE_TEST_PMD_RECORD_CORE_TX_CYCLES configuration option. + On aarch64 platforms, by default, the cycles are counted using generic counter which runs at a lower frequency than the CPU clock. + To get the cycles/packet at CPU clock frequency, please scale the cycles/packet to CPU clock frequency. Alternatively, use the PMU based cycle counter. clear fwd ~~~~~~~~~ -- 2.20.1