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 816CDC001DE for ; Fri, 14 Jul 2023 19:45:15 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C199E6B0071; Fri, 14 Jul 2023 15:45:14 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id BC9836B0072; Fri, 14 Jul 2023 15:45:14 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id A90F86B0074; Fri, 14 Jul 2023 15:45:14 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 947906B0071 for ; Fri, 14 Jul 2023 15:45:14 -0400 (EDT) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 58E1F16039C for ; Fri, 14 Jul 2023 19:45:14 +0000 (UTC) X-FDA: 81011246148.10.2C71720 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf13.hostedemail.com (Postfix) with ESMTP id B62DA20018 for ; Fri, 14 Jul 2023 19:45:11 +0000 (UTC) Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=ANq8x1n7; spf=pass (imf13.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1689363911; 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-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=9OVkrDxVo6A8WjUDU3AQWi2pZQRzBF2hWL+uV9EMi1g=; b=KAHv7B0FCVFsN+Hc5OW0OP8FD5KtvZsEI2WIidKxgaIThManVtlPiDhIp13wjS6WTFTLZw 6kqV0/eIfznRbPHLoh8EyG03nl4FCwiCMAG/oAg8v2LBHCYuLm6jAeDEsom37mG2FGYWns bZRtY0tjHGpxQkDTvR+tvEamA/Fz5HQ= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1689363911; a=rsa-sha256; cv=none; b=pM4fV3mXax4umicKnXz47BCLGrAIcsEZuDRtm65R8H4m+xOPGk/4R2U0PZ4nU7ETVUP0Ih 1AOukX6o7g06OK0um7hSKLUhhZiunhG6tnw9TM/o1qvJc285K6dnJB/x5DMQyGJwkS23zy ONSjDOLCiDkKssjCu3ADFoaB0bYo3ns= ARC-Authentication-Results: i=1; imf13.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=ANq8x1n7; spf=pass (imf13.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id E45505BF; Fri, 14 Jul 2023 19:45:09 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net E45505BF DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1689363910; bh=9OVkrDxVo6A8WjUDU3AQWi2pZQRzBF2hWL+uV9EMi1g=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=ANq8x1n7PadXgahfP2nzKXNTDfFTWa3BbWdyMolgk4uSDitLr7TMl5M3g4+i4dE91 hsR/poL7G8l/tEz9c8zFsSrinOLJ1ERiwfYyYtaPmBfGvk7bcqKij055X0aQ5+cxDS GJk4/0V29H8vBoiB9hFdHGPITm9BgXKx/+47obuQFhv/Wld+LiMpPVByuKtlkYrP5t Fy+H9yhpoxdxSCusZ7kArhtO+2TiHZiC6/m4KwowWsPbZP1LmSO1V4qV88ChcZAAaV Gsdla5Jx3eUxySSW5tswO35JrVB+w/jdpI6On+oAdoFamUP8hZvdIfbJiM0mVO3nV3 Io/hypcwkBDDA== From: Jonathan Corbet To: "Fabio M. De Francesco" , Andrew Morton , "Fabio M. De Francesco" , "Mike Rapoport (IBM)" , Ira Weiny , Deming Wang , linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org Cc: Catalin Marinas , Matthew Wilcox , Mike Rapoport , Peter Collingbourne , Peter Zijlstra , Randy Dunlap , Sebastian Andrzej Siewior , Thomas Gleixner , Vlastimil Babka , Will Deacon Subject: Re: [PATCH v3] Documentation/highmem: Add information about kmap_local_folio() In-Reply-To: <20230708121719.8270-1-fmdefrancesco@gmail.com> References: <20230708121719.8270-1-fmdefrancesco@gmail.com> Date: Fri, 14 Jul 2023 13:45:09 -0600 Message-ID: <87r0paxooq.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspamd-Queue-Id: B62DA20018 X-Rspam-User: X-Stat-Signature: ic9fbcnh1fx5adhrwfiapjfdaqyciwtu X-Rspamd-Server: rspam03 X-HE-Tag: 1689363911-40340 X-HE-Meta: U2FsdGVkX1+haiU4wfATPPfLikyZBgy1zYkz7hAgfCwyMhz9iYcSddaGU+P4DGRRE7gOQ7XZXhuV5UGu1KOFzFUSEuquMUHm4IHZoYweb3aNfT5SPPOYNMnsM6HRv8qqkU/DLQr/1JcdBsjsvu/0KY4qMVHSUxTDlL6UkU3IU/Blkt1pfIoYq8eCBzAI/6aqnY5TXWOvc1PCRaVn6XAn4qNsFRZe5EfDvqxklANDICuaVd5OJNXaMiljkesaYqT27VjLQAGSYAJfJ52GhsABo7WivCzgQ1s79sRfDyir3aJ+jlLLqKHkexj40GIX+u1LjAAQR/DZ2jfTBuevM4QmrPRF6Jpc3DCLlVfo/fiB7imBN2awaFoeQJHE28Pyzz61Rm/5NJg5+5NTXan30Bop65PjXS+9m/XIxr0wVpWbx6DkajTMSc2Fl00IJWCfXof1DT7kWYBWlTwY7UDQxrtr0mNGmnGUqdJM4qpzDXzn+x0K1qspnZYGC/rmFiVSkbdkR6zHIh877GFBkTlIf7nDKIyZESklHJFD8lyukN9M/HtbZfmtHz7FaubwhxeukFk+HEvEBu2B5Ab/JlOO5qFg69LxBtdFwau4A3tD+Co4NG+5gkKj0Qrno96GQjrlqnuu3LIqU2M0GcVAAYr+AV2HKY7AF0MmPJqwtP8PEuMXMFt3BbQyV7lk5IibSAv61s72XUr2I3SRO7dwghBQKY4cjY1kLRnGbgIiFd22JtnGGn4yxP9Tk9QCXPTp6BR0QyzPJeBb0GjhS9m5QXbdPc5M4ekt7wV0tK1lVH1/43i4vSyhte+AyM1msxg1DcB/VL9iEw2qXgT0yLO0ymU0BoUNpBCyVrHMQxsQnQKEGW6/pTtyR+KpAMkOxnmqUeLeHRV+PF2OK7qtS7kfhojhAcqP43VNkiuRkj4c84c84qJ3SV2Kolpp3P9Rcai/Lz4L5u11de+szx4ZY8rhxbAKH8Z cfJUv46J KVLi7oIUAVV6s1pmiuaFJlMZ+tWq+exSzLlbjGw/iEHaZ+akXbxVtLpKkkjzMjE6QydNS+RONLT4O18sGlT1gDp5cCPzSS+5ksGHIbKqoHhkduIKo2wxE5YDTc5CGc3YQ8xw9mSyjwKgD2OlhaK50aG+1SnsvJ3vFx4lmEhrB6zsoH5MXbbMr1l7N29PGQF74TlDRufQ/2aHiyJ0+GzM2cYZDgc4KWJNkz+hOpNIvuykJ6ccr3jRDCTVSXKUMFhGU/UGBofjPkTT1IeI0fw882SkSFQVAfwJuwrC8UL2lcsPiCWc+PgJTXJQF6XRvQ48/+QqLTI2MaiLhs19R7hIA8gOQ92rAFb43uM3UQOzy86jsJrzoDFRmhAq1hhhWIN46afyVyLPLyGVmrei79pfRNqhvZC7ZVT5r7bBEo4fok648ffQ4+mTUCfNpTFgZRN4r82dSF7ay0Ltohn18mwCYQQrTfbIvJGpmCaOhigiqVRaJivrFu2CCdS4/9E1n+nbUEk77wVftDykm1h5VU40Dx9Tis9pdCv3GIopP/IdfqDu0AGHbjX2wF3XjCQ== 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: "Fabio M. De Francesco" writes: > The differences between kmap_local_page() and kmap_local_folio() consist > only in the first taking a pointer to a page and the second taking two > arguments, a pointer to a folio and the byte offset within the folio which > identifies the page. > > The two API's can be explained at the same time in the "Temporary Virtual > Mappings" section of the Highmem's documentation. > > Add information about kmap_local_folio() in the same subsection that > explains kmap_local_page(). > > Cc: Andrew Morton > Cc: Catalin Marinas > Cc: Ira Weiny > Cc: Jonathan Corbet > Cc: Matthew Wilcox (Oracle) > Cc: Mike Rapoport > Cc: Peter Collingbourne > Cc: Peter Zijlstra > Cc: Randy Dunlap > Cc: Sebastian Andrzej Siewior > Cc: Thomas Gleixner > Cc: Vlastimil Babka > Cc: Will Deacon > Reviewed-by: Ira Weiny > Reviewed-by: Mike Rapoport (IBM) > Signed-off-by: Fabio M. De Francesco > --- > > v2->v3: Replaced "request" with "create". Noticed by Randy (thanks), > fixed by Matthew (again thanks). > https://lore.kernel.org/lkml/970a881a-cdaf-2568-657a-3b93b0273338@infradead.org/ > > v1-v2: I had Cc'ed everybody but Andrew :-( Sorry, it's now fixed. > In the meantime, I collected the review tags by Ira and Mike > (thanks to both of you). All entries are listed using a simple > ascending lexycographycal order based on first names. > > Documentation/mm/highmem.rst | 27 +++++++++++++++------------ > 1 file changed, 15 insertions(+), 12 deletions(-) Applied, thanks. jon