From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <Santosh.Shukla@cavium.com>
Received: from NAM01-SN1-obe.outbound.protection.outlook.com
 (mail-sn1nam01on0086.outbound.protection.outlook.com [104.47.32.86])
 by dpdk.org (Postfix) with ESMTP id 617712935
 for <dev@dpdk.org>; Wed, 18 Oct 2017 14:17:34 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version;
 bh=UDAXgccGeaUOnVFH+exOv3fdVGBQhysKQzv1HAqzYSc=;
 b=iL+IAJXhHuKb7SNDIdMBaavEHsXdG3a5KrX7xgF0Gpqm5WWCtN8IJgTX+un7A2fXzJsUjT5dcWKZQktNl2THru9uO4v73tex+Wa+8igU0aGvvc9Or2SQqHSgOhBgJJZLxON5QTjNpzbTRT548Fm8BzKOcCqObQvo9N3+PGRWdF8=
Authentication-Results: spf=none (sender IP is )
 smtp.mailfrom=Santosh.Shukla@cavium.com; 
Received: from [IPv6:2401:4900:1986:f06c:b9e4:6160:a3e8:a3c5]
 (2401:4900:1986:f06c:b9e4:6160:a3e8:a3c5) by
 DM5PR07MB3098.namprd07.prod.outlook.com (10.172.85.8) with Microsoft SMTP
 Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id
 15.20.77.7; Wed, 18 Oct 2017 12:17:29 +0000
To: Thomas Monjalon <thomas@monjalon.net>
References: <20170831063719.19273-1-santosh.shukla@caviumnetworks.com>
 <0d07a0ca-5fb3-f275-9d5f-2f30a8503caa@caviumnetworks.com>
 <d8b9d262-8aed-be48-14b9-e5455d88e12d@caviumnetworks.com>
 <79352056.QgdvfuXRzQ@xps>
 <e59209a1-ffe1-6f01-7373-19da6b9810a8@caviumnetworks.com>
Cc: dev@dpdk.org, olivier.matz@6wind.com, jerin.jacob@caviumnetworks.com,
 hemant.agrawal@nxp.com, John McNamara <john.mcnamara@intel.com>,
 ferruh.yigit@intel.com
From: santosh <santosh.shukla@caviumnetworks.com>
Message-ID: <2b50074a-f964-d1de-d3b9-0abcd9df68a8@caviumnetworks.com>
Date: Wed, 18 Oct 2017 17:47:14 +0530
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101
 Thunderbird/45.5.1
MIME-Version: 1.0
In-Reply-To: <e59209a1-ffe1-6f01-7373-19da6b9810a8@caviumnetworks.com>
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: 7bit
X-Originating-IP: [2401:4900:1986:f06c:b9e4:6160:a3e8:a3c5]
X-ClientProxiedBy: MA1PR0101CA0025.INDPRD01.PROD.OUTLOOK.COM (52.134.137.11)
 To DM5PR07MB3098.namprd07.prod.outlook.com (10.172.85.8)
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: 0ad9137d-6775-4b00-2269-08d516223571
X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0;
 RULEID:(22001)(2017030254152)(2017052603199)(201703131423075)(201703031133081)(201702281549075);
 SRVR:DM5PR07MB3098; 
X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3098;
 3:sBPpVjPhwOVT6/S7ockF/PT5wsOVUj9g/Hb6NyKR/5fn/F67I00mjnCzBDi3mt+Wh3ejCdEEGPRZKXo36/6gSl0b3udAGr/HE9iFnZ+NsIRLTfbaWv14IWZWNCpx4NlpYuIx84mwCwzYgJnRhdr21WzeDborkLIObWNe6VZj11azvL3aHZdnNjM2iy/LkzjKo0rPd9cxjwJH2JgtnWp9P60zt4gY0RruxzSGQ5NnyPq3EAjzgimMFrOpGA0AW1Jz;
 25:KuWvg8HIkoqZAOUaQCX1tiRSnNeIPOUNcC4+5BWwPJAb2QWsLBDV8R77I105lwQ+dyCmkDtVgrCK+Gemw7fxSaFdZSDnpj3NOAOEPgogxib27eJD569gfnvqljm/+DiqwVkWYswe7ZhuItLCt6nkGyoeCY/jw7HWVw6vXSU1gqK6cpz7nsIBppd0OfAtVsD+YUTrZcRL/LBwYdT2VpZ7jNh1sa34fGO7f1/ikxt+F86YAak/H5MD+HTa7EJGB8rZMpj3uAqP22QBcixSZ32V0g07HgyP44X93BzRi3/7MnQnizwY7oFdsCclpmTpfK5SK/ZdrIoBF/C9fGG45X4Ibg==;
 31:CuHZ9pLIrzITz2SF+Ui1umcT5Ft/gCIbpX6BE+c3v0SllrDu46a1/zm6eZuObyqgADkA9msnXonUNjVmFPJ7p3MXqxq5ye50cJxHYHOpuaM7osnRwKpVwIS/QaYj2cuHjB1IebLsFYSxbyzQ6iR2ekkIG7KvZkGKo+JfmBD850gB1lxqqGpWr7MGYsCF0lYDnIe5NiQXNXSZ41lEYvkYWzZ3itu2GpsES8cRrIe6Fuw=
X-MS-TrafficTypeDiagnostic: DM5PR07MB3098:
X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3098;
 20:3ZJVAm//DRJEVE9F0DUbBmNchWGZgTFhL8JNDLfVNnznLkzriXy4E5I4IqTvuoWPU0mvk+3qVcYo4+H7IzFWE/IPksGvDO4YM3C7/Nvsap29hrIwrbM4cfkKIeKTvmUoXVOkG5qnZEWVgUAN6V4msSMDqZRSHImA67WLtTEul3ogGc2JLFRounNWf2RirgcXdEvoQ4CKsBAhTw7m7TVYfoeY7GkCyQ/ekVmqNreJ50Esl75Da4rlghtYL60HdiGvmR5jCbMwnEcbLex8RnMUNGn7a2IFvgCrn7gYcrevUay16cIo6VaIuXzrJkacPSUxWOIbPK5rPiQTADCl97uux1ly/E2Bz7BmDdMQDm39/88x6LrT83bISQj/PBcusvNrtdzL5w41E+PEAT9swzbWmypaTbHyqyvVm52YKDzxAmgNQuqoM4beaD6/vlbbhGzRHbyPVgpQI0RZ1LZT24F7CnFU9hnihwcWuScBUXV4tjYwQZFTrz1lYXcvS740REE8RBQPFEb1rT5O9wwIouSSQ8brnXu5l3ptqu4T/cyy+81H735mUSx2M7Olj6CciNtX0in5KQzwe6oyzbLK3CMfUqXDX5juIeFT3nK01n7NvWs=;
 4:Nu3YTl97q3RQVURMJP9VPjacrNsNqXHFbEJw5kEKAM11Ww2+xoqXexFYzqxMv+Ec64PXiclO/TPcuGHDEGIlTZXY7OfdPwxa4SRMnL9oaCdOSTp2xqfMVSOH+n1nFsA5xdJo5h3zu9Vid3Ov98q1p18N/2BjxnpvBDLflNCT1USEGw/KxVfmlIiQf7wcQIdYC6C7ELIoDpiUzhLm7KktHOIzAoUROk3le5f5sn9kQ3qEl3puMwIumoJ6I8Bfnb+p
X-Exchange-Antispam-Report-Test: UriScan:;
X-Microsoft-Antispam-PRVS: <DM5PR07MB309800C9D4DB6F848FD1A0CEEA4D0@DM5PR07MB3098.namprd07.prod.outlook.com>
X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0;
 RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(5005006)(8121501046)(10201501046)(3002001)(100000703101)(100105400095)(93006095)(6041248)(20161123555025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123564025)(20161123560025)(20161123558100)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095);
 SRVR:DM5PR07MB3098; BCL:0; PCL:0;
 RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095);
 SRVR:DM5PR07MB3098; 
X-Forefront-PRVS: 0464DBBBC4
X-Forefront-Antispam-Report: SFV:NSPM;
 SFS:(10009020)(6009001)(6059001)(376002)(346002)(377454003)(199003)(24454002)(189002)(1706002)(6116002)(316002)(7736002)(478600001)(53376002)(58126008)(6916009)(65826007)(6246003)(42882006)(5660300001)(4326008)(81156014)(81166006)(2950100002)(305945005)(50986999)(50466002)(64126003)(53936002)(76176999)(8656005)(8656005)(31696002)(68736007)(36756003)(230700001)(101416001)(23746002)(2906002)(72206003)(54356999)(8936002)(561944003)(83506001)(31686004)(6306002)(47776003)(86152003)(97736004)(229853002)(33646002)(25786009)(8676002)(6486002)(966005)(105586002)(93886005)(65806001)(189998001)(106356001)(6666003)(65956001);
 DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR07MB3098;
 H:[IPv6:2401:4900:1986:f06c:b9e4:6160:a3e8:a3c5]; FPR:; SPF:None;
 PTR:InfoNoRecords; A:1; MX:1; LANG:en; 
Received-SPF: None (protection.outlook.com: cavium.com does not designate
 permitted sender hosts)
X-Microsoft-Exchange-Diagnostics: =?Windows-1252?Q?1; DM5PR07MB3098;
 23:xmlLSy12EzEd/m6Yzxe7ghUZ8JW2J6iWU3oVH?=
 =?Windows-1252?Q?XmG2sB/8xj/K+fNeK9X61imwo1Yggq8BJ9LA4Yso93n3stLBxuJ+FaFV?=
 =?Windows-1252?Q?UP7z9g58Q77fnmfH2Ns0xnV5ja08jQuM7pVeIxDJor8W2djf9+LLz0BV?=
 =?Windows-1252?Q?JBbj/qfH3XLVhnBn9awuo07aR5xQ/67fEzx6R4jq0ESdBZuN7LNTAnEP?=
 =?Windows-1252?Q?aBm4RwPk1XcM200EsgKgRI+vIH2K740LrDjzZamSsK8/guzdlkVs7/1a?=
 =?Windows-1252?Q?HlU75YQ7bf2oiL/q+AMjk0xTe/ApvZ+cz1qfOy6sD96CUBtQVdD1Mn0n?=
 =?Windows-1252?Q?3M8L02NyDNxJYRNNeM1cgGMh/gVNFgSUl4OBiKEuuBRB7RKC3hJ+bdM2?=
 =?Windows-1252?Q?1RhY+PtgTctainbexBtro3rxc5h4zlkRWKtoOjDXTrbKSLuyDqH03Emp?=
 =?Windows-1252?Q?LKeUFohKfav7HEdF1oV86bJIznAptJCVi786CbQjiFjOjbzRE0e7JqKc?=
 =?Windows-1252?Q?NEYscL5xn4SqGjqAY9tlpwG3/5CGQZ+nZvr71G/PzmOCyRwq7MjnlkUN?=
 =?Windows-1252?Q?usUcXQHm5UTdrBMD+PIxCl9mUscHJIaeyoZKLMF/50ac7968U/01DejH?=
 =?Windows-1252?Q?t+lnOjp7nzT9ij4vFJrkw39yB1LKeGRkE29A8Pve4RCi+ONeYjsc+/vA?=
 =?Windows-1252?Q?f/YCRcXh8XE9PHwRxcmKe2Cb2vIEew80YhVjtQ28DibaIDOv/sXcMAPp?=
 =?Windows-1252?Q?+RYziwpBiPCbyG5b3QblNzEcbx1DN31fB1/iRjhse+golbvcpjJOr+vG?=
 =?Windows-1252?Q?CCso+G/fIL9HJZdBAy+LNl86fhY6cn6+ZRarCGv/H6SFXh0sAIIQTwFa?=
 =?Windows-1252?Q?f9Fzg22qBhCt05cUI0OSu0YOVPcAZ3sS/OII6DEezVl+m/iTOtP8meXO?=
 =?Windows-1252?Q?V7g87DZiR8gfhl4s635MlaQ/WDCXjgMpwK1qBBozpR18NRKG4fumjQE+?=
 =?Windows-1252?Q?8UmAMmb4HadGrVPqhMZAXxqee8E3qGJlky0w3w3+0z+3LzCNvu0ecR/X?=
 =?Windows-1252?Q?EdSSoeGZ+J0Z+fHf3TfKoiVeBm2JCMNa9CKx19+vM9kOGztLOnQQTGx/?=
 =?Windows-1252?Q?9l3dU8MJUSnOKzIb9rCO70lfqwnXZ+vXmMe9IJBzd/5SOvjaQNp8xufB?=
 =?Windows-1252?Q?rXLJyEN8HhY8s9uqUoBSWiWOt5hiLc7zTUjTMGRsO8bWx7c3YqNutXQV?=
 =?Windows-1252?Q?rQmgQjwKUUn8rciPCpZSWrncA99//3EWVjCjHrjZD/FFMHBpPJFxzOaH?=
 =?Windows-1252?Q?jUPJpq9Q2D6idNYdY7h5REq9/xA0TtEXvKJC2wyd303DsXRHQybqYiMp?=
 =?Windows-1252?Q?RMYiviAPBI7rpWsD4OAfh3njcyvrCjXowEW/H4bepbf/paqC25GN35in?=
 =?Windows-1252?Q?+wfxpePXZ3OiLfK2US1WaVYKRLXGZd4qJWKzQdvTeN9RDueT3cVzAZWz?=
 =?Windows-1252?Q?mjG8RTDM5w4C+rf6o/9P5nBxgmGT6iM5T4eGs2zl4rxNGoHzQ=3D=3D?=
X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3098;
 6:02hbsCm2uJqNZzwe01TbB6chUlEVl8n5koVR9WUIX+x3Me6E/O0267EIyo3Sl9hw+badiE6EWrLR95JlXwIK/nIQ+TAZBunTKsL03Kxn9xHBad14sZpIKEvNFQSThxT3JYiFLiooJ9vG/ueIRqR1M8emrZeMvMNXZsNhe5a52By/vIlpKoEDM/sugEKUFhuY0KzREi/P3+zqSylSKi9jyk3ah3UC1NPUeNzvdnT3k0VThsMXQxzwhIUEI9pzfphiLqY6GopL6B2ZRUJxeTjBwAf/dbgn4i5szMj0+sWgt5ZExFZHDOdBxNx3TKCJiTehdm9tE3mA3uJJ72R0G2hQYQ==;
 5:X4PwH40VEOiVrNedL4rdClA2g6C9WKekvl5pWnzS8pHBhhcnDHGPtwVV2DqXQxaAxuPyKZuQ6/zm6ygvVY3COXebkG8+ftJLs4JF43dTGw0ASYv78pGFx1bLma/8iR5gTUpAbpECOTF3Kll7NNqpDQ==;
 24:qoulhVKLTcy5euugVXbvoU2Sple460IwpPNtr0KBnCjNNUUjd2kF83Ar+t87Ul31KoToaaOm5iwfinFAwC0Zt8dDMk1iseKQkRHPWATZ15U=;
 7:LL8IZKHdFlvXSfnuEb6JoN82FQ6wPJ/vTGN09dm7suWnZr6gpknn/uRYFypivn07364Zxu+DCRPw9nfYK4P3nEqdbj8U6DzBXFehCzj1inW/fTmZ9+nj7792631EjMRN/d4XGzZvGJ7q0ZhVTBVFiTwcAdwDxxn4L5KRVUFGSPdBZBEu+5FeL6niwl7XEAyzpEYoB++zwNdpaVvPxsiTiQjk2ORUU4ypYoAjeXrhs2k=
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: caviumnetworks.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Oct 2017 12:17:29.8474 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR07MB3098
Subject: Re: [dpdk-dev] [PATCH v3 10/10] doc: add mempool and octeontx
 mempool device
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Wed, 18 Oct 2017 12:17:34 -0000

Hi Thomas,


On Monday 09 October 2017 02:49 PM, santosh wrote:
> On Monday 09 October 2017 02:18 PM, Thomas Monjalon wrote:
>> 09/10/2017 07:46, santosh:
>>> On Monday 09 October 2017 10:31 AM, santosh wrote:
>>>> Hi Thomas,
>>>>
>>>>
>>>> On Sunday 08 October 2017 10:13 PM, Thomas Monjalon wrote:
>>>>> 08/10/2017 14:40, Santosh Shukla:
>>>>>> This commit adds a section to the docs listing the mempool
>>>>>> device PMDs available.
>>>>> It is confusing to add a mempool guide, given that we already have
>>>>> a mempool section in the programmer's guide:
>>>>> 	http://dpdk.org/doc/guides/prog_guide/mempool_lib.html
>>>>>
>>>>> And we will probably need also some doc for bus drivers.
>>>>>
>>>>> I think it would be more interesting to create a platform guide
>>>>> where you can describe the bus and the mempool.
>>>>> OK for doc/guides/platform/octeontx.rst ?
>>>> No Strong opinion,
>>>>
>>>> But IMO, purpose of introducing mempool PMD was inspired from
>>>> eventdev, Which I find pretty organized.
>>>>
>>>> Yes, we have mempool_lib guide but that is more about common mempool
>>>> layer details like api, structure layout etc.. I wanted
>>>> to add guide which tells about mempool PMD's and their capability
>>>> if any, thats why included octeontx as strarter and was thinking
>>>> that other external-mempool PMDs like dpaa/dpaa2 , sw ring pmd may come
>>>> later.
>> Yes sure it is interesting.
>> The question is to know if mempool drivers make sense in their own guide
>> or if it's better to group them with all related platform specifics.
> I vote for keeping them just like Eventdev/cryptodev, 
> has vendor specific PMD's under one roof.. (has both s/w and hw).

To be clear and move on to v3 for this patch:
* Your proposition to mention about mempool block in dir struct like
doc/guides/platform/octeontx.rst. 
And right now we have more than one reference for octeontx.rst in dpdk
example:
./doc/guides/nics/octeontx.rst --> NIC
./doc/guides/eventdevs/octeontx.rst --> eventdev device

Keeping above order in mind: My current proposal was to introduce doc like eventdev for mempool block.

So now, I am in two mind, Whether I opt your path If so then that should I remove all octeontx.rst reference from dpdk?
and bundle them under one roof OR go by my current proposal.

Who'll take a call on that?

Thanks.