From patchwork Fri Oct 20 12:31:35 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Santosh Shukla X-Patchwork-Id: 30641 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id EF0AC1B267; Fri, 20 Oct 2017 14:32:36 +0200 (CEST) Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0050.outbound.protection.outlook.com [104.47.42.50]) by dpdk.org (Postfix) with ESMTP id 593CF1B256 for ; Fri, 20 Oct 2017 14:32:32 +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=aA9ryfA+Y2z0I6nMk4wdX9CH4ygIDl0uEEIkyBRkdJ8=; b=DGSYn20i9jWyVN0G+PnW/7liwgQnoJIuvWm1A771NToeKxFX8VN3pw6rHJlsfQeVq+mrfAvPfEgu9S6ZWS1snIKQEwBPjKcuO09Pk9IDhaWTqKk/MOMlK1t85xQN0OXvHBGvtdONxQmEv0lkT6ctl/0YC/w0e0D5tl6uNUZ2fHM= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Santosh.Shukla@cavium.com; Received: from localhost.localdomain (14.140.2.178) by DM5PR07MB3100.namprd07.prod.outlook.com (10.172.85.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.156.4; Fri, 20 Oct 2017 12:32:28 +0000 From: Santosh Shukla To: dev@dpdk.org Cc: olivier.matz@6wind.com, thomas@monjalon.net, jerin.jacob@caviumnetworks.com, hemant.agrawal@nxp.com, anatoly.burakov@intel.com, Santosh Shukla Date: Fri, 20 Oct 2017 18:01:35 +0530 Message-Id: <20171020123136.10557-6-santosh.shukla@caviumnetworks.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20171020123136.10557-1-santosh.shukla@caviumnetworks.com> References: <20170905103119.20511-1-santosh.shukla@caviumnetworks.com> <20171020123136.10557-1-santosh.shukla@caviumnetworks.com> MIME-Version: 1.0 X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: BM1PR01CA0110.INDPRD01.PROD.OUTLOOK.COM (10.174.208.26) To DM5PR07MB3100.namprd07.prod.outlook.com (10.172.85.10) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 56213712-163d-4a1c-1a1f-08d517b6a211 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627075)(201703031133081)(201702281549075)(2017052603199); SRVR:DM5PR07MB3100; X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3100; 3:35hKO5ICaNQ8zcxRqXbylaHc+Hg2t3uP9rjKlgmsjUaPYYBY2Vi0iSb/9Z4PHqrBmZHCw9+m3MxvUIOg3eFERg9F1rOocFMoD4KGE9cNg/tAZwFBnxLen4ULj6HXoJ/uNi5fYLTJypd5Mmn4rkUIv9o3iZkzlyB1U8IxWvwNd6SQuwRL4hQS37PypFe78tFCKbP0nxwdQRwKvvrPuFzZckViMDpZVn18WjAFQivtFkUyBEbDT46gwqx53Me/4DJ0; 25:JOCDBkiyQTlXgWbgR6eRI7ZEn1Nkx0R2KlUssVu0o/aGmUyJetcYg8n+GXi16HUuZowy69ssqR5hP+pk3khSjIqjqRDkjnNUAQCg/p6vb9H0tPXYgWIh2z5zdS3yGdJfDwmp5Adivwv3conuDhCAOo8IRIUEMv0QEK1md6dgyr7VbPjPVyZXayaE11RXxmvLRo5GCXSGv1fryM36G+0IpzsjYxa/qySMbQ5IScMfHQMH+0EisCCoeRHF+cZTBA930/8VkaIqY80E3JEmhTHIarXRi4kRgAG9lsoqUv52G5n8VUcGPibovxAs/QceSChCc/mmwQSt1/JluuT/qQcS8w==; 31:Nt9Lf9uLmJ8QjbqF3CORJbOqkEjygvaxK+hycGUhN25FBo93VD1cRWqZalEWAI2lOrbPZpaIegBVnTn90xTHgMFKmstTyJEtbRWPhaKTwn4MSYnkzuaFBXNDGN1dGU2h1gEun/JQhmIjKm3S1t44MdzdmIhRo33wJZE9CvM+3ToWfs05quJE3QEd5Dkopx3PEcP0pRpNoom56KzLMdLq9XNLCwRuD/S2XYLMMSSy4wk= X-MS-TrafficTypeDiagnostic: DM5PR07MB3100: X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3100; 20:MKaUGFpB0cU5G58av0iv9Ek2+UACCn3OBFaZ57PPJK4lFnFzzZaNa99AzPiKsylWtvTsj4+fF06oki45CER8klK54zC7Zm1L7CQ10TBR7qkNOBlP+C5AamNnn2NpFqUxAReSTXrnbeD7n/tBNGCDLSjv/aBvjhErn2OQf5fzr0VLANa9g/bT4P05lCa/M8bt0yoL+EZOQGBfcQwNEtFAw5eB0e2nE7pez1P0qCCBmH9AfSAgiWVJzN+5a1vldsgRRYG8hIg78tgBU3S8Qdg7FU2B/jfIPWigHv+kavyQ9Mtn+h914KWo4iG8bWcdT5yQaidiAEPa3v4bXjVQEpJ0U/B7y3Bsifs8JY/T5bPhLedTELb4P5Mi3E/hvUOW2dmBIGCwWsgwg7zPbazp7WRMgwwWAU9Wc1AXJNGXUJLBoiK14o0bB/PJa3luGVqr4oJKsTcCcCZzw5eOAmqc+Cj4y6VWgBUQtIRX3Gi3hkGo62JHUPZ2Z4QI9S6FbgWozqISAWYfRbQ1cVkooF/JcJYNoJRyC4lMjxX0fM4ldGqfoD3LpQIZ0+71IpwPVmTL4YGIEdsCvRApl9ApwS7hABq1sIl2GEuJ0GfgxHx2ly+9CuE=; 4:QTCvS2EpifNmR/EPiH+YUTebylGbTRsa5j6h0EJFCKATcBqYJAj33GhAiQtDDntqdwQY+PFhhHY2zLFJMlXO2wB3eDFHHewe+/xwcfvTN25lWNBzkA4fbUHkBdqqtH04bHi0HeXQpC/cokg91pTfOb7LgI/yJ6SX1OXU3qGqwHz+d2n16WS3xk8r8uug59Cx4BzKCIqROmYp2Quml/dok0RlUwuENSIJD5kDX2f/Ow0BHCzKOchx4QrmDySxYseIGsiFXIhOSLaJuw2XK7vlCNuf6lN/JzSyRHJn8jvPNFU= X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); 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)(100000703101)(100105400095)(10201501046)(3231020)(93006095)(3002001)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123558100)(20161123560025)(20161123555025)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:DM5PR07MB3100; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:DM5PR07MB3100; X-Forefront-PRVS: 0466CA5A45 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6069001)(6009001)(376002)(346002)(189002)(199003)(81156014)(81166006)(2351001)(2361001)(66066001)(105586002)(47776003)(5003940100001)(16586007)(97736004)(107886003)(6916009)(42882006)(72206003)(478600001)(5660300001)(33646002)(2950100002)(6666003)(16526018)(106356001)(53936002)(8656005)(8656005)(6486002)(6506006)(50226002)(36756003)(189998001)(5009440100003)(15650500001)(50466002)(4326008)(6512007)(68736007)(25786009)(8936002)(8676002)(316002)(76176999)(101416001)(3846002)(1076002)(48376002)(50986999)(6116002)(305945005)(7736002)(2906002)(110426004); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR07MB3100; 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) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM5PR07MB3100; 23:UY89gydpvVNgaVRigtuStX1pH9YGg+0LAmyfUr0As?= BfKrTRRkRuAwB1PWLu1aZvQrLW46euNydrnjzSdhOidtT7EQ4unqFZ7LT1urhMsgstVF/y6FmEm+5VdiVmNgsreiz0j4FUPXhw9Zu11hDEptu6g81rzbkuS/BiWTeC1K8nIHTKgRIv4CtwNjwyn+h2SNhzdqy7SC97WlHqXjkHX8pgjEl3RJgFKeYs3+6/Jbo6S26sFsDSI0O+G1s/WLLXUf1HfAfCwzqh1/8fbBrjcQcQgKXr3qMd50vGIJOyyeoL+V2HP8e6gKCyFk20lgC/h8DfC78otoDFWapbl9ftsS5cF2MkHCzsjCCkkeD2Ywd1xNFK+8r88U4ZtZBfT3ry0qXo+UznqoSLEeDp8RPhN1woi/uvcrdr3TPAKqAUcIG9kAWjxLDSCWycG88iySR+1526mj4Q4r4j+8+a1IoKTKq/TONIjXv5Mak13BFZQ3raLP9hPVdT4uxdG4TITbLc/yErdUpTBfCgoZVY93OpnslQZPmeoU6on2YKEudyliMUvwCNiPfj9INmUiLKhEDyax/8WCiQnfma+Y7g++ktoJu4dhz1fPG3Cz2WIvOjAwTLwTqb4ONP6T4c4rPB6XmTZBMHzMV7IVarX+dOLgNwKWKC2GvL1IEhaymUO1dtZ0SnQeHI0NRJFndAf8nolYyYtj3MZx+uYfJyAXFt9Y6p24V+mcUZdvrUtTxUnqQ5l9zaqmm5yNerE8BHE2mdFnPQPIouvmORzGLeADixtrKm77+PdpgJ76uDncAcPFeE6NHOF0nUyKW8Id4M6GCFBrUpKeRbkGU3E2Wf8QOmCywRiidpPg+DtHnDoajmahmZvmsydlqzj3pn9JfUVmFwH+M26WTCP6kGvmGyPJfcxZ8tFnx+Vy69Qgdh+FC8sZliJQJkOy65Aiu5lUXU//QyE8UUZBG34iDIa+245zDL2M9Ja5LuApRLrlwdngqtd+sbMPzAzHaVo+VsM7Qhe5pmVzyOevZHktS0xwSDZVPQkgv5evRMFQUHHnnY9IXL0wJNQMhjcjEDQqiU5Dm2QcmzqlfI7/bQ9WSb4j8eCPvKohu3ABk18VA2XXeIRS0RoaaWupwXhj3rmEA5bUM2Q9NWnLBP04USQB+qYaiMmo33f51ASYSYZWewUIMQa364RgyWtHU08wVBeYY47FmawSpURDsmV81JypxNUC32UTuPBNEJkSp94f6TUerOVTbohHapFg7eWVBua8WSLoSr9bhJKMULBZbUcphUkz08oP8DGBO+Sug== X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3100; 6:ODfdtpM2vbS9HBCvctnRf+kQi1ZT8N2o1+5YtREPxoOBLfcvrRFcFy6/5XWCqtyfr/l5ZiXQVaNFG7alZr5U5eNT/fC3eNapc+qTthTPxm7qvyQSTGin3sUYEA4uzUtwYB8pUVdxobJzUOQ+hwpeWCXR4Ue0lsijQA/CU0RtX22tLzIRYEldJVNSYatTOYmBlYXKAlFFQmnXsJ/k3dZ/088dAtbukoWOPKkILy3DRtl9SfcVws2GddoP9mDo+7FUdv52fqcwJGErYHJxCPRqrcLjBXKmoB7ZUFVLYheMeHwyad75gw2gykQ2foJjWHlvaueVN8zgjQwQ/8ez6wR/9Q==; 5:xfPBxsR71s8Xwa97XmcpFXCjQiDUNR7YeGvN+JTvKEUmnhaytUYNsGffSEPIiQshJloMeOKkFfRWZzBKit1TYlAT29wk5FnU1/WbpjFhw9ERP2bn2rUK1czTh86Ut2QQwS6E3n9V6DsuWsQ6axQYXA==; 24:dFbpyPqjPFQ8Y+HhboHwIs6P4NWwA2JlwSL6v/H0HaI3GdtORC1qhaqaYo6lVAdX8XfzvBBq3FARDSWNq/5lZSijmC5zjMLmDwySZXEJ+fU=; 7:qNdYXXcWzEGXjg4WQ0+jAAv0lkewxdUpkfXS4qmE1PnIQUMipcfQ3CIIfQ/ximr7dU+rXzTpA2/NkTl4LHh8ci8D06JkahKg4yBtKgXcUZtHdmktC1Wn+VdYyhB7uqX8+lU/tvs/dHcinixZmMvMz5eZ55Q0n/+akxgTjtdj4BskwDRYffK2XUNmzeCnfMjAHYTfLmY3ebC1qPOKe+JemGTnkFkV9UvY42JVTlx1IeE= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Oct 2017 12:32:28.6590 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 56213712-163d-4a1c-1a1f-08d517b6a211 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR07MB3100 Subject: [dpdk-dev] [PATCH v3 5/6] 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 | 28 ++++++++++++++++++++++++++++ 2 files changed, 28 insertions(+), 7 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 52058f580..d89d35320 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -29,13 +29,6 @@ Deprecation Notices - ``rte_eal_devargs_type_count`` - ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse`` -* 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 6f3b92bc5..5287e96c3 100644 --- a/doc/guides/rel_notes/release_17_11.rst +++ b/doc/guides/rel_notes/release_17_11.rst @@ -302,6 +302,34 @@ ABI Changes The size of the field ``port_id`` in the ``rte_eth_dev_data`` structure changed, as described in the `New Features` section. +* **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()`` Removed Items -------------