From patchwork Tue Feb 28 21:37:05 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13155245 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 385F8C64EC4 for ; Tue, 28 Feb 2023 21:38:09 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C4F6F6B0093; Tue, 28 Feb 2023 16:37:49 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id C00076B0092; Tue, 28 Feb 2023 16:37:49 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id AA0256B0093; Tue, 28 Feb 2023 16:37:49 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 934A26B008C for ; Tue, 28 Feb 2023 16:37:49 -0500 (EST) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 6D13DA0D69 for ; Tue, 28 Feb 2023 21:37:49 +0000 (UTC) X-FDA: 80518013058.11.6983AD8 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf08.hostedemail.com (Postfix) with ESMTP id A7E4A160014 for ; Tue, 28 Feb 2023 21:37:47 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=SnSZ9lDB; spf=none (imf08.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1677620267; a=rsa-sha256; cv=none; b=TUKrrDvowbbQBOha5TzeFunvSTpBeE09L1u60ws/zl6at6fFhACya8Agiu6LyoS1KLHhA8 /QOCTGXJzziRfC2EjfxU7GyHQc+xd0rKtjMVRV2FUdZYujhiCdEfkTA6luHq9hTYFMyZyJ h5g+TpC53JjEvnkhf3w/ny/i+dMEQ/k= ARC-Authentication-Results: i=1; imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=SnSZ9lDB; spf=none (imf08.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1677620267; 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:in-reply-to:references:references:dkim-signature; bh=goynt5niP0v9aEgqldbKfY9zrWSKLPIYoftetp9ETpc=; b=h0LGFuJdfuH+UixlRJ60/bz+YfZc3qR9mqboIyNVCzSg5DPsk6IYTFSr2H3yedIOAqrrWP b8Z3NRDhnpkrqNcgwY8l4Jgv3NTHs37yuhg8yfSiE/0Db1IAvtIf2dW0/K3e7LFZYfOM2S yPlJrWQZ1voRAK55HuawOoIE1ZIF074= 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=goynt5niP0v9aEgqldbKfY9zrWSKLPIYoftetp9ETpc=; b=SnSZ9lDB/BBxP/CV69NmolSCQS 0cuOuB1PvC3Cyo73sMiE72INL5B+MlCDkHoO/vCso0e/cPBdn1Mo66xeJgrZvdDk2JEmaFWJIGbNL C+m/5sDD/h7mlDQW0dBCb7b3LMoxbGCVKIJcosPbhZnBx1tAP7kLWRM8OlecdSwoKgquypQCiBlI0 yQySTZC0IrVYS4ytXo8/oBAashPe0mVVrXG02yJo5exF0rIXUvmTkZvZEMo1oSHLpQidx4NitEJX7 kPKib2ibpZZXHT1STrdXWxBQdErEEB+e3GKFC5s81JmJmd2otXTYWYnZiZTDzGPZ9JftAhMFId4Ln lOQWXEig==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1pX7fH-0018oW-MA; Tue, 28 Feb 2023 21:37:39 +0000 From: "Matthew Wilcox (Oracle)" To: linux-mm@kvack.org, linux-arch@vger.kernel.org Cc: "Matthew Wilcox (Oracle)" , linux-kernel@vger.kernel.org Subject: [PATCH v3 02/34] mm: Add generic flush_icache_pages() and documentation Date: Tue, 28 Feb 2023 21:37:05 +0000 Message-Id: <20230228213738.272178-3-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230228213738.272178-1-willy@infradead.org> References: <20230228213738.272178-1-willy@infradead.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: A7E4A160014 X-Rspamd-Server: rspam01 X-Stat-Signature: ckfkuyzxac5gikqytcsoiqtbkqk7cs7z X-HE-Tag: 1677620267-216361 X-HE-Meta: U2FsdGVkX1+gpyIBhw7xxGnRV0JrK2MFsF7k+5+vQxR4Q1htCDjFA0uZ+jIbd6wF86iK9vzX7dcAoAcjp8jI+HUOvr/EbVIK0Idrfb56OX/kwNwmEOEhAlidO7f8W5wjxIf6MRIQ023raIYDsQUNYc2haM1SrnEdRZgGWTU2Qd9qWfctPcgEslbbDstjGVvfgjxReGbS7yPn2WwxU+7gEe8fwIxEtgLSrEwJfbA5sANtNN5KGzOljQefYOtOLJUo9VHEs1wkiHDWGYPQY+2Q5EWV3bXoKYx/CB2uub2Bbzlv1CoFvHAn0MXrrPTBDnfIW4tkb+qRhKYWVALb7PG4fx6PZFBvyuNSZCzvlhdVa8+4ZNmMRsW1moMfy5XbsIED1A/WR0uDtu64GHL0efHHyJoZ3beBi2hd3/nkx86W+/cXLtscYddoVK7gqNVE72U9Moynaks9Y0v7ikFUwks61or9YbupGKO8/pwS0X3pvaYBxiAn7sWIfaz8GLdOXIOZGwQSpeN48W/zCsz0w+PanxYlry6H4jZpnWGMswBymQL0+lyUQtT86ynBpl1jLOLHnBI3/CMtn3bb6/FRJNrM2mL+4QJxKs0EAk6IrnSthKUGPqyWX1KiWuAyxJl4kT6W83B4yqXAk1Wo0giuifxfV8FZY/1rn9KkTthW4pmyipfMCONLFwNi0Ip85P0KPILBZY/D4Yt9QEvrsPPhCBNdAFz5ejT9QFvS1LUhXEhzbpMwAMWSgL/S1S7PBE6o5nwAaRnOATbf5Qm4lpPgWT6T7z1p2jnQdggXmNPSTh9pGFOtF2MkgVdrhuLqobXrmKgSnG/SmIrXi4/2j0CKvLSZyr/GoJyhfgmzLthYahyWmrYbmK6ch/449yFtIGBDpCRZs1X9HFR+1SMWMnwJelD8VBwQI1MtHH58bGajx8oze4ZZ+42PmlyZYAJs4kgxY6RnySezePVGSXWsmhG1IcO LV733CzV Q2/DNVgz1qfTZe7jZ7pR55K58E5HsqV/NvGGn7oZtTxnyAfFTtikWKFUVYTtsJVZe/EFyuAby3xfY4g3DDXilG6wt3mTGkusTM+TNfM7yzru2KvXsC3YmIBfp3zdBxh1yHnpSHWnrAXo1m0k0tAttpzDlJC1dVtzNvuUe0g11UfLld5k4lEKWtQtA09PSyOv/B9fUQvuRH8T6HyGRnlrPKZUb5J20RqWCtNFyvocwM+RxH1shkKCthBzpzw== 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: flush_icache_page() is deprecated but not yet removed, so add a range version of it. Change the documentation to refer to update_mmu_cache_range() instead of update_mmu_cache(). Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Mike Rapoport (IBM) --- Documentation/core-api/cachetlb.rst | 35 +++++++++++++++-------------- include/asm-generic/cacheflush.h | 5 +++++ 2 files changed, 23 insertions(+), 17 deletions(-) diff --git a/Documentation/core-api/cachetlb.rst b/Documentation/core-api/cachetlb.rst index 5c0552e78c58..d4c9e2a28d36 100644 --- a/Documentation/core-api/cachetlb.rst +++ b/Documentation/core-api/cachetlb.rst @@ -88,13 +88,13 @@ changes occur: This is used primarily during fault processing. -5) ``void update_mmu_cache(struct vm_area_struct *vma, - unsigned long address, pte_t *ptep)`` +5) ``void update_mmu_cache_range(struct vm_area_struct *vma, + unsigned long address, pte_t *ptep, unsigned int nr)`` - At the end of every page fault, this routine is invoked to - tell the architecture specific code that a translation - now exists at virtual address "address" for address space - "vma->vm_mm", in the software page tables. + At the end of every page fault, this routine is invoked to tell + the architecture specific code that translations now exists + in the software page tables for address space "vma->vm_mm" + at virtual address "address" for "nr" consecutive pages. A port may use this information in any way it so chooses. For example, it could use this event to pre-load TLB @@ -306,17 +306,18 @@ maps this page at its virtual address. private". The kernel guarantees that, for pagecache pages, it will clear this bit when such a page first enters the pagecache. - This allows these interfaces to be implemented much more efficiently. - It allows one to "defer" (perhaps indefinitely) the actual flush if - there are currently no user processes mapping this page. See sparc64's - flush_dcache_page and update_mmu_cache implementations for an example - of how to go about doing this. + This allows these interfaces to be implemented much more + efficiently. It allows one to "defer" (perhaps indefinitely) the + actual flush if there are currently no user processes mapping this + page. See sparc64's flush_dcache_page and update_mmu_cache_range + implementations for an example of how to go about doing this. - The idea is, first at flush_dcache_page() time, if page_file_mapping() - returns a mapping, and mapping_mapped on that mapping returns %false, - just mark the architecture private page flag bit. Later, in - update_mmu_cache(), a check is made of this flag bit, and if set the - flush is done and the flag bit is cleared. + The idea is, first at flush_dcache_page() time, if + page_file_mapping() returns a mapping, and mapping_mapped on that + mapping returns %false, just mark the architecture private page + flag bit. Later, in update_mmu_cache_range(), a check is made + of this flag bit, and if set the flush is done and the flag bit + is cleared. .. important:: @@ -369,7 +370,7 @@ maps this page at its virtual address. ``void flush_icache_page(struct vm_area_struct *vma, struct page *page)`` All the functionality of flush_icache_page can be implemented in - flush_dcache_page and update_mmu_cache. In the future, the hope + flush_dcache_page and update_mmu_cache_range. In the future, the hope is to remove this interface completely. The final category of APIs is for I/O to deliberately aliased address diff --git a/include/asm-generic/cacheflush.h b/include/asm-generic/cacheflush.h index f46258d1a080..09d51a680765 100644 --- a/include/asm-generic/cacheflush.h +++ b/include/asm-generic/cacheflush.h @@ -78,6 +78,11 @@ static inline void flush_icache_range(unsigned long start, unsigned long end) #endif #ifndef flush_icache_page +static inline void flush_icache_pages(struct vm_area_struct *vma, + struct page *page, unsigned int nr) +{ +} + static inline void flush_icache_page(struct vm_area_struct *vma, struct page *page) {