From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from BN1PR04CU002.outbound.protection.outlook.com (mail-eastus2azon11010011.outbound.protection.outlook.com [52.101.56.11]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C87CC19AD5C; Sat, 18 Jul 2026 02:32:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=52.101.56.11 ARC-Seal:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784341945; cv=fail; b=ceiYWyjDHFvmXn8CIEKakbhuWaWaI8zcS6ptxONyzCChUQiegpEgDIdZe+3Q2CIssYCMpjCbt7DRTGjp6grwtYT27v102POE+c5bFjNhCOOZtvjx0bLk5v6wfnMkIldCaed4hJxFOjYNYqCi7h6QKNANX6ESK1NfHDtGHPzxg60= ARC-Message-Signature:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784341945; c=relaxed/simple; bh=DwVJ38TS/mx/HdzshHzoSTI9800SOL6uOVBE1nIiW5A=; h=Content-Type:Date:Message-Id:Subject:Cc:To:From:References: In-Reply-To:MIME-Version; b=LsTsCAUDp2a5bVLXMAIJqNkLc/NBkkkqcgNrmG7S96Y6h9IiZE8qa+GXlMwJ6xIqpEqZPe/ZGRSWTrXc240bvhcWEGoKf96ynzjv8gPIN49CbrS0uXu++i6JTFSgLZNxd7dt27DQo8UnrzpkXauFt6feAmsqfvpGqs5z/bg48CM= ARC-Authentication-Results:i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com; spf=fail smtp.mailfrom=nvidia.com; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b=IQufl9Ov; arc=fail smtp.client-ip=52.101.56.11 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com Authentication-Results: smtp.subspace.kernel.org; spf=fail smtp.mailfrom=nvidia.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b="IQufl9Ov" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=TjVWymu4D6Y/rAb8jww/iXdqhmWJ9k83EY9bVFf8a4sZv5nwYy8owEr24NfwVKZ6ZDxrjJxlsQoKtfc7i9XkQo6Q/t4EqQLYoAiLqClKaGTqf7mpBS8FDroQYxt75sWm5p5K+qyVdcNhFgn1lj5snekmfQRTM72j0ok/3FR92/LenhZnvCIOSOFeE9iVzrbjm4c+Up2kOL6S3KTFv9P1vw23h+qEjla+4Xowjk+6yx4GcY5CKGS7vzXpSIundkiH5PLh6OwI6mwsseMXyeDJ2foLEs72FtwcBiFoXffiiJeGiQaOXC4nEdoY8vqjB7RkG5T/lyjzv8VRHq5ntp54rA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=7u32SvWnmg92sF70UYVL465Y9YPZVIlMLC9Fiw7ziqY=; b=guLVwHOQD1N5iePDaVp5Z6JDPd7DHBaHhNxnp64I5maykwxHMLYRYjrJmicKIPG/OBPQZhws8IqogbosAvzKOs7vVO3Wy4CflVWfdJEsSQ+i2bTXQmAYjJ5/CXT66GBxPXvwt6yX1yEpwWDny3ehh2IVhAX7Jrc1XJUQQWtXWHTTGCJ3+IW8XmENsrQ0TYwTzWNsB7SLOwUwwYDjsqnprmAdX3O/lEuqqeVSaVC7FBjfxJTcctSvFt9TSZvCm5qCBeFmj8n0nSqxqUt32AHzaWG9qpxTuZTtrOb7Jp1RcuJcecvPbBQQLGh9ofd/egXgfJOFDK7cjceoHK07TBGccw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=7u32SvWnmg92sF70UYVL465Y9YPZVIlMLC9Fiw7ziqY=; b=IQufl9OvFgI9IC6H26JU0Fu9nlJKXBEfO4dWMjpLo1Hem6j1CAJPvCO5CTAEB7Y3/KflcvmtJPoODe/Cp0wYxNYKV/phXUqfPqW7IyeXU9Bav2bKUpL3IQ6bWO3iZ1c7qWpXdUhA0mSIuGs8Bs2k0fLGbom3PvgORcrfrpTRB3MqBt3pBpeEjowOohKjR0cgfyHC0tE8j+jw4bDoGKACTfaFa1wAu18D9k6P7TIOJ+AhG044LOslOapxbDZ6fljJzDsY280EO4XXrn43Orur+RLnXEM+KtySozwZslU7wQCA7WQQQ3ze2sx4B97Ub9nggGBpQjJM1uHHngEE3P5Xkg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nvidia.com; Received: from IA0PR12MB8374.namprd12.prod.outlook.com (2603:10b6:208:40e::7) by LV9PR12MB9782.namprd12.prod.outlook.com (2603:10b6:408:2f2::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.223.13; Sat, 18 Jul 2026 02:32:15 +0000 Received: from IA0PR12MB8374.namprd12.prod.outlook.com ([fe80::d85f:4c87:ae84:3f16]) by IA0PR12MB8374.namprd12.prod.outlook.com ([fe80::d85f:4c87:ae84:3f16%5]) with mapi id 15.21.0223.012; Sat, 18 Jul 2026 02:32:15 +0000 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=UTF-8 Date: Fri, 17 Jul 2026 22:32:04 -0400 Message-Id: Subject: Re: [PATCH v2 02/33] mm: add kdoc comments for vma_start/last_pgoff() Cc: , , , , , , , , , , , , , , , , , , "Russell King" To: "Lorenzo Stoakes" , "Andrew Morton" , "David Hildenbrand" , "Liam R. Howlett" , "Vlastimil Babka" , "Mike Rapoport" , "Suren Baghdasaryan" , "Michal Hocko" , "Rik van Riel" , "Harry Yoo" , "Jann Horn" , "Lance Yang" , "Pedro Falcato" , "Russell King" , "Dinh Nguyen" , "Simon Schuster" , "James E.J. Bottomley" , "Helge Deller" , "Alexander Viro" , "Christian Brauner" , "Jan Kara" , "Dan Williams" , "Matthew Wilcox" , "Muchun Song" , "Oscar Salvador" , "Masami Hiramatsu" , "Oleg Nesterov" , "Peter Zijlstra" , "Ingo Molnar" , "Arnaldo Carvalho de Melo" , "Namhyung Kim" , "Mark Rutland" , "Alexander Shishkin" , "Jiri Olsa" , "Ian Rogers" , "Adrian Hunter" , "James Clark" , "Baolin Wang" , "Nico Pache" , "Ryan Roberts" , "Dev Jain" , "Barry Song" , "Miaohe Lin" , "Naoya Horiguchi" , "Xu Xin" , "Chengming Zhou" , "SJ Park" , "Matthew Brost" , "Joshua Hahn" , "Rakie Kim" , "Byungchul Park" , "Gregory Price" , "Ying Huang" , "Alistair Popple" , "Hugh Dickins" , "Peter Xu" , "Kees Cook" , "Marek Szyprowski" , "Robin Murphy" , "Andrey Konovalov" , "Alexander Potapenko" , "Dmitry Vyukov" , "Steven Rostedt" , "Mathieu Desnoyers" , "Jarkko Sakkinen" , "Dave Hansen" , "Thomas Gleixner" , "Borislav Petkov" , , "H. Peter Anvin" , "Ian Abbott" , "H Hartley Sweeten" , "Lucas Stach" , "Christian Gmeiner" , "David Airlie" , "Simona Vetter" , "Patrik Jakobsson" , "Maarten Lankhorst" , "Maxime Ripard" , "Thomas Zimmermann" , "Rob Clark" , "Dmitry Baryshkov" , "Abhinav Kumar" , "Jessica Zhang" , "Sean Paul" , "Marijn Suijten" , "Tomi Valkeinen" , "Thierry Reding" , "Mikko Perttunen" , "Jonathan Hunter" , "Christian Koenig" , "Huang Rui" , "Matthew Auld" , "Jason Gunthorpe" , "Yishai Hadas" , "Shameer Kolothum" , "Kevin Tian" , "Ankit Agrawal" , "Alex Williamson" , "Paolo Bonzini" , "Shakeel Butt" , "Usama Arif" From: "Zi Yan" X-Mailer: aerc 0.21.0 References: <20260710-b4-pre-scalable-cow-v2-0-2a5aa403d977@kernel.org> <20260710-b4-pre-scalable-cow-v2-2-2a5aa403d977@kernel.org> In-Reply-To: <20260710-b4-pre-scalable-cow-v2-2-2a5aa403d977@kernel.org> X-ClientProxiedBy: DS1P222CA0013.NAMP222.PROD.OUTLOOK.COM (2603:10b6:8:454::16) To IA0PR12MB8374.namprd12.prod.outlook.com (2603:10b6:208:40e::7) Precedence: bulk X-Mailing-List: damon@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: IA0PR12MB8374:EE_|LV9PR12MB9782:EE_ X-MS-Office365-Filtering-Correlation-Id: 909b2983-f2a5-441f-405e-08dee474c7f1 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|23010399003|376014|7416014|1800799024|22082099003|18002099003|10067099003|11063799006|56012099006|4143699003|921020|6133799003; X-Microsoft-Antispam-Message-Info: L6bPRPnjZKCz43AQU9EsaE3en8GriayD23Lj+m0z/1bmu/6upgx13pCy4P6qvzaW2YLRnTJJNpY3TWo55EHktW758d1AkLcZ5qYarj/+EtqCbREyFEsDRmj2fGaY472dtJAf3Z6pNUb2zJQ31qw5XFOtC+FoP14ATlVsQHUNgMaVVTC5uKivlnpo0Mi2CZg8OXAruTZoA+umozylN9BG+dc0CNRJPH+i+t6kD5q18IGahoDY0NKh0yYHcLd2IC11Frgth1fFBeiUVeSUqJxYPo6dtLILb3a58xcXa7H3MYpHB5QwzHYZCCTbvI7OMBR31NdIabNCZk+QcpKRhPEFIaWCw3OQ6JgeZgT9HrDjiolvBoSoGmkxkLE2fkL4KIlpY97COmcpWP0UuV7nkAUKZL7+cLVts7RyN+SwTWWEJOuGyfLT9RjYvncLo8SMDMarPIlFaui8kacmndL53S/JoGXdj+yK6uSQS/IWcpEuSD8PytNSZoeakRFmR1OG9/lDqRaSBh1zxlJD55NkqNhgk3QvWbl2iRuhdfFX66vEbVyKueHTAE7nonKJXLRL5AaKt/gxl5HNJ4z6OoQWNGwKoOwAOur0sfA8Po1pLXtV0JUZTT/dOM18ylZUzzEO05Q01yp79jU/jGSbfz9fpym7Q59aKSFS3aWO6VTHJnGtZHFddCsYNQ/1V9TYiGWMFUZCOqGIka07tZi3zFxl4yG3EA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:IA0PR12MB8374.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(23010399003)(376014)(7416014)(1800799024)(22082099003)(18002099003)(10067099003)(11063799006)(56012099006)(4143699003)(921020)(6133799003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?bmpQejY5UHJGeUdBOHBxYStOZHRqQVBXUlVmZ05EMUJ4SWFVTHRBVUhybmU4?= =?utf-8?B?MlkvemJiTGMvQnJGVVUzTEc5TStCRzR0bFVtSWY2ZDhvOTNSUGVEVHVHaTAz?= =?utf-8?B?a1ZGL1ZXL0owWWYvQ3VBdm1MR1plNFVCd1c5YWpiWmJ1UjJVdzZ0TzFTV3pJ?= =?utf-8?B?dXdtNTNMNVdJTm5Sc2V5NkM4aklRTEE2NkM5R3NzbW9DMzBaMng4WXZ0ajlL?= =?utf-8?B?ZHd6eXgzdzBYRU5CQlpkRXJxQ3BYbjMzeWhuS2FDUGFSNnBEQ08wMkdFM2dE?= =?utf-8?B?RkY3c3N1d2k5NXVYYVBnR2hXcWVuSXNpRXJVSGVLY214Y3RZVHBEUkJNckVN?= =?utf-8?B?MnV4ZnN0QUZmaEVnUWtZYjVyMzV4ak1vakpwbmUzeE1WZFA0dVBCNVBWV2pS?= =?utf-8?B?eWV6dXZ5MTRPd2U0S3RNR0dMSmxDa1hwR3BIMTV2MTJ1b0VlTWxQZ0ZDVUtm?= =?utf-8?B?RjhZK0tybG03KzVBY3IvRzR1M2ZROTg3dHFLaTZjc0tiMEZVSHdJSXBIRzVJ?= =?utf-8?B?RnFES2hMamgxZjNGaFZqLytidUkwYlNCbEFmOHRXMEdmckJTZkdPYmxyQ3c5?= =?utf-8?B?ck1MOStqNXl0V1QrZjc5d2lzaFFhZG1xVXg3MnJjUWxSUUJ4L0xUcDQ2WHhr?= =?utf-8?B?eHZkU1cvL3JPL0cvMS9WYitzSVdOZVJRZ3BmSU4wMHRpTXNReThrSzlrU2pk?= =?utf-8?B?NjZyYy9HSEZiZUt6SzdiQ0xmWXgwSkQyaTd0VXlWR2UzaGttMHRFckV2Uzh3?= =?utf-8?B?N0t1MlBsYW95WVhZekJNeHpIeGI4VnZDc3MxdU82bDRLTnlrUU5iWWFsWU5j?= =?utf-8?B?ZW9tMk9PMU5CWlFzVUxGeU41MDFDVGhFU2FsTmxFUCtoZUhEbVRTcUx2R0tH?= =?utf-8?B?andOVXJpVjZ6ZGdMUHNjVnVDZTJwaTNPYmdzakpRWEtkeDRXYmVDSlM2Rm82?= =?utf-8?B?eG15T3IvMXZKSmtQd3hsK3BReU1sYmp5U0s1M1YvbCtuN2o3VVgrS2poZHNo?= =?utf-8?B?NFZWanBZejdRTFlMK201M2podnR2czhnRzdXaEtHOTdzNVdWUXluUDVBQTlx?= =?utf-8?B?TloxK1hxZUhtVVBlRVU5eTkrdE52SmZHczg1SVpzRHR5S1A3SHVPaWNUUU9u?= =?utf-8?B?RkY1K1NYc2xmSHRPSzNCTGJWLzRvbUdIUFFzemRKQ1RacTdrR0NuRE4yc1VS?= =?utf-8?B?OEtSRXhubFJUY3RlUDhFcTkrZDRqSW81ay84SGpuNXRjRklnNWJ0TXNLR1kx?= =?utf-8?B?WmUyN1RYOFZUdmNIcWFuQWc3TFJGcWhMSXljZXZvN2QvQWVqWmE3bmNSMWx5?= =?utf-8?B?L2E0cXdSMjlRbENnOGVtQjRic3FYSXpsMHpoV25EUHhoZE1vWE1mZDNjZmk4?= =?utf-8?B?SW1rWUJZRnVWbzNNaWF0TDdNUGFvVFpiWmRCRlB6QTd4Q05yaXJ5ME1KQzFp?= =?utf-8?B?c2ZTWUFKV0hIeEl5ZmFSL3ZrTlVJVzRzcjVUS1E4aGM3Um50cXV5OTQzWnBo?= =?utf-8?B?V0wySmQ0YnJsZzM4TmZvb01OaHlobHUvWWFqUjZvbDJnNGs2eHpPcEszakVj?= =?utf-8?B?M3o4bytWdGs3WDNob3RWU01mZDVMenFzS2R0eUJ2N3JERWZaVGxIVmtaQTF3?= =?utf-8?B?eDBBVEZyandnNnYrTGNNcEc1dkozN2prcloyV0MzNDRBS0pDRFdZTWUvS0VY?= =?utf-8?B?cnhIR1FxK1FpN2R3aWYvcG9CN0NZSG1YellPdU94eXhQYmxOcVM5bkdienJn?= =?utf-8?B?Qll3TkFaNU4zZ3l3NmpFbi95amZuSy84aGJkNXpBSERIYmVWRDYrSDdRM0I4?= =?utf-8?B?UEFoOGxLWDIwWDFnZG9meUhsS2t6Skw3TkNiWWloNGNCdUVBZml4YUM5UEY3?= =?utf-8?B?NlNtNHRxVTYwVVNuRTl1THNiY1J4Rk8vOC9DMUxxYkg4SkcwKzBzOWs5Q3F4?= =?utf-8?B?eVRpdVJtTXVnWGxlOWRqK3JjSnhqc3g2Z3dJbGhwVEV3VXlPUGhZMXovaXpu?= =?utf-8?B?dlhQWlNxamkwb1A3dGtheTd5SitLbXdjY2VoY21JdzlYcngrZmZueVNRRG9U?= =?utf-8?B?d25VWWN2cnJ5eWFjS1NNRDUzRWhIbmlMbDZrc0VSWVpMZ0d1ek5lcEYrS3Fr?= =?utf-8?B?VHNHWnpoeGpVYTM4bHFpYm5WMzhTQytBaGpCS3BxNzRKR1dKVjcvbExLaWNo?= =?utf-8?B?SUpxaXRIS2dFeDMzZzVWTjZmcGlJUDUvTklpVUhWQkU4ZVNkd1RTNHR0UEZ6?= =?utf-8?B?ZkZGdGRwU2tUR2ZLSk9qb0Z6NGxrMnljaFNEU1B4MEp4dE80aTFCNU1HMGor?= =?utf-8?Q?wT7z1YIbJMYGupDv13?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 909b2983-f2a5-441f-405e-08dee474c7f1 X-MS-Exchange-CrossTenant-AuthSource: IA0PR12MB8374.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Jul 2026 02:32:15.6243 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: +Bj9F6SnTKb81dS6lC4gA3Byl5p0cfXLqtSnYCk3MX6G+LW93TdW+KC2Egp3PvQx X-MS-Exchange-Transport-CrossTenantHeadersStamped: LV9PR12MB9782 On Fri Jul 10, 2026 at 4:16 PM EDT, Lorenzo Stoakes wrote: > Describe what vma_start_pgoff() and vma_last_pgoff() actually provide in > detail. > > This is in order that we can differentiate this between functions that wi= ll > be added in a subsequent patch which provide a different page offset. > > We go to lengths to describe the edge cases that can be run into here. > > No functional change intended. > > Reviewed-by: Pedro Falcato > Reviewed-by: Gregory Price > Reviewed-by: Vlastimil Babka (SUSE) > Signed-off-by: Lorenzo Stoakes > --- > include/linux/mm.h | 30 ++++++++++++++++++++++++++++++ > 1 file changed, 30 insertions(+) > Thanks for the explanation. Reviewed-by: Zi Yan --=20 Best Regards, Yan, Zi