From patchwork Mon Mar 3 05:09:20 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeff Xu X-Patchwork-Id: 13998194 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 EF2EDC282C5 for ; Mon, 3 Mar 2025 05:09:49 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 950E6280018; Mon, 3 Mar 2025 00:09:44 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 90137280007; Mon, 3 Mar 2025 00:09:44 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 75320280018; Mon, 3 Mar 2025 00:09:44 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 5624E280007 for ; Mon, 3 Mar 2025 00:09:44 -0500 (EST) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 1117E51048 for ; Mon, 3 Mar 2025 05:09:44 +0000 (UTC) X-FDA: 83179062288.05.CEF217F Received: from mail-ed1-f52.google.com (mail-ed1-f52.google.com [209.85.208.52]) by imf01.hostedemail.com (Postfix) with ESMTP id 28C6540005 for ; Mon, 3 Mar 2025 05:09:41 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=msRsmGZJ; dmarc=pass (policy=none) header.from=chromium.org; spf=pass (imf01.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.208.52 as permitted sender) smtp.mailfrom=jeffxu@chromium.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1740978582; a=rsa-sha256; cv=none; b=UU0XOxo+SSIOCTReogan3CMMgoopSdrsfo9QKwI/JWvkw6WMnUp8+WRmB9OJ91+UBwsLFK D8k0N/NQE42MvGeGw2qT6G3sQCT9r8CkGLn0gcE5Thiy8FDBYuWLDOGBZToiYmriLuGCn5 46Uh5XSAxtxDhJ9i8NYSDkY3FQ2Oov4= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=chromium.org header.s=google header.b=msRsmGZJ; dmarc=pass (policy=none) header.from=chromium.org; spf=pass (imf01.hostedemail.com: domain of jeffxu@chromium.org designates 209.85.208.52 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=1740978582; 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:in-reply-to:references:references:dkim-signature; bh=tnEHm8Q2R+qf55+zK9cHcOTX+1u/tw9AcohnyzHuWzM=; b=bxaSZwu9wdBIBzD9ofASZt39po3fpWOcDV/0/4KUJ8IYirV1LNT6ALA0Plyx7LVrU68F61 iqkb0r62uGCnzPGsN7zZ4Fun0M4UkO2CoGcKh/428WhocxiFnkURrO740jgZuStGRLG6mU WI0KebIvQMrHiDaGmniHL81FPAJYOrU= Received: by mail-ed1-f52.google.com with SMTP id 4fb4d7f45d1cf-5e4cbbb37ccso386185a12.1 for ; Sun, 02 Mar 2025 21:09:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1740978581; x=1741583381; darn=kvack.org; 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=tnEHm8Q2R+qf55+zK9cHcOTX+1u/tw9AcohnyzHuWzM=; b=msRsmGZJd7449aljSsaCrRxQ6w0mAA+wKgvi6nqs7VBBvBTxDgUX3dNJcYXREBik7S rZsbb/d2NfABt+iTz8dFuXCdJJ7F7RbALR7ioceSDqEW5oBph66N6rgEGosFl7Wg+ThF vN0E5ByZzhcRRpIj7A6U2Xvx/GisnUFQFTcgk= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1740978581; x=1741583381; 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=tnEHm8Q2R+qf55+zK9cHcOTX+1u/tw9AcohnyzHuWzM=; b=MxE7Nyzwmw2hIOOyi91/hqjCYuOOfD0D10jaIlUosqudu9ZEkx2g4+QFVKgX9/f205 vRPN2SAAtzFSMirBzPJ4XcD3R5lDzkkSx53UQVXLyLggZG86i4KLGP9H2BO1DrBFfdWO 5/0BXFNEVKO+fsoHdr190Kp7ePP+ZFCJtuO0iVAnYBxRN09pSV8U3OJrme6GAaQXcqrD qXcbCAWKGQNGHQQWzQy+xruIFMvnJxJRqrCfsdRI3BQ8kE1R4LHXNKaKfuVDlUTEtxAY uSJB5n7YEyvaonVzD7ZQHmlgPfmBqKNYG1YHvwSAs6lOggaOTMGMikHFX74n9vHZGKxX BkAw== X-Forwarded-Encrypted: i=1; AJvYcCVDy6K88P+Gu3f9lITxxumau/eA5IhLOE0y67lbPU58PbnKpmjlXumXm93Tu9KZ//rv1tucI93KVQ==@kvack.org X-Gm-Message-State: AOJu0YyPzgyeMN2nNolew2xyWHW/ZwUV0SL8eR7I86WCJB0TEWnk9G/P U6PLx1a7hgZYNP+Ybi2tZBJdfEn/NtMV0KElt27WsOVFu2NA3xwRlBYJ/WJmAg== X-Gm-Gg: ASbGncsKlEn7bmcFimZ75jjx3W24viIbZHx54phXFQfaJyOlsdxHCa6sS1VeDmYXchB 8Zx/9AHvyUcKGnDunnjsqT6ju1oVr9PdGn9EoQA0h11zZii1SjF17tNlQ8ybRvhMximyxiz2SM6 BCsT2PZI09D9qHUvapq7LxNq8ufTcjy6qEKNbxT0+BasWojhIJTGZScyjXiop3DAiuL5vP6L/yQ ElvMUKWxsZAa6caM6pTKQNZv9DE6cUYDiIFFmqvW7yI29NS8+utNlmQuwsWqzpVc8yODdC20FtR Ve+JqLGGcEiPsCBTlR4NsyVl4pOgGbkI28CmZAL1I+UQTdU/PcB5pzjiaSlHVKVwOqonh/rSGks n X-Google-Smtp-Source: AGHT+IGr7aLO58G4GmFia0KH79zY4iYQWcKqxIsMg7qlBQCpzajCy2mPKds0czrD1eMZhOSnlodKgg== X-Received: by 2002:a05:6402:2550:b0:5e0:82a0:50b6 with SMTP id 4fb4d7f45d1cf-5e4d6b57020mr4945161a12.6.1740978580628; Sun, 02 Mar 2025 21:09:40 -0800 (PST) Received: from cfish.c.googlers.com.com (40.162.204.35.bc.googleusercontent.com. [35.204.162.40]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5e4c3fb6067sm6248635a12.50.2025.03.02.21.09.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 02 Mar 2025 21:09:39 -0800 (PST) From: jeffxu@chromium.org To: akpm@linux-foundation.org, keescook@chromium.org, jannh@google.com, torvalds@linux-foundation.org, vbabka@suse.cz, lorenzo.stoakes@oracle.com, Liam.Howlett@Oracle.com, adhemerval.zanella@linaro.org, oleg@redhat.com, avagin@gmail.com, benjamin@sipsolutions.net Cc: linux-kernel@vger.kernel.org, linux-hardening@vger.kernel.org, linux-mm@kvack.org, linux-kselftest@vger.kernel.org, jorgelo@chromium.org, sroettger@google.com, hch@lst.de, ojeda@kernel.org, thomas.weissschuh@linutronix.de, adobriyan@gmail.com, johannes@sipsolutions.net, pedro.falcato@gmail.com, hca@linux.ibm.com, willy@infradead.org, anna-maria@linutronix.de, mark.rutland@arm.com, linus.walleij@linaro.org, Jason@zx2c4.com, deller@gmx.de, rdunlap@infradead.org, davem@davemloft.net, peterx@redhat.com, f.fainelli@gmail.com, gerg@kernel.org, dave.hansen@linux.intel.com, mingo@kernel.org, ardb@kernel.org, mhocko@suse.com, 42.hyeyoo@gmail.com, peterz@infradead.org, ardb@google.com, enh@google.com, rientjes@google.com, groeck@chromium.org, mpe@ellerman.id.au, aleksandr.mikhalitsyn@canonical.com, mike.rapoport@gmail.com, Jeff Xu , Kees Cook Subject: [PATCH v8 6/7] mseal sysmap: update mseal.rst Date: Mon, 3 Mar 2025 05:09:20 +0000 Message-ID: <20250303050921.3033083-7-jeffxu@google.com> X-Mailer: git-send-email 2.48.1.711.g2feabab25a-goog In-Reply-To: <20250303050921.3033083-1-jeffxu@google.com> References: <20250303050921.3033083-1-jeffxu@google.com> MIME-Version: 1.0 X-Rspamd-Queue-Id: 28C6540005 X-Stat-Signature: rz79i5autg9qgt51gfemjiff9jy485kf X-Rspam-User: X-Rspamd-Server: rspam05 X-HE-Tag: 1740978581-545328 X-HE-Meta: U2FsdGVkX1/wUo4rYwu5jVtAO5FkGbDJreG8qc/CN1+DigrTW+Vz2t8ORUopS1vnsfnzS8g418pDoayC4jyrDUcoc7HnoglP1WVk57WxfjhwkJ7uqtak25ZgYhS59Q7lGJrBQR+55DxeA7cWBakHboG+jclldwILUKWATUyEt0ywGOJyS/hqztxK6KgNDFgwan5sI2IsmiqCKhJzup7kbG+ZRqCfIafuYPdjWGGTMIxuk2rVjs9rgRC2biwM3CTjjW/PkaFgng0IiIbNfTih8jEgPjapqd81eHVRiiF2fNb4WE8gieLoA0VWXwx9ruBsmknXfVjaOf7z07DXFVb6ojCMEMbf2rguSDSohYjqndAM/lhlUA9EB+0b7HoNl8IZFSz0dv6xqPxdZVG5in4lAN1ySnGp0Cw62JddjUJlvcV9Ezp8Qyc8h+HdgHsqr4ISROqkGL3FIGvgI4LTRRCZDvQr9+skR2Fs6HxgXOrSg1++Plm0vm4jxMIwIxn/fnLNtwsaMzP+cPsJTU2QIGmai0EzidAEDnkAlFJwlgWVRTLf2W4qzgwsX3HtgB1we8z6Qq22VG6qfXO3pa+UcZlU9JeDOLfBUsJH7Hemxp59FVWaEU/ELpHRPOX+FulHLFC0ndHTjiky/ozLrkA2ru3MQF/JRmbLds7qBnejR83NEj10nopqXAs7eHpD/bKu4jaVkerNL5EteHAKPlYGtS9ScUhFKCXp/kIbPpyZaoCpCGhUfAtNGHUR1ULhKQYiAza9G7IqsQM5h61D1I3kZIGgGFJvCSIYhJsSD7yguyAA1JSSwjNx7dzsODUv5dXRHr/0Qw5OXY2wPRFNtdhTdyP+ZTXlWMQfCkAQgLMcU9vv9RAdqC/ashk+5al38smOIHXoYDzGtZS3NaU1JkUqZVtB72EYpUhrpbKjcSaoQJtzMxfCInxsd5fZc1/nJz84rtomQpWYzL2VC2Z7dZQ2L5D 8a793Prt IIbH4AvzHI/pFGKjeZZeKkZlL5aEILGOkCf/6g+uXZVnsBf+zExnlnLdKIKj6LGmZKM9dDdzQcVaUOoVYGZ5KSfxDhtmSO3l8Dw2oVKy6l/rb7kttyjszhpBc8yJSsPNgHMSiwtKzSruAASkDNzG1wuB+yG6ZKdWckTC8MexQpIC00rvwYIWB+fqT41dwnrGdhd+gDsyIF9iA05Xc5joeJagJlQ05W82Hk8OYNHGp5I6b5UgMe7xWlIQkO8YRGbDBop3coP48YAnqoN7b83ERCOGeM88GBbrSFSeaBWrpwpmaYk3uXTMiXgnECxkYDn2Kg36ljO+SI/NGZRKGRA64koOKu5XvkWYXXm7CXSiejI15GHHot0qdUJvOqydNAZR8X/mx/O5qatt/JqM= 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 Update memory sealing documentation to include details about system mappings. Signed-off-by: Jeff Xu Reviewed-by: Kees Cook Reviewed-by: Lorenzo Stoakes Reviewed-by: Liam R. Howlett --- Documentation/userspace-api/mseal.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/Documentation/userspace-api/mseal.rst b/Documentation/userspace-api/mseal.rst index 41102f74c5e2..76e10938302a 100644 --- a/Documentation/userspace-api/mseal.rst +++ b/Documentation/userspace-api/mseal.rst @@ -130,6 +130,26 @@ Use cases - Chrome browser: protect some security sensitive data structures. +- System mappings: + The system mappings are created by the kernel and includes vdso, vvar, + vvar_vclock, vectors (arm compact-mode), sigpage (arm compact-mode), uprobes. + + Those system mappings are readonly only or execute only, memory sealing can + protect them from ever changing to writable or unmmap/remapped as different + attributes. This is useful to mitigate memory corruption issues where a + corrupted pointer is passed to a memory management system. + + If supported by an architecture (CONFIG_ARCH_SUPPORTS_MSEAL_SYSTEM_MAPPINGS), + the CONFIG_MSEAL_SYSTEM_MAPPINGS seals all system mappings of this + architecture. + + The following architectures currently support this feature: x86-64 and arm64. + + WARNING: This feature breaks programs which rely on relocating + or unmapping system mappings. Known broken software at the time + of writing includes CHECKPOINT_RESTORE, UML, gVisor, rr. Therefore + this config can't be enabled universally. + When not to use mseal ===================== Applications can apply sealing to any virtual memory region from userspace,