From mboxrd@z Thu Jan 1 00:00:00 1970 From: Liang Ma Subject: [PATCH v8 4/4] doc/guides/sample_app_ug/l3_forward_power_man.rst: empty poll update Date: Mon, 17 Sep 2018 14:30:16 +0100 Message-ID: <1537191016-26330-4-git-send-email-liang.j.ma@intel.com> References: <1536070228-6545-1-git-send-email-liang.j.ma@intel.com> <1537191016-26330-1-git-send-email-liang.j.ma@intel.com> Cc: dev@dpdk.org, lei.a.yao@intel.com, ktraynor@redhat.com, john.geary@intel.com, Liang Ma To: david.hunt@intel.com Return-path: Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 67EA81B051 for ; Mon, 17 Sep 2018 15:30:56 +0200 (CEST) In-Reply-To: <1537191016-26330-1-git-send-email-liang.j.ma@intel.com> List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add empty poll mode command line example Signed-off-by: Liang Ma --- doc/guides/sample_app_ug/l3_forward_power_man.rst | 29 +++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/doc/guides/sample_app_ug/l3_forward_power_man.rst b/doc/guides/sample_app_ug/l3_forward_power_man.rst index 795a570..ca9c70a 100644 --- a/doc/guides/sample_app_ug/l3_forward_power_man.rst +++ b/doc/guides/sample_app_ug/l3_forward_power_man.rst @@ -362,3 +362,32 @@ The algorithm has the following sleeping behavior depending on the idle counter: If a thread polls multiple Rx queues and different queue returns different sleep duration values, the algorithm controls the sleep time in a conservative manner by sleeping for the least possible time in order to avoid a potential performance impact. + +Empty Poll Mode +------------------------- +There is a new Mode which is added recently. Empty poll mode can be enabled by +command option --empty-poll. + +See "Power Management" chapter in the DPDK Programmer's Guide for empty poll mode details. + +.. code-block:: console + + ./l3fwd-power -l xxx -n 4 -w 0000:xx:00.0 -w 0000:xx:00.1 -- -p 0x3 -P --config="(0,0,xx),(1,0,xx)" --empty-poll="0,0,0" -l 14 -m 9 -h 1 + +Where, + +--empty-poll: Enable the empty poll mode instead of original algorithm + +--empty-poll="training_flag, med_threshold, high_threshold" + +* training_flag : optional, enable/disable training mode. Default value is 0. + +* med_threshold : optional, indicate the empty poll threshold of modest state which is customized by user. Default value is 0. + +* high_threshold : optional, indicate the empty poll threshold of busy state which is customized by user. Default value is 0. + +* -l : optional, set up the LOW power state frequency index + +* -m : optional, set up the MED power state frequency index + +* -h : optional, set up the HIGH power state frequency index -- 2.7.5