From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Burakov, Anatoly" Subject: Re: [PATCH v5 21/21] doc: add external memory feature to programmer's guide Date: Wed, 26 Sep 2018 17:00:53 +0100 Message-ID: <081911b3-4773-747d-52b1-ccce62be6971@intel.com> References: <6DC05C7C5F25994B81B3F2F214251F66020313C2@IRSMSX104.ger.corp.intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Cc: "Mcnamara, John" , "laszlo.madarassy@ericsson.com" , "laszlo.vadkerti@ericsson.com" , "andras.kovacs@ericsson.com" , "winnie.tian@ericsson.com" , "daniel.andrasi@ericsson.com" , "janos.kobor@ericsson.com" , "geza.koblo@ericsson.com" , "srinath.mannam@broadcom.com" , "scott.branden@broadcom.com" , "ajit.khaparde@broadcom.com" , "Wiles, Keith" , "Richardson, Bruce" , "thomas@monjalon.net" , "shreyansh.jain@nxp.com" , "shahafs@mellanox.com" , "arybchenko@s To: "Kovacevic, Marko" , "dev@dpdk.org" Return-path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id 5C96B1B3E8 for ; Wed, 26 Sep 2018 18:01:12 +0200 (CEST) In-Reply-To: <6DC05C7C5F25994B81B3F2F214251F66020313C2@IRSMSX104.ger.corp.intel.com> Content-Language: en-US List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On 26-Sep-18 4:19 PM, Kovacevic, Marko wrote: >> Add a short chapter on usage of external memory in DPDK to the >> Programmer's Guide. >> >> Signed-off-by: Anatoly Burakov >> --- >> .../prog_guide/env_abstraction_layer.rst | 37 +++++++++++++++++++ >> 1 file changed, 37 insertions(+) > >> +The expected workflow is as follows: >> + >> +* Get a pointer to memory area >> +* Create a named heap >> +* Add memory area(s) to the heap >> + * If IOVA table is not specified, IOVA addresses will be assumed to be >> + unavailable, and DMA mappings will not be performed >> + * Other processes must attach to the memory area before they can use >> +it >> +* Get socket ID used for the heap >> +* Use normal DPDK allocation procedures, using supplied socket ID >> +* If memory area is no longer needed, it can be removed from the heap >> + * Other processes must detach from this memory area before it can be >> +removed >> +* If heap is no longer needed, remove it >> + * Socket ID will become invalid and will not be reused > > > Hi Anatoly, > > Im getting an error when doing > > make-doc-guides-html > > /dpdk/doc/guides/prog_guide/env_abstraction_layer.rst:241: WARNING: Unexpected indentation. > /dpdk/doc/guides/prog_guide/env_abstraction_layer.rst:242: WARNING: Block quote ends without a blank line; unexpected unindent. > > This is due to the indentation of your inner bullet points instead of two spaces put 4 > For all four that you have. > > Thanks, > Marko K > Hi Marko, Those are supposed to be sub-bullet points, i.e. 2nd level. Does it have to be six? -- Thanks, Anatoly