From patchwork Tue Oct 1 00:26:26 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeff Xu X-Patchwork-Id: 13817297 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 18BD1CEB2CD for ; Tue, 1 Oct 2024 00:26:36 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 99901280044; Mon, 30 Sep 2024 20:26:35 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 9231B280036; Mon, 30 Sep 2024 20:26:35 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7772E280044; Mon, 30 Sep 2024 20:26:35 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 4D2B9280036 for ; Mon, 30 Sep 2024 20:26:35 -0400 (EDT) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id EF6D61A0C81 for ; Tue, 1 Oct 2024 00:26:34 +0000 (UTC) X-FDA: 82623142308.12.8827B33 Received: from mail-pj1-f46.google.com (mail-pj1-f46.google.com [209.85.216.46]) by imf26.hostedemail.com (Postfix) with ESMTP id 3A134140012 for ; Tue, 1 Oct 2024 00:26:33 +0000 (UTC) Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=oT8ET162; spf=pass (imf26.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.216.46 as permitted sender) smtp.mailfrom=jeffxu@chromium.org; dmarc=pass (policy=none) header.from=chromium.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1727742328; a=rsa-sha256; cv=none; b=sAWQ4Pr0w+UT68fqXrJJDsCUfpTK5l7Br/U1bn9VLNvZvKH9ev9R4EWcLtxobVcCQU6CTo BCmSPAADXcoRcZMUAZ1IxPmveyiQw7XA2YB6qUMbJg8iUNmNcbsQmV+i20LfwnZo0WA4Jj Q9DeR95aaCRKyRFXSCJYBwK7epz2ID4= ARC-Authentication-Results: i=1; imf26.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=oT8ET162; spf=pass (imf26.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.216.46 as permitted sender) smtp.mailfrom=jeffxu@chromium.org; dmarc=pass (policy=none) header.from=chromium.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1727742328; 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=2+Ah0ZMWQ8huX6PXrR+FitgdByGuh4bQ4S4OQRetSRI=; b=zUoZ4IPCAp3zRp5JCN27rbSZl11e3aVeTsmqkZPELl+/WwzJ0me9ri/HBih+9sBKaTbwKC KHDmcz8tMl3/wQFvRy86r7lzDso7XJxcuFykJH21wUWKu+8Y+NtDG8LdEcQEfPh1Vt6nHL pQP49oiQI5ZmY49CmPL5wlqbvG7D/8I= Received: by mail-pj1-f46.google.com with SMTP id 98e67ed59e1d1-2e0a47fda44so718507a91.1 for ; Mon, 30 Sep 2024 17:26:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1727742392; x=1728347192; 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=2+Ah0ZMWQ8huX6PXrR+FitgdByGuh4bQ4S4OQRetSRI=; b=oT8ET162s/lBl/0MNlJj7H2pohm+8Jm+RfjKul0DsPvRFTul7G6W0VOfw92XvD5MTf jRquGk/wFcC/rGMAJ89zw++ggP4nic9i0kVVZ21YiziH926xFatgqtD98F5YM5DL4iZa Bfd1f8y9tu1FdKxjwLfWz99kBqq0eIxTOy05Y= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1727742392; x=1728347192; 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=2+Ah0ZMWQ8huX6PXrR+FitgdByGuh4bQ4S4OQRetSRI=; b=TWqGi+Xjprk5UbdyKEmlTs3Lnf3+uBvxMU9YvP8KdvntvycPr7Fl4S688o4XR7/ETK XP+PGExiEEkYH91hbXNCwbin+BZ9toi4c0I9WKIh/oPrr7CswGK0asxVl7e+PRRngKeB wiKtL73bYMaP/Gx/hHY9NDBkfqUJlQfElZ+vhHZofIJfRCmd9JGMnX0R4fxQnq28g7EO N7W4b/qKvNyIe3MjAVbW8I/au18up9BVjg3zwArqJvT1HlnqAnR+Zr7N1rrmM9iuW6NG E5h/3HfD7tIY697F2+y/vqIruSkuXmwoO/W9b2w/wBcm84rGCmNLODFq83yoSaTQIW8F iBeA== X-Forwarded-Encrypted: i=1; AJvYcCXCxLxfobQiJSStzUYi5E4shDDvdGok+YIVLEDhoZlCOyq6/JqMCm2Al74iHn9NUyYqezN6PunMsw==@kvack.org X-Gm-Message-State: AOJu0YxIb7XSr36e5BfLP1mzHER3/BWlPalY1X/Urqs80bR2GXfd2OHW IYb1DWV84+rBtzVAqozIxMJizLZEzOqLL6N2ZVTdfkxwz2uePwEN3q/SpsnL7w== X-Google-Smtp-Source: AGHT+IHaC8TRH+0CqFL8ePmOQQcQjHt2DWzOtlbUiQVAZBBhzUk+OWDYuAMRBsTobNPtDc/8lsuUIQ== X-Received: by 2002:a17:90b:4b41:b0:2e0:72ab:98e5 with SMTP id 98e67ed59e1d1-2e0e63a5a38mr5503246a91.0.1727742391881; Mon, 30 Sep 2024 17:26:31 -0700 (PDT) Received: from localhost (99.34.197.35.bc.googleusercontent.com. [35.197.34.99]) by smtp.gmail.com with UTF8SMTPSA id 98e67ed59e1d1-2e0b6ca4a4esm8734399a91.31.2024.09.30.17.26.31 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 30 Sep 2024 17:26:31 -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 v2 0/1] update mseal.rst Date: Tue, 1 Oct 2024 00:26:26 +0000 Message-ID: <20241001002628.2239032-1-jeffxu@chromium.org> X-Mailer: git-send-email 2.46.1.824.gd892dcdcdd-goog MIME-Version: 1.0 X-Stat-Signature: deo5wqztnp8q96bifiurdj1w8cs5hckc X-Rspamd-Queue-Id: 3A134140012 X-Rspam-User: X-Rspamd-Server: rspam10 X-HE-Tag: 1727742393-132179 X-HE-Meta: U2FsdGVkX192PptGAKB03LHqLdTLN0GFq5yqVrtWvPgsYhHgcicPRlomAGUSfCs5Cq0fNR/7ZLtI3Xgb2/S0RP9FMJPD2HrWtr0R9m/Dlk/njubVuvCWoBdwzpSE9sL1by4VGMCLcvBzweQ/UbNsg+LZSkw/76yHNi9ik1OwlBJynfBCd+lXthJ/GfDYcPzmh05ZDMkcYL3s4jqr6kfMx06SoOrIz+8pR2GSksBX+FYLFQyINrUuwSgvVDXwaZRObMsTF27Bdg5N95RhGkUfndxJDnBzY86oALsSS+RqhATl7fbtivsipajDU3pDtppLMH713KcgI6m5+ZeiqgTk68Gg8YNGP2fJdl5bEyGC2+eKJD8Pg9n0DEnO3axRZBDiEBQJC3M7P2ueNmklQfzaaqWDkL7XPGnePNj7qrEFq03FPRopjMwBrQOndCd5ogDyBYN82yJVHmqRnR0vd8wd3qRQr+J+22zWeLS33J1tK6aH+a/8BMYbTI0A7qIZ5jl923kp0zjaP5n+zJisbhd573R2s4DSrRmExaR+dBNWeOUr1FOYYcATL2Hi3f7Yg+PR7WuYCqci7CfORqm8sUtmX+VYvY8rMgZiRg2uN030rbDa86tIiioshfgCpe4UtBLVuu0VZYzDm+2JUMCzh+QW6IE6lB369a/XCjd3ZZDJs51fkWvkupGwToFrJBiPENSje0qhrMqlbaojioDf1/pOyW/nJZtR4w+FALFet+RcifipquBoyHrxCfLiKT3NM69wSYyeAh+Mg8s2DEfW7Cy562Eou/wqEhS57WJOHJULml8beGA5GnglSHPoQtz6/ZQaYW5OS7EicpExcEM/MPNzjraqPhlekm1z44cCs563aHZDqB47ue+m/JeNMQsQq+lgCgkosbT4X0ijXbaguhY67A0k0eEpFiaFbMeMOqXGDhCkWPlCoriNBtTUi5zKi+al4DHFKn6bCYuN5jPXAV9 S58mSdKZ gYVez2B1aqGDzU0jaF7iv9vsRO3QLf/rXbarjLEQ1DdNx203Gou/egBqHNge2dnzvPZrLB+f1ovx1fC8mqp84CLca9hYbGmdwQNHckcIjnZaaVv4Y8lrXs/ynC+kdA4N5bW1J8JdNU92Kla2mHyUOwjtYqlJghXfR+oFmg8rJaJVZJmKlw+QsFpqEBmpP511RBgCdYbr/GsAdHkAMWofHE0QNVI91mruLXMEypKjlrWbCrRjzhCssEJCWxWD0P6t15T2a4oLC9XKUWkuvIOWJUk6YP+/6pI98V4ZjlR4P6yHu93Dp6cppUHd3cTjVdfrueY45e2Z3gayaUFiAFwIjcEjtQZ+Tca89oacFMP9VLdFv4RnPSe7YWI9NG6JhMSFuo5KmMQxjdgRY8UU= X-Bogosity: Ham, tests=bogofilter, spamicity=0.007691, 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: V2: update according to Randy Dunlap's comments. 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 | 304 ++++++++++++-------------- 1 file changed, 144 insertions(+), 160 deletions(-)