From nobody Sun Sep 14 18:25:16 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 AC805C004D4 for ; Thu, 19 Jan 2023 21:24:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229924AbjASVYK (ORCPT ); Thu, 19 Jan 2023 16:24:10 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38072 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229461AbjASVWA (ORCPT ); Thu, 19 Jan 2023 16:22:00 -0500 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8EADCA1014 for ; Thu, 19 Jan 2023 13:15:46 -0800 (PST) Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30JKwx6L008067; Thu, 19 Jan 2023 21:15:29 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=8YPmBgiWXHv6nshpCJp4+H8Ty8HRSgwtJRlGF4JM4EY=; b=khvChgNxrgMXeqe22fvI+I+KrESMTEsHyArPzt1Kddn7SmTTwGVqDB5Mv0FKFK3tfG3k IHiuFYNVg7dHidiP71s68gRfbNMKw6+MyQn4eHlA8Nk7sifl4Pj+IFt1LBgQs/upksdk XUojjGnsKbEy8ZQDT+oL9+WDPRc+O8UAk3gJ6z/0WgapyPPQE0YG9U/gx8Ou6FWviarR 9z/Y92g6z2DO/KsC01bfJ017LFz91wraINrgRbvg6FLS416xSq1EA+tHguUAicEWjNMn HHeGPfWJKNy5GyQxbr5UdnHGwH8s9kKBKZWhf43HBbwbhx+geOTBGhDDYX0fEayiyz3h IA== Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n78958xa6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 19 Jan 2023 21:15:29 +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 30JJb3dh004704; Thu, 19 Jan 2023 21:15:29 GMT Received: from nam04-bn8-obe.outbound.protection.outlook.com (mail-bn8nam04lp2043.outbound.protection.outlook.com [104.47.74.43]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3n6r2v088m-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 19 Jan 2023 21:15:29 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GzRHy9A/itwLFxpVgKayhawUN2lP19y5iJGP8Rl1EcsrZN8cp0JARYNdCgn8VHgjKs0V3MT6hyoAjdY1hiuJktG7qhUL7N0mbKwc1btHz9mGeq8vgqXvF0neCAPue0p8qzDtHMtBLZEzV//fCRW/qH3kU75vEicxvmzu88bqkEOOuEo4+NnA2FCi7BlhYaUoYCP8yEob2BJefwqV2Vd5ZG3pd2vf/kM72/oLFBL1/dKxs96IDwNlUo3BGGL6BLN5xBPkr3XwBSo7TuZ4PB2sY5ymkvz+pYS7Cv3S/j1YErR2n3IREiOBwpmZ2UhigHffOkRnEHy5vzQDc7kItQ6oCA== 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=8YPmBgiWXHv6nshpCJp4+H8Ty8HRSgwtJRlGF4JM4EY=; b=VkBAuyQ5d6+IVbNRwtfQSLUJsYbkBzpshsidGYWquvIPfSVGCsbGQ55MH3DvGWvZjHJZPNyKR6WfOCIw4GC6nbzxkx94BWzYIh4RKe9s1oHl/6a13pO38VWULM/T8fbjVEnI61OKWMopmrEkk4K0PL2PtDVqMbB4N8eUSNXE3fPHF3IBwK6fcZpo72+lj+V7mrJjf9PfJp0LwXlCc7hF9uwCOW++bPWVxvxOqGY83OrpTQ85PrStGiZWUCHZ2jYXMgCUCzNtIP4/qc9Xhvo7xiCpDXEMNcUh8J7aLbpPDwUZiXRm36DH+cV6TOWkeT9tVTsCTM37wZtqqvhUGjDV1w== 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=8YPmBgiWXHv6nshpCJp4+H8Ty8HRSgwtJRlGF4JM4EY=; b=ZysFuDSzfhJulQkRCWN5mqttdXCP0X+Lcygc47Cup4kYLmpnqkgh/KeJOrWjqhSNM63pd+8M8ixmazzWf04QgDmTvGwGS0nzd5YyJDayPExY4k4RHyTJchz8sxi8n5nMrLY3mZKePp8+hGZMwPXqaYzb+lfdCE+ulZqhzOkHxdo= Received: from DS7PR10MB5117.namprd10.prod.outlook.com (2603:10b6:5:3a6::17) by SJ0PR10MB5600.namprd10.prod.outlook.com (2603:10b6:a03:3dc::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.24; Thu, 19 Jan 2023 21:15:26 +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.6002.011; Thu, 19 Jan 2023 21:15:26 +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, Sidhartha Kumar Subject: [PATCH 9/9] Documentation/mm: update hugetlbfs documentation to mention alloc_hugetlb_folio Date: Thu, 19 Jan 2023 13:14:46 -0800 Message-Id: <20230119211446.54165-10-sidhartha.kumar@oracle.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230119211446.54165-1-sidhartha.kumar@oracle.com> References: <20230119211446.54165-1-sidhartha.kumar@oracle.com> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: SJ0PR05CA0158.namprd05.prod.outlook.com (2603:10b6:a03:339::13) To DS7PR10MB5117.namprd10.prod.outlook.com (2603:10b6:5:3a6::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS7PR10MB5117:EE_|SJ0PR10MB5600:EE_ X-MS-Office365-Filtering-Correlation-Id: fafc298b-5b38-427d-4351-08dafa6248fc X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: ONeavsU7A7ykjoRuUpzt7m35SIiIJVwpufzluAsch8q6Nnh420heKnL5ZhBNkckfbDprN7xabLKCMRg1anPm9Ri+qadC4vfs4ghqRWaMSfJ0Ehw1AOm5i5dXy2wuER4DpIIhzyNpGfec3swS4lMrrRiddu5mvsNS0OZctur67zU5Oa2rVxZvVYvUm59G5YRJHXZgcfs5LFjbro+FsWd0+JmtzpSAFoVawgDE4nokE9cnXd7q9B60NilDj5cdcTp8ZSJCshsK1qVaZwVu3mWiQ10TV7bDZpphhMjRzbgLtSQJmpyeCxmvWpo2UkxTjKPUcDEj6JkJrg1GmveRZR60o3zrlBQEGpf3kes2OnSxXrUKJC1KfNAElf0b7iaTRVMJOLBTdLh04/SgK4w1eFOBfoTxN5PLPuFA6OZIjJT+/hjPD8FNrobi0v//cYZ8fh4kihwVdWAEAqrq27f0t8R2hZdFXHZsonvPQGQiU5JJ2GUmCx/ONtgbmc17ZnPufVUdAgZ5lE9Scpt5NN2qiqFhbjWmoAjACt7ADnSrcT1N5wH5Xo+i6fHeyxf9f/PyqI94XEujWCHc+03Joe8jGK1EyizELSmglbrR+pJAZhsPWxDSyrcX6b0EzqYLOZTstj3Qsz8+50TKeG18Q2JTfsfbWw== 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:(13230022)(366004)(346002)(396003)(136003)(39860400002)(376002)(451199015)(66946007)(38100700002)(66556008)(66476007)(478600001)(8936002)(44832011)(15650500001)(2906002)(5660300002)(4326008)(8676002)(1076003)(41300700001)(2616005)(6512007)(83380400001)(186003)(107886003)(316002)(6666004)(86362001)(66574015)(36756003)(6506007)(6486002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?enIycmtYL0llWW1neVl3UGlkU2paTWVDVXlqRVgwTVB3c3ZYMDdwZkVucGQv?= =?utf-8?B?QmdSSGJidlpwS0V4QlNwYmYxenl3c25jcUdlcVhLdko5eGlDQk9PdVRhcWpO?= =?utf-8?B?OGEzaytGcDM3aUN1T2U5cUVpVHY4eFZuWUNEZ3BBTDMwczJzbFFSaHY5bzU4?= =?utf-8?B?Y3NWSUFXeWx3K1owM21WdEdLeDRWVTArWkRzbGtOL01rNE1RSGNHdk0yTDBQ?= =?utf-8?B?cXdTRmNIL3Y0MytITkJRZGI3M1dZMDl5MnVIY0J4MUlKZ0JiRE5OYjU1U09L?= =?utf-8?B?bkNFL0c3YW9OTVMxcklNMGdOSUVNMFF1Ujh2bWFINFVpVngyYUtEdWw0OU5R?= =?utf-8?B?eWQ1MkZ3K2N2K3JBK2dZYklEck1nL3FvalpCY2UyZ1ZTaFI5UXBzUllYY0ha?= =?utf-8?B?aVhDMk8xL3c5UjFqcVRUajErTlRCQ0Q5NDRMbk5uUUZ3MUdLSUp2SzdGRG5w?= =?utf-8?B?OER4OXlya2FmUmhmd0JkaWVuL2J5Ykl2NzBmYkV2c1hiUzVkaUg2NlBCV2l2?= =?utf-8?B?aStQS3RIYk9Rc2FOMURlM2d0N0htZms5elgzSG1rTmwxQmljam1DU01rUWNS?= =?utf-8?B?ODJtMHZ4WU0zTWFqYUdjbFVHZEl5WEVMSVEzb01ULzZnVTNvcHFYWXZjVUcw?= =?utf-8?B?VHd6VkFyWFRnZ2dxcXpPVktRaUhSVFJvRmlSTEFLSVNzUDNuZDdyR2JqVEll?= =?utf-8?B?MDRteE1sb3ovZkM5ODdUT1QzalhzZGJVTHdpbE1LdEpmUlQ2SUk2ajltNFQ3?= =?utf-8?B?NVNrRDBiNFJ0alU3NDVncDBWZTl1TFhSYzBjTHVxWWl2VGp2ZWRMUWlmZkJw?= =?utf-8?B?SjgwSGlDdnUvWkNwSjVtcUgwZUUzRWlMeTUyc0NRTEpNa2ZVMXNpU3pDTnZF?= =?utf-8?B?L0lPRm9NRXRqRlpuaXhycHZTTEM3eG0xVDRVYzUrbG1tcXBNalJrQm15c21O?= =?utf-8?B?UWE0bG9CdG9wa203RUM2aE5UQk1DRkRnL0htZVZXK3daT3NxdEdEbVMrcHE5?= =?utf-8?B?amswb1JxWll6Lyt1WEFFelRTeXJ5WG5CVW5VQ0JDNG1Bd0ZONGNxeXBybVl5?= =?utf-8?B?bDgzOHFDSXgyeUt4U2hOOThuMzF3M1BzTVZ5VklwNVRPWmFEZURieTFaVmNi?= =?utf-8?B?NVJLcGM5bWF1WlBoT1VpL0NaY0ZmSmNsazQzTEtnUWVBZkx3TEZSM0tBMTFB?= =?utf-8?B?Y0IyUW1jNS95YzJmV21hVnZLZWF1MzVJSU0wdThzTHdoNjZ0b01NOGRjMlFQ?= =?utf-8?B?WUlrRlBxcHJMbGoxZVcvVWRpNkJpeit1SEFlbmRpN05sc3U2bzNNZGVoWjFj?= =?utf-8?B?bGNnVkVPK0Z5QzVxd25UWVVldUkxc0xBS1F5dnUyWjE5QVlGWW1IZldpdXRm?= =?utf-8?B?bk9mNEFscHh3cGk3Rkd1ODNpbW0vbXZvSWlJeUxkVVpoWGhhY0paOTlrdU5s?= =?utf-8?B?KzF4dEFFeDVzWUErVVNPeksrS0dYUnltSk1nVTBoM1lHcmhVSFBaLzR0WnNK?= =?utf-8?B?NWh4Wi9BY3Q4cEhCMTB3RnpnN2hBWElJbVk5REZsMVFVaUVOaWFpclkxSTlT?= =?utf-8?B?UlF6QitBV3R3NnBOSVpKUHQ2SlJUdVVZQk8rLzlFc2oxTlNuaDc3bjdCRGwx?= =?utf-8?B?aGNwV05UMmUvMUI2eno3eGVlS0ZBcXQ5SWpmYzF4dlp5a084UlhDdFVsUzRX?= =?utf-8?B?UGZyek9WMGNtSUhOYXBjbDFZeVBINnpHZnlJU2RDaVhTL3RXZlN2cFI4Mlp3?= =?utf-8?B?UmxKZU9KczIxUHpzdGVEVlJkZ0lWRUh5Q1ZzTzV1STVMOUFkUml3dE8yQk1j?= =?utf-8?B?QWFlN1NOL0tMb21ORkd2am9YalhwOWF6VlpMc252K25pa2ZaL29kRHlzOUlR?= =?utf-8?B?eXRBbktobkk5a1k4Q1BBaWR6aDljV0dLL1hMUHphaVJWSlpSc3d2YnU5NlA5?= =?utf-8?B?ank3OXFQNHZPTTYzNnNQdjJmeFNleC9KelVyTmU5cUxDQnE0UWF0bERqL2ZR?= =?utf-8?B?bUFTdy9YWHpUdWtjVkNTTXRHaWZFbGZSSjJNeG1CTUFrNFowbkxrVFBWYURm?= =?utf-8?B?SVJmcGk2UFRCYzl3eGRDc0U4ZW93NjkzS08yUThreGJFaVk4NTY3aEU4M09K?= =?utf-8?B?NGtuYzB6TW53VXlaek0wZytUVkhlUkJXdEdkZ3RhcmFCdkx1RElrSFpLcjdI?= =?utf-8?B?dHo4clZMK0RBT09uR3o4TzlNcGtYNnp0WkZCcmJSMkhsT05QNWtvdHFWSUJF?= =?utf-8?B?eDVsWWttb2NtZjgxYUd6MEpuQnhRPT0=?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: =?utf-8?B?Z3VuaHNtZUsrckdvTzYySWd4SnM0akh6R2pCRHJpT1M5dDA3WEgwT1lwcFd0?= =?utf-8?B?N0gxMHVzaVZTdjdDQUJVU0hTdzkxVGxra2d6UWFWUlFxWGI4b3NnN09NcHYr?= =?utf-8?B?c3N5RjJxd2NycWpNL25sanM3bUl5UUdZWXNSMXd2YWdTcjc1eVNTZ29FSTlw?= =?utf-8?B?TmpjL2Q3ZDRtWkRFUkljdTloRnZiSFdEZ1R4dmEyN0o0VDEzdlUvL1JEZThB?= =?utf-8?B?emtyYW45SnRadVVza2xGRjdMeUJ6dFQ1OExwY1dDNEZORC90bUxJdW4rOGxQ?= =?utf-8?B?RnZ4bnNaWWZMdWtHWGRoeUhBRzNrSXNjTm9tWFJnTUx4QlZ5M05JSXQxVmpV?= =?utf-8?B?V0dpejJNUmxYWHh6Rm5WVzhWb2JqTVNoQUxMaTFjN0lMN00rL2VBdVllTG1a?= =?utf-8?B?QzB5QUNxUFRvQTVJbXd2Q1plVGRtOEpmbS95WTdaaDNPOUs0NVRzaGZtb1ky?= =?utf-8?B?WG1MU2tFWi91S2haQ3QxRSthaE5BbHZVZGI1M3MraysrcXVjOEIxM29XSlow?= =?utf-8?B?N0s3V3RCMEFSNTQvWGdON1BzTTdoY20rdmJsZDBUelNySEtaZXoxSitqcVlW?= =?utf-8?B?WUZubEVKbnphVi9sbXM4emNqakVJdEtlQVcvZ2plcWRsUjlQNzUzZGZubFMv?= =?utf-8?B?cCtoalRPdmJLT0Zjd0JXR1owSXRUeGVYczQwVnBkQTFIaVorbC9kcU1vbnY3?= =?utf-8?B?MFR0TGN4K1NydnJHSmUzZ3NLVEluL21VaHd5Q3crSWtlM2ZLby9QSGlGc0Nm?= =?utf-8?B?SFJMZFc1bG04eU1VQXE2Ylhwam05K0JzSjZQN3ZMczNPTnM3bUtaVUFraHlL?= =?utf-8?B?cG5na0t0bmhLeVM1LzJmS01WTmFjVWFDc2NOMXI2NGkyWHlwTmt3bWllK1VI?= =?utf-8?B?cjdqemdrRWdWSTJseGNSRkg3WkUzZWJUTE5sTXBTeXUxcWZQVVZmMzBiMEMv?= =?utf-8?B?NE52NDZQeXJJVWhsemdVVWkrbGd4NkVXOC90NjRRc084OWFZdE53ZVpuVkVZ?= =?utf-8?B?SCt0cVZKdlhNZ05Rb3NmaGFvdE1ZcmRqeElPc2V4d3VScHVLYnM1K2ZVWkJO?= =?utf-8?B?L21udWRxMDBaMUtOdnBWcjhVQWdiNnA2SFdLeHp6QVBrSXFWSGRJSGl5RDg5?= =?utf-8?B?MTN0U1RRNmxjUWRkQzdtQkwyUkE1clRVUnFTUU1ueWo1d0JFZFZDNjZlRFNn?= =?utf-8?B?d1IxR0gwN1BpK28zVG9EMkVadDlXOUdjYzVyVm8ycUE2eVIyWU84aWU1NlBu?= =?utf-8?Q?Xd4jrt+ESKwuKcD?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: fafc298b-5b38-427d-4351-08dafa6248fc X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5117.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Jan 2023 21:15:26.7076 (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: vngtJTHiHIr8VwNwNobihGHe+9MapskawYYSiWD7gt4bduK1Jn0a+V1nFU032BxN9/TutaVMh6Aiwi/5EpB4do5cB5dQpMwe6md5KMM/ez4= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB5600 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-19_14,2023-01-19_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 mlxlogscore=999 malwarescore=0 mlxscore=0 phishscore=0 suspectscore=0 spamscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301190178 X-Proofpoint-ORIG-GUID: mk9yI2SgoqrUBZG-z_Taoy5eg0hBg_ug X-Proofpoint-GUID: mk9yI2SgoqrUBZG-z_Taoy5eg0hBg_ug Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org alloc_huge_page() has been renamed to alloc_hugetlb_folio() so update the documentation which mentions alloc_huge_page(). Subpool information has been moved from page->private to having a dedicated field in struct folio, reflect this in the documentation. 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.0