From patchwork Thu Feb 24 01:43:44 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 12757775 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 329F5C433F5 for ; Thu, 24 Feb 2022 01:43:52 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 81F008D0002; Wed, 23 Feb 2022 20:43:51 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 7CDF78D0001; Wed, 23 Feb 2022 20:43:51 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 694A58D0002; Wed, 23 Feb 2022 20:43:51 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0181.hostedemail.com [216.40.44.181]) by kanga.kvack.org (Postfix) with ESMTP id 3B3EA8D0001 for ; Wed, 23 Feb 2022 20:43:51 -0500 (EST) Received: from smtpin18.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay03.hostedemail.com (Postfix) with ESMTP id BBFE28249980 for ; Thu, 24 Feb 2022 01:43:50 +0000 (UTC) X-FDA: 79175977020.18.C6BB745 Received: from out30-56.freemail.mail.aliyun.com (out30-56.freemail.mail.aliyun.com [115.124.30.56]) by imf22.hostedemail.com (Postfix) with ESMTP id 61050C0003 for ; Thu, 24 Feb 2022 01:43:48 +0000 (UTC) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R201e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01e04423;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0V5LKxlS_1645667025; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0V5LKxlS_1645667025) by smtp.aliyun-inc.com(127.0.0.1); Thu, 24 Feb 2022 09:43:45 +0800 From: Yang Li To: akpm@linux-foundation.org Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] mm/rmap: Fix argument list that the kdoc format and script verified. Date: Thu, 24 Feb 2022 09:43:44 +0800 Message-Id: <20220224014344.99537-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 Authentication-Results: imf22.hostedemail.com; dkim=none; dmarc=pass (policy=none) header.from=alibaba.com; spf=pass (imf22.hostedemail.com: domain of yang.lee@linux.alibaba.com designates 115.124.30.56 as permitted sender) smtp.mailfrom=yang.lee@linux.alibaba.com X-Rspam-User: X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 61050C0003 X-Stat-Signature: rts56o8jdg59huc1hgheg3dgriuyj63y X-HE-Tag: 1645667028-494841 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: The warnings were found by running scripts/kernel-doc, which is caused by using 'make W=1'. mm/rmap.c:1684: warning: Function parameter or member 'folio' not described in 'try_to_unmap' mm/rmap.c:1684: warning: Excess function parameter 'page' description in 'try_to_unmap' mm/rmap.c:2086: warning: Function parameter or member 'folio' not described in 'folio_make_device_exclusive' mm/rmap.c:2086: warning: expecting prototype for page_make_device_exclusive(). Prototype was for folio_make_device_exclusive() instead Reported-by: Abaci Robot Signed-off-by: Yang Li --- mm/rmap.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/mm/rmap.c b/mm/rmap.c index d27d79ec11b7..ebcf17d8ac1c 100644 --- a/mm/rmap.c +++ b/mm/rmap.c @@ -1671,7 +1671,7 @@ static int page_not_mapped(struct folio *folio) /** * try_to_unmap - try to remove all page table mappings to a page - * @page: the page to get unmapped + * @folio: The folio we're currently operating on. * @flags: action and flags * * Tries to remove all the page table entries which are mapping this @@ -2068,8 +2068,8 @@ static bool page_make_device_exclusive_one(struct folio *folio, } /** - * page_make_device_exclusive - mark the page exclusively owned by a device - * @page: the page to replace page table entries for + * folio_make_device_exclusive - mark the page exclusively owned by a device + * @folio: The folio we're currently operating on. * @mm: the mm_struct where the page is expected to be mapped * @address: address where the page is expected to be mapped * @owner: passed to MMU_NOTIFY_EXCLUSIVE range notifier callbacks