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: 117046 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:9f45:0:b0:3ea:f831:8777 with SMTP id v5csp3127982vqx; Fri, 7 Jul 2023 02:12:29 -0700 (PDT) X-Google-Smtp-Source: APBJJlFKtpXKmL8FJGsqpWW19/PpGHF+zTMj6kuWQizziFzZOXmkmakWjodmNLAiYf7neUJ+VdPj X-Received: by 2002:a05:6358:6f8d:b0:12f:2573:45b4 with SMTP id s13-20020a0563586f8d00b0012f257345b4mr4285656rwn.26.1688721149103; Fri, 07 Jul 2023 02:12:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1688721149; cv=none; d=google.com; s=arc-20160816; b=eMigW3px5BMtJCzWN3dbIKooehscPo1uQY+qjGI6iydR/V0tZa+2h7sWPdG1TqXy1H +D0nI2PvKSSp9I6awaj7n0v58GSdQ/wZ6w8hlhQtRlQAUN4nAz9c+TpsHoT7mYkJTXkK eA18YdLg8a4TcuhrgojP9AOT8QpOxt0cZUdGdvUDeJoljsVq6xmjKs9nrK1jpI/3zYrR 4+H/KzxTPzebLQ6U6GYA4nyLF69V1xoLhJV8Wquj5FeoA+JjKF9skKtqEeAhOIf49dWS VlqWb1SLI2ZKz1pznq2t6y019BfJ3HoVlr0pKqPMPz87czqN/m5uAStmxx7IeK+g9f1z fjow== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=PWp/IcIjYGZP5k371PCYmNpH3tCX/RPeKbW8MqCiCdA=; fh=CPCg5h216n2VBteFykEzan7vO2yOXLLLt2vsu7+HH2Y=; b=hVDQoJR8cWqyBNZ1wzr3fHWnDdEz3/eLlSLGYJ0hSWZy1uUYywbOchuTgX4GjnHImE MS7HffOwy8Udmf1H0HvCo0rABSZTyrZ6wpLJMXRh+vi9z6bCU8k1TbNNXiQg3CpdEFfy VPzWP99kxoxxmmgaJCgI/gMnJt8vL06QWNutWv0kCvOgns4zBJCg8hQeWy1fMXdMFgDh RDbQuckMdq6iw/djPie8KHIi+9Sj2bJQh5CkeybWTmYAN+py+tmq0/MW6Wz2pmWHCM4p lqTevT+6Ho9ivFCgXawceYuBQESOO0ptxiyIt0xxHsH1FLNCVNs775h4dnjnPTNci7Ra 713w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id 73-20020a63014c000000b005429248576asi3482098pgb.128.2023.07.07.02.12.14; Fri, 07 Jul 2023 02:12:29 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232344AbjGGJAl (ORCPT + 99 others); Fri, 7 Jul 2023 05:00:41 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42164 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229891AbjGGJAk (ORCPT ); Fri, 7 Jul 2023 05:00:40 -0400 Received: from out30-110.freemail.mail.aliyun.com (out30-110.freemail.mail.aliyun.com [115.124.30.110]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E1EA611B for ; Fri, 7 Jul 2023 02:00:38 -0700 (PDT) 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-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY,USER_IN_DEF_SPF_WL autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1770752467980031175?= X-GMAIL-MSGID: =?utf-8?q?1770752467980031175?= 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.