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]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 36E62F9D0D2 for ; Tue, 14 Apr 2026 14:24:03 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9D3436B0088; Tue, 14 Apr 2026 10:24:02 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 9AA896B008A; Tue, 14 Apr 2026 10:24:02 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 8C0446B0092; Tue, 14 Apr 2026 10:24:02 -0400 (EDT) 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 77AC86B0088 for ; Tue, 14 Apr 2026 10:24:02 -0400 (EDT) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 1D71A140537 for ; Tue, 14 Apr 2026 14:24:02 +0000 (UTC) X-FDA: 84657380724.10.C2C9382 Received: from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31]) by imf19.hostedemail.com (Postfix) with ESMTP id 18A831A0012 for ; Tue, 14 Apr 2026 14:23:59 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=CUMgG7US; spf=pass (imf19.hostedemail.com: domain of kas@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=kas@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1776176640; 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: references:dkim-signature; bh=l/DIY4Wc2xC5bw06GZUdaqfjSUmMjDlkLw1fJqLtdqk=; b=2AE1DlaArDWSKGMY8rwcEXd1tWVNvvTkzJpMkKcZng/dmHTCh4PQ7379A6k1qdM3LDkOi1 Y0BE0qgWXVP5f59dx0P/vAmn1H6Kshv9xddTSeNC6nSXJG5GQ55CTj5aX1S3y6R8VU7gNT jx7O7ykD/r5lhKbHIDFAaLoI8i3d+jA= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1776176640; a=rsa-sha256; cv=none; b=Kb1GXjKL6UJDkU6Dtil8yuEQBRjRaET5qx7yc7a3yk7GpiSlkFs20deMR7jKxvvw1pVFis p8cex40XERSaHUBxdM2b1U0+73qlIsvi6RLxxSadwUz8+P30BUB1ySO7pUw0++2sPSZ82j KzhdahksSLHKJsW0Bl/7ThDcp6YdzB8= ARC-Authentication-Results: i=1; imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=CUMgG7US; spf=pass (imf19.hostedemail.com: domain of kas@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=kas@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sea.source.kernel.org (Postfix) with ESMTP id CC34543575; Tue, 14 Apr 2026 14:23:58 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 0669EC2BCB0; Tue, 14 Apr 2026 14:23:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1776176638; bh=/fCVxa0eMyMWklv2E9q9GFJdXVtpfKD77F6QKI/nFIQ=; h=From:To:Cc:Subject:Date:From; b=CUMgG7USGrHWNOhxeLwWd/mwPJHpMj3QUt4q9oHTRQdLna0K9mfo2uXiVDMQ4hKpc uqrM/kI+CMLi/YxeXP3Uj623dK4aKke80UIjoAkHX6M43RqZ9INfja18DHQc7R/S2+ pW4MsWKJLn0WAhQd7L7Bnq2qe9L/yhS012c69IM4E8TCzpKVthZEBVCnW8ufu9TC95 4DEGxxDjc8+U+4jNcXTmaTYPTexLDZ2jImIEi8IukiOLl4yyK7zsCk9aJdFfpN8eBS VYO4GHxm5TEZYZGz0+e6qMSjf4rzl5yQgj3E4hw6+5bIWpkdYJqXbqzw6K8qRMJ6CJ 2qGv8yv3OQZ6A== Received: from phl-compute-08.internal (phl-compute-08.internal [10.202.2.48]) by mailfauth.phl.internal (Postfix) with ESMTP id 28BECF4006B; Tue, 14 Apr 2026 10:23:57 -0400 (EDT) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-08.internal (MEProxy); Tue, 14 Apr 2026 10:23:57 -0400 X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefhedrtddtgdegudefkecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpuffrtefokffrpgfnqfghnecuuegr ihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjug hrpefhvfevufffkffogggtgfesthekredtredtjeenucfhrhhomhepfdfmihhrhihlucfu hhhuthhsvghmrghuucdlofgvthgrmddfuceokhgrsheskhgvrhhnvghlrdhorhhgqeenuc ggtffrrghtthgvrhhnpedvleevheejjeevveetgfejvdfhtdfftefhhfettefgkeejfefg keduhfdthfehhfenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfh hrohhmpehkihhrihhllhdomhgvshhmthhprghuthhhphgvrhhsohhnrghlihhthidqudei udduiedvieehhedqvdekgeeggeejvdekqdhkrghspeepkhgvrhhnvghlrdhorhhgsehshh huthgvmhhovhdrnhgrmhgvpdhnsggprhgtphhtthhopeduledpmhhouggvpehsmhhtphho uhhtpdhrtghpthhtoheprghkphhmsehlihhnuhigqdhfohhunhgurghtihhonhdrohhrgh dprhgtphhtthhopehpvghtvghrgiesrhgvughhrghtrdgtohhmpdhrtghpthhtohepuggr vhhiugeskhgvrhhnvghlrdhorhhgpdhrtghpthhtoheplhhjsheskhgvrhhnvghlrdhorh hgpdhrtghpthhtoheprhhpphhtsehkvghrnhgvlhdrohhrghdprhgtphhtthhopehsuhhr vghnsgesghhoohhglhgvrdgtohhmpdhrtghpthhtohepvhgsrggskhgrsehkvghrnhgvlh drohhrghdprhgtphhtthhopehlihgrmhdrhhhofihlvghtthesohhrrggtlhgvrdgtohhm pdhrtghpthhtohepiihihiesnhhvihguihgrrdgtohhm X-ME-Proxy: Feedback-ID: i10464835:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 14 Apr 2026 10:23:56 -0400 (EDT) From: "Kiryl Shutsemau (Meta)" To: Andrew Morton Cc: Peter Xu , David Hildenbrand , Lorenzo Stoakes , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , "Liam R . Howlett" , Zi Yan , Jonathan Corbet , Shuah Khan , Sean Christopherson , Paolo Bonzini , linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-kselftest@vger.kernel.org, kvm@vger.kernel.org, "Kiryl Shutsemau (Meta)" Subject: [RFC, PATCH 00/12] userfaultfd: working set tracking for VM guest memory Date: Tue, 14 Apr 2026 15:23:34 +0100 Message-ID: <20260414142354.1465950-1-kas@kernel.org> X-Mailer: git-send-email 2.51.2 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam12 X-Stat-Signature: fdsq97agnns5srjm95f6egrbgm3qtxra X-Rspamd-Queue-Id: 18A831A0012 X-Rspam-User: X-HE-Tag: 1776176639-46862 X-HE-Meta: U2FsdGVkX1+t3j4jQP5VVEl02JIi/ULTZDwtx13Z87DqtpTehzVL4mwqo69Xy7UOC5hmwSu0VThGGK/b+ZJtVvkmjnOTxO0AX9gHWIn/LI7UurOxCIKj8KdTD9pC3qz9FwUO+Ukp6Amru5thWp7qKIxZevCsBacVwaUiPvR3NwbG3yfl5tAKYM+EYdUBPfkj/D5VC5d8kGCU7eQ/zuZAy2H4Uk9G4ypT/h5GazI0Be9fzemsRhKRcg0SIOFcSM9Bz0SunwOILoef+9rQ9h2/jfWxPDgHCK/WtGzGPIE+fP5RbAsv51fGB0tf9UDP/r3gRps20lvQ9R3PyLBgbGBWpQdQtNKArasI2sKmWbQitk4OgtlcC3jqLwcQQVQYMT2Jq6UroGb+nwMYc/EuTDmdO4Xfjrvs/RA4JpZyveDFc3t9evZRayZrYm5tITLf03S9uDA8taN5qcBMyFXZ1tLsBg8ZZhOHALFX9VIUex09vnc6lpS6iWDbX5Imjc1hNR9x+VTSsLVDvMiLDeDVGSruMT3lPvjq+jYrea+vVL7pq5/9gouSIQdJ8tNQmk61/MCXPQNNVqCfs2XC/JZImmchzDn9Wvn3XANAlnpuFT6+vMdBNzgLxFWmmE/btNm4j7mY+VYhTLPbg0fRAcX4sh5HKr4yshM9mBDU7blbthF8WgjkErbU8NL/vNJXw/9n+hQgEW0EpT63FIihbFsCQ2SxDrwIUqdVCudyxVQ9fLsonDalsgRHcWNE67zXyVvhbx54PtJZ0t0OO9vruc5Pv1CWSzpqDiWD/PUyOEq5721j1U/I5y3YU8C/LOCl4d947MH/rO9qddi7ZdiGwX0/3yfqwJ7fMrmC+CMPPkBpI5FkkpIFy+95k3kxRj7lmVABCxrjt/V/e/62MNH3GdXE5ihNk7AQ3pn6uScwlutV0HiE5wHpSspml/W+x2FoLoTg2fGYQUctX7J0/0BwqQIse4b ZrP9GyBs nJF9+asThW+4U7ojtSNB5CgyvPqVqPmrL1zjQ7UJ20FGw43WXW4/bkWxUt9h6uK16wwmHXdodWZ98vDRtykfXXt3dg7V9ohc9GVoHsUpwAdyuIFsflemjKFcmRDOzd+Q+rqBlNHc+0CUygHct7TZ72repDM78qQex0z7Now8mUXFDy51hSoNXdwHbVzc6OJ2olcZPBwWkXAwr2I0pgDea8lFkIPy0xzXt/ajRnyZ4p5gYnUhaQetIH6UE4Yimje6SvXW7ewGFR+QQlIQ= Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: This series adds userfaultfd support for tracking the working set of VM guest memory, enabling VMMs to identify cold pages and evict them to tiered or remote storage. == Problem == VMMs managing guest memory need to: 1. Track which pages are actively used (working set detection) 2. Safely evict cold pages to slower storage 3. Fetch pages back on demand when accessed again For shmem-backed guest memory, working set tracking partially works today: MADV_DONTNEED zaps PTEs while pages stay in page cache, and re-access auto-resolves from cache. But safe eviction still requires synchronous fault interception to prevent data loss races. For anonymous guest memory (needed for KSM cross-VM deduplication), there is no mechanism at all — clearing a PTE loses the page. == Solution == The series introduces a unified userfaultfd interface that works across both anonymous and shmem-backed memory: UFFD_FEATURE_MINOR_ANON: extends MODE_MINOR registration to anonymous private memory. Uses the PROT_NONE hinting mechanism (same as NUMA balancing) to make pages inaccessible without freeing them. UFFD_FEATURE_MINOR_ASYNC: auto-resolves minor faults without handler involvement. The kernel restores PTE permissions immediately and the faulting thread continues. Works for anonymous, shmem, and hugetlbfs. UFFDIO_DEACTIVATE: marks pages as deactivated. For anonymous memory, sets PROT_NONE on PTEs (pages stay resident). For shmem/hugetlbfs, zaps PTEs (pages stay in page cache). UFFDIO_SET_MODE: toggles MINOR_ASYNC at runtime, synchronized via mmap_write_lock. Enables the VMM workflow: async mode for lightweight detection, sync mode for race-free eviction. PAGE_IS_UFFD_DEACTIVATED: PAGEMAP_SCAN category flag for efficient batch detection of cold (still-deactivated) anonymous pages. == VMM Workflow == UFFDIO_DEACTIVATE(all) -- async, no vCPU stalls sleep(interval) PAGEMAP_SCAN -- find cold pages UFFDIO_SET_MODE(sync) -- block faults for eviction pwrite + MADV_DONTNEED cold pages -- safe, faults block UFFDIO_SET_MODE(async) -- resume tracking The same workflow applies to shmem, with a different PAGEMAP_SCAN mask (!PAGE_IS_PRESENT instead of PAGE_IS_UFFD_DEACTIVATED). == NUMA Balancing == NUMA balancing scanning is skipped on anonymous VM_UFFD_MINOR VMAs to avoid protnone conflicts. NUMA locality stats are fed from the uffd fault path via task_numa_fault() so the scheduler retains placement data. Shmem VMAs are unaffected (UFFDIO_DEACTIVATE zaps PTEs there, no protnone involved). == Testing == The series includes 6 new selftests covering async/sync modes, PAGEMAP_SCAN cold detection, GUP through protnone, UFFDIO_SET_MODE toggling, and cleanup on close. All 73 uffd unit tests pass (including hugetlb) across defconfig, allnoconfig, allmodconfig, and randomized configs. Kiryl Shutsemau (Meta) (12): userfaultfd: define UAPI constants for anonymous minor faults userfaultfd: add UFFD_FEATURE_MINOR_ANON registration support userfaultfd: implement UFFDIO_DEACTIVATE ioctl userfaultfd: UFFDIO_CONTINUE for anonymous memory mm: intercept protnone faults on VM_UFFD_MINOR anonymous VMAs userfaultfd: auto-resolve shmem and hugetlbfs minor faults in async mode sched/numa: skip scanning anonymous VM_UFFD_MINOR VMAs userfaultfd: enable UFFD_FEATURE_MINOR_ANON mm/pagemap: add PAGE_IS_UFFD_DEACTIVATED to PAGEMAP_SCAN userfaultfd: add UFFDIO_SET_MODE for runtime sync/async toggle selftests/mm: add userfaultfd anonymous minor fault tests Documentation/userfaultfd: document working set tracking Documentation/admin-guide/mm/userfaultfd.rst | 141 ++++- fs/proc/task_mmu.c | 11 +- fs/userfaultfd.c | 184 +++++- include/linux/huge_mm.h | 6 + include/linux/mm.h | 2 + include/linux/sched/numa_balancing.h | 1 + include/linux/userfaultfd_k.h | 21 +- include/trace/events/sched.h | 3 +- include/uapi/linux/fs.h | 1 + include/uapi/linux/userfaultfd.h | 40 +- kernel/sched/fair.c | 13 + mm/huge_memory.c | 33 +- mm/hugetlb.c | 3 +- mm/memory.c | 51 +- mm/mprotect.c | 9 +- mm/shmem.c | 3 +- mm/userfaultfd.c | 164 +++++- tools/testing/selftests/mm/uffd-unit-tests.c | 458 +++++++++++++++ 18 files changed, 1096 insertions(+), 48 deletions(-) Kiryl Shutsemau (Meta) (12): userfaultfd: define UAPI constants for anonymous minor faults userfaultfd: add UFFD_FEATURE_MINOR_ANON registration support userfaultfd: implement UFFDIO_DEACTIVATE ioctl userfaultfd: UFFDIO_CONTINUE for anonymous memory mm: intercept protnone faults on VM_UFFD_MINOR anonymous VMAs userfaultfd: auto-resolve shmem and hugetlbfs minor faults in async mode sched/numa: skip scanning anonymous VM_UFFD_MINOR VMAs userfaultfd: enable UFFD_FEATURE_MINOR_ANON mm/pagemap: add PAGE_IS_UFFD_DEACTIVATED to PAGEMAP_SCAN userfaultfd: add UFFDIO_SET_MODE for runtime sync/async toggle selftests/mm: add userfaultfd anonymous minor fault tests Documentation/userfaultfd: document working set tracking Documentation/admin-guide/mm/userfaultfd.rst | 141 +++++- fs/proc/task_mmu.c | 11 +- fs/userfaultfd.c | 184 +++++++- include/linux/huge_mm.h | 6 + include/linux/mm.h | 2 + include/linux/sched/numa_balancing.h | 1 + include/linux/userfaultfd_k.h | 21 +- include/trace/events/sched.h | 3 +- include/uapi/linux/fs.h | 1 + include/uapi/linux/userfaultfd.h | 40 +- kernel/sched/fair.c | 13 + mm/huge_memory.c | 33 +- mm/hugetlb.c | 3 +- mm/memory.c | 51 ++- mm/mprotect.c | 9 +- mm/shmem.c | 3 +- mm/userfaultfd.c | 164 ++++++- tools/testing/selftests/mm/uffd-unit-tests.c | 458 +++++++++++++++++++ 18 files changed, 1096 insertions(+), 48 deletions(-) -- 2.51.2