From patchwork Tue Oct 8 04:09:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeff Xu X-Patchwork-Id: 13825616 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 063AECED263 for ; Tue, 8 Oct 2024 04:09:50 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5671D6B0083; Tue, 8 Oct 2024 00:09:50 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4EFD46B0085; Tue, 8 Oct 2024 00:09:50 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 369226B0088; Tue, 8 Oct 2024 00:09:50 -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 141236B0083 for ; Tue, 8 Oct 2024 00:09:50 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id B37FCC0CA0 for ; Tue, 8 Oct 2024 04:09:48 +0000 (UTC) X-FDA: 82649106498.28.2A118DB Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) by imf01.hostedemail.com (Postfix) with ESMTP id D317D40009 for ; Tue, 8 Oct 2024 04:09:47 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=g3rN79cC; dmarc=pass (policy=none) header.from=chromium.org; spf=pass (imf01.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.214.180 as permitted sender) smtp.mailfrom=jeffxu@chromium.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728360545; a=rsa-sha256; cv=none; b=xPzuFJoCNWRUs4FrOw6tUM2O7zcfKURaGTJW9a+QdH5YtKaRdFAMq93ES+eAk3H5ARNdBa EcR0iySxo67ruV+7ioxR0QEiECWz451sxyoir2A6Exa4MirnO1f5xjyWCL/3atNxQqyDEt W5rkTzjwy8EmOD4O9lAlXwj/cUKVidc= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=g3rN79cC; dmarc=pass (policy=none) header.from=chromium.org; spf=pass (imf01.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.214.180 as permitted sender) smtp.mailfrom=jeffxu@chromium.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728360545; 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-transfer-encoding:content-transfer-encoding: in-reply-to:references:dkim-signature; bh=p6ZGUL7jMwMvNfJbHmiytAX9Q9GIqYELEwcb1y0M4+A=; b=WGFEFGvR5G3EK4TfW5wr80rcjCoRc64gYVdzjp//oPvOzspEky0K8eaHvTS5HgTKs3Be+8 FqEpvf3NVbUAIytVQxQqLV1IreRb9yG/DYTmMGzlHSWt0B5dXrhTbAc/FPNTRRO5MVrQVk YemIh8mm3wm5dzrAsT/Tko1vmbjCrnY= Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-20b067fcd87so4093355ad.1 for ; Mon, 07 Oct 2024 21:09:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1728360586; x=1728965386; darn=kvack.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=p6ZGUL7jMwMvNfJbHmiytAX9Q9GIqYELEwcb1y0M4+A=; b=g3rN79cCM2rJ56XTQPYOH4Mwk+tP1a7n1brc1hgagp7/pP8hAWM6SPZ1MUkSxUTV/T wyaTipGGFhMHp7fVjH9T6+J7x4mcjNmgM92AyF6EG1U6PnpuR4Ltr5T+wOPG2tZEhLG9 Vd1C1rfoYd6e8mZfcO/daoX30JGmkLGaQR8Fs= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1728360586; x=1728965386; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=p6ZGUL7jMwMvNfJbHmiytAX9Q9GIqYELEwcb1y0M4+A=; b=Yl4iW1z8gx0lxQg+VrKhBJo0Vq0AycxvQ3XT++kT/7BiQGFsh3PqQatbQupXFqNIf0 lJXYATBWtgdaISa5IPT8RDUljDXvK3J7JZAVk3TEmorgiGPUM1CvN5JS7PeFWYZ1wr5y aS1BAPobkeMjji8gNeuj/W9msipbuK3rmiJiqe6pQz0tpmzSJEH/UUEXrhCcdcqMAQWF 89RWIBRF3kxu/ADxFeoX7R/Ovu5yQMy9tI2ncyRjRG1b6Wf99t+5fNYDprsw0bUDeMVY EpBkksFdIoqXcd9A18JyuHkuZ0IdyotsUXTSqhfJONsUspneA67YPlThn9ya0jsl+Ok5 y7kw== X-Forwarded-Encrypted: i=1; AJvYcCWUXt8wcyDaXjeZt/n4YEmsJxBuxSJp5AG8vMqhv2+aSXauBgwIOwLhRAeQzLATFxIV73yRd7E8fQ==@kvack.org X-Gm-Message-State: AOJu0YxWupuQMH6WMvECxSwCjupgSg752A8vucdQVEfUSOhzF4kcAeXL rt3b/hvkVaT4TgRTHXXnaoZUo76aHFUXpmuL5pACtHRnyo9msDjrQSuNVzDvIg== X-Google-Smtp-Source: AGHT+IH3Tzn6KlmwwEjDW6lynG5u+Vt1tkuQKry5GB3eE3XfLVQF+SrNLkDuseDanp8wOy58Zy4SaA== X-Received: by 2002:a17:902:ec8f:b0:20b:5699:178 with SMTP id d9443c01a7336-20bfe04bdd1mr89735445ad.5.1728360586544; Mon, 07 Oct 2024 21:09:46 -0700 (PDT) Received: from localhost (56.4.82.34.bc.googleusercontent.com. [34.82.4.56]) by smtp.gmail.com with UTF8SMTPSA id d9443c01a7336-20c138d4fdasm47234075ad.118.2024.10.07.21.09.46 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 07 Oct 2024 21:09:46 -0700 (PDT) From: jeffxu@chromium.org To: akpm@linux-foundation.org, keescook@chromium.org, corbet@lwn.net Cc: jorgelo@chromium.org, groeck@chromium.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-mm@kvack.org, jannh@google.com, sroettger@google.com, pedro.falcato@gmail.com, linux-hardening@vger.kernel.org, willy@infradead.org, gregkh@linuxfoundation.org, torvalds@linux-foundation.org, deraadt@openbsd.org, usama.anjum@collabora.com, surenb@google.com, merimus@google.com, rdunlap@infradead.org, lorenzo.stoakes@oracle.com, Liam.Howlett@oracle.com, enh@google.com, Jeff Xu Subject: [PATCH v3 0/1] update mseal.rst Date: Tue, 8 Oct 2024 04:09:40 +0000 Message-ID: <20241008040942.1478931-1-jeffxu@chromium.org> X-Mailer: git-send-email 2.47.0.rc0.187.ge670bccf7e-goog MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: D317D40009 X-Rspamd-Server: rspam01 X-Stat-Signature: ts57tnxeocojk8u37fwaa1ezrjoepyuq X-HE-Tag: 1728360587-86761 X-HE-Meta: U2FsdGVkX1/BanRV3krrrWj/ezxRFt3y0Y8aFCV/5qg7dEsfxUmaumI4K9DmEpCcUD9Ydype4BT3hNzqe0cS7Rnr80Len45z6lCfCBuh3y3cyKow42y1OCFgfCy2GtFUHfpgWnK1YPIPFVuren6RkjlMi69g2yLNOjB4Voh+0elDt9hTAdeacJBiSk8xr3ej6dAhtZB2vKULC2EzhxLxrciSzc9HT5FOj+51rnlr2vtozuyqWmbYG/ZfGSGdjS0dLhVxSFSmH5IWwHuPUNy7meax9JVnQCZ5lr6jKaJkVYzMtSRPFzR72Bn5USe0rMV9l3wKhWhRuP4FkxypEz10SD9ghYJmcYwO1Cd7kx5ZjapzINe3liTA5k9vBp4lsoZoeFjmg7QVeaORfQSUSY3q4A5eOdiCI1OvjzAWDnFphG1xhhvbbbMXJxClruZbfZ9MzzsMpcHoitux9DuUOnciPF2R/IlacE2/rTwAadrc71O6ULgTlqqlvtCqQu7VQvN4tad/ZS/7KmkXVox9sAHwK5uP3/+9A1rYZg0ilTnc6nvAhCJR5q//mOItTCqH4kfI8g2slQDjOJgVmF0BjgSG+mqA2IijZNLFjMNJzQzwbDD8zwYMGwvcyRVG5AyV9uaFox8abZnsIKgHbh5tRNsKcOpEx/SHpOFQhHBuGnmRbsir/jBF8relrvQbBveY89ScvsV/RcMpBOuGT9cO8IG25+9MWYhettQiwPZxOcKY5OjBuny+c4KrIqEPRfRaprqNVdcMWi+zqgXJqfvCCDhlQG4XHdC2Y9kPokVYUskUtq5XrtwjDoHGvV4G9n5QhJvrB1FY7wQhzDjIWLX80x+Vclg60yqQ/AJ3pEThioJBwUgKyXsyN39vLtGEgwP6yBYlSF4NqRXla4YuQaXphCXp2rCRVnzyKSselXWDhw27p6DzpHwVMigimhR36U28CNanYOzu8iqEx8Y5jcq5jPA puYe/f1V Tq7sd+Gf1o7gchnS31Hl+38Bs80Zbw8HjAlPzhLPd3wvjmj1WxSzHvnKcRn/d25XlQUrOkQ1wcw+RXWS58dJHOoMIlBhIyQT2+LHYHIDdw1Mfmwj+3iL2hrYksv2CVd4xL1/MseGNYEcl6kiS1YNSD7vX4S2Cu+PpwkMNQU0VRXCm1eShVIQ8rqaGdW6JynpHuirMLZViCokvAkoSgy2vNHBc46jIvkxNrr/fW/rwPjWYaoEkqKoG3ldjTDskY8lJdsFOr/fRjWdN9cJElBPYOCa+h7Ma8h6g6KyGIP4KP698Oj39Fhgj5bQIFZ+Do9/B2CZNvm/qmTao2nMSsY2v+F+KEQxca2NIPtvXKYm+2jBe8kDXDuBK08U7h7Dzk+Z2Fa5EX3gGDuQ834g= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000001, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: From: Jeff Xu Pedro Falcato's optimization [1] for checking sealed VMAs, which replaces the can_modify_mm() function with an in-loop check, necessitates an update to the mseal.rst documentation to reflect this change. Furthermore, the document has received offline comments regarding the code sample and suggestions for sentence clarification to enhance reader comprehension. [1] https://lore.kernel.org/linux-mm/20240817-mseal-depessimize-v3-0-d8d2e037df30@gmail.com/ History: V3: update according to Randy Dunlap's comment V2: update according to Randy Dunlap's comments. https://lore.kernel.org/all/20241001002628.2239032-1-jeffxu@chromium.org/ V1: initial version https://lore.kernel.org/all/20240927185211.729207-1-jeffxu@chromium.org/ Jeff Xu (1): mseal: update mseal.rst Documentation/userspace-api/mseal.rst | 307 +++++++++++++------------- 1 file changed, 148 insertions(+), 159 deletions(-)