From patchwork Mon Jul 13 15:11:20 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Sexton, Rory" X-Patchwork-Id: 73956 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 96F61A0540; Mon, 13 Jul 2020 17:11:44 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7FEAA1D671; Mon, 13 Jul 2020 17:11:28 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id DD3D81D615 for ; Mon, 13 Jul 2020 17:11:24 +0200 (CEST) IronPort-SDR: /rPsGlViZYxvPU5LoV38OuItmHVcGzjH2VqdhYCmGQ3X3DSYRpzFKxBoR2sZqn07+LdmgAfAZw 2i/mGPPfFqFQ== X-IronPort-AV: E=McAfee;i="6000,8403,9681"; a="146660917" X-IronPort-AV: E=Sophos;i="5.75,347,1589266800"; d="scan'208";a="146660917" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 13 Jul 2020 08:11:23 -0700 IronPort-SDR: 39xuli6pIVxJvRY0roF6O/iqTxT8Oyf0pLqXiHJr9s1us3mdtfWCiH+oSFns4hjFENyBdnWL2L 7btdXAU48BXw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.75,347,1589266800"; d="scan'208";a="485521568" Received: from silpixa00399913.ir.intel.com ([10.237.213.189]) by fmsmga005.fm.intel.com with ESMTP; 13 Jul 2020 08:11:22 -0700 From: Rory Sexton To: dev@dpdk.org, david.hunt@intel.com Date: Mon, 13 Jul 2020 16:11:20 +0100 Message-Id: <20200713151120.957342-3-rory.sexton@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713151120.957342-1-rory.sexton@intel.com> References: <20200713151120.957342-1-rory.sexton@intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] [v3 3/3] doc: update vm_power_manager cmdline options in doc 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" Updating the vm_power_manager docs to reflect changes made in previous patches in set. Signed-off-by: Rory Sexton Reviewed-by: David Hunt --- doc/guides/sample_app_ug/vm_power_management.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/doc/guides/sample_app_ug/vm_power_management.rst b/doc/guides/sample_app_ug/vm_power_management.rst index e98277ccb..1b6de8e93 100644 --- a/doc/guides/sample_app_ug/vm_power_management.rst +++ b/doc/guides/sample_app_ug/vm_power_management.rst @@ -410,19 +410,21 @@ There are a couple of command line parameters for enabling the out-of-band monitoring of branch ratios on cores doing busy polling using PMDs as described below: -``--core-list {list of cores}`` +``--core-branch-ratio {list of cores}:{branch ratio for listed cores}`` Specify the list of cores to monitor the ratio of branch misses to branch hits. A tightly-polling PMD thread has a very low branch ratio, therefore the core frequency scales down to the minimum allowed value. On receiving packets, the code path changes, causing the branch ratio to increase. When the ratio goes above the ratio threshold, the core frequency scales up to the maximum - allowed value. - -``--branch-ratio {ratio}`` - Specify a floating-point number that identifies the threshold at which - to scale up or down for the given workload. The default branch ratio - is 0.01 and needs adjustment for different workloads. + allowed value. The specified branch-ratio is a floating point number + that identifies the threshold at which to scale up or down for the + elements of the core-list. If not included the default branch ratio of + 0.01 but will need adjustment for different workloads + + This parameter can be used multiple times for different sets of cores. + The branch ratio mechanism can also be useful for non-PMD cores and + hyper-threaded environments where C-States are disabled. Compiling and Running the Guest Applications