MIGRATEPAGES(8)

✨ NAME ✨

okay so bestie, the manual name here is migratepages, from the Linux Administrator's Manual, section 8 🎀 It's the tool that migrates the physical location of a process's pages 🧚

💖 SYNOPSIS 💖

migratepages pid from-nodes to-nodes

🌸 DESCRIPTION 🌸

okay so migratepages moves the physical location of a process's pages, and the process's virtual address space stays exactly the same 😭 The pages just get shuffled around in memory. This lets you change how far a process is from its memory, which is lowkey iconic. Performance can get a glow-up by moving a process's pages to the node where it's currently running ✨

If you give multiple nodes for from-nodes or to-nodes, it tries to keep the relative location of each page within each nodeset 🦋 For example, if you move from nodes 2-5 to 7,9,12-13, the preferred result is 2->7, 3->9, 4->12, and 5->13. Honestly the plan is only doable if there's enough memory free, so keep that in mind 💅

🍓 Valid node specifiers 🍓

• all — every node 🌈
• number — one specific node number 🫶
• number1{,number2} — node number1 and node number2 💜
• number1-number2 — every node from number1 up to number2 ✨
• ! nodes — flips the selection, so you get the opposite of whatever the following specification picks 🙈

💅 NOTES 💅

You need a NUMA policy aware kernel that supports page migration, which means Linux 2.6.16 or later 🔥

Heads up bestie: if you call migratepages as a regular user without admin privileges (but you still have the right to modify the process), it will only move pages that are NOT shared with other processes 😭

If you call it as root, or as a user with administrative privileges, it moves ALL the pages 💀

🧚 FILES 🧚

• /proc/<pid>/numa_maps — this is where you can find info about the NUMA memory use of a process 👑

🦋 COPYRIGHT 🦋

Copyright 2005-2006 Christoph Lameter, Silicon Graphics, Inc. 💖 migratepages is under the GNU General Public License, v.2 🎀

⭐ SEE ALSO ⭐

numactl(8), set_mempolicy(2), get_mempolicy(2), mbind(2), sched_setaffinity(2), sched_getaffinity(2), proc(5), ftok(3), shmat(2), taskset(1) 🫶

Okay bestie, that's the whole vibe ✨ This page came from SGI, dated Jan 2005, and it's MIGRATEPAGES(8) forever 💅🌈