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]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6549CC433F5 for ; Thu, 24 Feb 2022 22:11:10 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id CB8F68D0002; Thu, 24 Feb 2022 17:11:09 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id C68858D0001; Thu, 24 Feb 2022 17:11:09 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B57878D0002; Thu, 24 Feb 2022 17:11:09 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (relay.a.hostedemail.com [64.99.140.24]) by kanga.kvack.org (Postfix) with ESMTP id A6C908D0001 for ; Thu, 24 Feb 2022 17:11:09 -0500 (EST) Received: from smtpin01.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 6D04820FA4 for ; Thu, 24 Feb 2022 22:11:09 +0000 (UTC) X-FDA: 79179069858.01.E1A1D93 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf29.hostedemail.com (Postfix) with ESMTP id 874F6120002 for ; Thu, 24 Feb 2022 22:11:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=gWZg4Mci3xMMsMEKOEhQVemcFoUDv2r9A30g2OkQn5Q=; b=WQKWMh7keWV19NfHy2Fp2epWvW GhuT9NVFRE/xGT5ypZtUYqcBTzwyA9S5T1xiZUoUgHlRmO1UQeNWCfRnhpVWsWODmeV7mze37dPyl HfgdyeeWmA2zbKW5KL5oJarc9wjPjaTU+IzIekcqRiAS4aBcSptMO0xiZMsqDKi9pinxtjkN7NAJy gsHPPw7lbO1U8BwgjxldHsgHbLjIgeemX+8lefL2f09eSsyYR4+m1z+VS3ZQOCTR4x7k8hF51hWH5 LS2BhNL4hwSUiKIebZ5Q9BwG2gXVqI/momUwsQOygIokUS3RCAgySXhiUScbo8vNsMAd9uf1szyJ8 5mRJIp/A==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1nNMKF-005BYv-72; Thu, 24 Feb 2022 22:11:03 +0000 Date: Thu, 24 Feb 2022 22:11:03 +0000 From: Matthew Wilcox To: Yang Li Cc: akpm@linux-foundation.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Abaci Robot Subject: Re: [PATCH -next] mm/rmap: Fix argument list that the kdoc format and script verified. Message-ID: References: <20220224014344.99537-1-yang.lee@linux.alibaba.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20220224014344.99537-1-yang.lee@linux.alibaba.com> X-Rspamd-Queue-Id: 874F6120002 X-Stat-Signature: fynsr359rar13ykzi8o96qa1bcfigtx9 Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=WQKWMh7k; dmarc=none; spf=none (imf29.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org X-Rspam-User: X-Rspamd-Server: rspam11 X-HE-Tag: 1645740668-835494 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000597, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Thu, Feb 24, 2022 at 09:43:44AM +0800, Yang Li wrote: > 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 /** - * page_make_device_exclusive - mark the page exclusively owned by a device - * @page: the page to replace page table entries for - * @mm: the mm_struct where the page is expected to be mapped - * @address: address where the page is expected to be mapped + * folio_make_device_exclusive - Mark the folio exclusively owned by a device. + * @folio: The folio to replace page table entries for. + * @mm: The mm_struct where the folio is expected to be mapped. + * @address: Address where the folio is expected to be mapped. * @owner: passed to MMU_NOTIFY_EXCLUSIVE range notifier callbacks * - * Tries to remove all the page table entries which are mapping this page and - * replace them with special device exclusive swap entries to grant a device - * exclusive access to the page. Caller must hold the page lock. + * Tries to remove all the page table entries which are mapping this + * folio and replace them with special device exclusive swap entries to + * grant a device exclusive access to the folio. * - * Returns false if the page is still mapped, or if it could not be unmapped + * Context: Caller must hold the folio lock. + * Return: false if the page is still mapped, or if it could not be unmapped * from the expected address. Otherwise returns true (success). */