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 CEFE0C3DA62 for ; Thu, 17 Aug 2023 17:34:06 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id E5857940046; Thu, 17 Aug 2023 13:34:05 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E0886940009; Thu, 17 Aug 2023 13:34:05 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CF86B940046; Thu, 17 Aug 2023 13:34:05 -0400 (EDT) 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 C2D01940009 for ; Thu, 17 Aug 2023 13:34:05 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 9DB8AA0750 for ; Thu, 17 Aug 2023 17:34:05 +0000 (UTC) X-FDA: 81134294850.05.EE8E781 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf04.hostedemail.com (Postfix) with ESMTP id BB3294000A for ; Thu, 17 Aug 2023 17:34:03 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=rhP8QvPT; dmarc=none; spf=pass (imf04.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692293644; 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=JOy8tw23GbqTzI989JJ+ZmQljWwQRjDrUvKtHWBanzU=; b=RWvGfc1M6OqMDqOUmo5aLIyAT5GtAHmnV+FdHtiBz3/46HQY8Wo6xrZVDs3q8QMoIQ9dhp vStHfxsdBljT5pTdTdTEG7j8hDIKtxyZTBQmnKOjRxyYwdzm6fCqpJiy6Cw2USGSA4Blhf QgtvBhJrPsaBhQeJLulYrYwHEfD0aXg= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=rhP8QvPT; dmarc=none; spf=pass (imf04.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692293644; a=rsa-sha256; cv=none; b=VOUWGjU3RaCacNVyRLkLlpKDvz77Tmkd5L4HMPvjH+ktKm12GJ4DDPQyMm3swMZ1H2RFeo APmYrliGBxicSMOI0N0tpbliNPk1Izc5MHT4GU0vrm5ISBGc+PDOhnv7sYXBnIqMNgXks8 GfECNmbZfxAv0D95toOXxbhznDKbzus= Received: from localhost (unknown [IPv6:2601:281:8300:73:dffa:9883:e232:5c72]) (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 C2DFE20BC; Thu, 17 Aug 2023 17:34:01 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net C2DFE20BC DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1692293641; bh=JOy8tw23GbqTzI989JJ+ZmQljWwQRjDrUvKtHWBanzU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=rhP8QvPTw6jrY8+OGf8yEX9dWu8OEPNsZ3wvrAfPUwYGpU5ajAMDBmzIVhgPEQae8 Csaj7xOK7KqCIohN1x0HMJb/zrHKopAACId7WadNmtaZ/+MwgoRaZMRhU9b/askFSr 90iI5lgW/HE8lY4dLaMWmy6HEjAFdHfixGbl03EKq6OqDDeedz+I8sPEa6nY4n2Z0w IyPjRhmp9mWrIPzhSXqW8KA4oHnL9c+0rE4YrZqQPt4B5c8cc3GoUnDlPMYCUFnQoe 9q28dnN4vmQ2bwmy56j+ez1zMqYo47Z6/UzUeyMn7f8WtEIgYHymdEwAGp2XH96Ac0 o06/1KukDywJQ== From: Jonathan Corbet To: "Fabio M. De Francesco" , linux-doc@vger.kernel.org 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() In-Reply-To: <2898756.e9J7NaK4W3@suse> References: <20230708121719.8270-1-fmdefrancesco@gmail.com> <87r0paxooq.fsf@meer.lwn.net> <2898756.e9J7NaK4W3@suse> Date: Thu, 17 Aug 2023 11:34:00 -0600 Message-ID: <87350h375j.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: BB3294000A X-Stat-Signature: e59oncg69gyb38wi46bjka3m3z81emjy X-HE-Tag: 1692293643-231390 X-HE-Meta: U2FsdGVkX18RM+gyqJ6TOTl30gDWYTH0hLB9gZUcZko6FIIoxXB4mmF1PQkPaZ0Y92ePfW+n9Na8BzDJ2HwOqRLdpC14QBKMAmAnH1CtMFAtHsrek5UNLUK3/KWxPhqH1rAzbeAYiC/ehhVMUfJQiHwo3WwG4Ys+ODsfh9nzH5nSSelqXTrTxuiOPtmH/Np3jc7d1n3H18TVsYZq729Z3QLHuPH9IJuGDGU+BNY4RuNLFoLm1RAUQtb8eii32xRvCiu5g7uwqzFMYKVGjWlOJMFI0KpSxK6pesINMAuWeKClf31h3eas0qja7T7nfpi18ImtS0QaF637HcO0Cd28AjOEeV9UdIhQXBNPeQE0XdepP56xytP/ygR6cYht0oAoijoZbMktXg7t63meccnTsza7fdAkDz+rw/RWjedqR2zC+C/Ly1s9KC/693ptnx2vA4Vxro1b0v3QidoQ00CLTUUiW0uNNh/CDf0VFJA2T7JA1dULTMkP6AWANS0e/1OcGp+eluzNcVb6/Xa8mAoaZPNrcJPpJcSSqL6iUCE+NyKrmQVDB9QAAo2IbFGcSAEFbvToCtp0KNleqCqXXSbB/erveNGDITMy9mdlLDDyTx0w1wP7j204dySP/G0MLECvTrK03ct/cypm+zroJ7zETDSf6sYG3wxE6vAsVL1Nzyn1b2BsBBlbWQcWJ4rxkHUAKb7Iu6DURyCVpe6UUiQpyZZGeG5u+vkYywfaC61l54rBPw4/71kGxI06eXWlgWC/7p5ZM0hqQ4kLz6y/aVEp6ueDt0aOIANLIoDolD4j/CWFLW+PEgLBMa3w8qrUBl7/IoxVlEONyPNs7cdvnB4EdryOdjmpSNu4Dc6ya9NDniDKHzOJ2VdBIjuV0DZ6QM8PgAOerzFiPb4UM0xN8MGZPIcv4klOhDVoDJHf1SzrhyUWjAqz7Oan0vnlJZZ21vDChg87cx+0W+v+mt9jl4x esXgvHDD 6q919NkIoIdy0Jj1mGQQoKd39Le9bL1EMp7iRYXVVECx+xXqNVP4hqd+CUZy+OvzikW1vuuUlrO0e3Do5zLOkh2Z2Rc1cc0rLedpeAhlBGSKgkTbjdP4D97LoyzEFfS9CJku7IFms2fvqaxf/gypN18N73oBww/cCQkqeWudJget+1plLJMZjF3q1jfWEi1fbub3IW3widN1cm56IG8QFizgGMM3aOCORwggbxFg29HW94mEpOKkcXKY84g== 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: > On venerd=C3=AC 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() consi= st >> > 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 w= hich >> > identifies the page. >> >=20 >> > The two API's can be explained at the same time in the "Temporary Virt= ual >> > 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= not=20 > yet reached upstream. It's in docs-next and will go to Linus during the merge window. Thanks, jon