From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ; 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 References: <20170831063719.19273-1-santosh.shukla@caviumnetworks.com> <0d07a0ca-5fb3-f275-9d5f-2f30a8503caa@caviumnetworks.com> <79352056.QgdvfuXRzQ@xps> Cc: dev@dpdk.org, olivier.matz@6wind.com, jerin.jacob@caviumnetworks.com, hemant.agrawal@nxp.com, John McNamara , ferruh.yigit@intel.com From: santosh 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: 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: 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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.