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 A2650C48297 for ; Mon, 12 Feb 2024 12:03:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 356EF6B006E; Mon, 12 Feb 2024 07:03:12 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 306FD6B0071; Mon, 12 Feb 2024 07:03:12 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 180B76B0072; Mon, 12 Feb 2024 07:03:12 -0500 (EST) 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 06D396B006E for ; Mon, 12 Feb 2024 07:03:12 -0500 (EST) Received: from smtpin23.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id D418FA09CD for ; Mon, 12 Feb 2024 12:03:11 +0000 (UTC) X-FDA: 81783016182.23.B79C41B Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by imf12.hostedemail.com (Postfix) with ESMTP id 7427340022 for ; Mon, 12 Feb 2024 12:03:08 +0000 (UTC) Authentication-Results: imf12.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=OIOaSvnl; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf12.hostedemail.com: domain of david@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=david@redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1707739388; 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=ThRnjc9V1cnI1MuBuadhXyQmboZs+nvqfoLxMt2WsZE=; b=BwjkAxG0wx2E3F6vIGQ/FVG3lbUDryum5yrtyUEqDA87iBVteVwxxcHGIi2XJjZNYtmNBs vuGjQV5Lgxs0htUYQs8dIwF1U1E97LeiJigGlyGIYHYQaNH+htHkIo59AqaJShGSYUkYid w/GCeiRmvD5rC6fHxmQ0UlfasdSDdO8= ARC-Authentication-Results: i=1; imf12.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=OIOaSvnl; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf12.hostedemail.com: domain of david@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=david@redhat.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1707739388; a=rsa-sha256; cv=none; b=heRcSg9ARdg8ahyRb/DetwAcV2fDcR3D23squ1WQsvi9wIE3MHaM8Uh4YjNDwS1JDck29r SENO/fLfYhLfL4uRLboIfRZjJ62zSIm9JtP5Yu7nADRY8A80YZ+2fDyedHQ0uKyNkHH1On B5UPEB3vmx2wfYHip2cOSjieAcxrgxQ= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1707739387; h=from:from: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:autocrypt:autocrypt; bh=ThRnjc9V1cnI1MuBuadhXyQmboZs+nvqfoLxMt2WsZE=; b=OIOaSvnlwH4IyTONmVvjHQ9IDaK1rR+vUEFO5UsDKKpTpdgJGgQAUZnuFURmLoe0czarTu SyjyukFtVt6gzfXGAzwRnExHK4G8lRSUE2lOb7b/yjdwpso3PVueIAHdR83d4UG8+8cbrF RnXZY9Na4BUIvsh11Cncb28e9JonGTA= Received: from mail-wm1-f70.google.com (mail-wm1-f70.google.com [209.85.128.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-112-sorzjT9NPHeHGQjJ6n7QOw-1; Mon, 12 Feb 2024 07:03:06 -0500 X-MC-Unique: sorzjT9NPHeHGQjJ6n7QOw-1 Received: by mail-wm1-f70.google.com with SMTP id 5b1f17b1804b1-40e4478a3afso16058605e9.1 for ; Mon, 12 Feb 2024 04:03:06 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1707739385; x=1708344185; h=content-transfer-encoding:in-reply-to:organization:autocrypt:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=ThRnjc9V1cnI1MuBuadhXyQmboZs+nvqfoLxMt2WsZE=; b=IqWYEUpe9GRGUU4B7M2nJtEU8pp+AXUBjx7SZ0g//7ZLSoSNdW3A3KFYn2yxHAQN8c 5KLeReIyOuq6hNrwKJWq4tGhTRfAwQOrpt2T6BV1uUFrOQRdofpXbR3AiGDdm9kA6RWB 6WRD+cRiAF+uXGu9Ax4GJz7S4lp/k2LrgMxtXZJxiAeDN3mYX8Tc0dgbdVq8U4eXdvOi hhNmzqe1nfpRshwVZZqdTyeDnfEo/mzCSuE1QTYAPiyYuBnVI7tpTOfEK0yHfgDlEXAm 0KBHbdDzqRjlMYaCrnsxzDxjBdGUpBSwCNQG6xEhUPHBF1Z65F/4nBwfdJ1PAeu6HPyi aRbg== X-Forwarded-Encrypted: i=1; AJvYcCWfz+Xe5RyUjYaogqEgneWAZwAio35p228FjB15BntHanXHU1Cr9++CqsvXM4DoLUG7Sfl9XPpVpLjrJUobaQN3zWs= X-Gm-Message-State: AOJu0YxytVa+cw75MMfvNnImVSHfCKUlG57TH5pEioPfR/TY87/JwI1v yLf1QpdTZ7vOlSHAPjAxrNLaHWVfdlowWlcdR0UAhP6ALBhgQ1Ur4y8fNvGju/KmLNJDctpnvc1 jeuwU6D8b8zzNJO7mFFlwprm5mL+g8izTiCuiD95BBNqRbbrj X-Received: by 2002:a05:600c:5127:b0:410:7a66:e95a with SMTP id o39-20020a05600c512700b004107a66e95amr7229907wms.0.1707739385198; Mon, 12 Feb 2024 04:03:05 -0800 (PST) X-Google-Smtp-Source: AGHT+IFI+E1vT4IrD9Jx5dHLmVjtQgMnruMIAl+D10JMPz6O0V7UwAMitsYs6gAig2CEpXBvW+xmqQ== X-Received: by 2002:a05:600c:5127:b0:410:7a66:e95a with SMTP id o39-20020a05600c512700b004107a66e95amr7229846wms.0.1707739384794; Mon, 12 Feb 2024 04:03:04 -0800 (PST) X-Forwarded-Encrypted: i=1; AJvYcCUhx1LPeaJcTP8l85ZqIkkvg7qw4zhLq6323PDgGsPccLeK28oR1BqpofVkH5cEh2WVk/gw6NuIiZ7epIY/ixrcBOifkRtgAWqVENo6fA9/+3yVXtcZHu1faKkJFaDQYYZV7G7Jxa323nz3qux3irKJjyZiBWm5SgkDyzC+DbaPw3FSD7zCKIfS1VFXSfXNCINA4QCzUI19ocwgWCawhOJpAjs2bR//m3dWhtS/mSHi93bH2o2ardo41V1nF9weH1bhEbHY87aCpc4xiS2ZfsHhFd0OBCMaf6/RLoYBhH8BPMArn5Z5ZYN+doyagegu80SWgQlm6+fWN4wJkLBif7MyMqU4srbzWxZJFvXWTmch82apLYG3GTX0DMJiKnHgYiEEnlgdcCPQdR3O91WDq5MSSkVsKEO096+YWsOFk0C7KmQPs1X1Wiv6+7zepSkiANdc5JgGbpi8H5KgcFknpBf5EFl9A9kQ6b7Tyk6Y7hSp1qIbmQ2VuG2rnjAckcgV2ubLIvu7kK1bxwx38h6sSckOmcLSkq/teNqUzS+LIZWfCxgnWsMzvuwqFcJr/hf9Xu7tDlXUOHdHbZ4ynw6QeMxyo95l5b2sksuiW8uxSmQ6CoNLdtEO/W0HBmY8JfTaKWXlpL6+g/+AL0b4p9ovBNFDmUV6h6i61pX+v2AJJccxDZX8sKD8A31n/VUqC4JfMnyJc/tx0NtO7x38rs8kpvTs1EP1CkkbKu1+RdcsUvTy6lsKA9A2O9s22HzgWG44BOGhj9ZJKKUOVJTdcweWvRTpyWZKNGfhX8g0xo2EitPDcg4gtVlwEGWl+6e259ABqWH7asc66WjnMb/JXBuqRqnkcGDlBhz//8p3d/HcKaOq Received: from ?IPV6:2003:cb:c730:2200:7229:83b1:524e:283a? (p200300cbc7302200722983b1524e283a.dip0.t-ipconnect.de. [2003:cb:c730:2200:7229:83b1:524e:283a]) by smtp.gmail.com with ESMTPSA id g17-20020a7bc4d1000000b00410add3af79sm4826304wmk.23.2024.02.12.04.03.03 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 12 Feb 2024 04:03:04 -0800 (PST) Message-ID: <739e29cd-a0a7-4e76-826e-6fd4968ba4e0@redhat.com> Date: Mon, 12 Feb 2024 13:03:02 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v5 01/25] mm: Clarify the spec for set_ptes() To: Ryan Roberts , Catalin Marinas , Will Deacon , Ard Biesheuvel , Marc Zyngier , James Morse , Andrey Ryabinin , Andrew Morton , Matthew Wilcox , Mark Rutland , Kefeng Wang , John Hubbard , Zi Yan , Barry Song <21cnbao@gmail.com>, Alistair Popple , Yang Shi , Nicholas Piggin , Christophe Leroy , "Aneesh Kumar K.V" , "Naveen N. Rao" , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , "H. Peter Anvin" Cc: linux-arm-kernel@lists.infradead.org, x86@kernel.org, linuxppc-dev@lists.ozlabs.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org References: <20240202080756.1453939-1-ryan.roberts@arm.com> <20240202080756.1453939-2-ryan.roberts@arm.com> From: David Hildenbrand Autocrypt: addr=david@redhat.com; keydata= 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 WNyWQQ== Organization: Red Hat In-Reply-To: <20240202080756.1453939-2-ryan.roberts@arm.com> X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 7427340022 X-Stat-Signature: 5fts3rs9cy77f4oj7s8qqmgjbz46k58a X-Rspam-User: X-HE-Tag: 1707739388-443791 X-HE-Meta: U2FsdGVkX18rZuTMMUN75Ur1YhWbHPTktXRX7/gm5MGMRfOC8xQgqOfQiN7tbyjCyv4yGb0/tiPuO0/DJYi+NNQD2VTY/9ta9gAoridXMEvEVsmx1E2Ex/kVamRjE+KEml+8F3mtp4j6Z/xy6uXUhCwYlJZykbb38I6EkAOEMO7g9BvXloXVyFN8jteUCdfmEuUr1uSRd9R7HGJDwcIlwRCWFiO90Lr6T8aj1Ny+W53Cltb3d6bsyN5J8HQ8ByOOeiUVYjatsK7L1AWIrGzwSqS3KQMpxGGyX8Lz06EsqAXxkSCt7xUs64lLx+JXE9Yxxr3t4st3iKCafxVMy26FfTaQJJB3TF8g47FaDA9M0r/qTG2uwMifp9Knq0Zj1ruednlKTVlJK7AYUBCp9UCTzjX1eVWgcTxbJucP2AanuwFkggm76RsxdAvHQZ6SYYiCbQrNpkTxlkTzeKGOLlNW6VQ0I3AGvMpYkcPLwzQP7irgeFPUuicuJ8bCojqf4DQmvVBbszBUXD/7sOjrXcWioPwHP/ylWRzoB3DAbBBIaYp3pQV5RLmxmYybvVJLU0H9az24Pg1fUgfXpWSD/g8/hlbz3tUOwXhA6fROTOoFqIyYcxu4DseWNB5MpLDmyr8J4VoynJc+hZYa+7JmX0n9yGzWpKStd8G/Bq32xanwW8Yu7L9DeGMgM6k0iGjbvFIiaXU3UoRAgVFCb9BZDl1uifUEkadyQxOfEt7OwaT30ok9TvIx91NNW4ahs8/njPiT3tHyYoxL2+vMdIPvCePUsvu5Cm6IWLSAwg7LM+9SuiKLzmVlCZTwp0/P8ea1pnDG/LAI5nkLQknX/CGT5O1uz/hmq7uP8kGxoBjmbYjoE6BAJACfnJwFRE1j6gah71Wv4NEQTdKQJAt4h/FwnUgbIo3we0OZhGATVPK2IbEq2obU83HenVrR3FE97eXexYo/WWD6tMI8Ah8U1Z92rrw T5fKcP/l wtjCa4Z8r6nuV/kogBPa6A5TevW28Cmb0Ezkqe9WlxbILrtsEvIlLs8wnN3Hpv+Qu0XKvCSQaNQn3K/xAX2GxlMW9W/tLLlvIK9Ro0sHtvytYzvGm2af/tb8ytgfZI+N8Tg3lwDyIsMyBqyZ0Wml4LrwC+RNlYJ506fwKHZnwxR800z8kBkX0lYfLfBvA8qUxhxGPRXHIb/fEG9rKuSungDZ80lytfBUyq+tZAV+aoaaK3+KF152HqGtNKmhhC3qzPJBvuY/O7hiMDjEE3A20gJ1vC3I/7zT8iUFx7YfCyxcgfuq66wd1ZVOpAolBl3BaMSnJ79plGoTrej9FsizfrYTiFsM/obFmEviQZqO6j0WGXxTYzWs0kIMer7Rilx5qO2+ZxM9q7pJUAVQ4pbTr9gJT8USt2DqJBCWhhwnM44wXM8Q6/BvpyQ3LlSgVNXosqZ7XgImXRAf4VdhMOMWW4yNwedOZYSs7mQIvQKWQbJQfSdFhEi7JzcQSK2IgemlpnFigleuJUKjJP77e7JFkDSaUDT2MXAqcvFRj62SOxLkTC4ujKpEA+dHFGs/ASkpIUX9e7ONS7yPZFZ5t9jww1NDGz+46M+yJeCAVuAhzVXSehwQw3rrrWG/eikhyY4pANk7KJYz2ewEhLToqg1bcK9nsJWdCrEEERh5XcX7O19nU0bg= 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: List-Subscribe: List-Unsubscribe: On 02.02.24 09:07, Ryan Roberts wrote: > set_ptes() spec implies that it can only be used to set a present pte > because it interprets the PFN field to increment it. However, > set_pte_at() has been implemented on top of set_ptes() since set_ptes() > was introduced, and set_pte_at() allows setting a pte to a not-present > state. So clarify the spec to state that when nr==1, new state of pte > may be present or not present. When nr>1, new state of all ptes must be > present. > > While we are at it, tighten the spec to set requirements around the > initial state of ptes; when nr==1 it may be either present or > not-present. But when nr>1 all ptes must initially be not-present. All > set_ptes() callsites already conform to this requirement. Stating it > explicitly is useful because it allows for a simplification to the > upcoming arm64 contpte implementation. > > Signed-off-by: Ryan Roberts > --- > include/linux/pgtable.h | 4 ++++ > 1 file changed, 4 insertions(+) > > diff --git a/include/linux/pgtable.h b/include/linux/pgtable.h > index f0feae7f89fb..5e7eaf8f2b97 100644 > --- a/include/linux/pgtable.h > +++ b/include/linux/pgtable.h > @@ -229,6 +229,10 @@ static inline pte_t pte_next_pfn(pte_t pte) > * @pte: Page table entry for the first page. > * @nr: Number of pages to map. > * > + * When nr==1, initial state of pte may be present or not present, and new state > + * may be present or not present. When nr>1, initial state of all ptes must be > + * not present, and new state must be present. > + * > * May be overridden by the architecture, or the architecture can define > * set_pte() and PFN_PTE_SHIFT. > * Acked-by: David Hildenbrand -- Cheers, David / dhildenb