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]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 74410CAC587 for ; Tue, 9 Sep 2025 09:02:59 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id CC5188E0001; Tue, 9 Sep 2025 05:02:58 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C9C636B0012; Tue, 9 Sep 2025 05:02:58 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B640A8E0001; Tue, 9 Sep 2025 05:02:58 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id A13896B0011 for ; Tue, 9 Sep 2025 05:02:58 -0400 (EDT) Received: from smtpin13.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 6CD68C042F for ; Tue, 9 Sep 2025 09:02:58 +0000 (UTC) X-FDA: 83869122036.13.C8BC2E2 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by imf01.hostedemail.com (Postfix) with ESMTP id 10E5F40014 for ; Tue, 9 Sep 2025 09:02:54 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b=fby3hU9l; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=BGG4P5Sn; dmarc=pass (policy=reject) header.from=oracle.com; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf01.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1757408575; a=rsa-sha256; cv=pass; b=IYNxI7gO4hxSolqPsghTv2oLH0xLLaEY/yNTcEejnhZWewVEODknunc+5QjvUzU62ze7xu LFxRts6D5wnTbsVaMsdPCODm1O8zzarpTws2Dvq128UMoLocEGQBDiHOUvow0LY2Zojhiy 9NOgcrkJsQeLzBUY7qaJF1IhYA8k9Qw= ARC-Authentication-Results: i=2; imf01.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b=fby3hU9l; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=BGG4P5Sn; dmarc=pass (policy=reject) header.from=oracle.com; arc=pass ("microsoft.com:s=arcselector10001:i=1"); spf=pass (imf01.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1757408575; 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=VNQsMydS7yWOLelpdGtphwOXejiwVo0zgaYV2Iorq9U=; b=jCjr5Hg7XRvlWMwANZcq3345L+PMEDHC002eV3CSHZWPEEVkMX5uHdpA2UnJBWYg18H+YS 0STRGcnJIR//gBJLZjRrPNHCOZg5LYbN4lvxmwHgeRcwSLaKr1b5uyCtXy538kVyoPBPOx Wd32sUi9LyvSiY73DDUeaTUpK00iZts= Received: from pps.filterd (m0333520.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 5897g1Ol009625; Tue, 9 Sep 2025 09:02:35 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=VNQsMydS7yWOLelpdG tphwOXejiwVo0zgaYV2Iorq9U=; b=fby3hU9llUBi2xaG+pDjzSu5gy5aeQFsd1 cy6sIa0XWuvrbnZ6XClKGeUy5FenbZFNlvpIMu3UVpTo+6WMoSlFfkR55H9NJcFm /o4t3CdScUMGEB+ZU3RKqmhCBZw6Qc9GHU3K9ItvrZ9eHux+6pQAa8vyo44CzA8S p9LlJhAtJz07PKepceSY5T2hL9cYO0uKP9sGK9Hbpm/XuXxP9Z97JWff8T8i3ibU ySNRVwKEGGaYtiSQyiwlZ0GRKiD5CSJ8CzBfZo3+DORv8kO9TguT8+nG5ob1jOMf hyJ7GXAO9zoRL22FbBl6hafu5E3OyVCoTtwWNNgVf+aAhoPTBr1g== Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 4922jgsdar-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 09 Sep 2025 09:02:35 +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 5898u41e026540; Tue, 9 Sep 2025 09:02:34 GMT Received: from nam11-co1-obe.outbound.protection.outlook.com (mail-co1nam11on2089.outbound.protection.outlook.com [40.107.220.89]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 490bd9bbh1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 09 Sep 2025 09:02:34 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=RouU61+EE3f1Ubf+Fh5KXDWA9RZKX6XqMLaY57ecaHG2kNh+FvUOmJFb+4Y5al+p6JpTPjcWOyuuSb2fuBts2hjDkI8JvgYDSPN9lZ6h7bGqmiWSQWI5Ok5y6psoZcf+HjLUBmQjyRr1oP8GUWFSXJJ/rBQAbKqg6vWa8ypRodYZiHWbmKq3KfPewqRxczrfOE5JUqkzZIgaN6UCe3oCqEMkOp2cHj4kSTXvdIUFXhcAIx3BQna2eMQgO3D/p0EhqNQdzGm//UknSRFvFhzlHMYvAW63z25j3d2CMX9d6Nk4/EKu2hGGrLwyZfj4dnczaMWzkyMRpsCLDeKwjrUMvg== 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=VNQsMydS7yWOLelpdGtphwOXejiwVo0zgaYV2Iorq9U=; b=QtT7eARFd519QUvCCuZjs5N0kFdzV7DFE+N2WOFTm69tBTYAl1G8w7EczcU23JlEuCeTNF20v4nT3X9KyYxr6fyERUNu8PJORXXa3/NnB3IA7kfAZ5R/nB/LMPr4ZoGGRYernbshHH0h0AVkWld2VnWtpCQX6yYvhN9wuBSBLCCx+phqJdbAsk7ccTHwslNcL2VxJFUQJMZqeKJZW0HtwkCCSdh8DHlYjaC0WboF60D6jh5S/QyudYJVrkhZbw8/UV8JVqnpwrf7YtvwB5ShTRNiDRhxtce0zt/+SjMlqjnCPxRdukcfwb1EW6oh3xEuLBBvRQDVoCzmZincFRYQ2Q== 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=VNQsMydS7yWOLelpdGtphwOXejiwVo0zgaYV2Iorq9U=; b=BGG4P5Sn77GQuZPMX0cmhJ4bAVUF9tq617tXLmFHlJ+NS+CYy72xXeSAGPuVWJ3X+i2Q+QGBZtyE9HlExx0i+NQBlnFSJouBowGuxlO90OjZYuSstKzT5OfCwOcKbdu+KtTRPM4L0HlyLEn0KJzsYyUt8YSSIca8Y1sSSi+bKfQ= Received: from DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) by PH3PPFD7011BF84.namprd10.prod.outlook.com (2603:10b6:518:1::7c8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9094.22; Tue, 9 Sep 2025 09:02:30 +0000 Received: from DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2]) by DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2%5]) with mapi id 15.20.9094.021; Tue, 9 Sep 2025 09:02:30 +0000 Date: Tue, 9 Sep 2025 10:02:27 +0100 From: Lorenzo Stoakes To: Randy Dunlap Cc: Andrew Morton , Jonathan Corbet , Matthew Wilcox , Guo Ren , Thomas Bogendoerfer , Heiko Carstens , Vasily Gorbik , Alexander Gordeev , Christian Borntraeger , Sven Schnelle , "David S . Miller" , Andreas Larsson , Arnd Bergmann , Greg Kroah-Hartman , Dan Williams , Vishal Verma , Dave Jiang , Nicolas Pitre , Muchun Song , Oscar Salvador , David Hildenbrand , Konstantin Komarov , Baoquan He , Vivek Goyal , Dave Young , Tony Luck , Reinette Chatre , Dave Martin , James Morse , Alexander Viro , Christian Brauner , Jan Kara , "Liam R . Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Hugh Dickins , Baolin Wang , Uladzislau Rezki , Dmitry Vyukov , Andrey Konovalov , Jann Horn , Pedro Falcato , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-csky@vger.kernel.org, linux-mips@vger.kernel.org, linux-s390@vger.kernel.org, sparclinux@vger.kernel.org, nvdimm@lists.linux.dev, linux-cxl@vger.kernel.org, linux-mm@kvack.org, ntfs3@lists.linux.dev, kexec@lists.infradead.org, kasan-dev@googlegroups.com, Jason Gunthorpe Subject: Re: [PATCH 07/16] doc: update porting, vfs documentation for mmap_[complete, abort] Message-ID: <0a19543e-d2bd-40d0-8f0a-42cbabedaa9c@lucifer.local> References: <1ceb56fec97f891df5070b24344bf2009aca6655.1757329751.git.lorenzo.stoakes@oracle.com> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-ClientProxiedBy: AS4P191CA0036.EURP191.PROD.OUTLOOK.COM (2603:10a6:20b:657::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_|PH3PPFD7011BF84:EE_ X-MS-Office365-Filtering-Correlation-Id: 840287a8-ea2f-4e34-2881-08ddef7f9b28 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|376014|7416014|1800799024; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?A0Zc9ZhKjmf3bNgIZnfqvb1MyoXGD0Bg3Ou3/j/6vRIsb2Z42qy0nZ2wWgKF?= =?us-ascii?Q?IdIbKD3rSWi7sBIzzJDTULGw2TM1190O6ynpgzQiQ3LQCC1JwG73ku4gRMwn?= =?us-ascii?Q?lLiVA2jSw1pYHQYGhZeA1GTvz/O9Dmn1OpRah82AySmJ17gBbYQSSg9PgdEX?= =?us-ascii?Q?QKE4T8S3iHc9IvONrgY51/+tmKpS3B9Ja9qvLdnZ325PPOfXM1nLuppMRk6Q?= =?us-ascii?Q?lMhuqMDL7nqbAZSwQXLVI/908yszVcKKgR4GPCB+v9Y9dowBg5yXsnkOfztl?= =?us-ascii?Q?gtCrZOgsVZLoHgicdtNfy7LKIPlkGp1rQl0/GgVgisB9SEDWR0rbgytKQL30?= =?us-ascii?Q?Wnc84ymDnsOh8mH144QhQk3AeuyKeBCx3xXZmLviZM3BaBctbtZgVxHX+1H/?= =?us-ascii?Q?dUc26N65R1WTWMckHzT42sflpy8jRU51A/HSnDLk9fcWKCJUdyLI/vPaFXMV?= =?us-ascii?Q?k1VtVhnS6LmP0IE0nnWf0YJnCepLWYsO4ocltog07XjkNtudMkeOpAxE0T9Q?= =?us-ascii?Q?sM5gEcEXk6kNw4AqWQbkXA3zCnZkIM8gTx/3PthnDNNsx8ZJdvwLSAanCKV4?= =?us-ascii?Q?d2M/uvrucCSGEveSBRxqDJrOMc9nlMGKIAKItbHKjzE03JyCbR7huXYHu0HE?= =?us-ascii?Q?m2x1tG0V+C1D9+KJfszN1fxSy7pnaFbgIB6rScbiIQvhuYX2TDDUH8JLWV9b?= =?us-ascii?Q?UsFkPh/VJmWEV8jsqTnREQ03ZJkhMkNjcNyhJzoLdFYyYhcSSPHrnmX14e9f?= =?us-ascii?Q?bS9HyHFVV8EZpgkFZbxodA4W8h/aJhTlwc9svALmVbGNYIMH6iAPb5nA5XHc?= =?us-ascii?Q?FS/CXd+FqKIHtZVIBRi5bkPRqEYp3LJp7MsHaeaH7jRq/dOoEofvDDjPbiMe?= =?us-ascii?Q?a97uU8NAyj9TrixQT/XDkpJj5XplMJgdaGuJpPyet4J93di0YQxojSvhZpzR?= =?us-ascii?Q?ar3dkpya1FHA0ql0TnFYWf3dzwUmImd8d9rclH7VRH2WHUFWviB4V5iCvlw0?= =?us-ascii?Q?Et5Z+wbOb73YEMUjWsDL5vO3ltlTMNVIoHhBXdsvoMj4ozD+ixzric4UdVrD?= =?us-ascii?Q?LsIrHvhdP3Cb+NdbRIzZUlRtu5djuYL01hOGx5X8rdpWzirh0COSrN3wJJDt?= =?us-ascii?Q?FwZJ5KU4fGila5L0rFg7T4aeAP7AyBnw073ed+ka3V2PvCQ0bxlE6EXXWMHi?= =?us-ascii?Q?w/DpeOsr6xhD0Q76cie/ktGiaUmQ2ymogQRSgHeYZj4iIg5rzSBzBBXsPKio?= =?us-ascii?Q?81c3nZqkA6CYgzCcvCZoj+AxkjnNBBVZJnjoTAaCa0b3MCpsFcJMiqcK6M7w?= =?us-ascii?Q?aA7J8LbZCNHVWEjrap9nNJVjj31Ikr0/isLfJqQlV32BexatGdNJZnIEwy5+?= =?us-ascii?Q?8SL5z846YZlnI9VLsQlqbt7MX0FBPrinRixdaDmh5UgCX0PFWM5VoZplgoTv?= =?us-ascii?Q?2QncEd0ADqc=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)(366016)(376014)(7416014)(1800799024);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?/vqDD/7sVCKCkPupKB5+SgEHn3lAz1ZWutsIF59Z4QOXcYGLhcnVCnVQ7Vm8?= =?us-ascii?Q?0tworREyRd02GgfAxPGMOE/uW4LFi8KTbILO3Seq08VuytaauCFFlnPIQJHZ?= =?us-ascii?Q?pimJdXimufB5GET5CXGL9zp2lOtkp9Bq62AiieVgVBaNt62//svohDg50JH2?= =?us-ascii?Q?8AnACGEbU0Zz73n2EgFvtPssd+DdPv9Do+tyMJHkmaXyWwMSNAe0zyW8RAl7?= =?us-ascii?Q?R73D/4BP2Cp6eKIutgZqsOTyGDuHL2sh/iA0hKdkXxIbHoRGFibDvX5VXZZY?= =?us-ascii?Q?fGMVmzz6RGqKODQXzwx78YEsusQ6tXA/cON7xN4cXHkMkMKFZFvuwFhhqscg?= =?us-ascii?Q?OsD/58KgknaT3B7WDI3hr1IhLLYdqumcP8YjS08JhGKtkV1PN3IwQmPTEMVj?= =?us-ascii?Q?8uIx3QseLVJRXVu73N4hHRXCX78EINq8N39IYiAgWyk19L6Z4sR1a7kPRwE9?= =?us-ascii?Q?9X9hawKfy2OxfuglSmhRCHnON3WToJ16DQOxensThyvHvcGMuLUY9x70ckUt?= =?us-ascii?Q?19fXK8Qnsn3BQWrvSDLsLDMQG3oj7q5FjYPVv1aKBSnwSN59eTyCQlV9MKDv?= =?us-ascii?Q?spS2q53J1RUFSZSu3Ye/lDPr/JAqySxAsA5k5Yu0Qngm0SG4AkV5CloUSRJ2?= =?us-ascii?Q?LqCNOPMHZ87lQxFZ7Rpy7fDsqgroNvTW8k2s9KdDcDKMd5gSZdZ0LdJcbrPx?= =?us-ascii?Q?PufIBdw2D5yzrnqToiSuv6ba2qEMLWvSvbTNccJ6JmRM7jFVVC0BROsnPb1f?= =?us-ascii?Q?RFKKofE2L+LYWXmr9y1e3H+JIWfSAe1g3LfCYt2LtLimeFi7X8AKTxURJDuV?= =?us-ascii?Q?cpG3OFhHLgIK9vrwcWG+A4LFwEgszfDuTEpqdqbPSMweDtbLdKAQE68pOMV7?= =?us-ascii?Q?SeoRoay517z7kG/HhmqijzBiVa5OrMQQCC4iLVS5ME1vrxjmOeplVC1ub2Hg?= =?us-ascii?Q?qSizqMNs9iy6dB3Vl1XM3UozISMEQf86+dWVywuJraFbkKXDTOuyXtPrONVg?= =?us-ascii?Q?FIVQAu1peuLgO6Wgaqgj+6jpD2aG574slm3FSnDNfwsP17vhH+u8lTXmYlu9?= =?us-ascii?Q?TgZn+NCi4O7iufUS5J72CDvVeygPu5pX5u/RThAlfFoYxlv52wGBlSETI9Dv?= =?us-ascii?Q?wkMaVlaPER8q6432nPw4JbRrPfuvMAmzjFQ9rphgKy2O/bGT0Nztb29MtNST?= =?us-ascii?Q?OxKuRLQII2PewNeTncegvDjOiPBye5Q4QojAABaY6E++pcopofqGDjuE1UPr?= =?us-ascii?Q?SIeVaplNMBPdTlM9cvfcWDixQreowoUCZ8gAdde1fOnkRQqbOmTNCtNZZ1tj?= =?us-ascii?Q?Y7doLnBndsOQ8Q/O3Ka4QJNNNUyvYPFpoyUhavThcbKpMXvOu6HBQIfcen1K?= =?us-ascii?Q?8brfCn/DcXjPgSAKO5GPksRHCZ0Yk6HCz5Dvy71PoPsQj8f1epAI1NNE8obw?= =?us-ascii?Q?EIbSDo/Ay1SNYoHSJiE4h3vZOKuN+NECBSV7d+DpNVEDuriE0Z7sAGhyWlkI?= =?us-ascii?Q?Bq89kIWmNZaEVjF2tozxyU6WmB3KlWF3h+Hx+v5gSW3C5BMoz2E0EL80xi9/?= =?us-ascii?Q?KTkNVR3LfbDsxa8eOi7fjyDKaYewVkv9rtAdaWJTd/DtaG+6hfAd7U9cD3NI?= =?us-ascii?Q?+g=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: HRera3tBPG3djQckdCSg/DiPb7fcpq+lbncWSu2mKXKCkqHlx03AmfivQYWIebLzRv/4k013sY9dQFARc9OfnuTS2L9oKG8FyAPlL/CDlBKaersWl6W87yY/NlrAsPeA4e3ZNYIsQ9u1yUqJQeQ75Dga0DI9WjDZATPnOvCGfnUYMF3idlslCrTuxFcY1f6ZZd6SZHwznaIjcEezkQZNKftkQDctvTDLvhXYe8ZuBKmsO1eSk6LJVhFjW+J9rpK42qVBlsPVHrSAnXDS+tBGtELC+BF/jNDQxU/hrQmqXyzZWU4qSTXko2QnCfmVsw3WX/pkR+PSDuGGntzG4eWaFqgvlA3W6xpsuqweacnW39xV0rl+aoqlEPkBJf/ssFFxjhCULZNq9tf1mo/qPW3jqeqiQN4YPJD08XP2BcB+S15Hew4DKJgVwhGsTE1Wx6KKEbDu+1L7KXfrF341kwsfHqFkHfsN2j5FY5IFk4AiNu+h9Rq4/1WL0GfMN2qCT9GLo2bYV4ZmmX6dBw2wZGM+/UX3YogmxHgJRGnQmUsi2fUmKlT3lHreayi53c9dEcEb4+UXOjFeNBYc97Ty5Ye0ghynPl7TuxgbP57cb0AkDVQ= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 840287a8-ea2f-4e34-2881-08ddef7f9b28 X-MS-Exchange-CrossTenant-AuthSource: DM4PR10MB8218.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Sep 2025 09:02:30.1169 (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: O/7M9LKhfoM4+Ihn6I6e2Yv61OWStjKVs2MOgg3heaRVyBJuyhmka6MxnXDIpKFhlRiT5H9oDQ6KbyKIY/1Fb1NgObA2G6j65khaquXPmsA= X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH3PPFD7011BF84 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1117,Hydra:6.1.9,FMLib:17.12.80.40 definitions=2025-09-08_06,2025-09-08_02,2025-03-28_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 suspectscore=0 mlxscore=0 adultscore=0 bulkscore=0 malwarescore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2508110000 definitions=main-2509090088 X-Proofpoint-ORIG-GUID: 7RqPNJvbkIbL3TpOON1cLpYqfiwzL2xB X-Authority-Analysis: v=2.4 cv=PLMP+eqC c=1 sm=1 tr=0 ts=68bfed2b b=1 cx=c_pps a=e1sVV491RgrpLwSTMOnk8w==:117 a=e1sVV491RgrpLwSTMOnk8w==:17 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=z/mQ4Ysz8XfWz/Q5cLBRGdckG28=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=wKuvFiaSGQ0qltdbU6+NXLB8nM8=:19 a=Ol13hO9ccFRV9qXi2t6ftBPywas=:19 a=xqWC_Br6kY4A:10 a=kj9zAlcOel0A:10 a=yJojWOMRYYMA:10 a=GoEa3M9JfhUA:10 a=yPCof4ZbAAAA:8 a=ntSo-Hi3etu3jdbqjNQA:9 a=CjuIK1q_8ugA:10 cc=ntf awl=host:13614 X-Proofpoint-GUID: 7RqPNJvbkIbL3TpOON1cLpYqfiwzL2xB X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwOTA4MDE2MiBTYWx0ZWRfX1WgknYqrL8DJ PuUbOP7t75ejQNwHd/jDbvPa/Z2KbLrYEiKLVewUnebmfWUxvGjmyLDmfJ9mBmo912dCrmwizJV i57cmsqRZuoAQTtSlkeQ4CyMcvOJIoexU09rpPM3rfVHNCD2l4rn5K8KSXIImuQZCnIW9EfLwVp BcCtOR0R2trICU/NEE8H3zfQoG5fXv25h4tLjGcPhMoQGozNUzVadiSmfAV9bq0jDaiiOgmEY2T VSAmyO4wFInuX5J8nJccil6csZ87iFGDP6z6+7tG1lnNs6qo7Ep7+E7dYxGFad4yTYZDY+mIhAb X7ghACgrvRzWqtPECqtLXqcXwBQzVeMBWy39m1zRQzkAy0LqWXuqJ9ng+6Q1++/kt98C7Kvzr5s dc/qhcqx5qEDl1z0oNldfTf4rtP6CA== X-Rspamd-Server: rspam11 X-Rspamd-Queue-Id: 10E5F40014 X-Stat-Signature: s7qz7e1rz5ku6d47q1qid9rjxt3pe679 X-Rspam-User: X-HE-Tag: 1757408574-399389 X-HE-Meta: U2FsdGVkX19O1WmTaltn4VtJ7h60CpBVc9eHMqto4gXVUL+3lxlYTlAbg0yfL7SIe/cGaj5wpSxaU1uYN/RCOpClSrSCWliXzosT43bwdMrBvtuFHkPfV/VjbD01u05LSd3YGX3oDDWqlSt4kiSvRemhn+RUDm7bhpFp2P68N/CbV0xyUcHggEdOZuRctptl0qREN/f7Rv/B2kCdwFZHzPA9Foe8LRBFAo92JUosprJ6ZIihYFbL8ZKsdolETlBCM3A8lTgo+DMaNlMToqqjzon7+Tr93BduHhFWMQUBDyCSiJsPt7wihIeM6wcJSEx0P5+iezKysG5CUvuxG0O5uEgjxoLlIlV/vIuyZDejoU1nBn3R9Z7FWp5oksxIqdLg7lAoPraiOxrdMMAA4mvOHsVcPQ9YKQVUAddaY+LvGHczfT/4lP4n3hI0RKx3Zxhy3j/QWx+TMEvxRmibr04XYetYxyozd+H99hTp7ETP7eBz0FAFSzd+ZIpiwE8U6isVFxy9a0EOgAb2OJrkoFejuydTPREoVO4JUPxoqlq0eLGj226C5Lnf5oXwJfi6I2BppBva3gUxzkIX6dH3QVS/TkZTi+Igo7R/fwys+IEmQlOfiMi8HBPyyrw9c5ZJwYsnd45392Ec0TUN6VL8h0LBQC1pYl75nuNs67P/hBM83J3XZl5Gm884eQ8K88vHLHYVIGIEJGoxgFLwiXBtqPhG7RaPh7Sohmx8aopNMvQUGno3NskaIud/ypxZWAwcOf8bhN1ySTU+e7QHIycwF6Po4nOOq18t5K+o3MoKmrvf8Qf55/RqOtYIzjAJ5xNJr/j3ue4HypIFz2/TCNNlrv1bR/GQOYBxpAB+WllWlLD8vQD6adjpSM5LU0Cm6AgyUXW057k/GSxJaKezBhpIJ5i0EWDhEbkYmmXjldJJKUtES48S1Pmn7PrMF37MKYcY0bx0G8xYbX03gWy4AkK37bD lIUZKCqB Sze/LkLgedNpSi4HCLMFKE+DR02U28eg5E6+rwEli6Q29r17UyjzKO1B6LtTd/6qRM7dqVRbYNQ08eJtOjb3YB29sGx5L6fnpcPjOdo0wcYHtI/cw1detdGlgL2t87hqgRMtj0b4/UKBzl74hGX+HMcDnq3HSvDOqp8EEuW0ZKggaJ6L5w7I7KHCOgHz7H0Qgijjn3AJ+ABSHhvj+qGYNb1FAVxmOgtUJD78ArdI0WWDbPhIASdEJ4UeYlPJ4NOBi6rmmTHmyPMtRcbcgDqTaIBB/DAdNZYwMUWUNzpWrlX2/06PNeUMMeqoPmCOQLWhmyCpMlZmN/K74AWJoYE8jCskMwCgJWSu8aKzIODr2PNZUBlrVGTly0NKs5+7QlZc/QV7o6M/4PlZknPu7CeS2owdXaQzBv5wN9DMyG4AUHzqkqoe3TtBb6p6DSfQZ1BflF7H26nmeHWINiakmunXQ3kwrdLyNcOgdv6DNuaV64EsGTZbRaQBP2jkFlCTy+xIWqD3aRySvBDBqH1LcrWlkeCSIazqYLerVfeo5pfX8FjEpGeXLvENzIfsAjJ7L/2hCat35eSIqsFLL7bgVKQSvvm3evnEtUMjTreghrUaEAOMh6ckHPpz34OP0VnRujSYCF27qgdAVwY5vFNXnVtcRjbidHSVhUBPNDy4Ftb7yjnSl2CzufpP8PVQSJDJCtLXmUdUJB3P2f9XEoYwwOlJdqT2R0eMgSvMZuz6zkKFdmp9JvLT89e4pFTP5lzOkLRKq6igEqPcv9t3GcnJGcHcpfLZBs9n8V1juX9CP3I9D2aa5sCHY19vgTJ4GHGHbugJiAW3X 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, Sep 08, 2025 at 04:17:16PM -0700, Randy Dunlap wrote: > Hi-- > > On 9/8/25 4:10 AM, Lorenzo Stoakes wrote: > > We have introduced the mmap_complete() and mmap_abort() callbacks, which > > work in conjunction with mmap_prepare(), so describe what they used for. > > > > We update both the VFS documentation and the porting guide. > > > > Signed-off-by: Lorenzo Stoakes > > --- > > Documentation/filesystems/porting.rst | 9 +++++++ > > Documentation/filesystems/vfs.rst | 35 +++++++++++++++++++++++++++ > > 2 files changed, 44 insertions(+) > > > > > diff --git a/Documentation/filesystems/vfs.rst b/Documentation/filesystems/vfs.rst > > index 486a91633474..172d36a13e13 100644 > > --- a/Documentation/filesystems/vfs.rst > > +++ b/Documentation/filesystems/vfs.rst > > > @@ -1236,6 +1240,37 @@ otherwise noted. > > file-backed memory mapping, most notably establishing relevant > > private state and VMA callbacks. > > > > +``mmap_complete`` > > + If mmap_prepare is provided, will be invoked after the mapping is fully > > s/mmap_prepare/mmap_complete/ ?? Yes indeed sorry! Will fix on respin. > > > + established, with the mmap and VMA write locks held. > > + > > + It is useful for prepopulating VMAs before they may be accessed by > > + users. > > + > > + The hook MUST NOT release either the VMA or mmap write locks. This is > > You could also do **bold** above: > > The hook **MUST NOT** release ... > > Ack will do! > > + asserted by the mmap logic. > > + > > + If an error is returned by the hook, the VMA is unmapped and the > > + mmap() operation fails with that error. > > + > > + It is not valid to specify this hook if mmap_prepare is not also > > + specified, doing so will result in an error upon mapping. > > -- > ~Randy > Cheers, Lorenzo