From patchwork Wed Aug 2 15:13:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13338334 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 68A7CC04FDF for ; Wed, 2 Aug 2023 15:14:15 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 261C128018C; Wed, 2 Aug 2023 11:14:14 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 15957280190; Wed, 2 Aug 2023 11:14:14 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E2012280143; Wed, 2 Aug 2023 11:14:13 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id C8D1D28018C for ; Wed, 2 Aug 2023 11:14:13 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 968C0A06A3 for ; Wed, 2 Aug 2023 15:14:13 +0000 (UTC) X-FDA: 81079510386.05.AFEC7D7 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf24.hostedemail.com (Postfix) with ESMTP id 9811218001F for ; Wed, 2 Aug 2023 15:14:11 +0000 (UTC) Authentication-Results: imf24.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=ODgX07Ll; spf=none (imf24.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=1690989251; 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=sWJNYdXqGD763FMdnHwt3YTZQSetHeelliQAJYOMW5U=; b=Oc2rHTpMGOtX+HvjVBSThM7cl5YZQbyhCfTeuEu3ZFXQAyLXmZtEFgKlQq1sC5sq7VRj0L aApNqbLuJEQb+VKREL6lqt52WgSGNE5MoslGMnwJXiaNFN+DzKu+xCuC3AqnALXiDtTJTG 1KE9SPEw4CNF5ojAN+DMI/OTdEHK7Vc= ARC-Authentication-Results: i=1; imf24.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=ODgX07Ll; spf=none (imf24.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=1690989251; a=rsa-sha256; cv=none; b=SKkysK8Y1w9aQz7s43skGDbsj0k5QjrJbN7B+qWGaxz1UxGQ89AQLCbvAKIi7kHJrdj4CB B9XSfvQrd7GZMFmbY5m2IFP1TgbY9q5H0fuCgKGTuLiSYfGPzROT0KSo1HyyCktWYsaxVb Q9kgTScGxfb3ucVopacGkdAS7Sb/Ik0= 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=sWJNYdXqGD763FMdnHwt3YTZQSetHeelliQAJYOMW5U=; b=ODgX07LlP3sQFSkIbptb9AtJgc aaCt28wefXbzh+jzF+mtW4/M2MS161SOAexmrxiEJVBvfMf4Dfthf+3NjqhKyrcEkEOmRfLAgsr2o Zkk3vRGGJAs8v76/DT1wxvYQyQnslgAHIcM9NeAuGr3GAv3/i2oOdrGFNFI/d+ccyTKu6XPbqwSQ/ COCod5aBIAQ7z+dXxFJMofhLgtjXZu5F77MSFSgoRMsJ+U9IlNsgp20zP/XVmaeDFFRbHwIgFndzb je7K0gzcmMJsibrqt1C/K6PDAIPqugOFgc4j7kRSb8OBNR4d9LS2i0IQZSZ4eJPK9V6Al4Zz1+ZOz Gqw0+z5Q==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qRDY8-00Ffig-6O; Wed, 02 Aug 2023 15:14:08 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-arch@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport , Anshuman Khandual Subject: [PATCH v6 03/38] mm: Add generic flush_icache_pages() and documentation Date: Wed, 2 Aug 2023 16:13:31 +0100 Message-Id: <20230802151406.3735276-4-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230802151406.3735276-1-willy@infradead.org> References: <20230802151406.3735276-1-willy@infradead.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 9811218001F X-Rspam-User: X-Stat-Signature: du7nkuwudcw64eu4nsij1spuhy5wtqin X-Rspamd-Server: rspam01 X-HE-Tag: 1690989251-154693 X-HE-Meta: U2FsdGVkX188jJtR4n6fqivjn/zX36wzHC4HJ05NA8uiVTkiqxLLXoQdJaJCQsUUq9a7Sd+lHdVe7jjJE/tnia1rxqzJuY1iZ55x6n550chSNb2uzTDUkH1+DbapI3WO+D73EEizgrgh7giLKbHiRM5aHDavZrich5JvsM1QTN44eflEMji2JURC8Qu69aqVTbfgCSFtmQfdBSwO8Wm98Ogo22epCuElptW/5zTFLsL358K2uFwaRNDqvKoaySoWGPDW1RiNtT+m7zfUAKgFRLqTUV1JDJzFc4h0z8i0CSg700LTj7ppC0O1MBDaZkQavPVCKsZbD45cVZ8US/qygO7UETlfTKVPPUFQSbWNarWHJHhI8yq9c1Q3sLt8XHSK0NRoojJyCDeGgJ/mVdUEtiI9Nrr18+9lOQi4Z3aVcQx0vVBYg/bQbUfTV5VUHfL8RsMr9dzIvX4a/gbM9wttJwa5T/pWTOsB0LrhCw9liX0jxXPXpzidWwN38I+6330aUlhqvEtPpxdTTU6WpqrR3ikOmmIondW2OMP+I6IdZAf6ygZrtaSFugpzuvXEikiq3cLEmIgJKTEop77zmxp6dddug8tIn5kZ7nRGd6IUpLXdW7Ax0iL25UXl1k8KkWVwvLvuZXV5gCI+tN0/jSAT+Y3jopHCadGrR0Dam27sdLaVjB3C3Wub55c5IC5bdISRC9QUT6c/qNYCtryZ/6/6x052E1+vKbGAGtnmXIU1XpbZ7iay5YJHKVvbUxCUrebyX/tqayIyZS1gG1Y40mCzvflagpcD93TbbCENM5XNf9lNP184d7sZ2lYwl66eG6hfXHzuXcB7zoe++24TET0oZVBtRdiaKl9iGwa/eJKoQ8Sq7d34fPgh1FX+ASBwgm/+hkcI4QiBuAYYQiqWTe+JNmrb7FUmubk1fePXCdvsmt0Mbc4Z9GjKosuQ9NWffmNp8LnsA3ta5sjWytWG1ph UwRcMICQ TahphKxd90YY4A8KlGWwh8TE9X7PMXNj6Ig90x85wY3prT+HHWcP+qpzCC48MImCu8AjIzwUJcLnDcPU2EFL4NGjP8XyBPj+TBwgKMwu94VbRf4eCiVgBobeGCNG2WfkYLPCb4wL6ICs+C2saQ2D6vhuOjMzI62VKc+xPIiqeeoIpy3Esaepy61JR7wlzK4/2H5G1vehNThF+wI+5zwWovfUbDxD83kgxLYfXfvPb9f0qVs2LbtDWCP6c0VVk1QFYv3c5Pyl1y7FgPDxLUvMsnxcT1tjh2aUpsQkXf6QWTXHY9fgt6uAbZ/VKYv3YFvwRI3EakIfdM8USvOrf4kUQxcPhsYZ9OcB2txvC 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) Reviewed-by: Anshuman Khandual --- Documentation/core-api/cachetlb.rst | 39 ++++++++++++++++------------- include/asm-generic/cacheflush.h | 5 ++++ 2 files changed, 27 insertions(+), 17 deletions(-) diff --git a/Documentation/core-api/cachetlb.rst b/Documentation/core-api/cachetlb.rst index 5c0552e78c58..b645947954fb 100644 --- a/Documentation/core-api/cachetlb.rst +++ b/Documentation/core-api/cachetlb.rst @@ -88,13 +88,17 @@ 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_fault *vmf, + 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. + + This routine is also invoked in various other places which pass + a NULL "vmf". 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 +310,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 +374,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) {