From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 779BFA0C40; Tue, 7 Sep 2021 17:22:02 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 03286410EF; Tue, 7 Sep 2021 17:22:02 +0200 (CEST) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by mails.dpdk.org (Postfix) with ESMTP id E0D46410ED for ; Tue, 7 Sep 2021 17:21:59 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10099"; a="281237009" X-IronPort-AV: E=Sophos;i="5.85,274,1624345200"; d="scan'208";a="281237009" Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Sep 2021 08:21:58 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,274,1624345200"; d="scan'208";a="648084992" Received: from fmsmsx605.amr.corp.intel.com ([10.18.126.85]) by orsmga005.jf.intel.com with ESMTP; 07 Sep 2021 08:21:58 -0700 Received: from fmsmsx611.amr.corp.intel.com (10.18.126.91) by fmsmsx605.amr.corp.intel.com (10.18.126.85) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12; Tue, 7 Sep 2021 08:21:58 -0700 Received: from fmsmsx601.amr.corp.intel.com (10.18.126.81) by fmsmsx611.amr.corp.intel.com (10.18.126.91) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12; Tue, 7 Sep 2021 08:21:57 -0700 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12 via Frontend Transport; Tue, 7 Sep 2021 08:21:57 -0700 Received: from NAM11-BN8-obe.outbound.protection.outlook.com (104.47.58.168) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2242.10; Tue, 7 Sep 2021 08:21:57 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=iyKxvfrHj9ZcA9f0WuG0EPyBY57FZkWyuDu64hzvIxYF5J9z13XgmoSDY8eBVjDTNL3o2igZzYgqd0gQV9JGzq45BU0QLIn47cM5nl8fQ78AU7Ry2+AnuK9phufOrXZvhzrrjwHICJGQMMSf1BTvmmXZ3o+bVRSkodmovvNDQJ9tEB7brtLrd/7sTEdLX1rwI8Ycg+17IKj8Kx5kQM4Wh/hUtSJK3mzn6XtoD7B0fYmLVQzy+CYaSxmsSrGvqcnuC1Uap5dYGGm5J1kmgxKIjvOUlLPT4jWS68vgfn6rxOGSHImx+n/ySbZrMMt37Puu8RbOJF3qf1hQue4TTdFSQQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=gvMu8CI+RRUkjABcwfSLkDQi0CAH1vhIPJ3NeUZOUyA=; b=lBH6Ui72ACmB4Livc1kkc3qqUq3iWn2VhAHW3cnD4QcY8IsZIO8SRaodYcHsEkzHLp6EvAH5rWa2tu++YTIJRcBbW8cSCMIASLWA5nIJxAdAxmgdXiTQIPm04RIBmUvZ7XltguoQn+i2pXWbCemvGYcFLkr+iMEwqVKg1X/m/epyZuQLbCJFFBF0Svft1qfaP16afvaNdx8M+24LIB3Ep+9Kzd342mq52/6fW//FCp6ltKkmrqVLjBoeLp99CsJsFEdmVK7v4D8cOLYZgI6LYUibvmNE80msrYqT0osTapdpniFN2MvdmLT0bXlVpXMChS/SNolnkqF7AiE93GBUww== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=gvMu8CI+RRUkjABcwfSLkDQi0CAH1vhIPJ3NeUZOUyA=; b=fCAwOJA6yw/mlKytGlJo2Gj49g517TATwt5oUyUgkg1aZnGiJurBywdyzSCw/9i+fRsKzeSVt8iWh4D3LpRpshfUbmVCdOVQ3NLer4z3WZHNNQoA0Ft8L48eEwKm0CVCk7Pd7BGgjqLhSlmihHDga+E/A+8gunJsGhX1qsnzpPc= Authentication-Results: monjalon.net; dkim=none (message not signed) header.d=none;monjalon.net; dmarc=none action=none header.from=intel.com; Received: from PH0PR11MB5093.namprd11.prod.outlook.com (2603:10b6:510:3e::23) by PH0PR11MB4887.namprd11.prod.outlook.com (2603:10b6:510:30::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4478.21; Tue, 7 Sep 2021 15:21:53 +0000 Received: from PH0PR11MB5093.namprd11.prod.outlook.com ([fe80::d145:710a:1bac:7e91]) by PH0PR11MB5093.namprd11.prod.outlook.com ([fe80::d145:710a:1bac:7e91%8]) with mapi id 15.20.4478.025; Tue, 7 Sep 2021 15:21:53 +0000 To: Ferruh Yigit , "Ding, Xuan" , "Kinsella, Ray" , "dev@dpdk.org" CC: "maxime.coquelin@redhat.com" , "Xia, Chenbo" , "Hu, Jiayu" , "Richardson, Bruce" , Thomas Monjalon References: <20210831131039.29964-1-xuan.ding@intel.com> <2c9fc397-df61-2ef6-0cce-db5dbbb1c952@intel.com> <926d7065-481f-b84e-1d05-bdeebd31d6ea@intel.com> <032e666a-9ada-f4c0-36bc-ad9b5fac4359@intel.com> <8779d165-6e98-a294-9f4b-a6ce76d9c77a@intel.com> <0998ae41-2c0d-c5f6-806c-50ccbcaf2139@intel.com> <695fb104-533f-a9cd-42b0-953769ebf7c9@ashroe.eu> <059c8e40-5fee-ce8b-c29f-c94a43ea7a50@intel.com> From: "Burakov, Anatoly" Message-ID: <20b52952-2c57-e07d-5982-f644d2921cb4@intel.com> Date: Tue, 7 Sep 2021 16:21:46 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Firefox/78.0 Thunderbird/78.13.0 In-Reply-To: <059c8e40-5fee-ce8b-c29f-c94a43ea7a50@intel.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-ClientProxiedBy: DB6PR0202CA0014.eurprd02.prod.outlook.com (2603:10a6:4:29::24) To PH0PR11MB5093.namprd11.prod.outlook.com (2603:10b6:510:3e::23) MIME-Version: 1.0 Received: from [192.168.1.10] (212.17.34.161) by DB6PR0202CA0014.eurprd02.prod.outlook.com (2603:10a6:4:29::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.14 via Frontend Transport; Tue, 7 Sep 2021 15:21:51 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3f42a915-1127-49d2-4cac-08d9721338cb X-MS-TrafficTypeDiagnostic: PH0PR11MB4887: X-LD-Processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:4303; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: VDz4axHWpWYbSkPXwT6g02Vd8hFEguUCDgKYkRO4tYDW/hzAWgqHvVTjueShlw4SX6riaESXjFM6VYUGiDoHggKzn33qQVjWaiDAIUKooL48u50rncn3+ZZwIl5VzXhVF6CS5T21t0o48m/ZeqU/XJOy224BpQpU2/jRgN3ymPgJim3zQxu7BBFRiusT43qL8+czuNoEV0xLNfvXx7HVVwKwzgEA7tBBIeboVK6Y5yzxhD4jyYdGkAC/JrFo6lttQl8ivCmzt6esTBaWmfNdt+CoBQ/OIL01GdUkCu3/IX55cCCOLRp25N0xERGkdGp+8IU2x69IFP8ysUSKKQP5SVEmVzFUwG+Zp2QJl2XRm9V377YXzAj/Q7Jy80OI2enodqY2FNAOkB4+yUoSYyq9kzCxJIEDHmRIKULpS3IOqpsdsrg5v5gmvXWRhdq0bOe/qRM98O805gzvnVXLNR9qJV0Fpy+niTi11yQnqfcWkd+19PjqpSEM3A2DK5Rj8Z/eGkH4OWqoGWSOmqJb1+1zocUzqET5GKGdf0ChF/8B9SzDgfpfbPsIjJEjvMht26GKOk1LHMsRAcq4Dn/Rx6mW9jS7XJs/mO37m6Yv5+TxHjr4zzk4ynVtyfRHB+ykbPtCFZzN7DAQ9X2jz1NihunqCnzYQ58t7FiAWzkqGoox3fmkMhVZ3Fz1jB8gHzsvWCWQAj3tHKFaAZclSop9Jzc/Bkm5Z8I7VnBi40gFSLnjz/5P058itS40Ki5oeLrFVT+1Oh1tTrT+bUGuIcVEHeoeNk8fwBZEMoZNqGMjMiqBAwBfBe4z0Dg1ERHZh1XKNaG7 X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR11MB5093.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(66476007)(2906002)(66556008)(508600001)(31696002)(316002)(16576012)(38100700002)(186003)(8936002)(6486002)(8676002)(110136005)(6666004)(54906003)(36756003)(66946007)(31686004)(2616005)(966005)(956004)(4326008)(5660300002)(26005)(86362001)(83380400001)(53546011)(45980500001)(43740500002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?RjdtSURmdnJtK2RLeCs0ZFBlMWhUbDZLU01Bd0JGL1BMMVpGZFpDU01mL0xY?= =?utf-8?B?ZlowKzFmYVN3WkFndDBEdEtkRG9BMUZYb2NQZ2VnK2tZSzZ4TjVxTE5TRmND?= =?utf-8?B?ZE5NT2grYnJmeFFUUWgxTUJRZ3hUbDE0Y1VlSEFDRFM3K1dMWnpZMGNDVkpj?= =?utf-8?B?eWMxNFcxeStQdkZYWFZaNDNXQllnWWxzam8wOWVVbG5XTi80bmE5MkNLcmpK?= =?utf-8?B?NzJHM25haHB1V0JodHVGdU1ESkdkS28zOTVHSzNORGpBUURtRmRVZHZKTUMr?= =?utf-8?B?UzVDODdXbC9JWVBTekVMV1RIQVFPRGhVdjNwRkZDSTluK2hRaXl2dzZkSmgw?= =?utf-8?B?eFg0UE1zdTRZS0ZwNGZGdklkTVFxMVlOTVZEbTYxQk5wbXkyNzlNM3BHRGUw?= =?utf-8?B?M1E0UW1BK3kwTGNTNlJrWHZNUklxSlZrZC9xdWlNT0Z4UUI3NFIwUE5RVFVo?= =?utf-8?B?STN0Wkt0ZXZlWXJFR3ZGcG9BSldDRDZaQzYvK3ExNCtYbXlTUTJRSThEVXZl?= =?utf-8?B?ZmV2QUFEQVJDczY1WkFpT0JEaEFxOGw5Tlh0OW1RRml0K0ZSU0pqYmIwNWlm?= =?utf-8?B?eTY1WEs5NW9GT2I2SFJ4aEwyRXozVTNNbWF3T1ZTUExNZytLZUZWMytWSm1y?= =?utf-8?B?UlRXZ05XZlBHSUQ2N2pQaXI0eDhCWXgrRlNFY1BwVG5HcXhTc0JsYis4NG5K?= =?utf-8?B?MDdLaHZtQ1hyL3RuZytJUEZ2UnR5TFE4Q0JFcmNjWCtXVWN3SEQwMFFnTTJ2?= =?utf-8?B?dTBIMTRjdHBIcm0xMmVoTCtRR2UvNWpSN3EvZFZ0bENsWkcvN2tndWFHZ2Zs?= =?utf-8?B?Z3NSdTl0c1JNR2JFV21scXpoUUk1OGpCVDIxbitxeHlaL3FQakhYWWNNdGtU?= =?utf-8?B?eWdtdGRPZTVtT0RHUXhrd1g2Y1BpM2ZvNzR1dzdadFNFUitlVUpuUnBkckpt?= =?utf-8?B?UjN2ZTdqNi9CU01mMUFhcTV6eGhwcFVqVlNLMVZFVzRWMGU3MFBUdExPeGg3?= =?utf-8?B?dC9Ed1R4MFlEWG1WK1pWKy9XSXNzcGZaVHBjSXR6M3o4RldHNDZ0eXUvcElR?= =?utf-8?B?UTd5amY4Q3N6Sy94U243ZDBrUFlyZGE1aTVUTU84UEdJb3V6em44eUEvdkZL?= =?utf-8?B?NDkxNUdCY2lMWTRwZE5ybzUvTVVRZFEzVGN3VHorYnp1aGFXMk9jRmFDanNR?= =?utf-8?B?Qm1RcnhSSlAwNVAzV2hSYVR1SXU5R1ZUcUl4U1FncVgrV1lEUlBWZUdJTFZm?= =?utf-8?B?THl1NmJTbG1LUlM0czVEOWtTNFkySzJkSUhtQllGNXUwS05nVnpuU2s1VXBI?= =?utf-8?B?dllzbUhNMUpkZkF3dGEzYTVxeWdBOUJzMnc2TTdlbDRocmw0Y2JKcWJtb29y?= =?utf-8?B?a2pFdkFnWk1ZdXBqOVFNdjdXb1k2ODhzWjl2RWdsVW4vN3hGaDJQK0JhVzZq?= =?utf-8?B?TG9wMjJBQ25uVXdiT1FwRzM5TjdWZ2Rnem0yQnluVnJaZ0JJdHBJU205VU9G?= =?utf-8?B?TjFWRm03N3RzL1VlbDF5Um1lUXp6V293WUhRTHRVL0F3UXVpZk04QVFiQ1Zq?= =?utf-8?B?bWM1MVJOM0JsbG5YRUQ0K0VacWEyREdieDFNVG9qQjhYSnBxVFlpWWN6OTNB?= =?utf-8?B?N001bm9WV05jRW93dHNvN01tTzIvQVI2bjBYa3c5RXI5NjhtRzhCRm80WVdV?= =?utf-8?B?ajVJTGp2VXE2SWFPVFZFMUx2amRTcGkxQWw4S2pqc1pYeFRWTHZSWG9vc2ND?= =?utf-8?Q?JtxiQPcbjiRPVSWDHU+YhaGZIt1LbK3sohJQlLE?= X-MS-Exchange-CrossTenant-Network-Message-Id: 3f42a915-1127-49d2-4cac-08d9721338cb X-MS-Exchange-CrossTenant-AuthSource: PH0PR11MB5093.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Sep 2021 15:21:53.3623 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 7lvC1xJy+mz+FNHx1rdU8wozRZl1VXk9DFQhD6FixuI8bgpmGb1MB9GyFQJiZHjNMhvCRWxMlY7PV+vpa0zmQE7Jp8TQEbMlqIkbbQpGisM= X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB4887 X-OriginatorOrg: intel.com Subject: Re: [dpdk-dev] [PATCH] doc: announce change in vfio dma mapping X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 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" On 06-Sep-21 2:43 PM, Ferruh Yigit wrote: > On 9/6/2021 9:51 AM, Ding, Xuan wrote: >> Hi, >> >>> -----Original Message----- >>> From: Kinsella, Ray >>> Sent: Friday, September 3, 2021 12:13 AM >>> To: Yigit, Ferruh ; Burakov, Anatoly >>> ; Ding, Xuan ; >>> dev@dpdk.org >>> Cc: maxime.coquelin@redhat.com; Xia, Chenbo ; Hu, >>> Jiayu ; Richardson, Bruce ; >>> Thomas Monjalon >>> Subject: Re: [PATCH] doc: announce change in vfio dma mapping >>> >>> >>> >>> On 02/09/2021 10:50, Ferruh Yigit wrote: >>>> On 9/1/2021 2:25 PM, Burakov, Anatoly wrote: >>>>> On 01-Sep-21 12:42 PM, Ferruh Yigit wrote: >>>>>> On 9/1/2021 12:01 PM, Burakov, Anatoly wrote: >>>>>>> On 01-Sep-21 10:56 AM, Ferruh Yigit wrote: >>>>>>>> On 9/1/2021 2:41 AM, Ding, Xuan wrote: >>>>>>>>> Hi Ferruh, >>>>>>>>> >>>>>>>>>> -----Original Message----- >>>>>>>>>> From: Yigit, Ferruh >>>>>>>>>> Sent: Wednesday, September 1, 2021 12:01 AM >>>>>>>>>> To: Ding, Xuan ; dev@dpdk.org; Burakov, >>> Anatoly >>>>>>>>>> >>>>>>>>>> Cc: maxime.coquelin@redhat.com; Xia, Chenbo >>> ; Hu, >>>>>>>>>> Jiayu ; Richardson, Bruce >>> >>>>>>>>>> Subject: Re: [PATCH] doc: announce change in vfio dma mapping >>>>>>>>>> >>>>>>>>>> On 8/31/2021 2:10 PM, Xuan Ding wrote: >>>>>>>>>>> Currently, the VFIO subsystem will compact adjacent DMA regions for >>> the >>>>>>>>>>> purposes of saving space in the internal list of mappings. This has a >>>>>>>>>>> side effect of compacting two separate mappings that just happen to >>> be >>>>>>>>>>> adjacent in memory. Since VFIO implementation on IA platforms also >>> does >>>>>>>>>>> not allow partial unmapping of memory mapped for DMA, the current >>>>>>>>>> DPDK >>>>>>>>>>> VFIO implementation will prevent unmapping of accidentally adjacent >>>>>>>>>>> maps even though it could have been unmapped [1]. >>>>>>>>>>> >>>>>>>>>>> The proper fix for this issue is to change the VFIO DMA mapping API to >>>>>>>>>>> also include page size, and always map memory page-by-page. >>>>>>>>>>> >>>>>>>>>>> [1] https://mails.dpdk.org/archives/dev/2021-July/213493.html >>>>>>>>>>> >>>>>>>>>>> Signed-off-by: Xuan Ding >>>>>>>>>>> --- >>>>>>>>>>>    doc/guides/rel_notes/deprecation.rst | 3 +++ >>>>>>>>>>>    1 file changed, 3 insertions(+) >>>>>>>>>>> >>>>>>>>>>> diff --git a/doc/guides/rel_notes/deprecation.rst >>>>>>>>>> b/doc/guides/rel_notes/deprecation.rst >>>>>>>>>>> index 76a4abfd6b..1234420caf 100644 >>>>>>>>>>> --- a/doc/guides/rel_notes/deprecation.rst >>>>>>>>>>> +++ b/doc/guides/rel_notes/deprecation.rst >>>>>>>>>>> @@ -287,3 +287,6 @@ Deprecation Notices >>>>>>>>>>>      reserved bytes to 2 (from 3), and use 1 byte to indicate warnings >>> and >>>>>>>>>> other >>>>>>>>>>>      information from the crypto/security operation. This field will be >>>>>>>>>>> used to >>>>>>>>>>>      communicate events such as soft expiry with IPsec in lookaside >>> mode. >>>>>>>>>>> + >>>>>>>>>>> +* vfio: the functions `rte_vfio_container_dma_map` will be amended >>> to >>>>>>>>>>> +  include page size. This change is targeted for DPDK 22.02. >>>>>>>>>>> >>>>>>>>>> >>>>>>>>>> Is this means adding a new parameter to API? >>>>>>>>>> If so this is an ABI/API break and we can't do this change in the 22.02. >>>>>>>>> >>>>>>>>> Our original plan is add a new parameter in order not to use a new >>> function >>>>>>>>> name, so you mean, any changes to the API can only be done in the LTS >>> version? >>>>>>>>> If so, we can only add a new API and retire the old one in 22.11. >>>>>>>>> >>>>>>>> >>>>>>>> We can add a new API anytime. Adding new parameter to an existing API >>> can be >>>>>>>> done on the ABI break release. >>>>>>> >>>>>>> So, 22.11 then? >>>>>>> >>>>>> >>>>>> Yes. >>>>>> >>>>>>>> >>>>>>>> You can add the new API in this release, and start using it. >>>>>>>> And mark the old API as deprecated in this release. This lets existing >>> binaries >>>>>>>> to keep using it, but app needs to switch to new API for compilation. >>>>>>>> Old API can be removed on 22.11, and you will need a deprecation notice >>> before >>>>>>>> 22.11 for it. >>>>>>>> >>>>>>>> Is above plan works for you? >>>>>>>> >>>>>>> >>>>>>> We have slightly rethought our approach, and the functionality that Xuan >>>>>>> requires does not rely on this API. They can, for all intents and purposes, be >>>>>>> considered unrelated issues. >>>>>>> >>>>>>> I still think it's a good idea to update the API that way, so I would like to do >>>>>>> that, and if we have to wait until 22.11 to fix it, I'm OK with that. Since >>>>>>> there no longer is any urgency here, it's acceptable to wait for the next LTS >>> to >>>>>>> break it. >>>>>>> >>>>>> >>>>>> Got it. >>>>>> >>>>>> As far as I understand, main motivation in techboard decision was to >>> prevent the >>>>>> ABI break as much as possible (main reason of decision wasn't deprecation >>> notice >>>>>> being late). But if the correct thing to do is to rename the API (and break the >>>>>> ABI), I don't see the benefit to wait one more year, it is just delaying the >>>>>> impact and adding overhead to us. >>>>>> I am for being pragmatic and doing the change in this release if API rename >>> is >>>>>> better option, perhaps we can visit the issue again in techboard. >>>>>> >>>>>> Can you please describe why renaming API is better option, comparing to >>> adding >>>>>> new API with new parameter? >>>>> >>>>> I take it you meant "why renaming API *isn't* a better option". >>>>> >>>>> The problem we're solving is that the API in question does not know about >>> page >>>>> sizes and thus can't map segments page-by-page. I mean I /guess/ we could >>> have >>>>> two API's (one paged, one not paged), but then we get into all kinds of hairy >>>>> things about the API leaking the details of underlying platform. >>>>> >>>>> Bottom line: i like current API function name. It's concise, it's descriptive. >>>>> It's only missing a parameter, which i would like to add. A rename has been >>>>> suggested (deprecate old API, add new API with a different name, and with >>> added >>>>> parameter), but honestly, I don't see why we have to do that because this is >>>>> predicated upon the assumption that we *can't* break ABI at all, under any >>>>> circumstances. >>>>> >>>>> Can you please explain to me what is wrong with keeping a versioned symbol? >>>>> Like, keep the old function around to keep ABI compatibility, but break the >>> API >>>>> compatibility for those who target 22.02 or later? That's what symbol >>> versioning >>>>> is *for*, is it not? >>>>> >>>> >>>> Nothing wrong with symbol versioning, indeed that is preferred way if it works >>>> for you, I didn't get that symbol versioning is planned. >>>> >>>> @Ray, >>>> Since symbol versioning is planned, ABI won't break, but API will change, can >>>> this change be done in this release without deprecation notice? >>> >>> Yes - I would think so. >>> Since we are going to the effort of using symbol versioning nothing is being >>> depreciated as such (yet). >>> >>>> Later we can have a deprecation notice to remove old symbol on 22.11. >> >> Thanks for your explanation. >> @Yigit, Ferruh Does it mean that we can do API change in 21.11? If so, we will >> follow the process and target API change in this release. :) >> > > With symbol versioning, yes you can make the change in this release. > > You can send another deprecation notice to remove the old symbol for 22.11, that > can be sent anytime until 22.08 released. > Hi Ferruh and others, We have decided to switch gears somewhat :) The original intent was to ensure that two adjacent segments can be freely mapped and unmapped. The easiest solution was page-by-page mapping, so that's where the API change idea came from. However, due to tech board decision to not grant the exception at the time, we have figured out a way to avoid the API change. The API change is still a good idea because mapping things page-by-page is a valid use case that is currently not covered by the API, so the next plan was to do the API change in a later release as a separate issue, not related to original Xuan's intent. However, we've been discussing implementation details with Xuan, and we arrived at a realization that what Xuan wants to implement not only does not *require* page size, it *cannot* be implemented with page size API because there's no way to know page size for that memory at the time of the API call. So, turns out we need both paged and page-less versions :) This means that there are no deprecation notices now, because we will be adding a new API after all, but we will *not* deprecate or remove the old API - that one will still stay valid. Apologies for constantly shifting ground, but in the end i think we arrived at the best possible solution for this problem! -- Thanks, Anatoly