From patchwork Tue Sep 5 10:31:19 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Santosh Shukla X-Patchwork-Id: 28362 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 34E077CD2; Tue, 5 Sep 2017 12:32:20 +0200 (CEST) Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0046.outbound.protection.outlook.com [104.47.42.46]) by dpdk.org (Postfix) with ESMTP id 29DC95688 for ; Tue, 5 Sep 2017 12:32:17 +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=FbPunCOhCfe7KtxdQ8XVcqC/3h0El1yrddoKAoolX3c=; b=m4JJJGOD09FVszJnG1wNL/J+T6SktLdupDCZo8q5JPRBUOfZIH5clnmsRQED9x79YqlJzXdt1EnL+//xoC5VS0h/JGFS0Twmcu5VBEckxfYQsgp60VKC3LzOxTHdCa4MeHF2QduiBiyStTuJ1xs62WnrcBPHPpfW/UxVagJkhMY= Received: from localhost.localdomain (14.140.2.178) by MWHPR07MB3102.namprd07.prod.outlook.com (10.172.95.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.13.10; Tue, 5 Sep 2017 10:32:13 +0000 From: Santosh Shukla To: dev@dpdk.org Cc: thomas@monjalon.net, jerin.jacob@caviumnetworks.com, hemant.agrawal@nxp.com, olivier.matz@6wind.com, Santosh Shukla Date: Tue, 5 Sep 2017 16:01:19 +0530 Message-Id: <20170905103119.20511-6-santosh.shukla@caviumnetworks.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20170905103119.20511-1-santosh.shukla@caviumnetworks.com> References: <20170814151537.29454-1-santosh.shukla@caviumnetworks.com> <20170905103119.20511-1-santosh.shukla@caviumnetworks.com> MIME-Version: 1.0 X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: PN1PR01CA0073.INDPRD01.PROD.OUTLOOK.COM (10.174.144.141) To MWHPR07MB3102.namprd07.prod.outlook.com (10.172.95.8) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: c7cf8e3f-66e5-4ac4-8ece-08d4f449608b X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(2017030254152)(300000503095)(300135400095)(2017052603199)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:MWHPR07MB3102; X-Microsoft-Exchange-Diagnostics: 1; MWHPR07MB3102; 3:vM6ScORTnDtrZg/HkvtNRosAqnlQ2th2FBB8TF8cSCBCWqQssqMRwCBgTlkohEVUeJZlTPQPgR8qDXiWFk5GqFl/gafP4wPkVm5zS0GpDeQfj3u8IpkgzBDvZ7pj1RfERca5ePMiu/AhK4gt7XGgJfM5QT/M4GOh6BH5ShqJbdDkG7kcMgGokCi5WwMa2gVsAjdd2jjURQTCLEgsRSmdXVPZ3qp/rNVjXHYTwo/8C0zqAwRWQLrk7n3ijEk6Az7C; 25:qRZo0ZCrWhvBIqkakoM2iIZUC9ZWmyvhgIks3ITP4aE9Mw/SuC1Wn9rGCJbcp7D2MrW1woMdSOU7ALPUJOmobrXQpsonzvgvQBWd7sFbnyESuA3fBujWQIrPuaCVbtISP0lAeIeJin+uozy2xKYls2YQbikQ2xZA5g2J0AUtNL/S2nbBRhiIp1V3EY6x8QdZUUXSLXBs0B3HhIo05U32n1z5Z8VYG7qlZYKXWq+A/hZGxYL3MKB2RRc7F0oyws1Vb7sUMHqMpPGlREc8dsPI4GXeN1aLTMP2qqK9pZua0yPTi0ACdfIKIqpnnU85RH+FPtsKJwm2rU7z0S8PHt2B/Q==; 31:FMyhxWt1K69pEq7hwKpxhee1yhWvsRBMaTMjquSzBQ4QsAG5wz9waBmoCvKui9Lo5vNExxPTjFjpeHNHP5CE1C9AZgfyJMhfosOit2Tizr/RVfFsaYsGgCRggixIDYd2cBoNDoqdDID4ICe5thJ6z5ZvJt3JvHs0lRL1z8lcxkIox2JMoPdcG+Vccl0qJBjwQ7zDB4HWqsknQ1LgvifHPec0SSjKknzt6Iag6c6Yxqw= X-MS-TrafficTypeDiagnostic: MWHPR07MB3102: X-Microsoft-Exchange-Diagnostics: 1; MWHPR07MB3102; 20:omRIKONa95Hw8aq0XWBke4CCIe166eG5NCsHkNF4FFUYTCQYsqZBwrnSeOZHiqShCVkMcSIq4oGYVs4ta/yVJ1CAaD2IKYikjhHAspTliOq0C3+mLm8xzzowfcLmCQj680Rnc//vqaqo2+G9Ja+xzyk7phGOtjoKDbf1fLwLRWLMfQAXKmzjqMUjULcNo35FbDBJA36KIQppB0yHxoouo3flp6AOPPTjDX2iX9t6QMjb1Es/9h+9aZapX1xQx2zXjdLjlJsk01H8TBbpJr1l5Clf/FUrrX/T5FVG+lS/Xd/ysOnflGc4C5zldRcJ0//Rh0hMyodwka+Kfo8HMkY3C0vLPrqWJIMI6ddKz6WvvCP72m5Fvn2LuHDkUSpTS4Oat22/mVHD//XHGJS1sYhe5Nalb24Xd9u20QJJuCmsMkq8wYpzJhRO+Pace2Ubn00kT5Q3J/Je7QNS1oENR7VuSr80vh/LZ+fn/dpEnRhyshsASvVgV9jmGy1FmvFacjF5a1grZgJ9lmaHwpgrKq6mXIEBSrcQOMPw0HUYBCR8RlUUgX8d3YLsCqfb7w93BDXsDRmqSzTYpYFWK8hp119Ye60m9UDq2gh4QSZd4x+nS7s=; 4:y3Ld+EAzt5DlN0/K0h6Ssa+DxHz98D3k9JrCP5zgKojZIFY8TNjVb+1vNJKs1EAfqItQyrM+82ibGlGLwiUWrFpqOi/61iBG3yIuZcP6mQ8/lzqRHSv1jprZhEJbIooOkQMCq/LyB/gDhrJBJxjkS8qW79WW2OPSgo0mFkbKZQi9/CE0rrUJtgiSvqTJPOZGJcT7bjgi/xf2RHDxxoGPu9eubKoTEPg4BWdd6ec8y4Neweu1QBS2FcghT2xnQ7X3 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)(3002001)(100000703101)(100105400095)(10201501046)(93006095)(6041248)(20161123558100)(20161123555025)(20161123562025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:MWHPR07MB3102; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:MWHPR07MB3102; X-Forefront-PRVS: 0421BF7135 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(6069001)(189002)(199003)(8676002)(15650500001)(6116002)(7736002)(101416001)(50986999)(5003940100001)(48376002)(53936002)(8936002)(305945005)(107886003)(110136004)(50466002)(97736004)(1076002)(6916009)(3846002)(2906002)(81156014)(81166006)(50226002)(2950100002)(42882006)(105586002)(4326008)(6506006)(8656003)(25786009)(5660300001)(5009440100003)(68736007)(6486002)(72206003)(2361001)(33646002)(2351001)(36756003)(575784001)(6512007)(76176999)(66066001)(478600001)(47776003)(189998001)(106356001)(42186005)(110426004); DIR:OUT; SFP:1101; SCL:1; SRVR:MWHPR07MB3102; H:localhost.localdomain; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Santosh.Shukla@cavium.com; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; MWHPR07MB3102; 23:2KquqO36ZcLIpKJp4VtVkywrs9+WVrY+BCszAIavg?= FLpT+RXWzNgB15LosKnoyOngCARYtfQegRRHwPjXSMs6Ye/zo92YA9e0jhqR4oTWGVpha98Y1u1GsDyqDOxygUGZztZmaAkKngiEwSY3bi5GX/YGzZ895HwQP4IXNaWUb8zP7ULzX1XP6kAPVBtT2NGRWytF3aq9+HSkDqnHJz03JQtBJibf50T4FJMXL3b3ogAxcPqgqUGO00MR7XOiTooSqUCNkcFHq6rYMdqq0zHv/9rOZl3OC3N88vnmUqvYDy/rdjRr4e526Kd3mTksnP0YxGxORLWWxod1a1P4O0coU9nyunTlKQIig8cjstgWQrrW3qsbSYTkNOc+bc4X7JUQrHp5p5ozON0Mz9rfNFdpOIeXMF1jmespjMHrDjREaRzM1otYmF0D/N6xWJDuXjymlBW8WhSB8Q4ue9Tv3B61fUO44KC9OoajbnPNrfSaFpwp+eCPx6z23OqgKiyq0aAaGIDhB0s+9vguN6+BbVdXaRrEhtiyBaJ4NWyZqSK/N0yerF1S/3WjAVzEcd5GFSk+gqqNOsmfeHjZtiMlBFsT3sg2123Hv/0VYHX61TcZ6RcdxRPK4JSuByj+d27mfFc7X2iyz7pt0eBz5t4S75qA5PDnVFxEEgvaPXRe9AHuf3nQ2eyEwov9ooSG6Ry3KgN892LeojJNL6KvnSmz+zgOkSikDxZ6Bg6SchdIpVll9j80QJoUf5Avf3cX/Le9+J9aKfDgnH0DRHGHVOUDKZTvWZl4pcDYNT7LZwdotYieh5P+4OrE40ZW9UkmYxxm8nIFGV1fkjxq+1bxEiOX0xY0ySjMndn/7Xy77Rtg8KMPonO19G4kKzfOgxnoMXrqPHXJ43J7TYBdQ96Eg6QDe6QQ67v+mm8hv2mDC5V0w/epDv9ehABKaLdnJeXnFUGT+PzVOavJPcqV/cTHjGwiMNu5uu+2ILMxfGUMIV5Nun7a9VXwQ881RNdrrlZcvzf8BVG1Bc5ycQKEPSC+9GFAIMR3xZVjZML2baXaLcsvuAB6Z875ba2BVTEhbGVfsIgZBaSwDUWxTPwxoEj2aQRi8jfBni+jCywTSa+aJ3UBbjhEeLGz9JaBHnCEkJi+pKt/3Nw3k2FyUepgBAQ+U+sWfgoqoAf+oQCWzGPJPSr0f/nTct/K0Tfg2FYzAbhPXBo1Kq9udfjZyTo8qasY1LC7E+6ya8YVAMWkin2+8C8fgikFtw= X-Microsoft-Exchange-Diagnostics: 1; MWHPR07MB3102; 6:2/6EVDddxTs/6zAl3Yw6MvoQN/OHdFkMb3fZfgzdUFisvm/1BUHd+IX5UQLwQ945WNQaGlhkuZVc8YqL4StBXrKNiRX+MU0zxv9nklId/vK7JgiFQXh8yKtYMP1q67soA7D2IwW7vun57VemW3WFQe5ddZ0JKRorRrZ2SXOnp+/t0AAcP6d2vRL5lzXDNNoowZ7hXwJ9w6JxfAyK2/3aeaEzlV9DjYegMFkw7o/xeGt4JQbKHb7UB4dMDfOqXEIfTbclfCc5ajVE1+gJyiF+NMBbxr4as13c6pRO1ngp5LxBuQ3vRFRwx4hceWRXaoNaK2ujpKM9NAEc3Evm0oUkBg==; 5:ApP4ct9RcH0V8uPcCKRcNeYCTfBdftQNFDAG/FauwdseveCpboN1sWxMYFa8kasQZEhL34548Jn92LpwY5+0L1M13ipxj+HgLWwgLq4KKaKe2z4uHaWfYERN3cVrsSDOZTLDmEvVqUQB7TzG4OBoKQ==; 24:KDqQ7trfxhMh9FNBQzMtGZBjdbZMAGoW4LA8lUM7HbYOlg/uYHX2C+XETOE9FnrUC6YVfUT/oR/bvCbJYJ0LllzSkHaaf7tWymEuZLmGsHE=; 7:aCphnOPT0qvC5T6DtcNaey51PQ4N1jNcVFJP0lBdDNl1reugPLuqeEJQfaFsPBqD3M40WxPHr2xmphJwo2KXV7bV2b62Q6yikw5YOTh6gAWbLEndTE/IDQbOZQEef67Xak1OBeRI/DF07UVf6kPFCMjBOwKzev+Qw+NiSTKQpMERB7JVU2ecSUsuup9v0cckCNhKGbAX6BMaKONSgRZGZnCBYa+MebueQ4mmLikUIi0= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Sep 2017 10:32:13.1880 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR07MB3102 Subject: [dpdk-dev] [PATCH v2 5/5] doc: remove dpdk iova aware notice 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Removed dpdk iova aware ABI deprecation notice, and updated ABI change details in release_17.11.rst. Signed-off-by: Santosh Shukla Acked-by: John McNamara --- doc/guides/rel_notes/deprecation.rst | 7 ------- doc/guides/rel_notes/release_17_11.rst | 27 +++++++++++++++++++++++++++ 2 files changed, 27 insertions(+), 7 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 3362f3350..6482363bf 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -32,13 +32,6 @@ Deprecation Notices * eal: the support of Xen dom0 will be removed from EAL in 17.11; and with that, drivers/net/xenvirt and examples/vhost_xen will also be removed. -* eal: An ABI change is planned for 17.11 to make DPDK aware of IOVA address - translation scheme. - Reference to phys address in EAL data-structure or functions may change to - IOVA address or more appropriate name. - The change will be only for the name. - Functional aspects of the API or data-structure will remain same. - * The mbuf flags PKT_RX_VLAN_PKT and PKT_RX_QINQ_PKT are deprecated and are respectively replaced by PKT_RX_VLAN_STRIPPED and PKT_RX_QINQ_STRIPPED, that are better described. The old flags and diff --git a/doc/guides/rel_notes/release_17_11.rst b/doc/guides/rel_notes/release_17_11.rst index 170f4f916..30d0c0229 100644 --- a/doc/guides/rel_notes/release_17_11.rst +++ b/doc/guides/rel_notes/release_17_11.rst @@ -124,7 +124,34 @@ ABI Changes Also, make sure to start the actual text at the margin. ========================================================= +* **Following datatypes, structure member and function renamed to iova type.** + * Renamed ``phys_addr_t`` to ``iova_addr_t``. + * Renamed ``buf_physaddr`` to ``buf_iovaaddr`` for struct rte_mbuf. + * Renamed ``phys_addr`` to ``iova_addr`` for struct rte_memseg. + * The Following memory translation api renamed from: + + * ``rte_mempool_populate_phys()`` + * ``rte_mempool_populate_phys_tab()`` + * ``rte_eal_using_phys_addrs()`` + * ``rte_mem_virt2phy()`` + * ``rte_dump_physmem_layout()`` + * ``rte_eal_get_physmem_layout()`` + * ``rte_eal_get_physmem_size()`` + * ``rte_malloc_virt2phy()`` + * ``rte_mem_phy2mch()`` + + * To the following iova types api: + + * ``rte_mempool_populate_iova()`` + * ``rte_mempool_populate_iova_tab()`` + * ``rte_eal_using_iova_addrs()`` + * ``rte_mem_virt2iova()`` + * ``rte_dump_iovamem_layout()`` + * ``rte_eal_get_iovamem_layout()`` + * ``rte_eal_get_iovamem_size()`` + * ``rte_malloc_virt2iova()`` + * ``rte_mem_phy2iova()`` Shared Library Versions -----------------------