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 579ECEB64DD for ; Sun, 2 Jul 2023 13:05:17 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6B8108E0078; Sun, 2 Jul 2023 09:05:16 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 6686E8E0059; Sun, 2 Jul 2023 09:05:16 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 508F48E0078; Sun, 2 Jul 2023 09:05:16 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 3F8338E0059 for ; Sun, 2 Jul 2023 09:05:16 -0400 (EDT) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 105C4C0797 for ; Sun, 2 Jul 2023 13:05:16 +0000 (UTC) X-FDA: 80966692632.19.44CC113 Received: from mail-wm1-f42.google.com (mail-wm1-f42.google.com [209.85.128.42]) by imf03.hostedemail.com (Postfix) with ESMTP id 14E6920022 for ; Sun, 2 Jul 2023 13:05:13 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=BuPmVteA; spf=pass (imf03.hostedemail.com: domain of fmdefrancesco@gmail.com designates 209.85.128.42 as permitted sender) smtp.mailfrom=fmdefrancesco@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1688303114; 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=Dgdbr/HmtEQw8fSZt1jOsGt71w5fzM6AVixcIzI7qJk=; b=Dazj5V1Po6GifTH61YTX3PTvzt21cVTmrjB5AlKmMwtIJ5NMPeyuKYufsmdO1euM1Hjia9 dcbI3jtXMZQh0vVlqRaabLHDCE5LZrwwvtSMiBAG6/weXFEjNqvjd7X69NvQ1j7ZjWEPMv 863WAw3G8D3s5FibQeg+1fEjdZFpPPM= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1688303114; a=rsa-sha256; cv=none; b=LKLCmPgTLUx7GZzNkpNt6dtgjgU43GgDIiGAxK5KEOMPktj6MsEzFH4vY6m4gwj8TTQA7p hlC8xIPPOTpapoersHZ73fZCQPWkldfTfDjjMZYlqH4Gyq5IO3rItD06EfG0yBT7tMh7py cfg2W5zQITIK20IUNenCN4V4GssdSbM= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=BuPmVteA; spf=pass (imf03.hostedemail.com: domain of fmdefrancesco@gmail.com designates 209.85.128.42 as permitted sender) smtp.mailfrom=fmdefrancesco@gmail.com; dmarc=pass (policy=none) header.from=gmail.com Received: by mail-wm1-f42.google.com with SMTP id 5b1f17b1804b1-3fbc244d39dso42071535e9.3 for ; Sun, 02 Jul 2023 06:05:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1688303112; x=1690895112; 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=Dgdbr/HmtEQw8fSZt1jOsGt71w5fzM6AVixcIzI7qJk=; b=BuPmVteApu1zcDJhkUW6FT4U4hP+BmZp0AG67WPeohkAkUaRSYIPGHMQywBPlsSJ0P h5qj/+r+48xaHfmRiiNH5c0Gf+3xVPtZpIGeYBRcrq1XmkGHl5mO7hEWe/7sWhgIbD1s bHzPJQwPlAs4p4VLR4rYJUJngP9OEFdF6wQKvjyaV+B0pTK2sJqPptr1rr9D41tv8yWU SYHetBT2ppr6gclkuXPAH6FZsoAl7QyVI+3G4qC6R2JSzOPZ+73MkU7anseCunQEOTry r2JFe6Bo9DHxcrCmZYFQzBbm3DlZ2bARdpO2yS+5IjrzXKjyoIXJeMExt7WRGV8kXhRZ UqmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1688303112; x=1690895112; 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=Dgdbr/HmtEQw8fSZt1jOsGt71w5fzM6AVixcIzI7qJk=; b=lGfSx25bXdRD6NeI9tyxFvSre5Xmaa3Ztf8AbhIkwlTRtxlP/T59/EmOcT3U9vlheJ Eu0LjgEdY7zgK9wtpj5DrLPE2HjuZ4G2aHJ81lZh2ACm8LEXIXvMNMr8jsZicQHHiR2E d7L0nTyIiIlRKm24B3pS9kH3h/1z2VWO0djqPB1A6LvqOA5MFw3UxjJnwhOZL4MsgNAt cRYB6bl9p0ma4l6a3eCDO/5TjaQV4IoGTrLjma1XBziLpzBwP2ZzRZi8//0jj9ovHeYm J4URVMF0+dLlP/sTL7KWzUs5u9APFXtQBHX8UQ0knnvDk0aQ0ATTcrE5aWy0Rgk9AkEY LHfQ== X-Gm-Message-State: AC+VfDyNaXBqNe2WcPn3P/bBGBtFQrLalmmyKKEQIGle9LZ/+2f7EQsb FIxTT+sm6f/ntnYR3b72LAE= X-Google-Smtp-Source: ACHHUZ6x9muc0ceSGU0/UqnBfVnTakbxWSM5xC6YsLa4F04Hq/9xgiIO0ebupNDInRMKFkZRBtuxQw== X-Received: by 2002:a7b:c445:0:b0:3fb:adc0:c37d with SMTP id l5-20020a7bc445000000b003fbadc0c37dmr9207057wmi.38.1688303112007; Sun, 02 Jul 2023 06:05:12 -0700 (PDT) Received: from suse.localnet (host-82-49-237-33.retail.telecomitalia.it. [82.49.237.33]) by smtp.gmail.com with ESMTPSA id k16-20020a05600c0b5000b003fba6709c68sm15014903wmr.47.2023.07.02.06.05.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 02 Jul 2023 06:05:11 -0700 (PDT) From: "Fabio M. De Francesco" To: Matthew Wilcox , Randy Dunlap Cc: Jonathan Corbet , Andrew Morton , "Mike Rapoport (IBM)" , Deming Wang , Ira Weiny , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, Catalin Marinas , Mike Rapoport , Peter Collingbourne , Peter Zijlstra , Sebastian Andrzej Siewior , Thomas Gleixner , Vlastimil Babka , Will Deacon Subject: Re: [PATCH v2] Documentation/mm: Add information about kmap_local_folio() Date: Sun, 02 Jul 2023 15:05:09 +0200 Message-ID: <2238844.iZASKD2KPV@suse> In-Reply-To: <970a881a-cdaf-2568-657a-3b93b0273338@infradead.org> References: <20230701142041.9992-1-fmdefrancesco@gmail.com> <970a881a-cdaf-2568-657a-3b93b0273338@infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" X-Rspamd-Queue-Id: 14E6920022 X-Rspam-User: X-Stat-Signature: 3e9dujm6mu7bfuogkhf8rywg44aa4ptn X-Rspamd-Server: rspam03 X-HE-Tag: 1688303113-326483 X-HE-Meta: U2FsdGVkX18DGHL01qWGiYgrgWcfQSNMB6nzG4WL2Fv33zALsV+FeXBp+/t9LQeUSHIOhpefXh1c+O6LTyoiIHvxT4LnLPG0b8cx0fROrTJkKFfIUXhrEc60uUfAU96OjGm4LhcMfsDIGsqDuFDsz8yP0IYF3FVTDNz4AvABF20Ln0tH2ie7i47/zWvBun6ZnsHJ3bp1Zz9IeOV6vNKNd4pYOc2w0M8snyIuwYDQNUd0WZciqBs+h/KgfU6DF4Ayj/o1oWB6OfV1gAO0lBw4SUDZCi9QIPMvzsNmTsFIOAPh5X7NTS6457ma0uhl8I3wS+0/86yQwT8lT9REuTeCBWit26D9Z0CqxFLE3shERFUML1mz8LjrEQthaML7RWf8TpR7FLQD2lBFpPI5eN3WbJOUjqoDkRKbZSlTT38YfYUYS23xIqbjTvbNcbynf/+mxO4D3P+E7++vh6qIylI1QTbM4zQFcNjSdrzioHNUJhjYDfu4MB5CH/dCLjniJtIizvq5lyPCqpWZRAtpPTuhP41U6GoozvJcQS+IWKsojTXnn7/thew0UHWzVm0jEc1VMcKy72hTok6LXoUpFNNFYz9iaiBT2jlNINJPSLYsvSj65aCFJW2Ylz4DJpXDUq4qjJB4pCWKNrwDrsyMNsXpX414YSJZb6DRlh4GPF+FzJJ9b8oNNfR3ZBOSyifxWZrDIFv+zsVzFWGgyVyjY5liLTaHTNYnqeyl6OaFcLNfeI4d2sGiiSuLf6KFRTFsmHGBrmW0c/ZuiBjDGoFhXpb5OZ+NbJKjdlLqQduQIFDMAjwuZ42g4UZhW3gRT+0WV9DpGAkwTbKN3ZGYB6rPJClA4jzm0jOZCI1EyPE4ZcGQRkzvjLjo1JG9Eoeb73K90oWSWWbCAth5+W0tlQdBYXr6kiJu2M0t11/rYg2binTLFHIOLoasSVwIt6NpOWxQ9if+P+OXdBm4zoDOAvNXc8t qmBb8x5x ZXJRyX9WBdP4Y1whYmI93jS69gODpjSNnYuh2pHa38/4piu8GbxJzR4uxLxMGvXJ5ni5vZpN6I0oglxAa/HMCJB91led28V5rvYFqwVzX+nfSr+lWYWVde83x0+eWrRJ/xiiNozNTHwyJX2ph7k9Hb5qWvE0gifFyodAsg2LKP1LBZj/GxHCDATtbq1cf6wuJMbTtJm/dw1kd3KyXCx491+9bmDS159MAefGu24qzvnxiqwMwW+d7h2cnfm1WEgunA+ZBICEFMVXbm9/uJ98+y/g1muk2Ioee7olm0NOXJsuOCpANCBM+nGQpm5AXkQ2Fwz3mP+Zh8qnNFhpGMou/gAREgkRc1Xk5C5NeasZDm36QJZstic/BbMVs5WVgEy1EIISTZc1GkqKKH7g4RJHJGw21lvwFAalJFltTe/UyN0HTUIVrOqepKi+b+jIXS19V4i9YV86mPQPbIu4+BsRMY1toVeiYFp+XF3nz8QWrKwwgyIFlSPMtk82Sww== 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 domenica 2 luglio 2023 01:59:04 CEST Randy Dunlap wrote: > On 7/1/23 16:54, Matthew Wilcox wrote: > > On Sat, Jul 01, 2023 at 08:21:20AM -0700, Randy Dunlap wrote: > >>> -* kmap_local_page(). This function is used to require short term > >>> mappings. > >>> - It can be invoked from any context (including interrupts) but the > >>> mappings > >>> - can only be used in the context which acquired them. > >>> - > >>> - This function should always be used, whereas kmap_atomic() and kmap() > >>> have > >>> +* kmap_local_page(), kmap_local_folio() - These functions are used to > >>> require > >>> > >> acquire? > > > > "create" might be better? > > Yes, that's good. Agreed. However, I can send next version only by week 28th. Thanks, Fabio P.S.: Actually I meant "to request". Unfortunately, "to request" and "to require" may have the same translation in Italian, my native language. I preferred to not use "acquire" because it is re-used few lines below. So I thought that "to request short term mappings" was good (although I wrongly confused the different meanings between "to require" and "to request"). Matthew's suggestion to use "create" avoids repetition of "acquire(d)". > >>> + short term mappings. They can be invoked from any context (including > >>> + interrupts) but the mappings can only be used in the context which > >>> acquired + them. The only differences between them consist in the first > >>> taking a pointer + to a struct page and the second taking a pointer to > >>> struct folio and the byte + offset within the folio which identifies the > >>> page. > >> > >> -- > >> ~Randy > > -- > ~Randy