From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id DB201CCD1AB for ; Wed, 22 Oct 2025 03:38:35 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 420408E000D; Tue, 21 Oct 2025 23:38:35 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3D1148E0002; Tue, 21 Oct 2025 23:38:35 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2BFB98E000D; Tue, 21 Oct 2025 23:38:35 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 1AD698E0002 for ; Tue, 21 Oct 2025 23:38:35 -0400 (EDT) Received: from smtpin01.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id DD7241A068F for ; Wed, 22 Oct 2025 03:38:34 +0000 (UTC) X-FDA: 84024342948.01.5AEFBC1 Received: from CH4PR04CU002.outbound.protection.outlook.com (mail-northcentralusazon11013035.outbound.protection.outlook.com [40.107.201.35]) by imf22.hostedemail.com (Postfix) with ESMTP id 1EA11C0006 for ; Wed, 22 Oct 2025 03:38:31 +0000 (UTC) Authentication-Results: imf22.hostedemail.com; dkim=pass header.d=Nvidia.com header.s=selector2 header.b=SpnKSKlU; spf=pass (imf22.hostedemail.com: domain of ziy@nvidia.com designates 40.107.201.35 as permitted sender) smtp.mailfrom=ziy@nvidia.com; dmarc=pass (policy=reject) header.from=nvidia.com; arc=pass ("microsoft.com:s=arcselector10001:i=1") ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1761104312; 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=OZT0XCRJVbj1WvWFdYdZ8grPJ+rp3Brk06dfTfBCiYs=; b=hPXU3Py85uHxWQeenE/OeA2u1jpxIDk6B+ZH9XXabaFOZeFZqDFIPouk6Et3nNt5fywLrS vAs+JnaqsCGNzePUmuH0q6C2bZduRE9W4oaky7EeC3BmK5WYCoGAAMV6Y36caJ18+rAG8C 18cXuSHF17Nu2DBXUI6ww3VY0glBYBc= ARC-Authentication-Results: i=2; imf22.hostedemail.com; dkim=pass header.d=Nvidia.com header.s=selector2 header.b=SpnKSKlU; spf=pass (imf22.hostedemail.com: domain of ziy@nvidia.com designates 40.107.201.35 as permitted sender) smtp.mailfrom=ziy@nvidia.com; dmarc=pass (policy=reject) header.from=nvidia.com; arc=pass ("microsoft.com:s=arcselector10001:i=1") ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1761104312; a=rsa-sha256; cv=pass; b=DTMpGOT3bzXWVytKwEaYKMRKBGr6wtRLbNCZbK5LOVhRflc0LRjpfkFzztG4G6PYq2S/sn KWcZbeDBIBaQmfzzG9Cs77wbcLE8AjFUqHDnfCMfKPMAQRWCZvF0mrsfib8SNp3A+YrWA+ 3D7u7dFVdgUEAzqWOracsAVHhmkuoeI= ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=UOI81TYOxxylh7O+mDeBFlD55l7m59Ggf9KD140Iwth0fXiniVKffenZAwms5aowZbUSud/YFtgSk2lQGdzPXtFe3yD07df1BM7dbO8sZ/dnFzqW/aU9CG7wzY3oyh8qCh9njRZnxm7zYhN9tCnxXPeuNYmO7j9YCysuG9vpBc6dMk7tv+IcNF3lF2mX6mO54BE1c5sgAiHBINyGAVdkzVUyuodfyZkbNVMv/KKXyXMByxPpcviNqMY068bZeFrj4qCBRSnoQ0SjKx6jCwJso7XRqIrluGdlziXzgQOfUnovRhmBlYHiMNHr7u5w/FJPkiwP0hI8gWohGgpR+G5nSg== 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=OZT0XCRJVbj1WvWFdYdZ8grPJ+rp3Brk06dfTfBCiYs=; b=J9JSIyLqGa5n5m8EPlOBxRhAqhxzeRbHOrrAwa7sgj0WWEmMj8p64Vv95U5bXXghphtVyMwdCAfTlxU0+IcxV1OGU2rQL244qryDFs4y71szfNUk+6W+Xy2syFb7z/wS75aUxYpFxm/uGXL6kPOZqiSlzVFUSfQMoUmfhJZ/Ww3SJ7UNHTxW0nIN4C3K0ewZPG6roUQoQ28ERlLIXijrGw9zurm5vHuJPMHj5flHOv4sIHorWuCuABIR7CRFOOVZ8uIpXqreLSEkeyAMAe+JkM3NkbhGt4mXKHxWj2VvZonXt3E6mGmvwlEghefnKjO0kqSgZiUtBgVq26W9mjnuuw== 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=OZT0XCRJVbj1WvWFdYdZ8grPJ+rp3Brk06dfTfBCiYs=; b=SpnKSKlUUF/UhZvnkaOVT+ZvLHy3UPEGLzLa6MWUiBkPpmuT8EJvwwa5mXu7lYD8n6TDRUSgWz36XiI3s3i2OHtg6zTXWBPJ8xreWzz3WFXw2STCXVFEVZ0iR9M2f0RSwu6+JadHFaPEIK4Bfu5ozC4BnruQHhsnNB/5/wRnDAcgYwaIxTkRD6VpvTaSXJY4l88jmb33IsynTT3GzjA3Xm1Dm2PuamPMqzj4FQp70ma6ZGswMVXxeDQNpvTW3MsTaxU1zEojZXy7gx8Rptx+0jTYN8ADTM9TuqJXCgdIBQgV28s0nn/BXesjxTc2UhtGB0qwnor4ZPbUlEBrzS9Umg== Received: from DS7PR12MB9473.namprd12.prod.outlook.com (2603:10b6:8:252::5) by SJ1PR12MB6268.namprd12.prod.outlook.com (2603:10b6:a03:455::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9228.16; Wed, 22 Oct 2025 03:36:52 +0000 Received: from DS7PR12MB9473.namprd12.prod.outlook.com ([fe80::5189:ecec:d84a:133a]) by DS7PR12MB9473.namprd12.prod.outlook.com ([fe80::5189:ecec:d84a:133a%5]) with mapi id 15.20.9253.011; Wed, 22 Oct 2025 03:36:52 +0000 From: Zi Yan To: linmiaohe@huawei.com, david@redhat.com, jane.chu@oracle.com Cc: kernel@pankajraghav.com, ziy@nvidia.com, akpm@linux-foundation.org, mcgrof@kernel.org, nao.horiguchi@gmail.com, Lorenzo Stoakes , Baolin Wang , "Liam R. Howlett" , Nico Pache , Ryan Roberts , Dev Jain , Barry Song , Lance Yang , "Matthew Wilcox (Oracle)" , Wei Yang , Yang Shi , linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH v3 4/4] mm/huge_memory: fix kernel-doc comments for folio_split() and related. Date: Tue, 21 Oct 2025 23:35:30 -0400 Message-ID: <20251022033531.389351-5-ziy@nvidia.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20251022033531.389351-1-ziy@nvidia.com> References: <20251022033531.389351-1-ziy@nvidia.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MN2PR05CA0010.namprd05.prod.outlook.com (2603:10b6:208:c0::23) To DS7PR12MB9473.namprd12.prod.outlook.com (2603:10b6:8:252::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS7PR12MB9473:EE_|SJ1PR12MB6268:EE_ X-MS-Office365-Filtering-Correlation-Id: 0e11917c-ae96-4190-b005-08de111c3d6f X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|366016|7416014|376014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?gGkyuXkrpAhMfB5FPU4F598BRan8vr+ii/YOyMnes0+9rTSK55FKeah1UmYx?= =?us-ascii?Q?6tOBepzlYR51ocx4BqcIVIzWvDEieEZVFCf3UemIZnQQQwwAvAUVoJflDHP1?= =?us-ascii?Q?ZQhbhliQo9L1GbBf3cT+EkPA4EfbwU+WxEOvjZsN9YnMjCz6HKgCwuQ/yhsv?= =?us-ascii?Q?CwWx2vf0UwduokAJBIgKAHeikRnEaJ4tj0OpnJp+6jICZMR5RrdZXK+YVK6U?= =?us-ascii?Q?CY4XW7fpoHSDEZmbE+PHdDTd+vaXFvdrrGkS0CHkGdwpQjXO1vYGxczggnAE?= =?us-ascii?Q?9Rk/QJ0VntaBB/kscgUEeit605q8a8xaJ5JkNbFn6JN0g+Pgfo9aAheIir51?= =?us-ascii?Q?kIYn1VhDH+rLUFGw8/5X3sEE0mBg0wps4+B6zTSMU4N7fJQGqqY8oV8ZGvHk?= =?us-ascii?Q?aUlB7//VACku/GulNEzY/v4rFqAUBDUGMFjZNr4/w3mLYELzwZ3ceV8TtBNP?= =?us-ascii?Q?3BHMIB67ICrzHjkb6a9kifv28cy01Vu/gokexhyr40h+6Bonk8d7++4/idFT?= =?us-ascii?Q?/VRPxT/GkQHWHIqZokqvcd2t9gg0tJNsXLfaodspPgTc1TH4rZE2JniWXWSU?= =?us-ascii?Q?YqzlWvGcVMO0UNJlPLY7XJQg94BOuw+OihxZ53wF8Kj3gnvLTLvJIC0B4gTo?= =?us-ascii?Q?upFrTqnzGBKJPqX6PnsDS3KAdReqf6BdZD0lNv8mHwaWIrHSLRYYOuy0UBbQ?= =?us-ascii?Q?F9hpPqvtrv0t1cM9TsWypopFmCzwUzPtvOmUSX/tpwWSkmJMixlMsVqxA0Eb?= =?us-ascii?Q?IfJHwZKHNrBr/OuA1/dqMf+Oh75UaoHoIQ2GLrxRStIddHZ64T6IZPtHgHfN?= =?us-ascii?Q?252OIozcJ4JYyPC1RTq6u8H8hb5qqMLWdQGoTzQdb1yUebMg+hqBwaGC8EYW?= =?us-ascii?Q?sCKrr5es93F48Y+uR+ZM99Zvmcx/FV6m9q+2rIiLqTsIMBHY8x+aGEC/vc/9?= =?us-ascii?Q?9vutsJD6tRemZTNaNoR13Mn1vrFbIDNoE93r+/7VxS2V/7ifOOg5meUTueSM?= =?us-ascii?Q?rOXuoN6VfXU7+p4W/pc/jWa003Mu91zMXRU2JkJUFeJhj6gAjjY1924WgxTE?= =?us-ascii?Q?K/W1b9ppeGkx2qzs+WbNDll1RRgmdaTO1OmF03SkveT1kGQGWUMZyBM+iJ52?= =?us-ascii?Q?jbVKhkUWrdsN//4GMTB7VhYdFM6TypLR8XcUpsO80mrPCBTu/NK91vy9m1qG?= =?us-ascii?Q?bAYr347mF5qGZ+UDr2d50j9b/bXqegqjh0+ySv419scJBl9ZNCDkpQuCdTUB?= =?us-ascii?Q?dKLEufXbkR0mGqk6yV2J8Lwe2FDlDrLVjMNKb49DZms8zp9AAccE4w1l50mo?= =?us-ascii?Q?3xl080AV9RwNfUXb5jbdX+okNYRMZNi28j6Xu2rc8oQhMPZWCBN39YQhCiHX?= =?us-ascii?Q?4gmn88JSa/w0tnUOcGaMDXbdojp5r63ZPzfQu3Pccy9MOCu4jTV3q0I97u3W?= =?us-ascii?Q?2sv4eLVEotFVle/PuWX7Hb6lvrKrKyvJ?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DS7PR12MB9473.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(366016)(7416014)(376014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?ZuTdFLd9Sww5EuaHcKN2L+UFLDi7GfQz0Z7KTQwyqh8h16HdjJTteIlnjB2C?= =?us-ascii?Q?oBOt2u00lsosvCVQZHjGMHyxNPdonE8wvZuJzlPdycL9Ku3nt5OfQrLIbEZ2?= =?us-ascii?Q?uMOpEsgV2YndqNHr4RfHKCS7fH2tDFRGhO1sqvLyGUDHd8bG8bSgO82+O5EP?= =?us-ascii?Q?wSnDLPTiN1OG27EjQsphBLdi8x2PBqOranTjmmWTCEuJrotp3/qeamdyyRoM?= =?us-ascii?Q?7hX1dI5U+35r9xdg6Gd6CfEkCbTCyeWvvZdu29CIZ0X5gnS9i7qzYsHuiSOP?= =?us-ascii?Q?/GS/oMBphnOfAn6jb9pns1vL6E8LZc9e+0NItsWB3xYVp7EFeHnO3Q4+wKkS?= =?us-ascii?Q?rGkGmE3hHeA+2XeQiPwjCGpzz5dOlJMBTU3TRIqeTM77nxF1LcO5FyYsqGWh?= =?us-ascii?Q?P7PvXFd5XMa/Z8DGPxQAOOGwA76CP9nqGzHiK5PMCQE3hChEe0NC8zleCiaF?= =?us-ascii?Q?DFFLXSOTdCCtIVosPy0craNmGHY5fgpZq9M+X5tvgTo0NAdmdPWiw5o4kycK?= =?us-ascii?Q?GsK40CCXyISpSwl5e1WM96fkL8thryt39ZZdXh+D0ZhmbmVTe6lgfOLM/54z?= =?us-ascii?Q?fHM9Lu1+4XIropzhIoVjrOOLrE0tGid9Jw878JrWsTpL9qMf3+m88XAYTjXo?= =?us-ascii?Q?X1udv2lry3PVUntXmpjpx5HHeEolOG2pBwm5y8PeOaBAgt2kMs2vuhlnhS6v?= =?us-ascii?Q?sNHFmD6TBfMSG9VQLSrp6BeWe79JXVyKfcsQApLk1FATp8Hwn6tpYAdeaTH8?= =?us-ascii?Q?L1eJZFlHE2/XwFmEajtMAKIAGEI0pp8uQ3WQlDn03pymlTqavnz4HAqDirag?= =?us-ascii?Q?Qki6KXRaQt5HhMKKakceyhGdbHALo61R0Wb5sfij6KI1TRq6drOj+mFnPOVU?= =?us-ascii?Q?PGSzoO7ViJQCMhPPN4x+BKwr2ESgw2R84W/NaMrhm53Ya+uXl7/mYQ8ueG3S?= =?us-ascii?Q?JLa22eIipyVhf0bfvO8kqKb+BrQ3e7J4C1bLpQhBYegTCXQX2g8yvnlq3lek?= =?us-ascii?Q?vv6tY++zMBj30HQjyuVO+g5uRP6+/pztyZ8Fwiindo24xxpUNp64E/u29r0S?= =?us-ascii?Q?k5YjF6dYAVmp7hc8an32G/y1L1U9e0+8keby6qN2SrSmcUtiHmRwpGFIGH55?= =?us-ascii?Q?Gs/W0/H/Ji2Pt0nMWNEPwEZ9Y/rwFi4nhWQHprKEE5POCWfd/6CBQxs8BEj0?= =?us-ascii?Q?i1g2DPG86GJRna3L7VGn15sKfnvRmEu/f/pZu4MRX152SZ2w1N9kbqRXXxb+?= =?us-ascii?Q?V5GE12JxBFLVYcVipu2jVeK0nwQvh78stQ/woNw+Sm5xfNdNt6KkAHvM0Xdb?= =?us-ascii?Q?kiiVR1cC1GPrxBb6BjDNfJ1e6/fzU6cmfACn1soaei7RRPsgXbSM0hHhQA4o?= =?us-ascii?Q?hLQEzUZK3AGTsHoCQWzYCWIOQ5GOloJNSK+I0CNad6uFwWHvpUVLl0XT+8xR?= =?us-ascii?Q?PzBs81E21SeimxkA9chos91K9dRdYfxnSZjsnaVNlcWOQVvBYw8BpBb/sETT?= =?us-ascii?Q?OYa5SPVMo4SN7u/iePcF50l8wcDDj2I9gvV2qhT76zg3CZtG46rgc3YUUS+4?= =?us-ascii?Q?L4b5dZeJfqPca9e+pUCz9j51BZnXCJHdLU8VpaL3?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0e11917c-ae96-4190-b005-08de111c3d6f X-MS-Exchange-CrossTenant-AuthSource: DS7PR12MB9473.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Oct 2025 03:36:52.1967 (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: ZmJ+2baWKgHTbpQypqZZVKGzHVzWS0sucZzOHIKBZT/5y2Z8kWCx2d2O8nZfbMbg X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ1PR12MB6268 X-Stat-Signature: 863te4wrqh5tt4m18i54kiau3hye9jgm X-Rspam-User: X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 1EA11C0006 X-HE-Tag: 1761104311-294914 X-HE-Meta: U2FsdGVkX1/9rtrH/zqA+p7LD4dtvnVrqIcIjK2NwBuJ4z1OOZP+vy+iX6+cpXLRtoAWSuymXfhh3S2v0bIpIuBJ0BVtarHkOfI8HOwg1IANOtH0CrD3cUzjnbbtAqfddtKJzsXKqEKdx0gIvE9uSXQMUqnWs/wz3K6kKKhM8ghptOZ6d6qJzzksMZj8B2GDe5f2xqryjExTHPCQc5KAblHJsbreWDCww0orj2cKKoIApG3femH7XWa6w6AspuN9G0UW+gxP9C3uMmaq+G1nr6TAcic80IM4JOoyS1EQrBIxPAF7GqnmSI8BMCs0fWtW2cMovgFdisYjBXvSW3p1XmmjcysXi/e6Y3Hlsyt032GbTapW4mnHmIy4DcSdQreomflrCQWEyt+NAucDmt9II2D67Dv1jBtrj050gzO+Q1/VMx4vPllKBYHjblxCbJeRAh2HbFGodk830aBpW4bvH8q+1rE+LOB6eWEFJAvO6iJSYOWgBAkPDGQ7k1YXl6uioUkHpZuHqTurZqPXllyhsTb+6VbHSmj8pwSgg2a9h+ppY4SOkLO+e/gVm1QHZoRcnAw3y0pV0boJjS5tYtG0aoYyBasztetjJdA8eKBzRKKZxOVJN5PJL+SdpQiuIoQJ+//JiDW++qajIJR4HwelhOPHTmeV4a4hH91yeG8qw/EkF5OnEPp08PsYpnzly373bSlELZYzA3dEyR9HXRDusDaqisWYE8RyOaSF2fZD2ttyVYUGJBM0r54nBCuMv25aKctJSdbj3rnqg9m5jiGtnyF9jwQ9ZSRvcfffPotOYPuG4629RFIhH7aKTECroeXnHeneHZZ6ab5HeoV+hsur560z+TPykMzzfqPyqnr5zEdu4HjOMCs082cREPHLSnt0es5F8lIa4O0trYxcwNreVZdHpu9q/fPpMpYpTJF+t0jSO1AAfbl/PaJasGvqdyBwzxPmgaosLFQM21fupWi qdEh8PhX UEidZLqeA+Pn/pbEYp3nvI0qX6usmd8+SjekC1SK8a1dm9yoZUe5ttFz6P8XwHOFD+mQMzyi5aSnVOnW0qwuBNJ5jHUk2VFCvKZ+vRupaZ+DKIlJrF8exeZs5VJi4NFp9S74YCpYnLWxQL5+az2M+voR6cJk2VDeFstbea265BE5+SriTsF0ZdQXxyYJ8IwMu3kY8fItjGwQDiQpVayG+MHvLoSHFCNkgk6dwX9iNU+9tg9ql+xBVxcMtcucQLIAtCEhuV5vZuEXDLKkCAMVrE+Ia/IbvqwMK9BO4rpJXa+G7Qni6Pokttd2UJU2AF+JurndYO9dggkqc1vr+/9X43r3A9VYfR0mA1bdv/kG5rIoXkxGGRZp5gJKnbW2V1c2KkLLCVsszOBuRA+e/CsQJ9/z8icFi7TtUBCVlUfwkFK/7JXQgz03rl9D/CIymBNZHCL/c2hlL64P+Jr4Bxc5k8tgc41N5r/oUGLlG6XBW4lOYouk= 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: try_folio_split_to_order(), folio_split, __folio_split(), and __split_unmapped_folio() do not have correct kernel-doc comment format. Fix them. Signed-off-by: Zi Yan Reviewed-by: Lorenzo Stoakes --- include/linux/huge_mm.h | 10 ++++++---- mm/huge_memory.c | 27 +++++++++++++++------------ 2 files changed, 21 insertions(+), 16 deletions(-) diff --git a/include/linux/huge_mm.h b/include/linux/huge_mm.h index 34f8d8453bf3..cbb2243f8e56 100644 --- a/include/linux/huge_mm.h +++ b/include/linux/huge_mm.h @@ -386,9 +386,9 @@ static inline int split_huge_page_to_order(struct page *page, unsigned int new_o return split_huge_page_to_list_to_order(page, NULL, new_order); } -/* - * try_folio_split_to_order - try to split a @folio at @page to @new_order using - * non uniform split. +/** + * try_folio_split_to_order() - try to split a @folio at @page to @new_order + * using non uniform split. * @folio: folio to be split * @page: split to @new_order at the given page * @new_order: the target split order @@ -398,7 +398,7 @@ static inline int split_huge_page_to_order(struct page *page, unsigned int new_o * folios are put back to LRU list. Use min_order_for_split() to get the lower * bound of @new_order. * - * Return: 0: split is successful, otherwise split failed. + * Return: 0 - split is successful, otherwise split failed. */ static inline int try_folio_split_to_order(struct folio *folio, struct page *page, unsigned int new_order) @@ -486,6 +486,8 @@ static inline spinlock_t *pud_trans_huge_lock(pud_t *pud, /** * folio_test_pmd_mappable - Can we map this folio with a PMD? * @folio: The folio to test + * + * Return: true - @folio can be mapped, false - @folio cannot be mapped. */ static inline bool folio_test_pmd_mappable(struct folio *folio) { diff --git a/mm/huge_memory.c b/mm/huge_memory.c index f3896c1f130f..38094d24fb14 100644 --- a/mm/huge_memory.c +++ b/mm/huge_memory.c @@ -3576,8 +3576,9 @@ static void __split_folio_to_order(struct folio *folio, int old_order, ClearPageCompound(&folio->page); } -/* - * It splits an unmapped @folio to lower order smaller folios in two ways. +/** + * __split_unmapped_folio() - splits an unmapped @folio to lower order folios in + * two ways: uniform split or non-uniform split. * @folio: the to-be-split folio * @new_order: the smallest order of the after split folios (since buddy * allocator like split generates folios with orders from @folio's @@ -3612,8 +3613,8 @@ static void __split_folio_to_order(struct folio *folio, int old_order, * folio containing @page. The caller needs to unlock and/or free after-split * folios if necessary. * - * For !uniform_split, when -ENOMEM is returned, the original folio might be - * split. The caller needs to check the input folio. + * Return: 0 - successful, <0 - failed (if -ENOMEM is returned, @folio might be + * split but not to @new_order, the caller needs to check) */ static int __split_unmapped_folio(struct folio *folio, int new_order, struct page *split_at, struct xa_state *xas, @@ -3732,8 +3733,8 @@ bool uniform_split_supported(struct folio *folio, unsigned int new_order, return true; } -/* - * __folio_split: split a folio at @split_at to a @new_order folio +/** + * __folio_split() - split a folio at @split_at to a @new_order folio * @folio: folio to split * @new_order: the order of the new folio * @split_at: a page within the new folio @@ -3751,7 +3752,7 @@ bool uniform_split_supported(struct folio *folio, unsigned int new_order, * 1. for uniform split, @lock_at points to one of @folio's subpages; * 2. for buddy allocator like (non-uniform) split, @lock_at points to @folio. * - * return: 0: successful, <0 failed (if -ENOMEM is returned, @folio might be + * Return: 0 - successful, <0 - failed (if -ENOMEM is returned, @folio might be * split but not to @new_order, the caller needs to check) */ static int __folio_split(struct folio *folio, unsigned int new_order, @@ -4140,14 +4141,13 @@ int __split_huge_page_to_list_to_order(struct page *page, struct list_head *list unmapped); } -/* - * folio_split: split a folio at @split_at to a @new_order folio +/** + * folio_split() - split a folio at @split_at to a @new_order folio * @folio: folio to split * @new_order: the order of the new folio * @split_at: a page within the new folio - * - * return: 0: successful, <0 failed (if -ENOMEM is returned, @folio might be - * split but not to @new_order, the caller needs to check) + * @list: after-split folios are added to @list if not null, otherwise to LRU + * list * * It has the same prerequisites and returns as * split_huge_page_to_list_to_order(). @@ -4161,6 +4161,9 @@ int __split_huge_page_to_list_to_order(struct page *page, struct list_head *list * [order-4, {order-3}, order-3, order-5, order-6, order-7, order-8]. * * After split, folio is left locked for caller. + * + * Return: 0 - successful, <0 - failed (if -ENOMEM is returned, @folio might be + * split but not to @new_order, the caller needs to check) */ int folio_split(struct folio *folio, unsigned int new_order, struct page *split_at, struct list_head *list) -- 2.51.0