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 34021D5E376 for ; Sat, 9 Nov 2024 16:02:27 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6BB316B0085; Sat, 9 Nov 2024 11:02:27 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 66A7D6B0089; Sat, 9 Nov 2024 11:02:27 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 50BFF6B008A; Sat, 9 Nov 2024 11:02:27 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 2DB926B0085 for ; Sat, 9 Nov 2024 11:02:27 -0500 (EST) Received: from smtpin23.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id AD6CE1A08C9 for ; Sat, 9 Nov 2024 16:02:26 +0000 (UTC) X-FDA: 82767022758.23.0E845E9 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by imf16.hostedemail.com (Postfix) with ESMTP id 56FA918000A for ; Sat, 9 Nov 2024 16:01:45 +0000 (UTC) Authentication-Results: imf16.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2023-11-20 header.b=gG7jbTJK; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=tx+bg4IT; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf16.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=1731167914; 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=5+cttJLajAntnpMUl5Xod3OPSkip4aFOUctLLLimTkw=; b=g+pHS2Dent+CXOZY38lNmCwNbYhCot73DlLue68uPShvHbXRNzeLsanlHlHPyCfUeev9iC hM7uvhIla0buOExh8qxlKiUbz9Vqoj3yrlW/Hwj6hOO6EpTc8PezkfvFabouVaZXQi/wCq u7gI5dlVXu2v6RzB6OVJB6iFXpKRav8= ARC-Authentication-Results: i=2; imf16.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2023-11-20 header.b=gG7jbTJK; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=tx+bg4IT; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf16.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-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1731167914; a=rsa-sha256; cv=pass; b=vUdzYoNTjHeiXXlrEh9SnjTCyaXcSMf068Z7wwHDVhsfhXInR9Po31nBSayVVwOdSaAzGS CTyBSGmf9DmmT2QSrdBXwXE2RDrqROypR4TG458ZNKHhLaRA/mHquasyLkCNdASey6gnCf F2cce0mNcYn3Is9sH7MCNIELx6b0zvc= Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 4A9CZuQN032551; Sat, 9 Nov 2024 16:01:58 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-2023-11-20; bh=5+cttJLajAntnpMUl5 Xod3OPSkip4aFOUctLLLimTkw=; b=gG7jbTJKY/SRS55CYlmslneUJZtdFVpYXI kUMFKiBd8sOJu5uKKcnEjdoWJGRKmPgjSiu9wIqDrwjbHQrt72kfavq4yuM5l82p gow0taJh2tFLaFD0c5fyGUCidcie3fQUgmmuxJHWtCAJ+YbmGKZ5+ZJh2QmaCcJx JndDgKHkgnfjHYQ2Tki4I4BYcVarw5ioMDG+cGSVzHeb+0VTQmMz+0mUUMqYr8EP 5dw7XF+NCylDPDiUsl9blygKnY/bvs3Bmue+BEqpSNTQZ6OySHFKcbrhMrRIpzbq QzpXPgD5uDTcLntB1q6nqUswOVYYE8mFSAR/W8xLS+ldQtgk7Nig== Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 42t0k58bxb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 09 Nov 2024 16:01:57 +0000 (GMT) Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 4A9F9EfQ034301; Sat, 9 Nov 2024 16:01:57 GMT Received: from nam12-mw2-obe.outbound.protection.outlook.com (mail-mw2nam12lp2049.outbound.protection.outlook.com [104.47.66.49]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 42sx65mppd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 09 Nov 2024 16:01:57 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=D7Wp4wq3Li7iZVryM+bY6oQocvt2jRZlsQJs30qBGsbRVeRnWTB6QB0TqhHC/FY3WF5ZtYPR9GDouzXl2wCnb5rp7xvCJnnI77o+xqi26s3xeMdp26l9tAavpSUgwyJcWD8nOcglUFgZHZbeeCXL6bwg7K5fNYNKIa5aHFsSNp+j5qscgn4kvokMycjIVziM4E0xjOvvQNiRywKuzPflE/0J0aqhVU5zNT33Qspig1V+2SWTrMFHngE2WC8rtcV6ZuHCY33HOQyfKK2MZHYOvXt9BeOJReC1LOhQ1f8BytbvGPkedv4rc26kRjYCRXiryt2qdFTtnEBEVsOJBD1piQ== 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=5+cttJLajAntnpMUl5Xod3OPSkip4aFOUctLLLimTkw=; b=BGUki6SBsPL5+ufjcEKQ6nGCcN8D+rBQZG4D5ec82TM5/FSRWrG5TznF5X5RS6dwS2ZSgm74SSgShAybdMTL8mQjOqiv0Dj9YGs89eZPokFVdBeBItGwzz4zCjx7zuuev+16NyOfc5rHrJpqGCTCEps9igFapj1DSDeS/rj0pnjGdOZvFKDYWNreCVkRLQyp227IFLmHhg5tsn++f8DjGFLlY9KloSFgbx3Oi9bXGZZKtP+Gaky803wo746Cx3Xyue0mat5UlaSM9kLfelVe0laX5QS0dMjJW0K+swmG5h6n9MYbOgf1WQBIs6LbEO9iOEiI1fsbU/fw7FvQG+0Fkw== 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=5+cttJLajAntnpMUl5Xod3OPSkip4aFOUctLLLimTkw=; b=tx+bg4ITqfPylEkNnNO/084CKX3a2h/cNNB4scVgdGZwL2ucD4pnfdJf879D3R0vp4vYoXxE1IUyTmEvMmgzMuIj+nAhVr8BadruCwW+yA5aNu6ioZQoXz3g68+71zQpvcnLZcrXLGsAS9nZ5WWUPOi3d/y8quOnGybwAooDMFU= Received: from BYAPR10MB3366.namprd10.prod.outlook.com (2603:10b6:a03:14f::25) by PH7PR10MB7803.namprd10.prod.outlook.com (2603:10b6:510:30d::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8137.25; Sat, 9 Nov 2024 16:01:53 +0000 Received: from BYAPR10MB3366.namprd10.prod.outlook.com ([fe80::baf2:dff1:d471:1c9]) by BYAPR10MB3366.namprd10.prod.outlook.com ([fe80::baf2:dff1:d471:1c9%7]) with mapi id 15.20.8137.019; Sat, 9 Nov 2024 16:01:53 +0000 Date: Sat, 9 Nov 2024 16:01:46 +0000 From: Lorenzo Stoakes To: Andrew Morton , Jonathan Corbet Cc: "Liam R . Howlett" , Vlastimil Babka , Jann Horn , Alice Ryhl , Boqun Feng , Matthew Wilcox , Mike Rapoport , linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Suren Baghdasaryan , Hillf Danton , Qi Zheng , SeongJae Park , Bagas Sanjaya Subject: Re: [PATCH v2] docs/mm: add VMA locks documentation Message-ID: References: <20241108135708.48567-1-lorenzo.stoakes@oracle.com> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20241108135708.48567-1-lorenzo.stoakes@oracle.com> X-ClientProxiedBy: LO4P123CA0276.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:195::11) To BYAPR10MB3366.namprd10.prod.outlook.com (2603:10b6:a03:14f::25) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BYAPR10MB3366:EE_|PH7PR10MB7803:EE_ X-MS-Office365-Filtering-Correlation-Id: dfbe3729-7356-475a-e7f5-08dd00d7d43a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|1800799024|7416014|366016; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?4tYcx/uRnu1jQ5v96pQIfyqYGA/0EuwNFKE4qLZytLLIbMs0a2y3FINq21IN?= =?us-ascii?Q?jta34MMVYr3nUiNWu6HwScYyizRP18dQYpLzotcaiS/b1XZ0Lpr/tIkmJoh7?= =?us-ascii?Q?5K5fUafKLyJgooRshdiXVy8/xdCaLhMSfuDjNvbLhirE9Wum0+x7tl2QP0Bs?= =?us-ascii?Q?mdEHyRjNcWwVtJp0gkuqxT0TSufSYc4EnFGSW8eyKHiCCXHuM1X9AhwueYt3?= =?us-ascii?Q?XYDe1c+24Kvq5BJaQIdDcAJBSJ/cKyeNT/KXwWV2sUrzikP09nn+lvGgyIm4?= =?us-ascii?Q?wq0oyWxKL0uVZESKpoE+OICy/pK2XQAYJn86Mh67kigU7Vsv+pAYc9N7yIja?= =?us-ascii?Q?Ay55rifzdkwYBwMDcLCOm26dIcgxxHmXYz8ltbznUHX5fQ+SVCVihwwwsKtQ?= =?us-ascii?Q?tXUv7MAaXeZ9nFCWcFQXTKmkNOp9JXz+IhAt0i0DxM8dfWvf/HCjTbW0neQj?= =?us-ascii?Q?RGfk+MbCdtGO+YFLd83RSvsRsYoyt4xFT5DlpMKS11Hp+f6mVnqrCLhr8tT1?= =?us-ascii?Q?WpV27HtdJPHuLqFZJo/uDtWjgJT5yoo2WeltXmlslZsnxuiAtW6kziJKoqDT?= =?us-ascii?Q?aa1R5NlXJNQOg20G1D5fUXwknzya+r1LdtPjpoWWPSV5RpsV0NgUgIrF+o1E?= =?us-ascii?Q?8LH7h3mTtaNu3bno8y+XwjSF678uUP0p9YDy8fVxJHO1nxLnv01yHPb5o9Cx?= =?us-ascii?Q?/5GBwk7rfuciKZqxFw77XZSBIgFRxdTHzD+OT0tHz9S/SgJqPHki6hRz+omL?= =?us-ascii?Q?zpDWa3Dt0DyTk6b4LhzXiE6DtyRljCfYh1Wqz0h7P8YskVqB6QfSPBqg4pHK?= =?us-ascii?Q?RJCMLg1qDFc//3f1WmtHJzKXoPckvriix+30g9y/Fe9U6HmkDbemtxUjUCh3?= =?us-ascii?Q?/5twN3td5o09cqKy3UO3rgHfl3jQN4Keti4ndKwEnpMVdYOs6uXsD8503Qji?= =?us-ascii?Q?nH1noCB/P6niVeg0xBoOr5SEGM0x+X2G8co5g99uf5/HACtyuQqNGYMi4njn?= =?us-ascii?Q?F/XSTCS3SnvYBSjd2orxuYKr6ku+q1eerjtqw0AvLe06Av3Rq7AcP9GYDpvf?= =?us-ascii?Q?bsxSO6H/jZ/hAt2Ss5W3jNWD5j0P2CICUKkNpqflhWCuXqgdutzddSHaS8hz?= =?us-ascii?Q?mZhD47oE0Lwq/CiYGs6Pqpw57PhUggB5tnDqjOXypLm3mcjea2NoLfoPrAPI?= =?us-ascii?Q?5EsoXCny36bKsh0dOn8hIXAg5RfvypMrYu7CznnqC6Xr6aqxFvxZ+jOYKjp7?= =?us-ascii?Q?bsenxZ+K0Ye8PkvCHZpz?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:BYAPR10MB3366.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(1800799024)(7416014)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?ZCentWqdttip2RXo+41DbSlNzpq5qpoTpyypVV7urJT2RbuhTxqvsYw9hWGT?= =?us-ascii?Q?jbRN9Y/oNMwHQPzQg0Z4D4x9FoL+ECsMx7LbGgoeO0Rll0h+i7oI8G+kUm1B?= =?us-ascii?Q?nd5kNrnDrGk+kLC25yX2Rqi3yyshWekg0R/wtHorNkklbNe2fze7NqBCfUt0?= =?us-ascii?Q?ZJngt/8RJpeFmNRtnmB+jxGjVwmzZM132e3hjchGWmxbh+a6Sf9hTQ8R+WT+?= =?us-ascii?Q?7014ZdIt8Jsrv7KR1sKWnZxfcWLK0+nDsZM3RCad+epzV2LCgyeoRUwg6cQn?= =?us-ascii?Q?Rf2csFrNwVn2jIvvn/wFEp7DBowpO3+fFNBP7UIFQv0Zz3fEDEZdU1izkSUl?= =?us-ascii?Q?GnCesvoaBycpa34cy26wZU09JXRQ+PMlsvGNirOY5nvdfIJcqP1KupuyJPPw?= =?us-ascii?Q?K2Ths71N3WFI6piy4f3MakG/DPjQX9eKu1GBsSgi9VgsepVWC83AOtZNigT4?= =?us-ascii?Q?9cLVlPZNPHhGUO8uyIlGnkVt7wN2MkoM2IYXMkTlSI/gif/c9qppsk3owlGT?= =?us-ascii?Q?vioIP2j7+kw4YTbTd25AhrpAihBX/nqI7iueaZaK8X9YirjNQojI5Dl/WT/u?= =?us-ascii?Q?kmJaSy8HBCw2H/9tqhOUdsQaLGCKZn2UKZUqJt5f95lUUC+xYKi2xRddiXZ2?= =?us-ascii?Q?fKujrgFc07tH5CXtsXcQ0j+hpIc6QlkOjiZXQ9NDn4nPX5jAcjhTNnwJyjZ/?= =?us-ascii?Q?1yGh/7zNvzg5mjw4aWmKm1Mv4ONNo3KrIwFjxvq/lTO1dQk3kqp/ts4uOIbn?= =?us-ascii?Q?A7ldzMvMwY3LeTKTKfgKHxq+3lPST0l0iJrt5EfGQGMNWrArlRoySwnUzMRY?= =?us-ascii?Q?F2vEZucDQzdB0Et+fvatXC+yYDPECDutjr7dddEh3s8/nAZbhdINcCMheBin?= =?us-ascii?Q?L1Gh02EOwvpNtn6Ve3IkZQvT2OjDS342Eg8I6W/j8hjpFlnJWk/UC/ebgdN0?= =?us-ascii?Q?33k/W3i4TndOsoPFz8XULC1vfR8dxKjlbkTyXmE57OpUWP+o4SbCfKh67zty?= =?us-ascii?Q?e8KOSJMgorE8ulJGZ+G0AhmOFOc/fEO517byPqDwEHN0r3jBeLUt7Re6Kmy7?= =?us-ascii?Q?3Ox4dw7y99f73fuvvxawy8H5R2c2C41QbJzCPBA18neLwosuMeSOVGrP8m9C?= =?us-ascii?Q?y4aCA8enKc7jk4g5KO0Ng+JHY3EMHoooiiJXJRbzDLNSeXZNgGmLrmJZSjzp?= =?us-ascii?Q?pvZI9KphWOncSu2o4B1MUW8d2b5AHioIXCGlvps3/OLOdW2ZcsksG6Wyw10v?= =?us-ascii?Q?gL+S3qUzW2eCd323n+BZ0t1aThpn7FYTakBzB+a6wXnvpgfG3wikqYltEse8?= =?us-ascii?Q?2fuShTyEiTKZxa1B0jWvPEhVSTws1/AgK89f++tJjrO7MUX5pQ3tf9z4rTbb?= =?us-ascii?Q?NOh4BD0UakB7CFGRBOmo1pTv0PJMizMY8Q5wwfQ9OeVj/oFRvxe1CatqqGn3?= =?us-ascii?Q?89p+IomutUqCrA1ZgiscbkB9FKBpQa+vg0xW74Vb10/5pgVJLMxKA27pJeLm?= =?us-ascii?Q?zO7DQttha71uJ2j47m+WzRWlyywNTNdakbDU20ttg4At/ou46MTZihp8yIH2?= =?us-ascii?Q?dSInC0T9+8kCWYe/r0HP7Xx4zckREdb3mn17uZjGLIQvwJnW2R3jPRfVF6m1?= =?us-ascii?Q?lA=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: zfH9qME4/bGj2/J1KeyKm8wQpDks1vX9FhTSQ0NjhMrwhvxAJjYLqbOUmLw9hq4+J1WnyyFlGQFuduM/I9c5X8XEsZizfniGIJ4TYcV1WJ7j768ArK3JAW0IE+y/6S5Osz9vGFi4FJrzewUIA9WdFCx+BLlReHw8TkoxmQZJ7bOcQwB/98BWgV4NOVesMeXAw5BZlp3gsBCB7QMXD/ypEuhDzhS9dCyh/w7raWws7Df4dLpOWjraD1O+KWn0xdXWk/uATMYQovhpYXwlkGlaq2z6hGuQtjwhKMm28tssp+b7m8t4YPGNnyH5dKZ+dhSTYD8lfCFyWeKWTr9lY7LNiR2sBluUTBe6lBCyy4ywCHdAxO1zioWy4bvaXgRGsqtxOP9eXkWSApHFJbd8PdGe1rYilv8+3bhHut3Ha00IJ5wL31xCeYG1Tl4fewFAZQ+AFn1qgESSuyVa0+Lpv+LhkB+r5TKOFNDfPGjQIeak+cxYouWqnhbz2Kz/VylnKxEm2PI32PwiaK4/8KzWGHB1jvDvkTfARfuQ9XRf68STkcXMsJWPx/NnNjPUM+KueBwpC7GuAszo7ZOKrB+GgHN5KuPgz43UoBDtt3Ccq5WEgz4= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: dfbe3729-7356-475a-e7f5-08dd00d7d43a X-MS-Exchange-CrossTenant-AuthSource: BYAPR10MB3366.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2024 16:01:53.8587 (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: KKWU2PnCmr1CacBME1oHbD23F4NNjFhhzfC8pS/zTtH8wiAoosuvQCrIUJmu/5qVckmmvJAZ0aKf8vHT2VWpVinSNX4p5s5qtWWV6HweBF8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR10MB7803 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1057,Hydra:6.0.680,FMLib:17.12.62.30 definitions=2024-11-09_15,2024-11-08_01,2024-09-30_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 malwarescore=0 adultscore=0 phishscore=0 bulkscore=0 suspectscore=0 spamscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2409260000 definitions=main-2411090137 X-Proofpoint-ORIG-GUID: KXIHlHLHPGNC1PpmRtYoDYb4i9tPHUei X-Proofpoint-GUID: KXIHlHLHPGNC1PpmRtYoDYb4i9tPHUei X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 56FA918000A X-Stat-Signature: 54fn4r9am1b5q4nce1jebytajka3qj1c X-Rspam-User: X-HE-Tag: 1731168105-634587 X-HE-Meta: U2FsdGVkX19hNPHJ8F2oyZUSV7pvn9EjCxaXuSTl31wQeX3dyKk2ISW/zj/l9gruTRlG2FaV8jVCWyuugN8kHAXEy3+J47rpEgbQY3gute94ffHDdS6hhQsujhrmSlnpaCwrqygIQ6eLa2l2VAaJD5229nv3/vOCNm5ckMz9ZZvXbecmZykS2Qc4uoa85sAGXxUjho9o3MBcMdpaFFxs/rP0rJJIfHt0+RPqvGNBtJ4jSmW4QEeVqRaONGJuu8Y9oFCpMGp+InEmFuwANjccLVGGRHyzqn5d/y00dcVdHoPbspY5hwQLZPBWXlqet+A96WNaDMrax8dBedLHmEoPraDJ27F3JeFbuHa3ttr/Wues7kq626Tnbj3CInoI2C7XBYUtd4RQtuYKaj7l0eWUMdeCimFb/8GGBqg9qNuYvOLfvYf+97sjoezZEGlXdEiM2fmySaBVizV484vSw83nNpr7bfCNznY1e2REBPhKJ4e6jqFS3t5LD8OzeZ8Z/czw4B4DfE7i6cowkWs546ow61z3rXvGsWUYaiGOP1LiIA58AqNk9unrRNkQAApwkyZhDRkQFP6ODJJEaF64f9dgO9W6phSfqAEywjm2xWxlelisluZnSyBsUGkb+/1l25CdzvzgQ4DILpYPx8HYekNs7YMlvaFYWbkQdN5BNHV8NeuoQ/RbM8LktIPThfiFeKGoI+4ruYKh6YZmy9XFCsihnrxUoEAFAFGaGhN7qR93ZYyjzhdgCfMQW6H/vYIfQSLxR4+fcVTPu/TunmmlYoixyd13JL1Vurb13Cq2OuLqZjnhAbvg0g29ybhtaTEtHFLKL65Edm80oogajjKH/M09T5oNBfHPwt1vp0WuX/P2p0L39ZZ+5mNf3mG2brXbRgIR23knWQzxnEaBHgxnZDR26Ytz8X3Hf6XNCYYsf+h1gAdfDE/mnoRSIL0P+CYFIUbkfh+c2UKAKxklnmoimvT aTz/6box AzuFd/MRWEaXRM1eqa0ct6MqsrEdF8ddNGM267DF+k25bxlpk4zAxROBX34+gnXje9KWWvPRU4pW/3ZARoC/yE0wbSH6lbyp2Vtwj7AuQLn9IxiIG2Q1pkAKmI6DxifRmIC38yjKXRHdLYCZt7RzSnbI8i/XP1UhTlIxjhsJ1ipw+i3AUrbPf0Q6t0jsuesg1UZJSX1H4ghK8MFYXTaOoJc5Jj8ZrHP/2XWDPM8TSrzbjFPLReu6HQ9scbi6FZFQt/vfqB1I5BBNqnSKjMXtDrK6a7AsmyCGz4AFZb3Zz2LfojGdkgTtCYbUDaECUqT9RwF8hIr11MNCrzXYZfnOmRTH9zp4oBXS1UbofLSPFt4JHGos+XbQSZIOo6t2l7sDQ00wiId8WJzMsUkJ2sMYduoaOYzlLpnRHGXsBPz2DvDznMNeYIQ468YpGaSBGq55fCuXyR3BEeOeU+AHNh5PGRT46lmwEhgNT8OTt0PfYHatkucs5OUwCZyCAgMWwIwJZrnUAc/KCWX1pdeGKetMlEKfh5E0nTDJaTocl5mkgYh3OdJEjLFsmkNAqWGI/Rbs/AbXE9g+XCRKP7W+ctqe9/s2M0FqopiDlYL3Us6AfGMpLqxt9wVmCu8gUo2rWKAQwlpk1L77ybL6C88lWHb9J7TFVRt/ypR0bT1BGzFJgMYCbni0MuOqFgqTm3lJ3q8tc0Y252hLL0ZXAh4w9wFLgiP/UQnqTWQ919e63 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 Fri, Nov 08, 2024 at 01:57:06PM +0000, Lorenzo Stoakes wrote: > Locking around VMAs is complicated and confusing. While we have a number of > disparate comments scattered around the place, we seem to be reaching a > level of complexity that justifies a serious effort at clearly documenting > how locks are expected to be used when it comes to interacting with > mm_struct and vm_area_struct objects. > > This is especially pertinent as regards the efforts to find sensible > abstractions for these fundamental objects in kernel rust code whose > compiler strictly requires some means of expressing these rules (and > through this expression, self-document these requirements as well as > enforce them). > > The document limits scope to mmap and VMA locks and those that are > immediately adjacent and relevant to them - so additionally covers page > table locking as this is so very closely tied to VMA operations (and relies > upon us handling these correctly). > > The document tries to cover some of the nastier and more confusing edge > cases and concerns especially around lock ordering and page table teardown. > > The document is split between generally useful information for users of mm > interfaces, and separately a section intended for mm kernel developers > providing a discussion around internal implementation details. > > Signed-off-by: Lorenzo Stoakes Hi Andrew, As Murphy's law so often dictates, I noticed a few small mistakes moments after sending the patch... :) I enclose a fix-patch to correct these, basically a typo and some small prose fixes. I have also updated https://ljs.io/v2/mm/process_addrs to reflect this. Thanks, Lorenzo ----8<---- >From 11d47b63e5b3a631741c663257f0f9051585f3b3 Mon Sep 17 00:00:00 2001 From: Lorenzo Stoakes Date: Sat, 9 Nov 2024 15:52:55 +0000 Subject: [PATCH] docs/mm: minor corrections Rename a section to avoid confusion with the address_space type, fix a typo, and reword a mangled sentence. Signed-off-by: Lorenzo Stoakes --- Documentation/mm/process_addrs.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/mm/process_addrs.rst b/Documentation/mm/process_addrs.rst index 5aef4fd0e0e9..ed74685ffbf2 100644 --- a/Documentation/mm/process_addrs.rst +++ b/Documentation/mm/process_addrs.rst @@ -68,8 +68,8 @@ described below). Stabilising a VMA also keeps the address space described by it around. -Using address space locks -------------------------- +Lock usage +---------- If you want to **read** VMA metadata fields or just keep the VMA stable, you must do one of the following: @@ -291,7 +291,7 @@ typically refer to the leaf level as the PTE level regardless. compiler might, in practice, eliminate any code relating to missing ones. -There are free key operations typically performed on page tables: +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 @@ -513,11 +513,11 @@ When performing a page table traversal and keeping the VMA stable, whether a read must be performed once and only once or not depends on the architecture (for instance x86-64 does not require any special precautions). -It is on the write side, or if a read informs whether a write takes place (on an -installation of a page table entry say, for instance in -:c:func:`!__pud_install`), where special care must always be taken. In these -cases we can never assume that page table locks give us entirely exclusive -access, and must retrieve page table entries once and only once. +If a write is being performed, or if a read informs whether a write takes place +(on an installation of a page table entry say, for instance in +:c:func:`!__pud_install`), special care must always be taken. In these cases we +can never assume that page table locks give us entirely exclusive access, and +must retrieve page table entries once and only once. If we are reading page table entries, then we need only ensure that the compiler does not rearrange our loads. This is achieved via :c:func:`!pXXp_get` -- 2.47.0