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 B915FC54E60 for ; Thu, 14 Mar 2024 17:58:43 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 46568800D6; Thu, 14 Mar 2024 13:58:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 415C3800B4; Thu, 14 Mar 2024 13:58:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2B576800D6; Thu, 14 Mar 2024 13:58:43 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 196F6800B4 for ; Thu, 14 Mar 2024 13:58:43 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id BBDFD1209A4 for ; Thu, 14 Mar 2024 17:58:42 +0000 (UTC) X-FDA: 81896404884.09.3BA6AA5 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12on2056.outbound.protection.outlook.com [40.107.244.56]) by imf19.hostedemail.com (Postfix) with ESMTP id 1CAE31A0013 for ; Thu, 14 Mar 2024 17:58:39 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=Nvidia.com header.s=selector2 header.b=lILygh9g; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=pass (policy=reject) header.from=nvidia.com; spf=pass (imf19.hostedemail.com: domain of jhubbard@nvidia.com designates 40.107.244.56 as permitted sender) smtp.mailfrom=jhubbard@nvidia.com ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1710439120; a=rsa-sha256; cv=pass; b=iYBQ80WR44HDp3By2dlxey0NRHFeaBk+ofcpQ4Iv5Y1jobOUIc4/Au3fjBtv1fzNPtf9aR Q+LRUBG/Irhj8vy4pSLLv+yQFzpCYrh8ubfXVD8a81Xx3gHj3igXUXIR7SVc8guyFv4xfg vdYqFPYgK8yHrqcNm/EZ4UcoLK0R/Pk= ARC-Authentication-Results: i=2; imf19.hostedemail.com; dkim=pass header.d=Nvidia.com header.s=selector2 header.b=lILygh9g; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=pass (policy=reject) header.from=nvidia.com; spf=pass (imf19.hostedemail.com: domain of jhubbard@nvidia.com designates 40.107.244.56 as permitted sender) smtp.mailfrom=jhubbard@nvidia.com ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1710439120; 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:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=64bcSLy9MK+ELMjO2jGHQTZpstMM33BUOyviRk2zJyo=; b=r/tkdt6GWANQlF8YK8+92KAHJsITqtjE0rHjdt9I7KgDlz2jA8uj4AGRhBRjMaHRN0SgI+ GMU2p8iED2sMeUweYr8WnSjJAjRTLrfcDU0qNIzygbj346CKMvErK7GplDkbQ9YKIHlRRG 0s0mNxE9oOnsM9ZTiB8Z4z0D8IoUL9U= ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=JpiemtEzAq5y0RVqadPZNm5EEoZta/kjAGVyV/D6R0RDJiQ7Jb1B2pvt1a03ZbcP/0piMWbLyNg/DkNiqZN1U4EjOPlsuN1FlzarSIZx/y6fiBBqXaEpHvEbXO2xYsHBcb92Q5wHoHs//vjgguacXVdeo1ehmgqD3qlLetDTPB5I9uxcB/b/XVg/NraZjdfmEluO7HvgxyMAGtBx+cbYvWEhadVFkY3JQtQoUoMu+73bXzjhUCI1w0OK832y35BJn+JMM0ywTsbHIs2TXC76mFbEoMOe1r3AnD7aZngswZcA0+FvoV6OzkmURlSbtdVoVmNbSFWLXA4aa93V7eFujg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=64bcSLy9MK+ELMjO2jGHQTZpstMM33BUOyviRk2zJyo=; b=bPWffsih8VmWxv/FBYE7TbAxzSKJE7bD0y2TEhvCO7YfI6Ptc0k/+bP7ZUHIp2C8+XoPv49tZV4uyZa8GzDdPaQMXpIuDLUAA3/lcAg5wDUHF8ARIS6Q3b8U2dQrvMKN+3NoCKIQL44Ef2Ins+PQuCQPWt6Sp9Mka1McmtajdhulMzYldxVdcyut/0+zzTaBIRgXZoxt7WiDt2pw8eN0rwsW77cfP+phMuJTm76pu9ghuhyFajye/R3XXS5txigBhm7F2x8OkEaglmj4bPkYm/YjLh1UeVu9Z6SAfuU6W6vVzuyiBtx97oLer4ogH4WuaPlNNRRn0IPt5Qf9VcIV7w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=64bcSLy9MK+ELMjO2jGHQTZpstMM33BUOyviRk2zJyo=; b=lILygh9giuAflVY9B6RAoc/nSPtpMs98dqYRQiWZXQRq080saFuwwfndXlqukhjmA+fhXMrpssNXYZ7v9sYjTBLjnZEn7oWNWwNLiHyI0yMwDXiKpneZDX2WQDlVB6inmn8/N8pCqJbTBrswFQktkuGDMyjSb2JzWP/hiVoWSaI5eZOeMr5GOf2quz530ScbFWGrQCqdydNdr5DO3ikN82ZJzJW5FFxkszgj6W5afmCDmhtm+w5EPpIY5/hepWlcmyfvLmzGPg7Z/vGKGN1hHidHY6aO9UXTWywqH+N/EXSJcOQjLv0DvGxJTyNJaYYa83HXWHqvH4eWagRiWJ2VUQ== Received: from BY5PR12MB4130.namprd12.prod.outlook.com (2603:10b6:a03:20b::16) by BY5PR12MB4098.namprd12.prod.outlook.com (2603:10b6:a03:205::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7386.19; Thu, 14 Mar 2024 17:58:34 +0000 Received: from BY5PR12MB4130.namprd12.prod.outlook.com ([fe80::3889:abf7:8a5e:cbbf]) by BY5PR12MB4130.namprd12.prod.outlook.com ([fe80::3889:abf7:8a5e:cbbf%3]) with mapi id 15.20.7386.020; Thu, 14 Mar 2024 17:58:34 +0000 Message-ID: <19d7bca6-aa01-49a1-84f6-535b83d774d3@nvidia.com> Date: Thu, 14 Mar 2024 10:57:29 -0700 User-Agent: Mozilla Thunderbird Subject: Re: updated documentation: Splitting pinned folios Content-Language: en-US To: Matthew Wilcox Cc: David Hildenbrand , Jane Chu , linux-mm@kvack.org References: <57c9e228-9aca-4da6-a714-f175f053ff50@redhat.com> From: John Hubbard In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ClientProxiedBy: BY3PR03CA0016.namprd03.prod.outlook.com (2603:10b6:a03:39a::21) To BY5PR12MB4130.namprd12.prod.outlook.com (2603:10b6:a03:20b::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BY5PR12MB4130:EE_|BY5PR12MB4098:EE_ X-MS-Office365-Filtering-Correlation-Id: e3a0ae55-47cd-4bd1-eb32-08dc44505e07 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: BHHoFx1a7N0Mz0yqGJWVopbri3cVjB4u2VOGxtlxpvEcWApjJervQzuUEB+nMHkhb7uL0YNehUVV/MK1ey7/jvksmchW26gSp1WNgHV6b1lKymMqMcvllFN8lj3LDCedch44lvfwanwST4aEIXszmJwMPy6xcVI9/iZ/zh70c0YeHW2D47JSeUhdersI0ItNrYldWBu+jtJjT+tIYdIeN8dDaakmXcsyZivaOuidYxPvFaTq95eDECd27FzFqeA9BPJeboiZhVwrBQWMqALHKaO6yGMQQ79SstaLHkEZJqh5ScPLTIrpa7SiYpBIZoK8n1ouawgJmdSRMbpfb4AIuKuHAE+ABfnVNDEbuvEGhqH9NeZldLQI8QmuLtAWwSVeVT9J7bjTI8BCbnN9f5bzYAaoiquWBtlaTKONCa2c0BSjCEN3oB2XAO0M8fNsvvvbbs8lk0/mfdpAL/6tIeK/Da0g8JTYV4NiG9VTUXHQtOqnNHM07CmkC2oKjT7bRsgT4sCoqyhpMooodqj4c22UC8N8K3axBuv9gHuZv/UQ8hHD5GE38q3QFmR1yw6aMhGyGYm/ddZgm0MrsMsgrPLOACNdc2lFB8E9d3A200Pz13TSGsS6mcIs56q16oHyo7TYcmhuT8qfpUVD4LJYea71V+4xMah/QLiYjKCKqwi7hS0= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:BY5PR12MB4130.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(1800799015)(376005);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?aFptMlVHTjZ5STBma1RMV01IUkhOMkFGYndidUlFOG1YbVozelBvcUQwTUVC?= =?utf-8?B?cXMzOUE0QW1GS2hZa3UzL1JpUnZHSDIwcGJqUzZ2T1BhVmFxVnREeTgweHNO?= =?utf-8?B?bG14eE9zbzBCdUhMT1NSQ3o3dThOc2RaekJHMDZ2ZzJNWmhVdnB2TmZZbkNL?= =?utf-8?B?UEd4UWpWbWdEWW1mV3IrZDNyRmJOZ2k4cHpxSkJiTHR0cmlHTzBYUlYvdHBn?= =?utf-8?B?TyttWDNHSmovcXdhZHBrdUYxaW5SdUxpWFlIUURMRU13THlsVHV6UmlldGx0?= =?utf-8?B?UjZZYWtNWEl6SlFGSVFYaWR5R1puUi9RTElrSjlLcjJ4MjhSWUtFTEc4YUlC?= =?utf-8?B?RkZ4UkFGM2dxVnROQmZmakdyTjc4blpjRmhKWGlGZTRJQXNhbW9uTXAra1FG?= =?utf-8?B?RUM3cDcxQitORzFya2lNSkFpekRGTjNFV2t4WnhuYWVGdlR4SHdUY3VTQTlh?= =?utf-8?B?MEwvcjJON0YwdFIvd2JmekY2bEQrSXdkRjBTMDBMM2tWQ285bFROMjZSdGlx?= =?utf-8?B?U1FxQlNNOE5CNHkzNHBmVy91R3YveFRMSEdoVm1XNkMxMnU1dmduQktUQ09h?= =?utf-8?B?ZG5LQXFkUExxZ1E0a25XN2V2bVpqb2RFa3F6NjFBeVl6SEFKamd4YXFBYnhj?= =?utf-8?B?SUt0RFlVVTdVUVpJZEtTNlM3QkpVWDJFWmVqaTNiaUhib1BiY0lWeDhzR1hT?= =?utf-8?B?dmlXeGVkd3JTb2JPQ0IyM0VhTUhkUnkyZit1bU9sV0tjNVNxQU5qTEhLbkJM?= =?utf-8?B?azd3WTNQTm9lVEp6OHNhRmxjTzVKbjJXWVBsc2V3YXJrWXZqOUoyZ01UaGpj?= =?utf-8?B?bXVKd0ZTSE5sSHlWVCtNOG1ISUFWZzRJK01helFnT0pITnFQOUI0RVlKb0Uy?= =?utf-8?B?M0NCOHVtY3YzcytzeGp4b0JJQTFEd28vMytxMS9MSTl2Z2RVaUZFOTZyMncx?= =?utf-8?B?U0IydE1UOTJlUVRjVEpoWTR4NW1wWjJKUFFjcU40ajZ0eXRlSTNhNGo0clV3?= =?utf-8?B?VVk1Q3JXNS9GQThKYlR5WTZEK3p3TW56cFVrWXJRVG1ONVJXS3c4WmhTWmla?= =?utf-8?B?blpZUWpEbzN3UUxYaklETjV3MVAzU3F5Yk5xN1dUdFZ4Q0J0V2hRc1k1N1lE?= =?utf-8?B?QzBKV21WZDdoVjY2RS9vMzJNcHpFditWdXRtWXEyT2JrVlhyVU1Mbzg2V0Fw?= =?utf-8?B?Z1VNZmpvcndzLzltc3Jua21CN1dTSHp0MlNWTmxvdlNHUTZFQmcvWXZWYXpJ?= =?utf-8?B?Mk1vdXV2cUpmOEJNcmpJcTJxZklSK1ArUXFUa282Q1laVjlQUld5d2hJbjho?= =?utf-8?B?R2tGRE5jcWhnRGxONE5URkVqT1hqV0ZvS0xpUi9kODY3c3NtS3pxUjAzenNo?= =?utf-8?B?Yzl5Mk5QOWJDZFZNL3h5SmdOMmFCNlhHeFhhdGNSd1FhZ3BLbTE5MlR0WXZj?= =?utf-8?B?bC80MnRWeXR3K3JSdThMWkN1Rms5OXJGaHYrS1FCTFJIYmRwMUJxU1ZkZ2tM?= =?utf-8?B?aDc5THd1UVVKV3FOZFEwajR6NElLMUozaGtzWEdJQisxejRXMmhibTdSNDRo?= =?utf-8?B?UjQ1QzRRSmlyOGw4WnZNTTRmZ0J1aVVucng5cWhTSTJsMjdXaGZQeXl6dGt4?= =?utf-8?B?Q3JRNWdMNGR2NTJsQnJHSDB6dWVRVWV4WmY3WXFtcEx0elE3cVVmVFFSelRv?= =?utf-8?B?UzNqTk4yUXRUV1VwdjhUZW1QVFFrOTFqRGVoRGlPWjFVWmZhcUhuTElHSDZ0?= =?utf-8?B?ZmV4RXhheXhQRTF0elZOV2VYR3lCUnNFc3QrZkgyNXVJSHJWdWJzRFg5RjY5?= =?utf-8?B?NzVFUmxaZ3ladmF5NkFPbWhCTGdVc2pOSzZ3RGJ4QXBoa2k2TWNyMzNLbS9W?= =?utf-8?B?ZVUyRy9yNEszY2p4d3pGbnZXVXRlQ2VLTDJKTGpwc1RiSUFZNTE0S0Z1dVBY?= =?utf-8?B?cmZ0TU4vdE40RlZmQjdPRWpETFluRUxyTjgwbHFkbU96eU1tK1JncjgzQkJi?= =?utf-8?B?U0JLRklLQ1o2VDluVEFOYXJ4T0llNXhkMm1qcElDQm92ZXovWUZqbjI1VHho?= =?utf-8?B?cnZqakRxWWlXVEpSRjNFR3FEZzI0akZQY0dtaVBZT09nWDEySlM2MEo4L1A4?= =?utf-8?B?RGs5UzZCWVdwa0tnbnVnd3FaTDNOQ0YyRGVjekxLdlVVUFlheXViYmR2UXEz?= =?utf-8?B?S3c9PQ==?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: e3a0ae55-47cd-4bd1-eb32-08dc44505e07 X-MS-Exchange-CrossTenant-AuthSource: BY5PR12MB4130.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Mar 2024 17:58:34.6985 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: I6bvdgna41KoFem5NK2ngTBVexsMFRBRCs5W7cHsfJ6RgBSSqYXvBoIs9aCDqzxJZ/5y+jXELCDFrd1nYLN0PA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR12MB4098 X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 1CAE31A0013 X-Stat-Signature: 3to6gy7fetoaj38c7xsdnras5h5rgpc5 X-HE-Tag: 1710439119-596851 X-HE-Meta: U2FsdGVkX1+IwZml8vmdYwSGMRNgyKo7gNah5CwrLbU93bXBmWUo+zDHg//G0KngeS6DPmeyWRR5ejm81SV8r/Ek8cfgFfmnCjp+e7NasW9C5znltWaUcenRzrLZ2D6XuxWB3KGnxyHDVBAnmfEM8BY2Nzkyg9g3eF0A3q7OlgSk0eDCe9NSWIzRLELiAn726U6gp+LCaqVgeL9lgSigAvP03OWGIoG+DGq2ZnCZn7d64RL40SQLp9y5eEqkGCL9HggxMi593XYtR/Gn+2zU97kP1w891rTyABsfar+9V+rfdaSWmnFnQgedyefUiBnRXfK0/iOp+YFX1hVjfWyBd1LgqE8HH9nnCO3s+mtrBbVqI7j0OGPm7pcsj7c2VPkpyAvlK1g9pkbrqjq/qsDu2ZnvyAHYWRiKd9sQ9iTVDeKwB4tilNZP7oBL4oGVSugWk8dLyqmIuDNYuneT9JCYfAQ+KhAUpGH3UsrNct2eWYntbWEEUlL/VoHWbn4yD7in1gFPlCse7OtfSydd6j9uS5B+eeSUhYj8dgb6M32WiHKyviI4Woh4lsGA1bvBmJFRKn7bVOFx7w2bhQyeoEmA4GR4OLSaocg51Wi4F5CB1YyBb2F5rYw0PCt0qsKP9SiPSghYQGGU4hzd0BOQf3HxeqYL+qto+7ocJixF7eip1CjlnzHeXBjMHF3+qmXZCstw4hHHFNCD81st6haJMXe4xY/6nTLc6j8G3mpL71fbQVlXj+unLk5GDLb4T6tJSY0CD5pE54FXlkJrE4210bIBrboo072ITtV2PQtRTTklSM65gJRgegw/OHN+wqRN3L5IDpvmYIPwmooIwGT7ULUYug2BNcf4NQlfKRJQ3e8IZYuyMj/q/1KRgiLDbfiJKrBB4LL4+kwTr6PaEvU/RFZsKR6yyL+qsO1dY2zx+ta7T5ua6JTvC7fyelMh43POYQW6 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 3/14/24 10:45, Matthew Wilcox wrote: > On Wed, Mar 13, 2024 at 07:46:54PM -0700, John Hubbard wrote: >> /* >> * This function splits a huge page into normal pages. @page can point to any > > s/huge page/large folio/ and s/normal/smaller/ ? OK. And yes, I did find that it's getting harder to figure out whether to write "large folio" or "huge page" lately. > >> * subpage of the huge page to split. The split operation does not change the > > Trying to get away from "subpage", maybe "can point to any page within > the folio"? Sure, that works. > > I think following these suggestions throughout the text below will make > it clearer ... Will do. I'll post an actual patch against -rc1 with these and David's corrections. thanks, -- John Hubbard NVIDIA