From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id E3A75C5B552 for ; Tue, 3 Jun 2025 10:56:59 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5C99F6B040C; Tue, 3 Jun 2025 06:56:59 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 48F086B040E; Tue, 3 Jun 2025 06:56:59 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2E1E76B040F; Tue, 3 Jun 2025 06:56:59 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 012A26B040C for ; Tue, 3 Jun 2025 06:56:58 -0400 (EDT) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 868CE1A04FB for ; Tue, 3 Jun 2025 10:56:58 +0000 (UTC) X-FDA: 83513786916.18.1F69AC7 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by imf08.hostedemail.com (Postfix) with ESMTP id 2DFD516000A for ; Tue, 3 Jun 2025 10:56:54 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b="iaEDL/sk"; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b="bqrz//Oo"; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf08.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com; dmarc=pass (policy=reject) header.from=oracle.com ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1748948215; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=U4j2smpAHwrXK/Hx46o7m2gSshrZg0cj1L7W43hKcgg=; b=wylhxXMQ0Egb3eELg+Q8i7nBiP31CiaD5eti7Fke7gkgCCrTu7iK5AWH3C8FB9/OwtAuHU OOuLRD5GS4nG62h1LJt/Wh73ahPsW7NjndW+Zv8pAIh4lL1SrwJWc/lKWFaUb7fc8DM8p0 v/1BBky9pv/1SwlTzvKHb0pBHgXX56I= ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1748948215; a=rsa-sha256; cv=pass; b=1FWBRT+ZnsBPJ5D88qZ5HpgWPj8PiKMB4GlEiOhY6y6GI+AIpcVVLxCGZrXBXmzew0QmQT Q4ePyMGCzbjv17b+pY4kpBc97RARbvfSkyGz/mQfFtJRgwNzY+gUHvRIvB55roCUOxu2cb FQ45pUZX+Nl9frCaQ53agxGS8Izg4ac= ARC-Authentication-Results: i=2; imf08.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b="iaEDL/sk"; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b="bqrz//Oo"; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf08.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com; dmarc=pass (policy=reject) header.from=oracle.com Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 553AEqQT028239; Tue, 3 Jun 2025 10:56:43 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc :content-type:date:from:in-reply-to:message-id:mime-version :references:subject:to; s=corp-2025-04-25; bh=U4j2smpAHwrXK/Hx46 o7m2gSshrZg0cj1L7W43hKcgg=; b=iaEDL/skfRl5t8TQNkN2+1TpHMF57D6k7R XN+KMHgEI4TsDq+GnVEdK1KmAK8U23OaeBSfPDVTlcAxFbPruXPlzuhy99yDKuJs d1wHNk8wYy8Fvv1hGtMui+QdKM3ynxfzTa9TpJ/A3YuzB7atAjfL/CtsxFMVVntQ IfFYKD5PIgEbTqkBxPDV+F/FIu6JiQSMBPUYsrStVDkQEshOJvcR1E51C6SgQpbR bcP8VUUzOu3MXJjD4ngOF2i/ljdZxg20zqQWOiTxSrLUqdgenNWtMtDka0DhtMdf YKZr3Hd8D9LWIoBkeSDrcVWo+QmiZ3mIP5xyf781xqFNXQd6qW4A== Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 471g8j1n1a-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 03 Jun 2025 10:56:43 +0000 (GMT) Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 553A66g1040645; Tue, 3 Jun 2025 10:56:42 GMT Received: from dm5pr21cu001.outbound.protection.outlook.com (mail-centralusazon11011039.outbound.protection.outlook.com [52.101.62.39]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 46yr79cs10-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 03 Jun 2025 10:56:42 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=fFkT5xR6GKV2c9PaijEEa8vWyTEVO+o3C0yHz5hcObBiW6yjkFihE+pH6GJ8U7UMo2SCOA65IL3VGWyhNPAmGLX3GBxkfaHTTfv4l4ZXjQQVv+myvPHjPK3C065VP7H17+nFUMe2ZMOBsxP5qOT4STyhupVkuKddXCr6lBj8uVoaPuyKeZrSd8drNW25XwxHrLhepDU636/du/CBozM5bJxTdFtKfHxSkNqTDdUh5lBaI4qmF34zpFiOqueV9saIwvH6+mgLLYo5yHXFo90X0KuxAG/s55HVlXNckSseSVVFnGFydcgc8sVuOSEMwDopJRns77fwOlkFCu4YQhX8iw== 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=U4j2smpAHwrXK/Hx46o7m2gSshrZg0cj1L7W43hKcgg=; b=giRkdqHlXbufiwBz0HZRNlHrFRTq5CyuYilakm5ybMg9lHaWpNQIpgDUpyLGTIsoOiTi3P+5l4+XGVbz2ORmSl6XfQlc+U1FUSqAmKqeKSmQDGC8DjYA/sJTuxw4b7EvXRCIo56+jn8HEeCdyMWU1Oxs+purI3JSW3fLIJnpr1GmzY6Biw3Q/+R9ItjR+eIVLP3G1BETg82t2yQ2xDA05HDtcEavXnM6ax5iiBwFbTxmEU0x/L9BiqEtaGZhRZcRIA49Mjaak5dba6FaM1EnDwXVeeAoHX4X9qa7DEtWYtmA85bXu1TXMvuIYYb41V6NaF1oxt94QXKEpDhjHCwe6Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=U4j2smpAHwrXK/Hx46o7m2gSshrZg0cj1L7W43hKcgg=; b=bqrz//OovvfX1vSXOlgwj00YTB7haC0POHWcytay305ZGW6m4794uAIthfGYrA9BlhCdTNhAS+XddEPcu7M5yhEgrSxphFyCs3oFh5Woi7Wwxd/dbo6ls1B5dV1nOxDM/CmyCo6To4wORQrL+xizNepSZvfiNtK8POOPOT6nXUM= Received: from DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) by DM3PR10MB7926.namprd10.prod.outlook.com (2603:10b6:0:3d::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8746.40; Tue, 3 Jun 2025 10:56:40 +0000 Received: from DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2]) by DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2%6]) with mapi id 15.20.8746.041; Tue, 3 Jun 2025 10:56:40 +0000 Date: Tue, 3 Jun 2025 11:56:37 +0100 From: Lorenzo Stoakes To: Jonathan Corbet Cc: Andrew Morton , Suren Baghdasaryan , "Liam R . Howlett" , Vlastimil Babka , Shakeel Butt , Jann Horn , Qi Zheng , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs/mm: expand vma doc to highlight pte freeing, non-vma traversal Message-ID: <9fc9ac50-abce-48bd-979f-2e00b26917b5@lucifer.local> References: <20250602210710.106159-1-lorenzo.stoakes@oracle.com> <87bjr59634.fsf@trenco.lwn.net> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87bjr59634.fsf@trenco.lwn.net> X-ClientProxiedBy: AS4P192CA0035.EURP192.PROD.OUTLOOK.COM (2603:10a6:20b:658::18) To DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM4PR10MB8218:EE_|DM3PR10MB7926:EE_ X-MS-Office365-Filtering-Correlation-Id: 6b5e42f9-7cc3-468f-acea-08dda28d51af X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|366016|1800799024|7416014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?pqfJIz5/voITn0ZZEdgSpPL6vnrBgUBjmFSb3xclMQzZkXhU+BynqVU7BRfk?= =?us-ascii?Q?yQK4ydqrJKgNAkAncpd/ry7GMXTmIKmcndXhf1J40wFFafBzT4lkcuXwInCf?= =?us-ascii?Q?ZzbvpYsDSe0tTLCLNWSOe8FKRsrEJGmfRpcNSDsZAesbKpbjAgsgMUZpTdQq?= =?us-ascii?Q?z5KiSC8H3IxU0kDXW0OMuhL/IXY3qxMJYvOn4blA7FLkGdadAiPozSf3ed3M?= =?us-ascii?Q?3cJxHOoLY1/jfH67KIolDzudeRHRh/kBltazL8RTkDVbwn9pHijiqSJjvlCo?= =?us-ascii?Q?skBZ5FOXE6wV/h1nHwlHM6t6577S+6tMteevQrlV+BDq0rCZAfnGfgvDlgkY?= =?us-ascii?Q?E4gJQjs0+NIKw84LRxHzYhqHR05UXfq9QprEc1J6gob4yOZNdZ6upklnxA2M?= =?us-ascii?Q?9WvjsmKONgvHqKUeFN3iEHZ8XqIbHE2X8HFal8ST12lKH1tDMwS+ibBzyFrC?= =?us-ascii?Q?MOxkXYyvTSg371QA1MD7FHMO/jxmdyZJ/5095j/wAQjD8iSFARv1sWjLqmx8?= =?us-ascii?Q?wdIyLiU6a8XJItbAW6R85w/6RHTPJRGl3wPp/XpX5zMi15gqbkKvYQwxdC++?= =?us-ascii?Q?fbbdn4MZrYWx1V89AihM/RVL+pUFj8N52zvdo/FeJV9YJpLI2Y6G/zOaFGiE?= =?us-ascii?Q?dOTA1GmA8TxAWc0cnGbRrYoWbpV4r+30NLpvlXeDzOnmsW3LbZIPtY+4wbYS?= =?us-ascii?Q?gIllhAVU63hDVivWd1/P9yPYpHj7//uT36tAPrzaJ7IILbyEQaejquvLJVw9?= =?us-ascii?Q?UWoYXhwUJMfC6c0Q7es8Nm+Lm7ZLn4a9b+zo0reC0qp9D086RsRpoGH19plw?= =?us-ascii?Q?HeNnc1uEOvOpUztNU021/09wmQi8doBh+f8GxOmOQEGnaGp357S2F0JOzr5B?= =?us-ascii?Q?4in+R7UdkGBcNRfWYT0xKJ1HQiF6zGYDEocM8QAONynd7Ts+ma0QMlegIy9n?= =?us-ascii?Q?FzNAGVVAPWo9ryYDPOWXY5jfbupu/hAH/Jf4B4HNK5mo0uV9owMTdEDRw6/J?= =?us-ascii?Q?Nhofj/iDxq8hktaO9Lizo16OVcf91BeF4D0oJLSiF/kEANjRIKZW7HOCyf26?= =?us-ascii?Q?+rvD867P1zNVw3HSAFdlNyEM6gwRLufPkpPGzyjVrZWoJzeNzNpvSS7j0pkL?= =?us-ascii?Q?Pxx9fKkpHe9OhJn1wFvp/B5jREsYR79nLm0MTzJ9SBGG80gHsHoiDp7HV6w9?= =?us-ascii?Q?6+dq1wOo4k+aKzntssTjagUSR1PreV7G8hhnqI+7eMy15KoBQLYq0WO/LuMm?= =?us-ascii?Q?8zeK/o5zP/nJdelZSOBPku/cA4Nib/QhJTbF+XKPaGmYtu9TtQ3khbSP+yYX?= =?us-ascii?Q?1bsYxJFZXfYHHEFvbaTfN3kNkbrdqVk9KNXqT5g3vgP6oNk8nUBLwJmnTw4g?= =?us-ascii?Q?U3JjhkpkzO2lWVycv/PxKRBPqP6tgQhkPFB5q79ywAfEQ9Mjy3Bptm2oQp5v?= =?us-ascii?Q?Z78QIXuW7eo=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM4PR10MB8218.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(366016)(1800799024)(7416014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?c/UqP3o75mtXZQmdQp0yJVOqaifN/LD59CN1wtUx5p0nKpeSMMq3Z/btusVN?= =?us-ascii?Q?Yk+LC+cwHOqJQnBE+FqR5XtWVdF5HnfyDbfWJ7WueN/QKi0xsDTrArt6c5iP?= =?us-ascii?Q?p4KW6LFANzLQ+kYpHg6eebR1RHM40DwRFFMGZ7lIWJrzbjFnmFxn4K2Rs64T?= =?us-ascii?Q?B6gR+NK6IfNVeIfCqESgFOHZPQJNxHdwiFOs84xl7o9yvbgdbXSZig17dan5?= =?us-ascii?Q?uY8cv5qZL7JRyjVFNAw5uMQVnES4tzSc6vO8ouxumVB47Sh59/4bQIJPwBfC?= =?us-ascii?Q?1z2I6AbZ2Ql49V1mt+GYTt/RFBTPcKkdjynDebuFpUGz1J1t/znNYF/DeXjQ?= =?us-ascii?Q?YhMb8dpuD9amI+ejF0LDsXNF299KLSUbi4yAc9ZFzyhTNpYnllIXwta9jRPt?= =?us-ascii?Q?eSjYJ4HX19floHcoJGNnySzaGjm9nsYC9vqcwULFnfduKtZrDr8Ox9irlI/k?= =?us-ascii?Q?9oa61yem1lc0Kya+qeiJ43r49XzFEtvByIb526ghmnwNOieOoLN+YPo5XJX1?= =?us-ascii?Q?zMd/CiKRk+z5LHy4eYKdRrZbKu+EY8GJtDFJipfArZrb1cIfWKK24oSY2u9G?= =?us-ascii?Q?dqHsP9FX5/hNFaInW5AE1gvdF4Seby0oiZUGSxFYdZT+HWOBJDT5iPVx0Eau?= =?us-ascii?Q?5CXmGyVmNozV3YMkMUvy6WLYm946vTBBc4xYDBGrLk5dVaFT+AsrwYAn3Ae5?= =?us-ascii?Q?iAau/k4W/RzUBtkEgKI+e/YGnU38nlE7FRgPLCFLBKNWhSSEptspic7bZT9w?= =?us-ascii?Q?mJ0VJYrWfOqeF810x1ZsSBETEyx+897x86p5AF5LoX/7tgdDWN7e/JeD92hm?= =?us-ascii?Q?4yEnD3icWySM60p+t9Co0P1lChkfdAf+Scaw+AQ8unC3HYFKvNQZ0yxQMA50?= =?us-ascii?Q?TdR5VnfPh7NkIZOlCW+OKUAF9l8Fpm4nYDiTk2rgLIP5IgX7D6cktx2Naduh?= =?us-ascii?Q?3vOZwYMAPk/pBpZHYddeiB/igAYQShJeegFA0WP0qn/Y7a+32Lp4JAJnFLex?= =?us-ascii?Q?7GAwMhWOCqRvGiCICh2munwoai1Jz2JW8og/nxsn9SJxt8h62lXBQlrNvupm?= =?us-ascii?Q?ursaaoExlSx6Dq5y/Jrwfk8Ll16Tn3cYLzW0+SEKGvgESVG6eMa8uQRzpTxr?= =?us-ascii?Q?vgwUd1+tlSHOtjqqztRu6U43SxqpuH09q4+d/nCiPTO/VaQH0ekjQWt77S7/?= =?us-ascii?Q?buKsN/245QZThQ70dlru5AJTaQOvFOqzzGCa8wQGAPPZqGgoycZCdbSBQyoA?= =?us-ascii?Q?1PRS8zYXZtBgA3DdM7Xyj5FM8mVr921Vd5G+oUVC5gktAXzwFBkhz52gV2kD?= =?us-ascii?Q?cuwMfjlc3gK3gQoKp9Cynwmfm5v1KJ6WSrTVLtXIxqk+7cUIPPrB+tfbz858?= =?us-ascii?Q?NaeiFllAp9i5/LiwhxAoEKWBBoZpWevuxmf5JNf0c6R3xCq49NjtIE6TyEK9?= =?us-ascii?Q?WJOtm0i/4J4LQCyexJUp1awH2Rt6Veg0IOM6xAr3fe6oOYnXOqdu/I5xaxJF?= =?us-ascii?Q?+4hVMi63ieQQIzWffBy/SfLZi8P+Ex17EH3mTN1XCr+Ok8uoEdtEXXDelV1P?= =?us-ascii?Q?6UlCVrZcSaQo2gPItyFz4rtFAFofUdu46G0a6Hy700BzzJ5IyXXn1j35bZKc?= =?us-ascii?Q?BQ=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: VVSeuyFU/Za9oh+b4NpfWTsQgiPN9PQiobJ0XqvIKTrExQqfXKPtJSA0tVVSxU4tEhbRMJI+WWgz7KtySzv2QUB/qr8Xt7ncPjtgHv6JYgFz/HyGyD1Ps1jehI5NO8/3CJBN5mORQMTFruFW8Qd/LOL23GwzWbDR6TMCZFQznI81ghWeJC9GS3iX6hqeGdL3W8JFG3PCZYGjf0GQJobgJl1116RtfqYVn6/ZilajRWTWaQqJ1u54bTy9DDo0QqpBiJbszbgc7rsygFpvEnHMEVJG82cKSBGJOvjA9UM0CmDxwdWyFVH4PLqOxwYT9E1t1ee8Lz2PecjfUZO6Ktwah712mL7/+Z5587WQ9TXS6brzUNqxvIXPqp3lQGLeuVNikQaYP9KabTHqXA1V1h3DKeeYjIjWtpmjk1TVPJHqnwSqH9y/8qXMR5xB0/y+8HHmTftee6HbOwrXL41BCcm5RzmhFjm2wf4dnb33WVvDutiZwZ6wTWfxoKOvzjR++YyZf7Da32s6L5dpwc+isc+JsoC+KR01HjcapqcTNN6CX1pckjn2xJBAMz/0n8FkaX+kxXP31rzXq+MJ9oJfPTiAL3UGzOoCYgeQuhQXQ8Hi8wk= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6b5e42f9-7cc3-468f-acea-08dda28d51af X-MS-Exchange-CrossTenant-AuthSource: DM4PR10MB8218.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Jun 2025 10:56:40.1992 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 8gbpeOL+0wIMsrir8NOlx0/QgIKXFxiaHxDDi8YvqKOkbz73SUs4iPQZtpA1UTbgxUA/eZhN6bfx5K6/B4TYiBA27GvzGCERyyGIfGlp5qo= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR10MB7926 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40 definitions=2025-06-03_01,2025-06-02_01,2025-03-28_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 adultscore=0 malwarescore=0 phishscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2505160000 definitions=main-2506030095 X-Proofpoint-GUID: 4HNX10PRGzm84_gaaE8Cee1yAI_lO6q4 X-Proofpoint-ORIG-GUID: 4HNX10PRGzm84_gaaE8Cee1yAI_lO6q4 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNjAzMDA5NSBTYWx0ZWRfX7SWfQJK7qFbb n21BY3Dtii+/d7AGtINes+eI/JliQwDy3/qAH/Xx9GUiZEYu2J0amcqYPE6RHSND5p2CStZOh5z VaHHJvqrjGSDy85BZqffoohUQoDQtmKLQrDN3rfiScNfDwMPJg4VOnFrUwY0LhoJmVz9FFDp341 xMXseKWqqyJ3Tn9HpWnoOu90O+sTrDXIDql3iPMJ5y2WzMSAXSf07G9foA4Yaqgyc6yCn6jLchC IeKjnExorjMW0zYBhGIkHDY62T6vg/YgAieN1ZCJn6vZOeL9YnhOOCy1n7QsY5AAYzpnYPkiQL9 4aPB2fqJT9HjCCoDPHjs83KQJMf/qhV9AoGyLzxz/nJylu0gUKg0KXAsxsFtbH16ahd5Km3OllM Rk7UFDYHcc8uqD1UwQ2GMNbsOk/UM8Ywal9lWmPSflg6bGwCntvNZomY0jCTsFVdad7WxeQO X-Authority-Analysis: v=2.4 cv=QI1oRhLL c=1 sm=1 tr=0 ts=683ed4eb b=1 cx=c_pps a=zPCbziy225d3KhSqZt3L1A==:117 a=zPCbziy225d3KhSqZt3L1A==:17 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=wKuvFiaSGQ0qltdbU6+NXLB8nM8=:19 a=Ol13hO9ccFRV9qXi2t6ftBPywas=:19 a=xqWC_Br6kY4A:10 a=kj9zAlcOel0A:10 a=6IFa9wvqVegA:10 a=GoEa3M9JfhUA:10 a=yPCof4ZbAAAA:8 a=X1B4bhp_suYpz5SoF0kA:9 a=CjuIK1q_8ugA:10 cc=ntf awl=host:13206 X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 2DFD516000A X-Stat-Signature: bubgdajohixd8zm6o376t3f3bng7dooe X-Rspam-User: X-HE-Tag: 1748948214-391538 X-HE-Meta: U2FsdGVkX19Blgu3Owc9mYb1oeWNAG8VQGFjuk/lqNM43hEkrTXj/ubdft2qwuLmjXOQkulRSyE5wC4b4Z4M5D604y6X1C+lgf20uwfrxE11FVEZGBIXlkmS+I09lHt7oTcuhfs5V5qrrFurHp1MXSc75uSJB7csy671Frqff+z3J+3V7Fl7/qUOVOLiFB5jsNsDyg7l1JfqIiM3z2hh8IrAkSPNJnfGVzuhTn8DGP4XVc73wK5LwyBZgWUQurBNBBqr4m1MsgHvDCaeltdkQas15vpfsvtmT7SmIAr4ZCfJiiTr0KFlKFY8eXbIvgR0U31r1PNKN7K47fHaoP4c2ZATx4xbDcayZwi2nsT6JBf74cycx/iroKBSEIN9aH4rKDg/1q0vf0/K9VAMw//i9jCxmx3blDwdU5nspl3iu0Rn7yRGempG084AqFSfRpRnIiYR8bTACzydI12bsiMYQhSsrgqS7f5lhiMjohY/TYfPExdJilz3uSr5Xj4kUT4UxWxYp4jE6/9Sf3HjbERoFxqXdhxXUIe27MtjKRjb/U+xr7M4hs4KzlT3XW+MWn5mqGxWhKEaOIRTMnWex9sxo73RDtpdNq/wjIBqNbuy+FMTut2h3GLut3uNQsw9WwOw/qhudX3f6ffhc9z/Xh63yCk6tNVDk5JqrJrKmOhNETFZabiVl+7VB2WRDQQwKWRoJMmhC4tVf9I8GBvZwyA1sEdG4sin0GgulLCtJ2zPl/dlt4LZUb8/W/3oSwFpoFzqFGVd8pL/vulxW/gQS17/QINyOSrhl6JkH1H1/FMJJSofseLaM4OOUZwFbPilsEQHOztbqeXPFjVkKlg+eW6BjPyz/L0tyrgq4u+YudW1xEsM6pnKQtGskzw0qwMwGntCZHnegTmQQPol6xcgmvSRW3kYN9CkznPK2YfY+W7UiWo9zYayCmRURJC+XpGgl+P4Gj3ZBa9Kob1FRQQcjIT IZHsxlqd gWtcGGNQEFErPIdGk5LPshkRYO5PmF9sUW8OYIh6S8RQDXxlpvUfYKemN4BKvVhn6EKXjSLyoELYfaWoGw11j+hPo0CYUbRqHkhs8Lklqy/O6pe6y/5TxHzPu+3gg3LPKcHxzFL4h2VCDJo7ivtDm0WlN/xThi1baM0fTl8yS03VdICIm2jDDiGfBrLGFpsPSWF8aCZmOm90SDgHfW+q4tsl0XwXqJ/IxmYEBXD+oKhOG907dCikMim3aBXzUsMfWS6xgEFsMYX1Ku4vFpgTviYjIDqCOn1qVG+vSr9hmJ3uEI4e2Dbw/vNqluQQnR8R3VJuKsHrY9KJiZpOUSkdQ9H5N9kD0kO3QjyV8vYyzCHvDQlEPgAT9n6lmE1F/EiviwFXlIipkkn+/RJ96x50Bzgi6KRU2XcN/KROBHJVE4XtuCfHRjXYgeJRNglzN9qGahePGrkiy5bf8Mto72olSfBFEO4DkTJHwaWc2cb2yg44pTTaeKhMouWUCA6SV7IyIQ7nHAE80X+TIpBDRJZCnGd9/RGgeey1PM3eEQL1/0UcK9W4iIFrQz+bOmD9+vAAq6osgI2g+292BzieYg4PmF4MZh9Nl0AdxS/wLiQp+663E6dy9FzJPoE62bMgvx+H980MeBE5qCAJ7e0E+gjXIDdzeAnBPEbyPXLmZbddF/K5pINOK08AVvQJ/Lc0/9l6hPAmpetMLg68wREizeA5pKBgEuj4Yt1ItyeENZ3XQaMNA+Sc= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: On Mon, Jun 02, 2025 at 03:38:55PM -0600, Jonathan Corbet wrote: > Lorenzo Stoakes writes: > > > --- a/Documentation/mm/process_addrs.rst > > +++ b/Documentation/mm/process_addrs.rst > > @@ -303,7 +303,9 @@ There are four key operations typically performed on page tables: > > 1. **Traversing** page tables - Simply reading page tables in order to traverse > > them. This only requires that the VMA is kept stable, so a lock which > > establishes this suffices for traversal (there are also lockless variants > > - which eliminate even this requirement, such as :c:func:`!gup_fast`). > > + which eliminate even this requirement, such as :c:func:`!gup_fast`). There is > > + also a special case of page table traversal for non-VMA regions which we > > The "!gup_fast" caught my attention - I was unaware that Sphinx had such > a thing. Its purpose would be to appear to suppress the generation of the > link that turns the cross reference into a cross reference. > > The MM docs are full of these, do we know why? Removing it from the struct vm_area_struct struct immediately give: /home/lorenzo/kerndev/kernels/mm/Documentation/mm/process_addrs.rst:11: WARNING: Unparseable C cross-reference: 'struct vm_area_struct' Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6] struct vm_area_struct And given C's weirdness with typing I really prefer to be explicit in referencing a struct vs. e.g. a typedef. At any rate I'm not sure it's all that useful to cross-reference these? Any such change would need to be a separate patch anyway or otherwise this becomes a 'add additional documentation and drop cross-refs'. > > I would recommend removing them unless there's some reason I don't see > for doing this. Also get rid of the :c:func: noise entirely - just > saying gup_fast() will do the right thing. Re: the c:func: stuff - Well, the right thing is making function + type names clearly discernable, and it just putting in the function name like that absolutely does not do the right thing in that respect. I feel strongly on this, as I've tried it both ways and it's a _really_ big difference in how readable the document is. I spent a lot of time trying to make it as readable as possible (given the complexity) so would really rather not do anything that would hurt that. > > > +.. note:: Since v6.14 and commit 6375e95f381e ("mm: pgtable: reclaim empty > > PTE + page in madvise (MADV_DONTNEED)"), we now also free empty PTE tables > > + on zap. This does not change zapping locking requirements. > > As a general rule, the docs should represent the current state of > affairs; people wanting documentation for older kernels are best advised > to look at those kernels. Or so it seems to me, anyway. So I'm not > sure we need the "since..." stuff. Sure, I will drop this. > > Thanks, > > jon