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 B462FC2FC0F for ; Thu, 17 Aug 2023 17:22:34 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D65B3940045; Thu, 17 Aug 2023 13:22:33 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id CEED3940009; Thu, 17 Aug 2023 13:22:33 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B6901940045; Thu, 17 Aug 2023 13:22:33 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id A0456940009 for ; Thu, 17 Aug 2023 13:22:33 -0400 (EDT) Received: from smtpin20.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 3A35BA10E4 for ; Thu, 17 Aug 2023 17:22:33 +0000 (UTC) X-FDA: 81134265786.20.C1AFF0E Received: from mail-wm1-f50.google.com (mail-wm1-f50.google.com [209.85.128.50]) by imf01.hostedemail.com (Postfix) with ESMTP id E4B354001C for ; Thu, 17 Aug 2023 17:22:30 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=cE8nmPU7; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf01.hostedemail.com: domain of fmdefrancesco@gmail.com designates 209.85.128.50 as permitted sender) smtp.mailfrom=fmdefrancesco@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692292951; 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:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=SxMhizufldjXqr2LJXmRW1fhXbnI6OJa+DaLU10aqqs=; b=yh0pZRkIjlZdCBu8+vJ8M2QSOSjXsHUzHtPD44wHBr9CC1wLY7sE+pVwKGZv4oVIimFJ/T ui49fJtyjPWdWPVjV/qhDZSG7rD586h92jSXi3nlPV0OhS9DHai2YgkSB25OO+dCUecYfI QDhF8aJ0OOPqJAcPxtP6vDsX2b6T18g= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=cE8nmPU7; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf01.hostedemail.com: domain of fmdefrancesco@gmail.com designates 209.85.128.50 as permitted sender) smtp.mailfrom=fmdefrancesco@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692292951; a=rsa-sha256; cv=none; b=JXl28+PFulkziWio8S2wv+MCusvEiRz/QDKnxfcqnXrBPZD1KkusPH7lJIwmsiYgyG7wrZ XPV3+LmGx5yJYt3diDwueVnP2iLvTExnqBuSI7liq9DBPA5CVMzz+O+6bt/Mnw7fhZye1N uiGEcCBv+EvMk5W7Hyz/dlSfXXM7wj4= Received: by mail-wm1-f50.google.com with SMTP id 5b1f17b1804b1-3fe8a1591c7so1005215e9.3 for ; Thu, 17 Aug 2023 10:22:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1692292949; x=1692897749; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=SxMhizufldjXqr2LJXmRW1fhXbnI6OJa+DaLU10aqqs=; b=cE8nmPU79jz365GDzNZwMeC+RHo/75g3Hck2wL6uFmYOTaBzRFKml9H5vGH5fEcJBc jYTJ4sk/kjrf+b4Z+MaLyZrEO+82tJty+a3J07Pz7mjVe+3ffew8c0W5xJspajTcpipa g4IUjaDodsrhE8aX4DE0+D22u8k36Gl8IzD6FhhVQc5NEB4pAt2TTNWxqaQO/cms6r5G BzsQWy5oogh9cAR3lGOrk5wHE2iFjqCNxOsaz+MHnupl6aQ3KPP8XH6U/rJcAM9owbTf jJd4l4LnWgN32zKjceKvj/j1Q94MdtKYcefG8JWWNunae8yUOO47sr2eBCSEB37gu6Zf 5BBg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1692292949; x=1692897749; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=SxMhizufldjXqr2LJXmRW1fhXbnI6OJa+DaLU10aqqs=; b=bbcvKP0UI/VIEpNk+gjNziY4HHX/ym51m94GZApznnYfxSQ/QplKCkh7trMyvn6yiL KZKmKFUTyjvetu3zkUQb6j3yegjfpxfnTbI2BsJ9QqWOOvzRhLwyNmq4p6OxUMgBM67a QL2xnDdprvCizsFTB7CP2MjjSM9wjVUNxRDEvI3nX47Sa74qOhUoUxDLLh2WZ9+IE6m0 cz40BkQvwdTpEWkhekjKUj2jPHr2qm3ORB8Cna45M61en8oWzGQxtiOMha2Umm+L5/P0 C1zK5ffX2HdHzyMzKcvbg5XPUiLwCgyw/yiKaEQJGoUroLh9axasr43mHmXHbD7sqFC2 LXYg== X-Gm-Message-State: AOJu0YxFxLD7//8bUjMVZz7PHbFgwEoS1/hezEFCqUf1kA4HzYIiLSev kJP05iiYrDloc72qY6kYxRI= X-Google-Smtp-Source: AGHT+IHUcsncBbdMEjkERvYbkzbI5x/ECjIiPMT2fuyKCWabM0+Ufwa1Gdq7bs5fdXXcSgHEV3JrAQ== X-Received: by 2002:a7b:c84b:0:b0:3fc:616:b0db with SMTP id c11-20020a7bc84b000000b003fc0616b0dbmr327435wml.9.1692292949050; Thu, 17 Aug 2023 10:22:29 -0700 (PDT) Received: from suse.localnet (host-79-56-101-183.retail.telecomitalia.it. [79.56.101.183]) by smtp.gmail.com with ESMTPSA id k9-20020a05600c0b4900b003fbd9e390e1sm3629554wmr.47.2023.08.17.10.22.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 17 Aug 2023 10:22:28 -0700 (PDT) From: "Fabio M. De Francesco" To: linux-doc@vger.kernel.org, Jonathan Corbet Cc: Andrew Morton , "Mike Rapoport (IBM)" , Ira Weiny , Deming Wang , linux-mm@kvack.org, linux-kernel@vger.kernel.org, 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() Date: Thu, 17 Aug 2023 19:22:25 +0200 Message-ID: <2898756.e9J7NaK4W3@suse> In-Reply-To: <87r0paxooq.fsf@meer.lwn.net> References: <20230708121719.8270-1-fmdefrancesco@gmail.com> <87r0paxooq.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="iso-8859-1" X-Rspamd-Queue-Id: E4B354001C X-Rspam-User: X-Rspamd-Server: rspam05 X-Stat-Signature: fyoorkgw1nqzmjpy7sb4ud37t4pfjsw7 X-HE-Tag: 1692292950-493921 X-HE-Meta: U2FsdGVkX19vAeSExmn/53lb4NAOcjt7pnNeZKyHPDC3PmcHA9mRV9dD4J2QC8zTr0wmvlh47PaxwD1yU7XFK6yewTGyNukiQmOpQyqo9l0A3l2sCI4Tbo0q2KBrx+s+/CJnKxKOqlhjz4neiwaslCfPn10RXyx2aeOwxUrogGnbyK69o1LPlW6ysTTd2mjEkhQclNWhaD2fjfzEh0kDZ07rg8wH7BoIFoGkcERTGKx1mpEvXBbZ9PmgHrEdmUPIdduK1EwM2l356EbFZQ0hheD7cMkPYQle9wCmlNCj3y84ezdZL+hbbkUxuPn5nwN4aBhTrf50bCfNU56aMPLMt6PpEAOVIEEKgq5LAYiX/fUdfLojDTqkGt7MaDVWWx6azl1vSJrkBT4SB9lJQvmID8eXSHo/RJessD53iAyRM7IUWAu9RSLrd+ioCEwTf3586qU7LyiPWO8n5St/wjFJZA3UHX/nr+xSFY1YRALsARAN6/ruDqqYWnymzs00D5YiOzTVAckNsOM+RgwqeMPRNKFUX/V4dET98sz5j0DrufyJg4IBUcmQhwKlV0EPJCGRqLpY7oQjOmHVGOkSXM+EO/e2poNVWpnIIwTlme9sayTwXZfc+zvqWnBhVMvEO6P7h/+Q/yR0xV4xa+xSvjP9hdBSqV2xxgjDtrsHOeJgNkGit2QW6DBcsUr/lGWtffPYaug43qtE8Am+6AfG2CZ7xhk5qhHMEfAkpVfvGsth5i1XhXUaQKTYgqvpVN/1Lf+uBPNFb8yFgfR6fPek/q2JMnqloD3BKyoajY5lUI6dQAZ0rGNKmNargUUtN1qGKTT7Ojh9RY1jBvrOIK3RPykKBy7fZ031HA3Z3zrN57YEqBIPRiwcwJmkYIkK33qGNO9WwrdICKYTPr6UL/WH1KUAFxol3D1iA5fUdZSXuSz0XO3UEAQ+c2l6WcKXdUCSZ523tLws0au/hVycojprhGk CSDSEAr1 rtP6y0S4c3cT/ooo96d6YCobO0x2FL7dzL8v4Z4eHlowEgxYy7ZdIdrPZL8/t7DtHEv4icdhEHYnUKJkTOgtPs5+dNgOdA3IkyyslgYWu/PQGGcv/ErO2hzN7UL/bgyo/KMRVTe4fsxGV/f/WPLWRTr3sz0dJZitY0UF1iJQuKooyUlT8gIoM5S15UMbBFIX75gF9aQMVvtOj7R3BqSD0klgz3m2aj0xwU813BPFeXuqNzCBI9SKpYhsFhNNLAp4iMaHz8D1Gzm9PeiuBYnxWRzzJBLdtvYycpJSffohbYZ9WPrBDkV0x+ojXm5i2s8qQlg8y7nNFSYVFU1482cUMllhzr3ry8Hc4kSEFNLTWpPKY4nR8hj5BXgucdDKOBm7JadjOsX8xznAZdBWPV70WAt8eYP9FjvPDwr1ysSL0lrol6GgZyW5aK8vMANpijV+u6gNLqZQltz6Ty4mih0n/KNdPMk5oMP2YLCbL07oZdnMTF8gkptlKwH8e/g== 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: On venerd=EC 14 luglio 2023 21:45:09 CEST Jonathan Corbet wrote: > "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 wh= ich > > identifies the page. > >=20 > > The two API's can be explained at the same time in the "Temporary Virtu= al > > Mappings" section of the Highmem's documentation. > >=20 > > Add information about kmap_local_folio() in the same subsection that > > explains kmap_local_page(). > > > [snip] >=20 > Applied, thanks. >=20 > jon Jonathan, Can you please tell me which release is this patch for? I see that it has n= ot=20 yet reached upstream. Thanks, =46abio