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 71025C433F5 for ; Wed, 8 Dec 2021 06:26:28 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id B49876B008A; Wed, 8 Dec 2021 01:19:37 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id AF9256B008C; Wed, 8 Dec 2021 01:19:37 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9C1F76B0092; Wed, 8 Dec 2021 01:19:37 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (relay032.a.hostedemail.com [64.99.140.32]) by kanga.kvack.org (Postfix) with ESMTP id 8CE8A6B008A for ; Wed, 8 Dec 2021 01:19:37 -0500 (EST) Received: by unirelay09.hostedemail.com (Postfix, from userid 108) id 7C39A208F3; Wed, 8 Dec 2021 06:17:49 +0000 (UTC) Received: by unirelay09.hostedemail.com (Postfix, from userid 108) id 7920920B9D; Wed, 8 Dec 2021 05:33:54 +0000 (UTC) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 9C2F6213C4 for ; Wed, 8 Dec 2021 04:28:38 +0000 (UTC) X-FDA: 78893345916.15.10F324F Received: from relay.hostedemail.com (relay034.a.hostedemail.com [64.99.140.34]) by imf21.hostedemail.com (Postfix) with ESMTP id 3FDA4D0369CF for ; Wed, 8 Dec 2021 04:28:38 +0000 (UTC) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 1750B20A06 for ; Wed, 8 Dec 2021 04:23:14 +0000 (UTC) X-FDA: 78893332266.19.9E807DB Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf25.hostedemail.com (Postfix) with ESMTP id BE314B000185 for ; Wed, 8 Dec 2021 04:23:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=gbbxmu+s+53RY1++9cSXBb5q+fBsNrDNEdjEeiwvuA8=; b=KHT2l7KWrwSvVWmmvX7PpKnxK1 L8+ad2z1XwLEB+iBzc92Z4LmFXM67tn867+cijQQFdXI2SK/5jA1QXQcTW3hSxM+C45hpOrESrQ4B ro/4VwGFTzcFUFK9qjyUvnndvI0NbL1QWBL61Cc1mlcJM4zG65o9vRwvTFSreAiukTBewdO9W5/uY 34/Mqzb/sUX0MXY2bRZDtEv3xnMmFLrwa+EHLFimUpN749LatBzS/MS3mNypJ+VsHFuYiXCgdgb3r CE5hzDxfh+gbc9pCSY90zXL7rZWAGHbxL8DbfnTxAtioZJKQ3pPPeXgPy9vbU9+djpyw5MKd07zXO fvJoOcWQ==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1muoU1-0084Wl-Nj; Wed, 08 Dec 2021 04:23:09 +0000 From: "Matthew Wilcox (Oracle)" To: linux-fsdevel@vger.kernel.org, linux-mm@kvack.org Cc: "Matthew Wilcox (Oracle)" Subject: [PATCH 03/48] mm/doc: Add documentation for folio_test_uptodate Date: Wed, 8 Dec 2021 04:22:11 +0000 Message-Id: <20211208042256.1923824-4-willy@infradead.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20211208042256.1923824-1-willy@infradead.org> References: <20211208042256.1923824-1-willy@infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=KHT2l7KW; dmarc=none; spf=none (imf21.hostedemail.com: domain of FILTER%willy@infradead.org has no SPF policy when checking 64.99.140.34) smtp.mailfrom=FILTER%willy@infradead.org X-HE-Tag-Orig: 1638937391-689692 X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: 3FDA4D0369CF X-Stat-Signature: fizzq649g1an8nhwp5f1gc3mk9ow667w X-HE-Tag: 1638937718-227484 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: Move the PG_uptodate documentation to be documentation for folio_test_uptodate() and expand on it a little. Signed-off-by: Matthew Wilcox (Oracle) --- include/linux/page-flags.h | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/include/linux/page-flags.h b/include/linux/page-flags.h index b5f14d581113..b3d353d537e2 100644 --- a/include/linux/page-flags.h +++ b/include/linux/page-flags.h @@ -68,9 +68,6 @@ * might lose their PG_swapbacked flag when they simply can be dropped (e.g. as * a result of MADV_FREE). * - * PG_uptodate tells whether the page's contents is valid. When a read - * completes, the page becomes uptodate, unless a disk I/O error happened. - * * PG_referenced, PG_reclaim are used for page reclaim for anonymous and * file-backed pagecache (see mm/vmscan.c). * @@ -615,6 +612,16 @@ TESTPAGEFLAG_FALSE(Ksm, ksm) u64 stable_page_flags(struct page *page); +/** + * folio_test_uptodate - Is this folio up to date? + * @folio: The folio. + * + * The uptodate flag is set on a folio when every byte in the folio is + * at least as new as the corresponding bytes on storage. Anonymous + * and CoW folios are always uptodate. If the folio is not uptodate, + * some of the bytes in it may be; see the is_partially_uptodate() + * address_space operation. + */ static inline bool folio_test_uptodate(struct folio *folio) { bool ret = test_bit(PG_uptodate, folio_flags(folio, 0)); -- 2.33.0