From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR03-DB5-obe.outbound.protection.outlook.com (mail-eopbgr40044.outbound.protection.outlook.com [40.107.4.44]) by dpdk.org (Postfix) with ESMTP id 33C961B435 for ; Thu, 2 Aug 2018 07:58:17 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ASGvmLwTU9Hrfe2f5WQRipDdvMPONBg/Rta2kY6JQgc=; b=iNO+eVN5BfdWPPsEexKZhEGksD3lsUfNB036Hg8moACmtxtD9D0YMjw7d3vOj74SZzuyHLO+YU0/dAvjj6Ym98Gj1fHZkaa867xSlsWK6MClmo/Z1jV2f2mBPKrK9KRCDCF0vv1DO3tkkk3/gdl73uo+0R59mKQVQUMbFF/CnrA= Received: from VI1PR0501MB2045.eurprd05.prod.outlook.com (10.167.195.147) by VI1PR0501MB2736.eurprd05.prod.outlook.com (10.172.11.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1017.15; Thu, 2 Aug 2018 05:58:15 +0000 Received: from VI1PR0501MB2045.eurprd05.prod.outlook.com ([fe80::882c:f01c:dfb2:175]) by VI1PR0501MB2045.eurprd05.prod.outlook.com ([fe80::882c:f01c:dfb2:175%2]) with mapi id 15.20.1017.010; Thu, 2 Aug 2018 05:58:15 +0000 From: Yongseok Koh To: Anatoly Burakov CC: "dev@dpdk.org" , Neil Horman , John McNamara , Marko Kovacevic , Thomas Monjalon , "keith.wiles@intel.com" Thread-Topic: [dpdk-dev] [PATCH] doc: add deprecation notice on external memory support Thread-Index: AQHUKZBG9QNtC3KTwUqwO3bOpMkqJqSr+KsA Date: Thu, 2 Aug 2018 05:58:14 +0000 Message-ID: <71DD2117-A90A-4DD8-AA16-391224CC8C89@mellanox.com> References: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> In-Reply-To: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=yskoh@mellanox.com; x-originating-ip: [73.93.155.83] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; VI1PR0501MB2736; 6:dzkHoUUUdBn6F5+D03jNI/qBwgGsndh1YuPIUSlzlMi6CiuxbT/QuA/vZtYpmEnOHJNdad1WRqS+hfWn3QenOR0qLGIIqWMmSIsFuM3eUisgzN4zMssr+6jvH+81VmQIG3DJhF8sSas8wLdNWtCMeQHiWQjYw/khpaHgnbJX6s01On5b+L+TcUC8DH6D9BBizUfSRelvY5+kZLU6Q7f8M3oH25WTAJslu4ICROcX31q0S+CAc/ghLUv7cHFcbmgYBL02jQ/VpFjRo56/tueU6XufXY/I9AGp2xxJc5HROpJdxVHT3iCT4tnt0w9iZ5U01fIUlHI/hZjzhC46nVGqIF/ZMOBXcJKrrThJELjBjnK7iOosNrz3lGLsXHDaNYmlVCsM59mZzCtVuzL10EvipZ4JW0hBBglGVa6KEB56FSkMWgihHylWVkAKmuzrvq3a1HzmQQ64if+B0LwMdcKy/Q==; 5:378p8+fbHly6xBPYO/H8j6Y3WV9jLIK59+LsbJP5sf/6Sol20d0aOsbZVIW/okjg3mvgWb3TzTujW8t18py3CbqmSV5PuFj0fnUnCBkzGRuZMV0cSm1HH7HknDZvrZFgcUaKaOC77lD+hMmc7cfGv2X0pqCpXutCUOV7SkPV7OQ=; 7:JGVjkmv7rWAY1f9Bjxf1WTj/oISO+BS3l/6o6GcY2L2dKSlFcgSNuIx4IM133OlN/ojMfDUE3vZ74peyNyxUF0V2zLDQYUpaAiTLpbklLAJuny0f8/xZaqwH8QYgvxo+XfkUkcpge0w7cAAVURNafllVdBXB/NqjnSSQNnHUrenaPZGwIf6TAimaJ3stkjwHb9OWcxmKoHjztHjRoUX2c+MY0Y7R1VU3ut3jv/FmXVOUFd220tvw39dWRR44gouT x-ms-exchange-antispam-srfa-diagnostics: SOS; x-ms-office365-filtering-correlation-id: 9544682e-8375-461c-e5f4-08d5f83cf007 x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989117)(5600074)(711020)(4618075)(4534165)(4627221)(201703031133081)(201702281549075)(8990107)(2017052603328)(7153060)(7193020); SRVR:VI1PR0501MB2736; x-ms-traffictypediagnostic: VI1PR0501MB2736: x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:(189930954265078)(100405760836317)(45079756050767)(228905959029699); x-ms-exchange-senderadcheck: 1 x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(93006095)(93001095)(10201501046)(3231311)(944501410)(52105095)(3002001)(6055026)(149027)(150027)(6041310)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123560045)(20161123558120)(6072148)(201708071742011)(7699016); SRVR:VI1PR0501MB2736; BCL:0; PCL:0; RULEID:; SRVR:VI1PR0501MB2736; x-forefront-prvs: 07521929C1 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(136003)(39840400004)(396003)(346002)(376002)(366004)(199004)(189003)(305945005)(5250100002)(476003)(68736007)(6436002)(6486002)(36756003)(81156014)(81166006)(256004)(45080400002)(99286004)(14444005)(2900100001)(76176011)(15650500001)(106356001)(14454004)(53936002)(102836004)(229853002)(6116002)(486006)(2906002)(3846002)(86362001)(7736002)(478600001)(66066001)(53546011)(6506007)(5660300001)(26005)(54906003)(33656002)(6246003)(4326008)(82746002)(25786009)(446003)(83716003)(6512007)(6306002)(8936002)(105586002)(316002)(966005)(2616005)(11346002)(6916009)(186003)(97736004); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR0501MB2736; H:VI1PR0501MB2045.eurprd05.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; received-spf: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) x-microsoft-antispam-message-info: UedvplO+GRPwi9Lg1095ukDDypl8+bvnHhdLlxhlFzlK2VXAxh9999FuA/O/QA8GBKWfgXZyET+2/EJKpzASvzTrR2G2ChdP4A1qKR3IWRLIFtSjuR74Xx/nJray5XmA5K6qNLKwm0vFijJxbS+ONgXOxmWGqcdLGgD4c+jCYuyiQZvuKoGbUWKHz7PGQHpGlOlZ0HAUbp2ISi9aaQwtW/I+I9d9+z6byG1pV7S1WHKCFP5Dl/1rE+g/dVOU7/XRLW6mJk/7xtKijLO+XCo9mCv4Dk/DIrNzhH57Ld0KVDcMPtdo+w3M7EBcCjIadZyKm4bEdReE/AL+/dIj5O58G552SQEPs/RJbnC9Uxp3WTc= spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM Content-Type: text/plain; charset="us-ascii" Content-ID: Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-Network-Message-Id: 9544682e-8375-461c-e5f4-08d5f83cf007 X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Aug 2018 05:58:14.9847 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0501MB2736 Subject: Re: [dpdk-dev] [PATCH] doc: add deprecation notice on external memory support 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: Thu, 02 Aug 2018 05:58:17 -0000 > On Aug 1, 2018, at 5:07 AM, Anatoly Burakov w= rote: >=20 > Due to the upcoming external memory support [1], some API and ABI > changes will be required. In addition, although the changes called > out in the deprecation notice are not yet present in form of code > in the published RFC itself, they are based on consensus on the > mailing list [2] on how to best implement this feature. >=20 > [1] https://emea01.safelinks.protection.outlook.com/?url=3Dhttp%3A%2F%2Fp= atches.dpdk.org%2Fproject%2Fdpdk%2Flist%2F%3Fseries%3D453%26state%3D*&d= ata=3D02%7C01%7Cyskoh%40mellanox.com%7Cc4caf7979dd943bb48c508d5f7a7661f%7Ca= 652971c7d2e4d9ba6a4d149256f461b%7C0%7C0%7C636687220727753880&sdata=3D9y= DGZf21ImYOUzM85n92cs%2BsgeafrrhG%2FlmJpWVpcWA%3D&reserved=3D0 > [2] https://emea01.safelinks.protection.outlook.com/?url=3Dhttps%3A%2F%2F= mails.dpdk.org%2Farchives%2Fdev%2F2018-July%2F108002.html&data=3D02%7C0= 1%7Cyskoh%40mellanox.com%7Cc4caf7979dd943bb48c508d5f7a7661f%7Ca652971c7d2e4= d9ba6a4d149256f461b%7C0%7C0%7C636687220727753880&sdata=3Dzn4ZfXModNRgnS= p649JFWd4Byr7RxH8mgcM6IKJTGWk%3D&reserved=3D0 >=20 > Signed-off-by: Anatoly Burakov > --- > doc/guides/rel_notes/deprecation.rst | 15 +++++++++++++++ > 1 file changed, 15 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 14714fe94..629154711 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -8,6 +8,21 @@ API and ABI deprecation notices are to be posted here. > Deprecation Notices > ------------------- >=20 > +* eal: certain structures will change in EAL on account of upcoming exte= rnal > + memory support. Aside from internal changes leading to an ABI break, t= he > + following externally visible changes will also be implemented: > + > + - ``rte_memseg_list`` will change to include a boolean flag indicating > + whether a particular memseg list is externally allocated. This will = have > + implications for any users of memseg-walk-related functions, as they= will > + now have to skip externally allocated segments in most cases if the = intent > + is to only iterate over internal DPDK memory. > + - ``socket_id`` parameter across the entire DPDK will gain additional = meaning, > + as some socket ID's will now be representing externally allocated me= mory. No > + changes will be required for existing code as backwards compatibilit= y will > + be kept, and those who do not use this feature will not see these ex= tra > + socket ID's. > + > * eal: both declaring and identifying devices will be streamlined in v18.= 08. > New functions will appear to query a specific port from buses, classes = of > device and device drivers. Device declaration will be made coherent wit= h the > --=20 Acked-by: Yongseok Koh =20 Thanks