From patchwork Fri Jul 7 09:00:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 13304603 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 372D8EB64DA for ; Fri, 7 Jul 2023 09:00:44 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9A5A68D0002; Fri, 7 Jul 2023 05:00:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 955F38D0001; Fri, 7 Jul 2023 05:00:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7F8DB8D0002; Fri, 7 Jul 2023 05:00:43 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 6FE938D0001 for ; Fri, 7 Jul 2023 05:00:43 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 40BAF120CF5 for ; Fri, 7 Jul 2023 09:00:43 +0000 (UTC) X-FDA: 80984220366.28.28AE73C Received: from out30-130.freemail.mail.aliyun.com (out30-130.freemail.mail.aliyun.com [115.124.30.130]) by imf11.hostedemail.com (Postfix) with ESMTP id BAAB74001C for ; Fri, 7 Jul 2023 09:00:40 +0000 (UTC) Authentication-Results: imf11.hostedemail.com; dkim=none; dmarc=pass (policy=none) header.from=alibaba.com; spf=pass (imf11.hostedemail.com: domain of yang.lee@linux.alibaba.com designates 115.124.30.130 as permitted sender) smtp.mailfrom=yang.lee@linux.alibaba.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1688720441; 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-transfer-encoding:content-transfer-encoding: in-reply-to:references; bh=PWp/IcIjYGZP5k371PCYmNpH3tCX/RPeKbW8MqCiCdA=; b=jWMa1Hc9NPsBtscPB+6mk1onPdNANAAJtzi21XoSsrbXwGAG0h55f0svQvsDEnNptION0m 5qXhm9fI1PifsB4x1VFarw6WCma73M03C7s+sLIuoAfmMa9AKkiqUDaR/NNbYtfI1rZ+AR lSjWV8WWS61UlQmN6HvN5A6I0j3zyxA= ARC-Authentication-Results: i=1; imf11.hostedemail.com; dkim=none; dmarc=pass (policy=none) header.from=alibaba.com; spf=pass (imf11.hostedemail.com: domain of yang.lee@linux.alibaba.com designates 115.124.30.130 as permitted sender) smtp.mailfrom=yang.lee@linux.alibaba.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1688720441; a=rsa-sha256; cv=none; b=Gx5BEjoXp5QvC9SHyU5JJS1h0tpxALsynE/kArUcpMUph5+s+btggY3UWBinWyVvt83FRw lQgU1GdxpjxtHMWZvuldUMTRuQ8rHdI+Cd/92GVdjedkplFeEu4apmDQ10Vc3IpNCIjT3m sqopbIjz8bUVF8vHtSgIZr5/y7NcQ88= X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R531e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018046056;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=4;SR=0;TI=SMTPD_---0Vmo-124_1688720435; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0Vmo-124_1688720435) by smtp.aliyun-inc.com; Fri, 07 Jul 2023 17:00:36 +0800 From: Yang Li To: akpm@linux-foundation.org Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org, Yang Li Subject: [PATCH -next] mm: Fix some kernel-doc comments Date: Fri, 7 Jul 2023 17:00:34 +0800 Message-Id: <20230707090034.125511-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 X-Rspam-User: X-Stat-Signature: qtg8dxgrt4ier8g31ktb1azjm9hfi6tb X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: BAAB74001C X-HE-Tag: 1688720440-361375 X-HE-Meta: U2FsdGVkX19aJy2kGSLkpQDE8Ldqr37VZXMPLbSPNhzSR1huqsNa4PT/nQpW6tThxhoWzsPN7qa3wjWnDmJ+fZAXWxDd3Z7nHqiqISEIA5/45/5m73avqlPGXZTjdaQDsHtJKamRKPrKLnYuRScxvyTV/OdavNOUAbKSdFWTCGdftfq0RSGda9Irqgun5CQQ23irbhxOaJ+rnA1LZiuVJB/r2YDq1cAh8aLBb5DX1eRh040R1Qb/493AfFmsgN6JaRoCnIw9eZ0AYdTqPX7cm+hxUy5YykhJ4a/JPLsbu40fkxS61eMPAc8IPqwwlo2Fg5ZivOWkjBoQzm5NdlGLr1yZ4PJ30B0IKTsOzknMA4v8Mn8g2HbLFQejRqr3krBOnjVXOxhpBmk+xa5Yckm4COeYCi9OWKCS+MlM6CL2MpFdRinBftZBcUoRO8dw/YViT4xel6/VkcEnbr0c7SZwAsMj7j2Wt3K3UfNBGkAgZe1NsbdVzvywvvayOhj9P3MlLirxQfw2Y6grcm4wp0il02y9o/zS3L8m4SL3xgRcTk0kYRLGARzOgZlmjYynO3ywynQOV+tx2GVFSciyOoc0bHPwtBpN2cXO+DzMG79i+mVZOZ7Qej3Hq5spKNq6F4pCtopEypyL3I2K41XM4kp9O7PUxi1pf/a8v5Eghz+MiPCf3j+z18YY2W5gC3MtFhH9jRGaHvtBlniTyyDMbJbJqj0OQhKwvsLlqF+dptdAcsvQ5FNXjXTxw5r3Mc8S3jWXCNf4MeC4REbTVXSU+17aPH4xxEeM/4aEtLuPym60tRgKp2ktiYlNU87HMogAplP9g0mu3y+AJ59skeKlO/h5f+VBeIL31mdtfinVCKSLJUUedTg6p9X9WSOksUDA7MCmvcvh++Y2/+GcoObr2ejKG+GJu6dWEme3aGVHCBuemIiJdNadIiFHcX5Hfmka4x42cz1/kNLZGCDpTw3cB4m U7x/SV4n DpkmqkmI9U/E+G8PfdshMzqpJGdBjjAdSIEkO6KAeILXVal2wn6NfE08W7PeLQicQLalxkrvl0gmKCmJ8U6szoHBuTrw81lLfdELOEDsquQyRHVR7xSthtfQVWU1HI4zf8IDo6vPSrrI2Dl13g54H9egqTh1uHZEsbwHQsKIpDDKSEzXjhILx4G7iwg== 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: Add description of @mm_wr_locked and @mm. to silence the warnings: mm/memory.c:1716: warning: Function parameter or member 'mm_wr_locked' not described in 'unmap_vmas' mm/memory.c:5110: warning: Function parameter or member 'mm' not described in 'mm_account_fault' Signed-off-by: Yang Li --- mm/memory.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/mm/memory.c b/mm/memory.c index db42a3e939d5..ceff67b5a0e0 100644 --- a/mm/memory.c +++ b/mm/memory.c @@ -1698,6 +1698,7 @@ static void unmap_single_vma(struct mmu_gather *tlb, * @vma: the starting vma * @start_addr: virtual address at which to start unmapping * @end_addr: virtual address at which to end unmapping + * @mm_wr_locked: lock flag * * Unmap all pages in the vma list. * @@ -5091,7 +5092,7 @@ static vm_fault_t __handle_mm_fault(struct vm_area_struct *vma, /** * mm_account_fault - Do page fault accounting - * + * @mm: mm from which memcg should be extracted. It can be NULL. * @regs: the pt_regs struct pointer. When set to NULL, will skip accounting * of perf event counters, but we'll still do the per-task accounting to * the task who triggered this page fault.