From nobody Sun Sep 14 08:30:32 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id C9106C54E94 for ; Wed, 25 Jan 2023 17:07:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236069AbjAYRHL (ORCPT ); Wed, 25 Jan 2023 12:07:11 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57930 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236084AbjAYRG6 (ORCPT ); Wed, 25 Jan 2023 12:06:58 -0500 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3F58F5AB56 for ; Wed, 25 Jan 2023 09:06:33 -0800 (PST) Received: from pps.filterd (m0333520.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30PFNj4w009521; Wed, 25 Jan 2023 17:06:14 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=k9Ou4eNZgNrqDC9CsktHGFmSHUS05/MDzuaI34nkS94=; b=kU9vQjFJ/qQYUDydbc6I8CvCgLX7PqEGdEh7pRKCxujMa6evhS3tAo4xqsx/vBkC47sN /uh8k96hVPKH3r/4gWXtInBJl2R46Zdo6YkqPDrO4vhEBiwfFnUyU/GtF8PGS/yf/utP rWxnF/72amaeB6tbF97J1ffhl4f4uDx3AulR34a9JLOfvS9dkmU7vVAg5YGc7MJuGeKb IF2nUW28UHDeUHfVlnxudJ/IMGKQsEQ/vUMYML/2HCon52h4m2JFQ7VAjgV9ca6G12ll 3gdlcKjx0G26kP9MQyxa9kRTCBP/lvuDXgIyB51M/vaCOSIIiWJZoT4RbYgJ/B3XjsRu yQ== Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n883c8jf9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 25 Jan 2023 17:06:13 +0000 Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30PGGDHC019163; Wed, 25 Jan 2023 17:06:09 GMT Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2101.outbound.protection.outlook.com [104.47.58.101]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3n86gd5hn4-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 25 Jan 2023 17:06:09 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=b5D9QgTaoza/JRC/q9nOHq7vBJEeNn+PeQGQawEeFd8yBPuzsBZN01F+pMHImXtkgHIzlJz6HaWDPGIxa5KumVPaqHDJ/GFnEef06OTEPKdsAJ/PsFuQwujtSHMGCvVz4m+J0PIXjbG+Z3Z435Pz/BhW49FSnsRKn3HYzOEeeC6lAcp+ujsELD+slaaqZM9jtP5INuVhTKAkSoLvriYnsVY+CCeyDCWqcW7GuYYpxOPTlk28zkzLo2bHF35vJGYgESByDBdFzQ09a6ERfBPmGH0/YFEJahyRSJyJwnfHdiJDFz63XVztw4UZgHinPZJ2iNLpLTd3qIrmnGt+PEl0DQ== 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=k9Ou4eNZgNrqDC9CsktHGFmSHUS05/MDzuaI34nkS94=; b=Uel6goyUaSBdF0FXFip4MAC4n4Z12kD1a4vxiFVr1HkARi792VPYdv4F1QJqsp9/0kMfzR6zEnq+ZmiFx02DTHwOfipjGBYaP+MrNCgntc6ceq1vI0QBD+mJIxHnk9vwq4Q29UGFkdJs4B6Cp7brtM8aS9HR8Y/u8EyQ8l9bohVDA41jLRHUheaY0LrqeCI27UYvNrG1DfeKdaageiYMxdT5ZBQ+2zxZ6L0XXdor5Htm3mP8CKoXZ0zpUBy4//L5xpd5MU94WWadT8KUdZNLNFj8xq77OGdSlbXkADwWwOBepWA7W2FrBm435zYV2XubhUOx881d3waKnAoWGm6gHg== 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=k9Ou4eNZgNrqDC9CsktHGFmSHUS05/MDzuaI34nkS94=; b=LzEdZil+jLIpjwpykLEW+b2Af6MtTX8FBqy5VfJwZzEo+Jk/j/LdDcq94mdqAXQaV5/Asul6puc9qSLWeM2N/PiUxAFNWAR71oMj4d9KJpfhPJLO9avz2rHTST10v5LWNCJwjbnBOjnjmwZd1pPVdmaXIVeO8k+P2WXVQ35fG20= Received: from DS7PR10MB5117.namprd10.prod.outlook.com (2603:10b6:5:3a6::17) by MN2PR10MB4384.namprd10.prod.outlook.com (2603:10b6:208:198::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.20; Wed, 25 Jan 2023 17:06:07 +0000 Received: from DS7PR10MB5117.namprd10.prod.outlook.com ([fe80::93ca:e22f:aa6d:94d9]) by DS7PR10MB5117.namprd10.prod.outlook.com ([fe80::93ca:e22f:aa6d:94d9%2]) with mapi id 15.20.6043.017; Wed, 25 Jan 2023 17:06:07 +0000 From: Sidhartha Kumar To: linux-kernel@vger.kernel.org, linux-mm@kvack.org Cc: akpm@linux-foundation.org, songmuchun@bytedance.com, mike.kravetz@oracle.com, willy@infradead.org, jhubbard@nvidia.com, gerald.schaefer@linux.ibm.com, Sidhartha Kumar Subject: [PATCH v2 8/8] Documentation/mm: update hugetlbfs documentation to mention alloc_hugetlb_folio Date: Wed, 25 Jan 2023 09:05:37 -0800 Message-Id: <20230125170537.96973-9-sidhartha.kumar@oracle.com> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230125170537.96973-1-sidhartha.kumar@oracle.com> References: <20230125170537.96973-1-sidhartha.kumar@oracle.com> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: BYAPR02CA0039.namprd02.prod.outlook.com (2603:10b6:a03:54::16) To DS7PR10MB5117.namprd10.prod.outlook.com (2603:10b6:5:3a6::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS7PR10MB5117:EE_|MN2PR10MB4384:EE_ X-MS-Office365-Filtering-Correlation-Id: 82001441-0492-40be-a7a6-08dafef67331 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: kJq8bQSJGDYZDqAVZnw1hx7Q3gdFLya899ow5Nl+QJenlujPH1TQubjOetPfSMElnJ4gbzTecTVh16gHFoJb33FK/6vnq0wiVMAjN/IBN3FYDwTx0GMro5LzcFEEKv+maxj95t7szfAQK5no4K4yjqdEQxOrqliNr5jEwpVuj4iJydPcqdAgVFJGFPYNV645k/soVn9dXG8zBNYOgpP6vLL025kBUm8iE1+8CZ9s5Z+TU1kvZN1IZ2OpJifWHAq9wdW4+UptqE3vmcNipuerO//OUR/DVlELYLQhj+tas0ktHC7NV831RrPcGS83PUlBMyBMVbKiD35/9FYNsXJrx+13i7Svbh+kTqYZtw++3HSDpi2mtbzNhTXYH4OJjtEydbPccAf+NsVoRZ6CChROe8NRvcRnPX+QvR9H/nTQ4rdpMhjOw4ocMUuqpHHzsQb9xnLF052loArwBoDOLGDVYPSa8A5t6gErqy68MB1d/0DB9y3Mq3QNMh+GnVqiyKooeErXtaNMKOIoG4xydRFqEBNOjC8cZ7SXcCa4K3v6Ta7pKjGJPqViXMJRf2KVSizvrxmUde6Mmzl2OwkkvUedWuPK09KJ4tdJCDfLcsDNl18G5Ja789lRxj4R7he0DeM0ylhVOmIoEZGuZMHYe0XuGA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:zh-cn;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DS7PR10MB5117.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230025)(366004)(396003)(346002)(376002)(136003)(39860400002)(451199018)(186003)(26005)(6512007)(38100700002)(66946007)(66476007)(66556008)(8676002)(83380400001)(4326008)(8936002)(15650500001)(41300700001)(2906002)(44832011)(107886003)(6486002)(478600001)(5660300002)(6666004)(2616005)(1076003)(6506007)(66574015)(316002)(86362001)(36756003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?ekMxYWM5MHdBempOSEtsemlBWXNrT1ZVS212K0U5RUlPUkhrWDU1Unp4blRy?= =?utf-8?B?N1dSejRPYnc5TlBNaGhYdUNZOUNJWHFXak1pakRoajRSV1lvN0VNT0NoZU9r?= =?utf-8?B?QW9wU213SkV1OUVDbkRvZk9UTWhMckw1Um1yVlZ0aG1Mc2QzSVVHeXloOTU2?= =?utf-8?B?dXViNG8zOGpJem1welovcUtOZFNzVDQxRUs3WHVMeUk4blNiZkFvZG0rT3R1?= =?utf-8?B?WElaUU9yZk5SVGhNM3I4V2NyZDVWZ1R6U3FLZWlaenVaRHJOZ2F5T3QzMWVh?= =?utf-8?B?YVlDWk1WVHE4dEY4YkdKdUlEL2hZNVcxWkh5L3pLR1RWRUw4bWxDVjlpbVRs?= =?utf-8?B?Z1BKU3R5V0Myc0JzN29Hd1ZIK0VpTjRFczZrRTBjRkxEanVUSUgzdjdCR1Bj?= =?utf-8?B?YnhmbTRnV051MnR4YnVHY2JOTHVoMk11eEhsVmxJT3VkdXYrMUszSUROcGlW?= =?utf-8?B?Mmc4UXEyeEJKRGwwLzF0cGd4V3piQ3o2S1M2V0VwNWJEY0UwTisrT3gzdjNP?= =?utf-8?B?eFBPdHQ0TEJnbVpFdllmbGI3ZzJ6Y29ZMWY1dEp6S21zeVAyc1lhT2hmQkFI?= =?utf-8?B?SXI1U2xpM0JVS21LaVZzbGFrTFlFNElyZFBIR0p3K3JDbm5IWnN4ZmlReXg4?= =?utf-8?B?VnZ2REwvWEVaRjd5V0hWR3d1QmZHa1laeVVmMVF6c2kwelF2RDlrSnJKSlJJ?= =?utf-8?B?TnlSbXB2dVYzTnlQdjB2Y0ZUZm5VY1lGTXIwVG5Td0s4SUFRcGNiZ0d3Zjcx?= =?utf-8?B?Tktwb1RuSjB2aDJOWHk3UmhpUGpyaTE0ZDZBRisvSmdBSDBnRGtBbkoyN2pP?= =?utf-8?B?N25lMURuQ21QRHVvSXd0YytnaTFza2thb2pFaWZIam9lSXFJOEFUSDdOY1pL?= =?utf-8?B?aEJ3a0JhZlovS090cHdaeXhiTU1objdSbHE4NDk3ZHRwMjBZdm14c2RoVW1H?= =?utf-8?B?bEFSQ2t2NjdEQ2VsTjBkL0ZRTG1xL3lZZnN2RWFjY3FjSlZsVGlDSmw4VG5m?= =?utf-8?B?Q282a1BHeW95c1diUGZRSmUvN0ZTOUM4Tmpmd0ZVNXc3S0lJZ3dHbndnc3VY?= =?utf-8?B?L2x3ZXNObm9XTzVFZGlsdTF1L0JIZHRMcm5HYTRzNmpSUGV3c0V5VnpVc2VO?= =?utf-8?B?ZnFydCtjMVN3ZHBsS3ZCSEd4Zk1Gb3BzeEx2RWVveXpKUVYxckxvdUVISmxm?= =?utf-8?B?L0R0K0M2T2N0K2k3S2lna0w5VW9HN1FqTHdlZ25RcEZseEgrOEZ0amRvdEJ4?= =?utf-8?B?S0tyVEVDSDNTeVdDK3VHQlgwRVlvMXlFWW1yQU9DQjlPTktjQi81Z0RKOFYz?= =?utf-8?B?UmR3Yi9RY2dVZ0FqMUhsSGdJb0RxWitzWWV1Mkg4U2xTM0Zhdzd0QVFGSUZX?= =?utf-8?B?ZDhLZjE5aVRoOXNEQ1FCeWRZY3pQaUxTRytDOWJzY1h4cVI3eEdZVVI1blZD?= =?utf-8?B?cFE2N01nc3ljL1VXMHgvVmFtYmZFTVdBQktURXI3dnY4QjZsK0hwejRKVHNz?= =?utf-8?B?Z094TFVZSnMyUWorSk05N0JtbmVUVW5VdGhhTGNZaVYxNWg0d05CMXdxTExY?= =?utf-8?B?a1l4REVYSVFidHpjRlJwaXF4QTNRY3hiWWFzREd3SmNLUm5HeGtsWXBEamp0?= =?utf-8?B?TXdmQlAydDFWQ1djY2Z0cm1LSWtWSGtJbllKZFZYQ25EQ1Q0M0FaQXBleFJG?= =?utf-8?B?OEFHSk4wQkhTT0RoU3N2WFZrMWp6Uy9wN3N6VmFWZUgxdlA1WDVZK0tRSyti?= =?utf-8?B?dVpkbGVVcXY1eXMyOUE4U21Ha0RudkhvOGJYa3FiN1d0RndtRGhFL2RhNVR0?= =?utf-8?B?ckp2MVE4aDdEUDhxdFE4SHNGbkkrQi9OaVJHV0dRZG00dEVzSExnU3hWR21H?= =?utf-8?B?K2VJSjVEZ1lKSUNDTFpLcmpqaytPR2hTdXQwb05tTnozYjY3ajEzNmZjVWd6?= =?utf-8?B?eUJXRGpmNlU4dzEvK1NIL0w1SktJZkxuZ0o0SzZVSUp1NG1aeGR3YzkrTUpM?= =?utf-8?B?b1A3OFRtY0Q1UGJCTE45WjB3b0d6TlkzWitXYUdCWk9mSHZhYnFtSDBoaEhr?= =?utf-8?B?SFNXeStXMWpDMTlnTFk1VFRvUVphWWpDN0lCV3d6aGIvNzdJckRiUmhxT292?= =?utf-8?B?dDVta2NJdGV1aUd2MWZtWXQrbmJab1Bqd1ZPV0ZCZS9WK0JtWGJHTjE0cHFD?= =?utf-8?B?OVE9PQ==?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: =?utf-8?B?L21EZUhEVDF1d0pHQXpXaWQyeTAvVU0yQVExSDU0VWxhS0dabUJuYWRrNUNj?= =?utf-8?B?VDlHdzBtK1lkZDFvTmlFaFo1RElraG9NRU5kVkcrNVRQcmRtdDZ0Mk00b2NB?= =?utf-8?B?akR3d2hRTmlEOW9Hd3BQQUszdXJ3ZEhWbEw5NW9HMWtzdGFwb0RPVmVYU0ph?= =?utf-8?B?Ly9CRXBDOUxEam1vZkFxY2hLZSt2R2dML1p4WGVMdlJYTjNaY0hLRnptelZL?= =?utf-8?B?Y2JBeDdISkQ3MU9qN2JGVTZmcnk4ZHdmRUxnSlNxTXFrK2F1eThKOFd5UDhQ?= =?utf-8?B?N25JWk1tSkFGd2lnWlFQTEtOZDNZUGFqcU5LcFFjdU5qUVhtR0YrbG1rU2or?= =?utf-8?B?RUZhWk1FR28rYmZicFBVZ1FQQUVQa3lvVUJLQVR5Y2t4NVpOMmJmdUxCN0JG?= =?utf-8?B?VXZua3R5ZTBvMmZ5NmJ2REwwVDVBY1ltMGszZENvOWhwZTY3Wmp2dnJtVmhI?= =?utf-8?B?bWt1NjlmbmJYa0NqeHJ4MlhMaVAydVlkb1VCSCt2c3NMRXJTc09JL0xhZXhX?= =?utf-8?B?ZXl2NWhOOGMvN3NVOFBwa0w1WkZubXNWbytSSEZjTy8xUmNIREhERTVsTDRw?= =?utf-8?B?VkF3S3RZd3pyajY5N1FxQXlUK3BLQ3M5RC9FMzdmNGVUdHVDVkVUZW9xRS9N?= =?utf-8?B?MExhb2FjUVhJcEdjRUcyUzB3YzJXMGJxbnpPRVRvaTBSa3I0eDdVMmpBa2Rp?= =?utf-8?B?RUROL0FFZlFMb2tiamRmTWNIYWZyaTFDYnhNVkpFQkhQTUNBMmZ2cUlEN2tD?= =?utf-8?B?dnY4dDZmMWorZk93eldQSndHU1ZoYW9EMXkvalROdU1lemNkendweHJtYUha?= =?utf-8?B?Q2Y1Y2FmTUs5dFd0c2xKaExqcEwzUWNqRXdxQWc5SmpDS2t2MTBGc1lFRUNR?= =?utf-8?B?MVZGT2pFMjYwZU92d2ZxTmRlM0RyZGlxZ25QZWRZTGdkbENPN1BiUDZvbmJQ?= =?utf-8?B?VUVTbHg5dmxndzNMdlVVMW9vQWwwZHRQVXpmS0dPd1lkQmMxYmxaN3k4WVU0?= =?utf-8?B?a3QybEVFSFlRS0NyUFZmOGtseXJ1bU0yN0hDdi9IdWpIWlEwb0Z5T1lHYmdk?= =?utf-8?B?Vmo3K3pCdlFScmxkRHMwdDd4VDd5VE91ZDQyY0R1bFhrdEtTQnpqTWs3R0xi?= =?utf-8?B?ZTFZNDNNOFdYbDJ4SEtYejdJNEsxYlZqVHgzVWU0ZHdsOTdWY21sOWlqUHJC?= =?utf-8?B?djRVeFBWNktqYUpucU9HTlZkRnA1V1JGVWtNalVDcDVxWDFBU0F1amIzTzVq?= =?utf-8?B?NEJucm5OMWc0RjJHLy9pbUtMaU5UdjFsa3pZeWdFQWVGT04wNnYvVjVoU2I3?= =?utf-8?Q?B7N+nQVmFvBas=3D?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 82001441-0492-40be-a7a6-08dafef67331 X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5117.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Jan 2023 17:06:07.6244 (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: smKWXfr8g+q7OiBlK7jcb7duTZFN0GKvLR98pehHC4Y/N/QVP8Upd5tUI0zSB1K3BtlhAg50BmmKIZ77LoKzFC4dO82ARlygJsQGh9vjJbk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR10MB4384 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.930,Hydra:6.0.562,FMLib:17.11.122.1 definitions=2023-01-25_11,2023-01-25_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 mlxlogscore=999 adultscore=0 mlxscore=0 suspectscore=0 spamscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301250152 X-Proofpoint-ORIG-GUID: Vlw7kiCJ9H6_bVndrEOg8GZCmStiFpAX X-Proofpoint-GUID: Vlw7kiCJ9H6_bVndrEOg8GZCmStiFpAX Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Signed-off-by: Sidhartha Kumar --- Documentation/mm/hugetlbfs_reserv.rst | 21 ++++++++++--------- .../zh_CN/mm/hugetlbfs_reserv.rst | 14 ++++++------- 2 files changed, 18 insertions(+), 17 deletions(-) diff --git a/Documentation/mm/hugetlbfs_reserv.rst b/Documentation/mm/huget= lbfs_reserv.rst index f143954e0d05..611728c49bff 100644 --- a/Documentation/mm/hugetlbfs_reserv.rst +++ b/Documentation/mm/hugetlbfs_reserv.rst @@ -181,14 +181,14 @@ Consuming Reservations/Allocating a Huge Page =20 Reservations are consumed when huge pages associated with the reservations are allocated and instantiated in the corresponding mapping. The allocati= on -is performed within the routine alloc_huge_page():: +is performed within the routine alloc_hugetlb_folio():: =20 - struct page *alloc_huge_page(struct vm_area_struct *vma, + struct folio *alloc_hugetlb_folio(struct vm_area_struct *vma, unsigned long addr, int avoid_reserve) =20 -alloc_huge_page is passed a VMA pointer and a virtual address, so it can +alloc_hugetlb_folio is passed a VMA pointer and a virtual address, so it c= an consult the reservation map to determine if a reservation exists. In addi= tion, -alloc_huge_page takes the argument avoid_reserve which indicates reserves +alloc_hugetlb_folio takes the argument avoid_reserve which indicates reser= ves should not be used even if it appears they have been set aside for the specified address. The avoid_reserve argument is most often used in the c= ase of Copy on Write and Page Migration where additional copies of an existing @@ -208,7 +208,8 @@ a reservation for the allocation. After determining wh= ether a reservation exists and can be used for the allocation, the routine dequeue_huge_page_v= ma() is called. This routine takes two arguments related to reservations: =20 -- avoid_reserve, this is the same value/argument passed to alloc_huge_page= () +- avoid_reserve, this is the same value/argument passed to + alloc_hugetlb_folio(). - chg, even though this argument is of type long only the values 0 or 1 are passed to dequeue_huge_page_vma. If the value is 0, it indicates a reservation exists (see the section "Memory Policy and Reservations" for @@ -233,9 +234,9 @@ the scope reservations. Even if a surplus page is allo= cated, the same reservation based adjustments as above will be made: SetPagePrivate(page) = and resv_huge_pages--. =20 -After obtaining a new huge page, (page)->private is set to the value of -the subpool associated with the page if it exists. This will be used for -subpool accounting when the page is freed. +After obtaining a new hugetlb folio, (folio)->_hugetlb_subpool is set to t= he +value of the subpool associated with the page if it exists. This will be = used +for subpool accounting when the folio is freed. =20 The routine vma_commit_reservation() is then called to adjust the reserve map based on the consumption of the reservation. In general, this involves @@ -246,8 +247,8 @@ was no reservation in a shared mapping or this was a pr= ivate mapping a new entry must be created. =20 It is possible that the reserve map could have been changed between the ca= ll -to vma_needs_reservation() at the beginning of alloc_huge_page() and the -call to vma_commit_reservation() after the page was allocated. This would +to vma_needs_reservation() at the beginning of alloc_hugetlb_folio() and t= he +call to vma_commit_reservation() after the folio was allocated. This would be possible if hugetlb_reserve_pages was called for the same page in a sha= red mapping. In such cases, the reservation count and subpool free page count will be off by one. This rare condition can be identified by comparing the diff --git a/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst b/Doc= umentation/translations/zh_CN/mm/hugetlbfs_reserv.rst index 752e5696cd47..826a50c47389 100644 --- a/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst +++ b/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst @@ -142,14 +142,14 @@ HPAGE_RESV_OWNER=E6=A0=87=E5=BF=97=E8=A2=AB=E8=AE=BE= =E7=BD=AE=EF=BC=8C=E4=BB=A5=E8=A1=A8=E6=98=8E=E8=AF=A5VMA=E6=8B=A5=E6=9C=89= =E9=A2=84=E7=95=99=E3=80=82 =E6=B6=88=E8=80=97=E9=A2=84=E7=95=99/=E5=88=86=E9=85=8D=E4=B8=80=E4=B8=AA= =E5=B7=A8=E9=A1=B5 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D =20 -=E5=BD=93=E4=B8=8E=E9=A2=84=E7=95=99=E7=9B=B8=E5=85=B3=E7=9A=84=E5=B7=A8= =E9=A1=B5=E5=9C=A8=E7=9B=B8=E5=BA=94=E7=9A=84=E6=98=A0=E5=B0=84=E4=B8=AD=E8= =A2=AB=E5=88=86=E9=85=8D=E5=92=8C=E5=AE=9E=E4=BE=8B=E5=8C=96=E6=97=B6=EF=BC= =8C=E9=A2=84=E7=95=99=E5=B0=B1=E8=A2=AB=E6=B6=88=E8=80=97=E4=BA=86=E3=80=82= =E8=AF=A5=E5=88=86=E9=85=8D=E6=98=AF=E5=9C=A8=E5=87=BD=E6=95=B0alloc_huge_p= age() +=E5=BD=93=E4=B8=8E=E9=A2=84=E7=95=99=E7=9B=B8=E5=85=B3=E7=9A=84=E5=B7=A8= =E9=A1=B5=E5=9C=A8=E7=9B=B8=E5=BA=94=E7=9A=84=E6=98=A0=E5=B0=84=E4=B8=AD=E8= =A2=AB=E5=88=86=E9=85=8D=E5=92=8C=E5=AE=9E=E4=BE=8B=E5=8C=96=E6=97=B6=EF=BC= =8C=E9=A2=84=E7=95=99=E5=B0=B1=E8=A2=AB=E6=B6=88=E8=80=97=E4=BA=86=E3=80=82= =E8=AF=A5=E5=88=86=E9=85=8D=E6=98=AF=E5=9C=A8=E5=87=BD=E6=95=B0alloc_hugetl= b_folio() =E4=B8=AD=E8=BF=9B=E8=A1=8C=E7=9A=84:: =20 - struct page *alloc_huge_page(struct vm_area_struct *vma, + struct folio *alloc_hugetlb_folio(struct vm_area_struct *vma, unsigned long addr, int avoid_reserve) =20 -alloc_huge_page=E8=A2=AB=E4=BC=A0=E9=80=92=E7=BB=99=E4=B8=80=E4=B8=AAVMA= =E6=8C=87=E9=92=88=E5=92=8C=E4=B8=80=E4=B8=AA=E8=99=9A=E6=8B=9F=E5=9C=B0=E5= =9D=80=EF=BC=8C=E5=9B=A0=E6=AD=A4=E5=AE=83=E5=8F=AF=E4=BB=A5=E6=9F=A5=E9=98= =85=E9=A2=84=E7=95=99=E6=98=A0=E5=B0=84=E4=BB=A5=E7=A1=AE=E5=AE=9A=E6=98=AF= =E5=90=A6=E5=AD=98=E5=9C=A8=E9=A2=84=E7=95=99=E3=80=82 -=E6=AD=A4=E5=A4=96=EF=BC=8Calloc_huge_page=E9=9C=80=E8=A6=81=E4=B8=80=E4= =B8=AA=E5=8F=82=E6=95=B0avoid_reserve=EF=BC=8C=E8=AF=A5=E5=8F=82=E6=95=B0= =E8=A1=A8=E7=A4=BA=E5=8D=B3=E4=BD=BF=E7=9C=8B=E8=B5=B7=E6=9D=A5=E5=B7=B2=E7= =BB=8F=E4=B8=BA=E6=8C=87=E5=AE=9A=E7=9A=84=E5=9C=B0=E5=9D=80=E9=A2=84=E7=95= =99=E4=BA=86 +alloc_hugetlb_folio=E8=A2=AB=E4=BC=A0=E9=80=92=E7=BB=99=E4=B8=80=E4=B8=AAV= MA=E6=8C=87=E9=92=88=E5=92=8C=E4=B8=80=E4=B8=AA=E8=99=9A=E6=8B=9F=E5=9C=B0= =E5=9D=80=EF=BC=8C=E5=9B=A0=E6=AD=A4=E5=AE=83=E5=8F=AF=E4=BB=A5=E6=9F=A5=E9= =98=85=E9=A2=84=E7=95=99=E6=98=A0=E5=B0=84=E4=BB=A5=E7=A1=AE=E5=AE=9A=E6=98= =AF=E5=90=A6=E5=AD=98=E5=9C=A8=E9=A2=84=E7=95=99=E3=80=82 +=E6=AD=A4=E5=A4=96=EF=BC=8Calloc_hugetlb_folio=E9=9C=80=E8=A6=81=E4=B8=80= =E4=B8=AA=E5=8F=82=E6=95=B0avoid_reserve=EF=BC=8C=E8=AF=A5=E5=8F=82=E6=95= =B0=E8=A1=A8=E7=A4=BA=E5=8D=B3=E4=BD=BF=E7=9C=8B=E8=B5=B7=E6=9D=A5=E5=B7=B2= =E7=BB=8F=E4=B8=BA=E6=8C=87=E5=AE=9A=E7=9A=84=E5=9C=B0=E5=9D=80=E9=A2=84=E7= =95=99=E4=BA=86 =E9=A2=84=E7=95=99=EF=BC=8C=E4=B9=9F=E4=B8=8D=E5=BA=94=E8=AF=A5=E4=BD=BF= =E7=94=A8=E9=A2=84=E7=95=99=E3=80=82avoid_reserve=E5=8F=82=E6=95=B0=E6=9C= =80=E5=B8=B8=E8=A2=AB=E7=94=A8=E4=BA=8E=E5=86=99=E6=97=B6=E6=8B=B7=E8=B4=9D= =E5=92=8C=E9=A1=B5=E9=9D=A2=E8=BF=81=E7=A7=BB=E7=9A=84=E6=83=85=E5=86=B5=E4= =B8=8B=EF=BC=8C=E5=8D=B3=E7=8E=B0=E6=9C=89=E9=A1=B5=E9=9D=A2=E7=9A=84=E9=A2= =9D =E5=A4=96=E6=8B=B7=E8=B4=9D=E8=A2=AB=E5=88=86=E9=85=8D=E3=80=82 =20 @@ -162,7 +162,7 @@ vma_needs_reservation()=E8=BF=94=E5=9B=9E=E7=9A=84=E5= =80=BC=E9=80=9A=E5=B8=B8=E4=B8=BA0=E6=88=961=E3=80=82=E5=A6=82=E6=9E=9C=E8= =AF=A5=E5=9C=B0=E5=9D=80=E5=AD=98=E5=9C=A8=E9=A2=84=E7=95=99 =E7=A1=AE=E5=AE=9A=E9=A2=84=E7=95=99=E6=98=AF=E5=90=A6=E5=AD=98=E5=9C=A8= =E5=B9=B6=E5=8F=AF=E7=94=A8=E4=BA=8E=E5=88=86=E9=85=8D=E5=90=8E=EF=BC=8C=E8= =B0=83=E7=94=A8dequeue_huge_page_vma()=E5=87=BD=E6=95=B0=E3=80=82=E8=BF=99= =E4=B8=AA=E5=87=BD=E6=95=B0=E9=9C=80=E8=A6=81=E4=B8=A4=E4=B8=AA=E4=B8=8E=E9= =A2=84=E7=95=99=E6=9C=89=E5=85=B3 =E7=9A=84=E5=8F=82=E6=95=B0=EF=BC=9A =20 -- avoid_reserve=EF=BC=8C=E8=BF=99=E6=98=AF=E4=BC=A0=E9=80=92=E7=BB=99alloc= _huge_page()=E7=9A=84=E5=90=8C=E4=B8=80=E4=B8=AA=E5=80=BC/=E5=8F=82=E6=95= =B0=E3=80=82 +- avoid_reserve=EF=BC=8C=E8=BF=99=E6=98=AF=E4=BC=A0=E9=80=92=E7=BB=99alloc= _hugetlb_folio()=E7=9A=84=E5=90=8C=E4=B8=80=E4=B8=AA=E5=80=BC/=E5=8F=82=E6= =95=B0=E3=80=82 - chg=EF=BC=8C=E5=B0=BD=E7=AE=A1=E8=BF=99=E4=B8=AA=E5=8F=82=E6=95=B0=E7=9A= =84=E7=B1=BB=E5=9E=8B=E6=98=AFlong=EF=BC=8C=E4=BD=86=E5=8F=AA=E6=9C=890=E6= =88=961=E7=9A=84=E5=80=BC=E8=A2=AB=E4=BC=A0=E9=80=92=E7=BB=99dequeue_huge_p= age_vma=E3=80=82=E5=A6=82=E6=9E=9C=E8=AF=A5=E5=80=BC=E4=B8=BA0=EF=BC=8C =E5=88=99=E8=A1=A8=E6=98=8E=E5=AD=98=E5=9C=A8=E9=A2=84=E7=95=99=EF=BC=88= =E5=85=B3=E4=BA=8E=E5=8F=AF=E8=83=BD=E7=9A=84=E9=97=AE=E9=A2=98=EF=BC=8C=E8= =AF=B7=E5=8F=82=E8=A7=81 =E2=80=9C=E9=A2=84=E7=95=99=E5=92=8C=E5=86=85=E5= =AD=98=E7=AD=96=E7=95=A5=E2=80=9D =E4=B8=80=E8=8A=82=EF=BC=89=E3=80=82=E5= =A6=82=E6=9E=9C=E5=80=BC =E4=B8=BA1=EF=BC=8C=E5=88=99=E8=A1=A8=E7=A4=BA=E4=B8=8D=E5=AD=98=E5=9C= =A8=E9=A2=84=E7=95=99=EF=BC=8C=E5=A6=82=E6=9E=9C=E5=8F=AF=E8=83=BD=E7=9A=84= =E8=AF=9D=EF=BC=8C=E5=BF=85=E9=A1=BB=E4=BB=8E=E5=85=A8=E5=B1=80=E7=A9=BA=E9= =97=B2=E6=B1=A0=E4=B8=AD=E5=8F=96=E5=87=BA=E8=AF=A5=E9=A1=B5=E3=80=82 @@ -179,7 +179,7 @@ free_huge_pages=E7=9A=84=E5=80=BC=E8=A2=AB=E9=80=92=E5= =87=8F=E3=80=82=E5=A6=82=E6=9E=9C=E6=9C=89=E4=B8=80=E4=B8=AA=E4=B8=8E=E8=AF= =A5=E9=A1=B5=E7=9B=B8=E5=85=B3=E7=9A=84=E9=A2=84=E7=95=99=EF=BC=8C=E5=B0=86 =E7=9A=84=E5=89=A9=E4=BD=99=E5=B7=A8=E9=A1=B5=E5=92=8C=E8=B6=85=E9=A2=9D= =E5=88=86=E9=85=8D=E7=9A=84=E9=97=AE=E9=A2=98=E3=80=82=E5=8D=B3=E4=BD=BF=E5= =88=86=E9=85=8D=E4=BA=86=E4=B8=80=E4=B8=AA=E5=A4=9A=E4=BD=99=E7=9A=84=E9=A1= =B5=E9=9D=A2=EF=BC=8C=E4=B9=9F=E4=BC=9A=E8=BF=9B=E8=A1=8C=E4=B8=8E=E4=B8=8A= =E9=9D=A2=E4=B8=80=E6=A0=B7=E7=9A=84=E5=9F=BA=E4=BA=8E=E9=A2=84=E7=95=99=E7= =9A=84=E8=B0=83=E6=95=B4: SetPagePrivate(page) =E5=92=8C resv_huge_pages--. =20 -=E5=9C=A8=E8=8E=B7=E5=BE=97=E4=B8=80=E4=B8=AA=E6=96=B0=E7=9A=84=E5=B7=A8= =E9=A1=B5=E5=90=8E=EF=BC=8C(page)->private=E8=A2=AB=E8=AE=BE=E7=BD=AE=E4=B8= =BA=E4=B8=8E=E8=AF=A5=E9=A1=B5=E9=9D=A2=E7=9B=B8=E5=85=B3=E7=9A=84=E5=AD=90= =E6=B1=A0=E7=9A=84=E5=80=BC=EF=BC=8C=E5=A6=82=E6=9E=9C=E5=AE=83=E5=AD=98=E5= =9C=A8=E7=9A=84=E8=AF=9D=E3=80=82=E5=BD=93=E9=A1=B5 +=E5=9C=A8=E8=8E=B7=E5=BE=97=E4=B8=80=E4=B8=AA=E6=96=B0=E7=9A=84=E5=B7=A8= =E9=A1=B5=E5=90=8E=EF=BC=8C(folio)->_hugetlb_subpool=E8=A2=AB=E8=AE=BE=E7= =BD=AE=E4=B8=BA=E4=B8=8E=E8=AF=A5=E9=A1=B5=E9=9D=A2=E7=9B=B8=E5=85=B3=E7=9A= =84=E5=AD=90=E6=B1=A0=E7=9A=84=E5=80=BC=EF=BC=8C=E5=A6=82=E6=9E=9C=E5=AE=83= =E5=AD=98=E5=9C=A8=E7=9A=84=E8=AF=9D=E3=80=82=E5=BD=93=E9=A1=B5 =E9=9D=A2=E8=A2=AB=E9=87=8A=E6=94=BE=E6=97=B6=EF=BC=8C=E8=BF=99=E5=B0=86= =E8=A2=AB=E7=94=A8=E4=BA=8E=E5=AD=90=E6=B1=A0=E7=9A=84=E8=AE=A1=E6=95=B0=E3= =80=82 =20 =E7=84=B6=E5=90=8E=E8=B0=83=E7=94=A8=E5=87=BD=E6=95=B0vma_commit_reservati= on()=EF=BC=8C=E6=A0=B9=E6=8D=AE=E9=A2=84=E7=95=99=E7=9A=84=E6=B6=88=E8=80= =97=E6=83=85=E5=86=B5=E8=B0=83=E6=95=B4=E9=A2=84=E7=95=99=E6=98=A0=E5=B0=84= =E3=80=82=E4=B8=80=E8=88=AC=E6=9D=A5=E8=AF=B4=EF=BC=8C=E8=BF=99=E6=B6=89=E5= =8F=8A @@ -199,7 +199,7 @@ SetPagePrivate(page)=E5=92=8Cresv_huge_pages-=E3=80=82 =E5=B7=B2=E7=BB=8F=E5=AD=98=E5=9C=A8=EF=BC=8C=E6=89=80=E4=BB=A5=E4=B8=8D= =E5=81=9A=E4=BB=BB=E4=BD=95=E6=94=B9=E5=8F=98=E3=80=82=E7=84=B6=E8=80=8C=EF= =BC=8C=E5=A6=82=E6=9E=9C=E5=85=B1=E4=BA=AB=E6=98=A0=E5=B0=84=E4=B8=AD=E6=B2= =A1=E6=9C=89=E9=A2=84=E7=95=99=EF=BC=8C=E6=88=96=E8=80=85=E8=BF=99=E6=98=AF= =E4=B8=80=E4=B8=AA=E7=A7=81=E6=9C=89=E6=98=A0=E5=B0=84=EF=BC=8C=E5=88=99=E5= =BF=85=E9=A1=BB=E5=88=9B=E5=BB=BA =E4=B8=80=E4=B8=AA=E6=96=B0=E7=9A=84=E6=9D=A1=E7=9B=AE=E3=80=82 =20 -=E5=9C=A8alloc_huge_page()=E5=BC=80=E5=A7=8B=E8=B0=83=E7=94=A8vma_needs_re= servation()=E5=92=8C=E9=A1=B5=E9=9D=A2=E5=88=86=E9=85=8D=E5=90=8E=E8=B0=83= =E7=94=A8 +=E5=9C=A8alloc_hugetlb_folio()=E5=BC=80=E5=A7=8B=E8=B0=83=E7=94=A8vma_need= s_reservation()=E5=92=8C=E9=A1=B5=E9=9D=A2=E5=88=86=E9=85=8D=E5=90=8E=E8=B0= =83=E7=94=A8 vma_commit_reservation()=E4=B9=8B=E9=97=B4=EF=BC=8C=E9=A2=84=E7=95=99=E6= =98=A0=E5=B0=84=E6=9C=89=E5=8F=AF=E8=83=BD=E8=A2=AB=E6=94=B9=E5=8F=98=E3=80= =82=E5=A6=82=E6=9E=9Chugetlb_reserve_pages=E5=9C=A8=E5=85=B1 =E4=BA=AB=E6=98=A0=E5=B0=84=E4=B8=AD=E4=B8=BA=E5=90=8C=E4=B8=80=E9=A1=B5= =E9=9D=A2=E8=A2=AB=E8=B0=83=E7=94=A8=EF=BC=8C=E8=BF=99=E5=B0=86=E6=98=AF=E5= =8F=AF=E8=83=BD=E7=9A=84=E3=80=82=E5=9C=A8=E8=BF=99=E7=A7=8D=E6=83=85=E5=86= =B5=E4=B8=8B=EF=BC=8C=E9=A2=84=E7=95=99=E8=AE=A1=E6=95=B0=E5=92=8C=E5=AD=90= =E6=B1=A0=E7=A9=BA=E9=97=B2=E9=A1=B5=E8=AE=A1=E6=95=B0=E4=BC=9A=E6=9C=89=E4= =B8=80=E4=B8=AA=E5=81=8F=E5=B7=AE=E3=80=82 =E8=BF=99=E7=A7=8D=E7=BD=95=E8=A7=81=E7=9A=84=E6=83=85=E5=86=B5=E5=8F=AF= =E4=BB=A5=E9=80=9A=E8=BF=87=E6=AF=94=E8=BE=83vma_needs_reservation=E5=92=8C= vma_commit_reservation=E7=9A=84=E8=BF=94=E5=9B=9E=E5=80=BC=E6=9D=A5 --=20 2.39.1