From nobody Sun Oct 5 23:38:28 2025 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) (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 2BC76433C4; Mon, 28 Jul 2025 14:06:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=205.220.165.32 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1753711595; cv=fail; b=mSI4G+6NHIC8oGBVB6C0UJgMhfQ+CtP7tZEp8m2UX9rAgwF5gGmndNKVa0fSSiIWXp76a2GgNnLXjpOPqM39fwikm9Y4mUcRTHETJq1MYsRDWREQ32Xj9zpcmvFnvMkITUROHag4EjC1RNx98JYJSe1s/FY1cCpd3vla6us1g1Y= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1753711595; c=relaxed/simple; bh=lBbj8x8Calk4eHGGl3XlkDZrb3nROmS1fhmMynZ50rE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: Content-Type:MIME-Version; b=K+GodXFuBbWOnGlvoYDpGRPlxYFN/hDRLsFUHBOfxqxBIEFrTBKvYACMthzUAC+EQHx3btIsvwN155vIOcTcRKGJZX+bPu/rts4YSOODtQCxvy0lKn57tBrzrgHZvcwkr6wwIRjRDP1igJUdDKY1VVsWF2kPmHiUeLuP5quTf2g= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oracle.com; spf=pass smtp.mailfrom=oracle.com; dkim=pass (2048-bit key) header.d=oracle.com header.i=@oracle.com header.b=f24I09zH; dkim=pass (1024-bit key) header.d=oracle.onmicrosoft.com header.i=@oracle.onmicrosoft.com header.b=itkVuuDa; arc=fail smtp.client-ip=205.220.165.32 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oracle.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oracle.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=oracle.com header.i=@oracle.com header.b="f24I09zH"; dkim=pass (1024-bit key) header.d=oracle.onmicrosoft.com header.i=@oracle.onmicrosoft.com header.b="itkVuuDa" Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 56SDCTpZ014190; Mon, 28 Jul 2025 14:05:09 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc :content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s= corp-2025-04-25; bh=IAV4vevKfuGXtaOlcyf/R3o2HV03EGn8eDqHc+QoUJI=; b= f24I09zH5UZr5jNItenvPNLYiOIqJaN7/Ii/R+Qi2aI9Bioe1SAUh1uviWQiqpxj ImtRw33gEKdgBKZWe/5WKIkyTpO/8tBd4Kb/XmJMIftBSgQyIwevlQ0IAPdx5dzv iwbYULvTi3lgVpLEsDH1wsgm9vtgNaU86KTZb/nK5e8RBAEB/P55tqxgVttwXBpO al/EKcfqeeTJEONiYKdWkbOYnzGr1bsrjg1t37IvK7i0RU3V9zcEHzNFSth9ttOb 2EYFZkSiLPmr0rgryZJPiSUthQLy+M8+fa9m/31IZYgeIgfgqR0dfgjzubU+Y3HS 48T6Wzdk8+O6h9swYMad3g== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 484q4e45gg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 28 Jul 2025 14:05:08 +0000 (GMT) Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 56SDwwmq034448; Mon, 28 Jul 2025 14:05:08 GMT Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10on2070.outbound.protection.outlook.com [40.107.92.70]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 484nf8us7y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 28 Jul 2025 14:05:08 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=QFN8sk8pr12lTQ44RDRyp9qOOg9egfeTC+2IJdtbnr9XFHn+on+DuX1lXRig9GyQjyJ6HsYYJSaT6evO+FFarFOYxCuEKEOeiAJOSUAbmi8YNww7lq+V37fgoZXJgwCwwVsBKUVPSnud8htei4fEv38WTli8+J7rLLHayrbtI49Bpo8XXbaRj3DTcNPiAF12zcDQoXy5QN0IcNAMuWpZZGHkOFPwwIZQ+NAfj6x64JS4Ef7BhUPlaBkzeCa1D/6np+5Jc/VOqRt5JlkES0FbyCcHXr8jtCBvbkIsgdjZxBN8T10z9E7P6Oz288knghKcdJDr3/JVGAlu4hK7kE5zUA== 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=IAV4vevKfuGXtaOlcyf/R3o2HV03EGn8eDqHc+QoUJI=; b=bRHu6ALuJ0nL+WaHExkOBWawpr+qlBQhdBaT+YVcFol6TaESghr4ZkE6AJZufI/i0WCUkS3a6Qrb9YlHqdYZYlIdbjMhkKlhyMZL74RXEFIgWzqgmF9iRljGpX6UGCIvc4YTuhHoHpOBPjpahaURb7w85wHRWNiXw3sVQqqcdJjKD7QM/Pj8+fg6ekVYurUeOvgj76Fuv5uHKKqHzMiv+HyuZahqL4xoPKCmQqP+x15CN+7p7qeyI7jKFgfLwujAkp+icMKTUmImKzXbVPEqem2En1cro/RhxAZvVQq4dX657qJO9V3SYeucC9wxtLa+FbfLYqx/pQQ5r0rZ5Jjv1w== 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=IAV4vevKfuGXtaOlcyf/R3o2HV03EGn8eDqHc+QoUJI=; b=itkVuuDajh+5NJVoCkiTWiQoUN5wwYKsUmxti68aSIwZKYBpnp3dhHIIkce9oRDrWix5pScnTGccCpLKTFyEklKVUYbx867FEU5+yILefmFu9UQUxT0RV6TAu4fB7RNBxDElLIKSX/L00xFY3FjgH8+9OCHsBNW4Tc4Rqr77TDE= Received: from DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) by DM4PR10MB5920.namprd10.prod.outlook.com (2603:10b6:8:af::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8964.26; Mon, 28 Jul 2025 14:05:04 +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.8964.025; Mon, 28 Jul 2025 14:05:04 +0000 From: Lorenzo Stoakes To: Alejandro Colomar Cc: linux-man@vger.kernel.org, Andrew Morton , Peter Xu , Alexander Viro , Christian Brauner , Jan Kara , "Liam R . Howlett" , Vlastimil Babka , Jann Horn , Pedro Falcato , Rik van Riel , linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Subject: [PATCH v2 1/2] man/man2/mremap.2: describe multiple mapping move Date: Mon, 28 Jul 2025 15:04:50 +0100 Message-ID: <386ba8fc99adb7c796d3fc5b867c581d0ad376c7.1753711160.git.lorenzo.stoakes@oracle.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: MM0P280CA0069.SWEP280.PROD.OUTLOOK.COM (2603:10a6:190:8::6) To DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM4PR10MB8218:EE_|DM4PR10MB5920:EE_ X-MS-Office365-Filtering-Correlation-Id: efce62bc-46d2-4306-e36d-08ddcddfc02e X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|7416014|366016; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?hUoDoXb9Kx9oxlhA9hvXMfHcQjCA0uvxO/Eg3Wpbrhq2eMY/7Kr86v9HPWzk?= =?us-ascii?Q?EWkTam3ibWVlPKPeKDnpWzZQgiVpQthOmNPMAmhkdyOsSOrTnJ+df4FszJX2?= =?us-ascii?Q?FaSlnhBAU7HmMM6vo2fu5shMSoivTXRZG9x9uYAB268gHS8XZFWmTxYtygrH?= =?us-ascii?Q?8KHrTCivmKHA7PLjp6ZEGIbAvSz0EoN/WjYHDIYSB9TX6Bgkc4FflZPlxJKv?= =?us-ascii?Q?W7kN4cqsCK1GovYiSv0ZIitTdDPxD3jsr90TmBOszsFTJZO4bWwGvccr5iaI?= =?us-ascii?Q?2ocX0UFXZNe8gK2ONjoB2C89XjuADSr6XtUngv4UG3HEN/IEP1d4R0PJAoIg?= =?us-ascii?Q?9YUp/m6pf0ksMJECugzfU5JDPsoFnfwtzyCErfGv+8jIjKn19dLos36rh56j?= =?us-ascii?Q?RqMMNbxMT6jILa8rT5E7XGxjn/YfsHMT9A1nOUCSULBpP/92VVjPG3v94Jf8?= =?us-ascii?Q?kcJjaehc21dILCq8sgJ8mXcTuD4QhoEe+StnO8qTI6as0jmdEA1mDlldMqIp?= =?us-ascii?Q?BbgMFUtjoabNBURfdLVs14mCQYWF6nZ8XAMjuCURAouqlE1E8eOm91xIbR3R?= =?us-ascii?Q?w4pz6MMbscoMIVlSIe/Oz9yhg6AtxlOfMxsFEyXX1bVI4V/rN8VomyNTvZQk?= =?us-ascii?Q?oR8urS21fdk7NrbL9b5p+AwkAEQTKQlubTW3vW447ZbiLXvUWsxqEQUBlMup?= =?us-ascii?Q?XbNQ5kiuSsqzoogedYOd9xDGkACefh8+T0sOF1PDAGcELf39rNU2rdk72oDW?= =?us-ascii?Q?jsfGwvWtpDdIFPi/QAcjtJ7/g8kzG5B5KLxyZWgHQGbXCuMaBWpEGzlqdV7E?= =?us-ascii?Q?pye2vlCNnpmxK3ikBtilVbnIs+U4a/y4kWb7eRo2Jt8Iw+cS4+zR8tJnGJsf?= =?us-ascii?Q?1TXg153H9BcEousX8SM5Uma8HXpeRXkL1xGtb/xqVo3dbshdRWXJnnImFV46?= =?us-ascii?Q?/GnuMKMROM1u7+Z5V5dSFPtyKdfEslK4VsxvsJt6ZHqHI1YuEQmGViD/Ydy/?= =?us-ascii?Q?cA+8s1UHPcRfDtV7ePNZUoliAq3weoyJwcjJAg62QkrKlLJTE6/t2gjoNNwM?= =?us-ascii?Q?ERIrLuO+q5Tyl+1/+8agHkTxMAfF+EtUE68EUJ6wHKxM/PtPqQ3vYDXzsWYh?= =?us-ascii?Q?kOK+qzU/lPp0L7CBeEIWLSWuAQy7VQAty15FwdRWOuDxqyyVEoQfruhDDLAl?= =?us-ascii?Q?XpMmb98+v4OvZO5Q5n3Ftb9697hAGNr+vgb934s3nj9OgDuB8SUof7CCqYhm?= =?us-ascii?Q?3EKheejcX1pQx+gLDejqCw8qHr+mijPiBv+0BTzkDRGDuTpxBtvechLOOvhS?= =?us-ascii?Q?8L3VYhiH1+wxKCGK6gPWgIRNsr7Hm0k4ReVKFtH4ZGhRQ6CiCa2FJzq66MkH?= =?us-ascii?Q?6aLibtPlC0RqPDPa5uYXkmyR4D3o6UhVXRGl41Se5fSVYBR4bZcPJChy2ipM?= =?us-ascii?Q?5tQTwJwlYbQ=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)(1800799024)(376014)(7416014)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?Vr6bCwskqCT9xfEq5nPMsptLuG8RXi2hOTMCKkuu4TWuXGMMKTb2oAwPsFlA?= =?us-ascii?Q?A8XBfYCf6PXs3w25iQGyANpFcJxz9Kn1Ij1FD2gxbfkZz/04SYjZHbIYO3ZX?= =?us-ascii?Q?aqkI+aBc/WjcWKZKSQkS4jx9pfjZW+VVY9kVd+epKZn1nPiXdFRMx6yXw6M3?= =?us-ascii?Q?U4aQ+pHmOFMGvZAXRmP2KECsZymUjITN6kKBTNGAlYiqotlDoVULdc1+nnUz?= =?us-ascii?Q?etJ4mFZEh5bYh1Dxvo7qlUaood1M1JTjjAj/3qhmPYTOKFgeKtojQfY6bv4T?= =?us-ascii?Q?fy0FKRjXOo0Dw+sc/2KD1nOnZe4+KltUubSrgg/rG0EwKMpydbLM71BPENQe?= =?us-ascii?Q?vY5pgFuqJlMdg702DkGho0NPzWTbZMpUtW8ifYyrFn0rQG2D1dMGGeapfItp?= =?us-ascii?Q?FRB7Iuulqj+9BzI0HNcFhvBNs6XGoTQVGE6k/MmzfiwDKC99k4sMzB6A+sk6?= =?us-ascii?Q?93XVgyJdFTcSeEEucCJ/W35KuIBlkem2VayAp+cxW86Gayt7RvKfCBt7U10z?= =?us-ascii?Q?BN2up3eDcL3bCu/lKpS95sQ1Al0p6IAxH6tQx5o0p7lX4+giTcD0P8oUEoC2?= =?us-ascii?Q?Ln3GZbXzpw+2ucJnNVALcnUbi2ktK9NgLJ/H72YWIoPZxYNOFj9UzyUM+oTU?= =?us-ascii?Q?VqqXL98+Nx859dpFa/9xjyNqUGfg1phL6KIIeoFGHIzU7NdQwPAAT189h+/Z?= =?us-ascii?Q?ki8PndO6wT/abwd/Zdbjtgi8xwI9gNo6sXz4jaLYE/4neIu8TYLX/PKteWJ0?= =?us-ascii?Q?YQxvBje7L6Cdgzu5jlWRc0iyT74WpZzZgwKuQr+fQ22u5zl7tnujQiqDSCFw?= =?us-ascii?Q?xkyK3ONukXUos0ihOICv4WSHVuxvuhyxtIDG1K9MPxOb+fPJKamaVkaZyelY?= =?us-ascii?Q?MVuAxqgoz2RhjLni1m1G72XBI070ldQwWn3PqitCIgSB7i94K01G60PAHkQh?= =?us-ascii?Q?DYV1fxsvbhtz7akdeiCrpJEHpSPpbw3pX7ujf2R1D9LM+mH4ts+qrhMJ1TVA?= =?us-ascii?Q?aaOY/cJ7bS6BXd+K24lPkgSuE/0VAFVL/+9gBKtDJjoovjkdhPxQv378yGvA?= =?us-ascii?Q?RkfWlxIpWrNsP6hQlEjS1PH+Qc6tReuiLuBaTcG3/gM0Zvgc/btTQeK82y2z?= =?us-ascii?Q?e+1kJ3BoCscqCvtYS2uhVkSPC5c8bq+8+xkoSpBLBCk6vRqnFUxnW+4ytvPP?= =?us-ascii?Q?Rlr1M2ZaJPVniEA5yQCxaKaRBaTGupznkGTALjXW9K34nRc3Jm5rwarXbA0R?= =?us-ascii?Q?3wRnHOOY1rUvHK3gU9D8VWlpBVhl5t7Iv2mqCzV1p+c6/vC+R2pdaIPyED3L?= =?us-ascii?Q?oSfYvI5B4JMhOAd/kp25pByQ2sRFCN2tp1MpyBXV3Bmj06umagGwTPWhMHrx?= =?us-ascii?Q?UpoCq2s6lyJz0+CQI2Tkp3pl10Kxp8BRD3HnkBtYpW3XObZcFEOxqVsqiXnT?= =?us-ascii?Q?6ZUddQtEtnZg8yRy0Iufv/buYSE8GG4xdp1Y7NPgtv96G61ydrBq24Fx3AkJ?= =?us-ascii?Q?6pZCZRmeYGRsKqyo5r1fpJgiwdU2LQ/1FsXSJF2KjkWKP1x3ymoFzMrJNJF1?= =?us-ascii?Q?QqxcBMJVt29g6ddxXRR6drQFOx7RIVp9n7p67ncixECRd/IA9g/Tt8GiOPYN?= =?us-ascii?Q?gQ=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: Ec0relkQ8d40JXfoDDDd2QIP2w64S2IHNROHyTt898vLtRkQyfDTMmfv6Gc4x8HLJyfOzUG+SMdMfIAF4G4qEW7pxorUXU3BSrUJXtfRwAoG+2uzYQx9ZgandPHfq4420Ok15WII9AB78qC4fBHyHVnwKxZ+8eVXdNC/5PCxvkieS3Wc01/r0LUKTG0ML6LjUUtUO52bSn8T2PNxugMfM2vlrtVROKYx8CXM2IdSv3n7Kd3ENgttmkxs2yN5omW/qE8tp9dXeJLrmHOJAkv8T7VV7U12mJUSZZ4ltF58cufHQHk9xO0DMVVePOX3PFCdenaSXe5tGVFPN4echZhTmi4FvOFQXrfaPza22Sa797qht3ZltsnSDhTtYgCZvldPFDutTLae41e7S+pUcloN3FVv85tSvQRoGbD9LuerFMWuxAN/YJprpJELlrnfPDTjCifvpdUSQyitzks+sKW0HJ7RDsUvyLMiJZ8bk7Uisi/L5PZIA2cxFW434gEoUFtzODRkYDHe2XHGrU4xIe5lJ8iEbjNonBU0KbKH3F2OT/94fo4A/cUtm0ew1cYFeK85PhbZwm5fGtApl3D0/5PSghTC6pPE4cqLr/m70xWUwS4= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: efce62bc-46d2-4306-e36d-08ddcddfc02e X-MS-Exchange-CrossTenant-AuthSource: DM4PR10MB8218.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2025 14:05:04.3643 (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: mHzSQZpqCFXcAG8h0CCGMI60J/jsFEzQgsz5/cFlv8g0WPtmQXjrpBz+GKLWdnV4Mw3lHgRZZ5cHj8poi0E+zsP7de8MNM+0RL1UnWbJVTs= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR10MB5920 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.1.9,FMLib:17.12.80.40 definitions=2025-07-28_03,2025-07-28_01,2025-03-28_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 bulkscore=0 suspectscore=0 mlxscore=0 phishscore=0 spamscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2505160000 definitions=main-2507280103 X-Proofpoint-ORIG-GUID: fANH-S5R6ZMm_25hFIpB0UmYQb1TSDkE X-Proofpoint-GUID: fANH-S5R6ZMm_25hFIpB0UmYQb1TSDkE X-Authority-Analysis: v=2.4 cv=QZtmvtbv c=1 sm=1 tr=0 ts=68878395 b=1 cx=c_pps a=WeWmnZmh0fydH62SvGsd2A==:117 a=WeWmnZmh0fydH62SvGsd2A==: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=Wb1JkmetP80A:10 a=GoEa3M9JfhUA:10 a=yPCof4ZbAAAA:8 a=VAqEK11FdZ_IT4zXH1QA:9 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNzI4MDEwMyBTYWx0ZWRfX1BcL24TWjWKu EJi1iVqkcVm2YQVNUHQmrlIA4AgPRyJbUbMaWBk6xBxvBh7kx5klttbaviKIDiUcrN4yc4m/NMV QavM7aBACatouKnEtPZOt2TlowgGQ5NBnBrsLqcmkgDC3tlfZQ2dgLSreruxUm9Op1noIWvAvzg rXTEewk1+MpXJqzjAF/OWx8WI99F1cC0q+zc1LNLCZdcWZa/P5hy2udemiWTVsX/QFif78BEUnp A37lDfsZEC8O0G8S9a0p/o+yyLfQwVwoTLFjUJ88lLAEHHqaV68XM2IH5lpin8Bl7t3YTlwYr4b fcWm79u3DxHDOt4APMwZ3Ll4MQCXywHGNjeUj82d9dtPa62KX+HZVuFc07ejqtSDINbCNT3zJyJ 1yDmxscFumBrSu0dWeLdhEqpOPn6GeKTLJMPWq3Lj9AkufJjTw9AacW5u3j7w4FKQCDFD5r6 Content-Type: text/plain; charset="utf-8" Document the new behaviour introduced in Linux 6.17 whereby it is now possible to move multiple mappings in a single operation, as long as the operation is purely a move, that is old_size is equal to new_size and MREMAP_FIXED is specified. To make things clearer, also describe this 'pure move' operation, before expanding upon it to describe the newly introduced behaviour. This change also explains the limitations of of this method and the possibility of partial failure. Finally, we pluralise language where it makes sense to so the documentation does not contradict either this new capability nor the pre-existing edge case. Signed-off-by: Lorenzo Stoakes --- man/man2/mremap.2 | 78 ++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 67 insertions(+), 11 deletions(-) diff --git a/man/man2/mremap.2 b/man/man2/mremap.2 index 2168ca728..cb3412591 100644 --- a/man/man2/mremap.2 +++ b/man/man2/mremap.2 @@ -25,18 +25,41 @@ moving it at the same time (controlled by the argument and the available virtual address space). .P +Mappings can simply be moved by specifying equal +.I old_size +and +.I new_size +and specifying +.IR new_address , +see the description of +.B MREMAP_FIXED +below. +Since Linux 6.17, +while +.I old_address +must reside within a mapping, +.I old_size +may span multiple mappings +which do not have to be +adjacent to one another. +.P +If the operation is not a simple move +then +.I old_size +must span only a single mapping. +.P .I old_address -is the old address of the virtual memory block that you -want to expand (or shrink). +is the old address of the first virtual memory block that you +want to expand, shrink, and/or move. Note that .I old_address has to be page aligned. .I old_size -is the old size of the -virtual memory block. +is the size of the range containing +virtual memory blocks to be manipulated. .I new_size is the requested size of the -virtual memory block after the resize. +virtual memory blocks after the resize. An optional fifth argument, .IR new_address , may be provided; see the description of @@ -105,13 +128,43 @@ If is specified, then .B MREMAP_MAYMOVE must also be specified. +.IP +Since Linux 6.17, +if +.I old_size +is equal to +.I new_size +and +.B MREMAP_FIXED +is specified, then +.I old_size +may span beyond the mapping in which +.I old_address +resides. +In this case, +gaps between mappings in the original range +are maintained in the new range. +The whole operation is performed atomically +unless an error arises, +in which case the operation may be partially +completed, +that is, +some mappings may be moved and others not. +.IP + +Moving multiple mappings is not permitted if +any of those mappings have either +been registered with +.BR userfaultfd (2) , +or map drivers that +specify their own custom address mapping logic. .TP .BR MREMAP_DONTUNMAP " (since Linux 5.7)" .\" commit e346b3813067d4b17383f975f197a9aa28a3b077 This flag, which must be used in conjunction with .BR MREMAP_MAYMOVE , -remaps a mapping to a new address but does not unmap the mapping at -.IR old_address . +remaps mappings to a new address but does not unmap them +from their original address. .IP The .B MREMAP_DONTUNMAP @@ -149,13 +202,13 @@ mapped. See NOTES for some possible applications of .BR MREMAP_DONTUNMAP . .P -If the memory segment specified by +If the memory segments specified by .I old_address and .I old_size -is locked (using +are locked (using .BR mlock (2) -or similar), then this lock is maintained when the segment is +or similar), then this lock is maintained when the segments are resized and/or relocated. As a consequence, the amount of memory locked by the process may change. .SH RETURN VALUE @@ -188,7 +241,10 @@ virtual memory address for this process. You can also get .B EFAULT even if there exist mappings that cover the -whole address space requested, but those mappings are of different types. +whole address space requested, but those mappings are of different types, +and the +.BR mremap () +operation being performed does not support this. .TP .B EINVAL An invalid argument was given. --=20 2.50.1 From nobody Sun Oct 5 23:38:28 2025 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) (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 6F31626E149; Mon, 28 Jul 2025 14:06:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=205.220.165.32 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1753711608; cv=fail; b=BmEQTWENVc7wqobkm0o8WRrcKDmZ4k/mZ6X0wAcjbh0WWp8QRBXuFy82CZzM4/mzJFVe++riafHUl0LlxGQL6y+bNLrcH3TXRyXYVSZgmEFKyrZmun/JPRxlDtaXUsKkZ6E988PPPaoIszgMoa9ZVUm0TJH5C5XpAIO/HX8pY1s= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1753711608; c=relaxed/simple; bh=sh3aAXI0DVmAGiskEYGMXIgdQVg252iQ1FncdKshY7U=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: Content-Type:MIME-Version; b=WJUwg8WyqefrpZYDnxtINYLteSenaFWgSN4stN18sEO+d1g6SO6kKwE5hPXMfNRJzyGIV1+2lkMY+tNrJmccCxAOzbqp6xmLdPeYN1JjSGv+B2DZsU2i5fZAu1FPKT93xn5lNmgaZ0M7qlfBGmuPBjks2ZHkPe5x+6JX38S9IBg= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oracle.com; spf=pass smtp.mailfrom=oracle.com; dkim=pass (2048-bit key) header.d=oracle.com header.i=@oracle.com header.b=hObuJILX; dkim=pass (1024-bit key) header.d=oracle.onmicrosoft.com header.i=@oracle.onmicrosoft.com header.b=hvrUJVw3; arc=fail smtp.client-ip=205.220.165.32 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oracle.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oracle.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=oracle.com header.i=@oracle.com header.b="hObuJILX"; dkim=pass (1024-bit key) header.d=oracle.onmicrosoft.com header.i=@oracle.onmicrosoft.com header.b="hvrUJVw3" Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 56SDCRBp014187; Mon, 28 Jul 2025 14:05:12 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc :content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s= corp-2025-04-25; bh=4221I4VavoFlyV5acjuFOmYCRrRWjNh6pea+gFr+11o=; b= hObuJILXZlA3V4eNCrnZ9pvSKcIdBVvjAoGSmb0Elm1D2aCX9bfWZSbZW8TA5mup 9BIVTfohMs96JPbIgBST2uMMVSts8VPvo55ocowKLs2xanYRcT7ByqospVKohuBq F94yHk2DdPxJN4KE0Br3w6GaKF4U8Az9UCoWXfm4oIEsNKMNDKOGEAcnvHFpSgPJ InAumDYBT1bVQZJllHXSS3/17Qdz1nWXDnbzPxy/EFKV6+NRpHyuT4ig6MBZLE+m Gzwq0hYadhSOpJUz06DLPXOaIklTqnP2GdQoG0n/kRh4xH4uBmTVwgRgfM+iVxZ6 oJK2/vhXb318fxZ4Fs1W9g== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 484q4e45hr-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 28 Jul 2025 14:05:12 +0000 (GMT) Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 56SE2MR7034545; Mon, 28 Jul 2025 14:05:11 GMT Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10on2082.outbound.protection.outlook.com [40.107.92.82]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 484nf8usby-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 28 Jul 2025 14:05:11 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=A856XQbM9dToKLRSzEkRavjvBomffpeVytX88tS/ObNk6HvXY/0m3KIz71DW/dQPUXaBMQj87/2NKdpDjZTmrkrfWTRyQRuqJ9q57jhWbyktAndORqcbkLDq7n+XteBxM5WGIosT2n9zyqPciIr999ZR8nkk4iYsQUjK6/oAJBccNV2wU/vimsUOX9lWi537XLSzKwlqwEak+GX/gNPgjbzcbiyTDZavTECK/qBFcBqSQZszIxmd39ReFSQmX06T+/mOfG/HCP5C4jtNc9k3/IpsdTwPO7YfoHCqNiMf6m2AJzcoAXfMYUufrh/2ThFq659fX3s+9/bpxTIvgg7QAg== 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=4221I4VavoFlyV5acjuFOmYCRrRWjNh6pea+gFr+11o=; b=kgs67EHEtoCrwG1HaTvIf3IvuFWXb3VXfENKVYfcA79UblCalCn+oRM5sAq7B8gB6V/9IyFTDsMoTTsH6EPLDV8PMx5isuVnYT2DNDXsrk0D9EMuENPiwNA2dka4QYj14CGTmSlRF2Ip06VjXuR87sU809c9A7euDfdwiFKG5r1KMXmUCgzZLpil9Mxfy3fmjvj5l1WfFtiE8wzf+foJhZm1GLf1bZs0MtmIjo2vnFVmtm/t3CkTbh9W3JmsLWZ+ecrGLYXd2RXNcTJJejUbETyULt0trcyw4BrD/j+i90wrsaplMPfdRihi64S07foCNPYIURXxKDS5Y9DcCxfg1w== 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=4221I4VavoFlyV5acjuFOmYCRrRWjNh6pea+gFr+11o=; b=hvrUJVw387rcmsUp/SVVMHZUslj3P3lq/ndQv/mfPpBoQsmP2QuDJtFjHqJnqwsi+UaqIopFmwgdFTCHeyZvXi2X/cT7db4iYb+xXx6wPRMUW/HEc7QdirKhtX76ysT3Oh5P8wPRM8POKjIMEjSueQyYbRMja2aiHUKG0T5fUpE= Received: from DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) by DM4PR10MB5920.namprd10.prod.outlook.com (2603:10b6:8:af::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8964.26; Mon, 28 Jul 2025 14:05:08 +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.8964.025; Mon, 28 Jul 2025 14:05:08 +0000 From: Lorenzo Stoakes To: Alejandro Colomar Cc: linux-man@vger.kernel.org, Andrew Morton , Peter Xu , Alexander Viro , Christian Brauner , Jan Kara , "Liam R . Howlett" , Vlastimil Babka , Jann Horn , Pedro Falcato , Rik van Riel , linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Subject: [PATCH v2 2/2] man/man2/mremap.2: describe previous undocumented shrink behaviour Date: Mon, 28 Jul 2025 15:04:51 +0100 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: MM0P280CA0086.SWEP280.PROD.OUTLOOK.COM (2603:10a6:190:8::10) To DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM4PR10MB8218:EE_|DM4PR10MB5920:EE_ X-MS-Office365-Filtering-Correlation-Id: dd64f768-4d6e-4be6-d000-08ddcddfc263 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|7416014|366016; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?QbhtkZOvbLtkiFBt/etTE0dsAIDaNBPwsVMNnhNdTcs45p3URIh03hQ6gUYL?= =?us-ascii?Q?9k9rsr0/MGQiD8dRWsWOtqDwELaECOxfzEbfF5L+MVL5XXJnmPmRCkh0tLpq?= =?us-ascii?Q?HrHL8AR7InQBULu1I5E9+g7jQmPLIma3RSQVcjn+KBXtXdWYh2ezvX3e3ABT?= =?us-ascii?Q?719ZpMAo7zHwd7rObZY/wVFSEioWS1rwuZo9UCH0sQmByv6I9gK0Lrvvj6hS?= =?us-ascii?Q?TXWkmfgIUFNDnMup0VkCDl4pYpNfzH+VSqeH/EElrauPmqJpfo/DsN1uPrAL?= =?us-ascii?Q?O8RyJyLLr5j71GkcBo8Qr6qW+pAjp0IsFWCTGAkPSASJ06jjuGlzUT/S+bxM?= =?us-ascii?Q?BTTMW/ZgMOzL0QHvtktJvcruaW8C2ulsRTqa29bQumnmjJrB42hiCQfGE34x?= =?us-ascii?Q?Fa9XwR2On18yUgKgkSFalvPk995GRDuE9OIHwfXkLnqDhWl7n3yFboHl1Mf6?= =?us-ascii?Q?ESA5EKf8W9vvUbTGNXLiHYChe70OUSKmPWqnbXjJbJV7v36PexJc+GNpSP3C?= =?us-ascii?Q?u7AdLO6MCPMblX+SUXmZFOs/HhQtn9TZJXAVZgKSao/BffNd8+m4N5uNZ+uZ?= =?us-ascii?Q?bR5CcndlGp+dZMpl/2+6EO1zDAkR+erDc9DiAD8OcR+u0oVroMFEnlogQT2f?= =?us-ascii?Q?dmaISyhybPzSXi9mTwV7oybKE6Ea89lSpzjZviBoOPkxskMhAXffG2RsKR/k?= =?us-ascii?Q?pclbv8ab4z9mUVv3TkN6cAffUDxjsi/c8c/wLr54h0pl2lJMIvC7W9C7HAWr?= =?us-ascii?Q?NavMCQtstO8l0S3sXiqW9jfx0yUWOxko6eQn8ZIDJiXmrMke+AAkiXrLZa1z?= =?us-ascii?Q?8EGfKvdWg/QmgW7VnFqWZBPrHE6pTdD1PVJsDOflOx641c792ulfo/DbjyDk?= =?us-ascii?Q?CqXN99O5lGzWaxe5RbDuQ/K60zpzyXwyrlQgmL97B8ODE6ZIt4aOVGbMicTz?= =?us-ascii?Q?ueQmXgScTzL4RgLmQX8Q0lu96l/ZyVogVQt7AMqeuMa4JIFEQ7jWG1unvY1u?= =?us-ascii?Q?tFWa1QEpR1h+hM1sILlW+U4pBoSEYkp+yplEr4aw6w3zURun0Z2oSnBDVm6C?= =?us-ascii?Q?y2zwnijFeB/hUP4q57cOnFOXswl07QBMBlrr7pYbKEQwgr1WbI8nPFLF0xT1?= =?us-ascii?Q?ZQU7VQ2RCk6v7AUTWRsA75CDzVJlENPduqsdtC9+7kpcWdEgjFng3MxjdMcZ?= =?us-ascii?Q?IlIWD8VdDx1FFe/8GUpaae12HD13jy09PBJgDovZldG9lAnsER+2Z+BolaO7?= =?us-ascii?Q?J9n2b5a0/+uV1Cgh+cx+hbUMS20O+a/c47RRuJqASaDuwsLj0MIwRzWPIWTB?= =?us-ascii?Q?F+SSCSP7OO9N4yvECXmjqIQ7N+NhTKCJRbGDN/rWXErb+1NlGSkt5ShAXH4O?= =?us-ascii?Q?kC1E8JPFubhT6wnqp+BK+xLzfSxH2LZpClNgYbfu+Fe8+lNkILvEL24YdyzF?= =?us-ascii?Q?2EX+b5Ri3gU=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)(1800799024)(376014)(7416014)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?wcWgfrZH1UPtfzT2id3qoRm2tk0c9Z1s0sDf83elDLudD6duBDWkLWOYjBYh?= =?us-ascii?Q?avlizyGuVfVsaV+nsnZw+MN6cAlosRoCHtT3QhfjVUGqeC5pOgZo/K92YwaX?= =?us-ascii?Q?08czaTPast7CydoPcqiAif7HAVSsxPjBjXAuQEyMBEd3qR0jH/+NhtQZc/G5?= =?us-ascii?Q?sc0bVCtCDcwvjkDp8i3pz8hTfzwT8/yCz9QqL8LGNWzK4JgwHxWJ9MiP/sE2?= =?us-ascii?Q?9ER/mRB8o0aFtc1hLhPG0xPjyPBEDAruuMNm7zSYRYV6LT2D9s/q/bqTB4yl?= =?us-ascii?Q?H48QJuV27tmgkgXNRS8K5C/LRMEcrkFS5awWDKNSaxY7ZfYs8kVDoPykoVDZ?= =?us-ascii?Q?YbJHSJ7gO+hq9iJ0qr/JS1G81rIIRzW0U1VC8s6WTGA6sokYhEWVbDgNhH07?= =?us-ascii?Q?L/F4TANCrkCIW+KWWGIde5FCFU6RGW+1P9IKujcgMUcor00tFthwPWUHo7/e?= =?us-ascii?Q?Lh+mRyMsP8OH3q7GRgAE9TX3u0aS9xBQZk97pmLtXQR8tM9oFrX3u9oboxHj?= =?us-ascii?Q?EWT2wm6M8S5Eajqu5qAuYJWH13FosMXrcfzLDMYOjc7yYUs0IZN9/vT58v9q?= =?us-ascii?Q?aIpmljKrDW/CKefTULuTvCKFwE/VCnUnkDdrjY1mbz0SrL5y7OYLgK/Q/NsB?= =?us-ascii?Q?+SiOVE7YAqN7amBHygycPZ6gU29jnewT0m69fyAeZFi2XFV23z5u9KrSW+me?= =?us-ascii?Q?/x8b2HEPJt9C+27bvJK4qED2Iu9iXiqcsho0+xPx28F2K+HoXMYxt6WBe8ZN?= =?us-ascii?Q?ZM6uHSr1O6CuckafKg6nlboYIhnpk1Sb/XOQIdQHeIFj7n7Mm+36OQjE2vIp?= =?us-ascii?Q?P1EA+41c/UAZrRnwjHDRjlC8jsKmsLhqIoF1U7RcLjmbeKNq6XsEyOUO6lk+?= =?us-ascii?Q?BprTDEnKF4l19HsrYnsxO4ivFC8SPy8Br7yby//hWla4N2DDIX+QhvT6RzVa?= =?us-ascii?Q?Hj/2vjBdFUZn1m/CRS9Pf/nkPdO2ytj9GXTdpGK3CRDzDZR1XvAsV5HM1zGU?= =?us-ascii?Q?fV322+2BXjQLcujVxhr2XExEMYpWL8iujFEa0LScScml3gKgbPQzBrhZDAMh?= =?us-ascii?Q?EVD26KvoxRFpEMySZgDRlmn2AUa9tptQrv21096qu31rolzGXZWZKmGw85a8?= =?us-ascii?Q?QOpT8Gj0BVzQHbvnNrEuEEsfRWAuerXEffOkFqK3yJ64ri7JxX+lypJOHCvp?= =?us-ascii?Q?eoJK/LlIxnX+2DePvjKm8wzRiYQbKPJmcYV6V0CsqN0rofJg18s4qxctr0ak?= =?us-ascii?Q?f7acDi2JiE7P6/ZVEpaCHZhomcPQYx5OzhtDbtfViebbrUhbus+C2glhD1I8?= =?us-ascii?Q?LkEa1NKaa6qmZtE/G6W38mlTHTGed8BsGIDACNL3ReYBqfEE020nsPjgvRaO?= =?us-ascii?Q?LDrHwWaWAsCMRdLYirbuOA85TvjbO1O0mLnfAlRwe34Hc3LFMXYw+MvHBv8+?= =?us-ascii?Q?bpl6zbrNzlxzdpQl38FLYI0S5R8OOosUIQrNnNcssNPNrDIdVOgoH6yJ9o+0?= =?us-ascii?Q?uCiTTy2Owk2bSvW1UZHC3SMg12CtleW7w10Pqw74s4EpTmq1DJKAj2qQ+mf/?= =?us-ascii?Q?nIIxXOX0qsClpPvdSye40MOV8iA4o5e9czv3f6FVAyqyjv8P0HLBsj8lJIE2?= =?us-ascii?Q?hw=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: O+L3ERlbeTfa05SrnFJj2kqpaDeXafvjpUscZh5GLuhhEgQm/UQAZ8umqqp9jnN/jVF0mJ05PgtRumej8IqCjJr0u471Yey8ChFLTa6a1+mK3zoTuF/Z8y0vsClY/n5PUUVM3R6AkFVdu7QqII/4iPNc5VlTcmi6pM4TNRLbYWiy/mO791E2hAB2GdHngxYTQdk33sGPgDXxJfE+aPtehe0P1BIhUUvZNeZqVIRMXaXRX11Px4eYfvrAkTYoPxPFgBvPBh3gMMBiSrQWLNP1bEOn2bZZhCaOY5wlFL0sZAfIlFMAqB2sHgCZTx2jpGc7ocE3II6dRf1E2dW2RLd6v3FCtS22mJVnyckRWVyx8ofjigbuds5Ps45wo8YjEWIBRPxHbTOmPH27eCUiGavcd/WQ0Gcg+9KPHplY+TZzuE1iboLfkI4434yU7an6IjC2bxevqxLaC4F8WS8NkDjot3LkS6WJ0xN68pVCvwrPe7QYXuG8+rRrQGX0okVy4V5//Wv9ONB57s2tHkDPgK3KSYrvWv25xwUdo/hFKif7f7psAc77nP3w4m7tD6SDwwQHIjBb2RZhNDoZ2PN0gcuX0n+4wmXYafHzh6xiOm5ni5g= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: dd64f768-4d6e-4be6-d000-08ddcddfc263 X-MS-Exchange-CrossTenant-AuthSource: DM4PR10MB8218.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2025 14:05:07.9837 (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: KuxiBuvRbwQ3FITrPob2P+NC4pes0QmlHOu58NJHhSInn7U5VPlrzMqGsOUtNAAB13u481mqGK7tOUACquwJjdSbTK5peZirNvZm4+iX8Iw= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR10MB5920 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.1.9,FMLib:17.12.80.40 definitions=2025-07-28_03,2025-07-28_01,2025-03-28_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 bulkscore=0 suspectscore=0 mlxscore=0 phishscore=0 spamscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2505160000 definitions=main-2507280103 X-Proofpoint-ORIG-GUID: IB82IvYpJ6Lu4-DXex7k6_v4-i22pD_R X-Proofpoint-GUID: IB82IvYpJ6Lu4-DXex7k6_v4-i22pD_R X-Authority-Analysis: v=2.4 cv=QZtmvtbv c=1 sm=1 tr=0 ts=68878398 b=1 cx=c_pps a=WeWmnZmh0fydH62SvGsd2A==:117 a=WeWmnZmh0fydH62SvGsd2A==: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=Wb1JkmetP80A:10 a=GoEa3M9JfhUA:10 a=yPCof4ZbAAAA:8 a=O8myZlW8C2RKAW_23OIA:9 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNzI4MDEwMyBTYWx0ZWRfX4EnbZjy1CJQW 7/2Shoy4YXFpAffDOlf4o8yBRv3oqF8wEF217GqfxroZ36+E7PKy0BoK4dOvZ0KWWm70cTtov4m aU5RuRkUJz6B8VqH9toP2V2rjcLaUHOlxdmiehie91SH/Sd91WW+HZ+7c2kMxQm7LajSvmotRFu l/Z5L++p5txJqUNiXvfF0+j0fSNU6T+7f0SyiVIEqVzUsH/IcpqpofzRdW1OJTKgJ3/yl0PsUdX CqQGF5TnIWoCkybmIQMlY2Nl9pUxa3sssRfpIVhnfcAWPqvAsDwkCBw1ZKwBhKNRHS06G7dE2o0 1NmWdwyyQ/65nDfKOiJQQAGTkHXD32vfOcK4O1fGV9gE0CxUftIuTWzW4pAy9R/Whc+vkMIAD8G 3pn7pxcjN89p4eGng955fhvCImv0DmRB60UEXC6Ge2dHEKv9xQOOvjMn5m3nfAx0HQumD1oZ Content-Type: text/plain; charset="utf-8" There is pre-existing logic that appears to be undocumented for an mremap() shrink operation, where it turns out that the usual 'input range must span a single mapping' requirement no longer applies. In fact, it turns out that the input range specified by [old_address, old_size) may span any number of mappings, as long old_address resides at or within a mapping and [old_address, new_size) spans only a single mapping. Explicitly document this. Signed-off-by: Lorenzo Stoakes --- man/man2/mremap.2 | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/man/man2/mremap.2 b/man/man2/mremap.2 index cb3412591..c1a9e7397 100644 --- a/man/man2/mremap.2 +++ b/man/man2/mremap.2 @@ -43,7 +43,22 @@ may span multiple mappings which do not have to be adjacent to one another. .P -If the operation is not a simple move +Equally, if the operation performs a shrink, +that is if +.I old_size +is greater than +.IR new_size , +then +.I old_size +may also span multiple mappings +which do not have to be +adjacent to one another. +However in this case, +.I new_size +must span only a single mapping. +.P +If the operation is neither a simple move +nor a shrink, then .I old_size must span only a single mapping. --=20 2.50.1