From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id 5DE431B11E for ; Tue, 25 Sep 2018 14:31:43 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 25 Sep 2018 05:31:43 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.54,302,1534834800"; d="scan'208";a="91730590" Received: from irsmsx153.ger.corp.intel.com ([163.33.192.75]) by fmsmga004.fm.intel.com with ESMTP; 25 Sep 2018 05:31:42 -0700 Received: from irsmsx104.ger.corp.intel.com ([169.254.5.213]) by IRSMSX153.ger.corp.intel.com ([169.254.9.126]) with mapi id 14.03.0319.002; Tue, 25 Sep 2018 13:31:41 +0100 From: "Kovacevic, Marko" To: "Ma, Liang J" , "Hunt, David" CC: "dev@dpdk.org" , "Yao, Lei A" , "ktraynor@redhat.com" , "Geary, John" , "Ma, Liang J" Thread-Topic: [dpdk-dev] [PATCH v8 3/4] doc/guides/proguide/power-man: update the power API Thread-Index: AQHUToq72H8KQoRwdEWcCOe3mfU5yKUA+NSQ Date: Tue, 25 Sep 2018 12:31:40 +0000 Message-ID: <6DC05C7C5F25994B81B3F2F214251F6602030C3A@IRSMSX104.ger.corp.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> <1537191016-26330-3-git-send-email-liang.j.ma@intel.com> In-Reply-To: <1537191016-26330-3-git-send-email-liang.j.ma@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.0.400.15 dlp-reaction: no-action x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMWE3MmE1M2EtMzAyYi00OWViLWIxNDItZjI0OTdlOWVmZTJiIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE2LjUuOS4zIiwiVHJ1c3RlZExhYmVsSGFzaCI6Im14RmcyXC8zckF0V0VTaEtHcVh0VTkxN2tkRmRnbkFzRThLQTA5a2syT1FNPSJ9 x-ctpclassification: CTP_NT x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v8 3/4] doc/guides/proguide/power-man: update the power API 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: , X-List-Received-Date: Tue, 25 Sep 2018 12:31:45 -0000 > Update the document for empty poll API. >=20 > Signed-off-by: Liang Ma > --- > doc/guides/prog_guide/power_man.rst | 90 > +++++++++++++++++++++++++++++++++++++ > 1 file changed, 90 insertions(+) >=20 > diff --git a/doc/guides/prog_guide/power_man.rst > b/doc/guides/prog_guide/power_man.rst > index eba1cc6..056cb12 100644 > --- a/doc/guides/prog_guide/power_man.rst > +++ b/doc/guides/prog_guide/power_man.rst > @@ -106,6 +106,96 @@ User Cases >=20 > The power management mechanism is used to save power when > performing L3 forwarding. >=20 > + > +Empty Poll API > +-------------- > + > +Abstract > +~~~~~~~~ > + > +For packet processing workloads such as DPDK polling is continuous. > +This means CPU cores always show 100% busy independent of how much > work > +those cores are doing. It is critical to accurately determine how busy > +a core is hugely important for the following reasons: > + > + * No indication of overload conditions > + * User do not know how much real load is on a system meaning > + resulted in wasted energy as no power management is utilized User does not know how much real load is on a resulting in=20 wasted energy as no power management is utilized > +API Overview for Empty Poll Power Management > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > +* **State Init**: initialize the power management system. > + > +* **State Free**: free the resource hold by power management system. > + > +* **Update Empty Poll Counter**: update the empty poll counter. > + > +* **Update Valid Poll Counter**: update the valid poll counter. > + > +* **Set the Fequence Index**: update the power state/frequency > mapping. Spelling above: Fequence/ Frequency=20