Files
linux/tools/testing/selftests/mm/prctl_thp_disable.c
Usama Arif 6bb9614484 selftests: prctl: introduce tests for disabling THPs except for madvise
The test will set the global system THP setting to never, madvise or
always depending on the fixture variant and the 2M setting to inherit
before it starts (and reset to original at teardown).  The fixture setup
will also test if PR_SET_THP_DISABLE prctl call can be made with
PR_THP_DISABLE_EXCEPT_ADVISED and skip if it fails.

This tests if the process can:
- successfully get the policy to disable THPs expect for madvise.
- get hugepages only on MADV_HUGE and MADV_COLLAPSE if the global policy
  is madvise/always and only with MADV_COLLAPSE if the global policy is
  never.
- successfully reset the policy of the process.
- after reset, only get hugepages with:
  - MADV_COLLAPSE when policy is set to never.
  - MADV_HUGE and MADV_COLLAPSE when policy is set to madvise.
  - always when policy is set to "always".
- never get a THP with MADV_NOHUGEPAGE.
- repeat the above tests in a forked process to make sure  the policy is
  carried across forks.

Test results:
./prctl_thp_disable
TAP version 13
1..12
ok 1 prctl_thp_disable_completely.never.nofork
ok 2 prctl_thp_disable_completely.never.fork
ok 3 prctl_thp_disable_completely.madvise.nofork
ok 4 prctl_thp_disable_completely.madvise.fork
ok 5 prctl_thp_disable_completely.always.nofork
ok 6 prctl_thp_disable_completely.always.fork
ok 7 prctl_thp_disable_except_madvise.never.nofork
ok 8 prctl_thp_disable_except_madvise.never.fork
ok 9 prctl_thp_disable_except_madvise.madvise.nofork
ok 10 prctl_thp_disable_except_madvise.madvise.fork
ok 11 prctl_thp_disable_except_madvise.always.nofork
ok 12 prctl_thp_disable_except_madvise.always.fork

[usamaarif642@gmail.com: return after executing test in child process]
  Link: https://lkml.kernel.org/r/3dca2de4-9a6a-4efe-a86c-83f9509831fc@gmail.com
Link: https://lkml.kernel.org/r/20250815135549.130506-8-usamaarif642@gmail.com
Signed-off-by: Usama Arif <usamaarif642@gmail.com>
Acked-by: David Hildenbrand <david@redhat.com>
Cc: Arnd Bergmann <arnd@arndb.de>
Cc: Baolin Wang <baolin.wang@linux.alibaba.com>
Cc: Barry Song <baohua@kernel.org>
Cc: Dev Jain <dev.jain@arm.com>
Cc: Jann Horn <jannh@google.com>
Cc: Johannes Weiner <hannes@cmpxchg.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Liam Howlett <liam.howlett@oracle.com>
Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Cc: Mariano Pache <npache@redhat.com>
Cc: Michal Hocko <mhocko@suse.com>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Rik van Riel <riel@surriel.com>
Cc: Ryan Roberts <ryan.roberts@arm.com>
Cc: SeongJae Park <sj@kernel.org>
Cc: Shakeel Butt <shakeel.butt@linux.dev>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Vlastimil Babka <vbabka@suse.cz>
Cc: Yafang <laoar.shao@gmail.com>
Cc: Zi Yan <ziy@nvidia.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
2025-09-13 16:55:06 -07:00

292 lines
7.3 KiB
C

// SPDX-License-Identifier: GPL-2.0
/*
* Basic tests for PR_GET/SET_THP_DISABLE prctl calls
*
* Author(s): Usama Arif <usamaarif642@gmail.com>
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/mman.h>
#include <linux/mman.h>
#include <sys/prctl.h>
#include <sys/wait.h>
#include "../kselftest_harness.h"
#include "thp_settings.h"
#include "vm_util.h"
#ifndef PR_THP_DISABLE_EXCEPT_ADVISED
#define PR_THP_DISABLE_EXCEPT_ADVISED (1 << 1)
#endif
enum thp_collapse_type {
THP_COLLAPSE_NONE,
THP_COLLAPSE_MADV_NOHUGEPAGE,
THP_COLLAPSE_MADV_HUGEPAGE, /* MADV_HUGEPAGE before access */
THP_COLLAPSE_MADV_COLLAPSE, /* MADV_COLLAPSE after access */
};
/*
* Function to mmap a buffer, fault it in, madvise it appropriately (before
* page fault for MADV_HUGE, and after for MADV_COLLAPSE), and check if the
* mmap region is huge.
* Returns:
* 0 if test doesn't give hugepage
* 1 if test gives a hugepage
* -errno if mmap fails
*/
static int test_mmap_thp(enum thp_collapse_type madvise_buf, size_t pmdsize)
{
char *mem, *mmap_mem;
size_t mmap_size;
int ret;
/* For alignment purposes, we need twice the THP size. */
mmap_size = 2 * pmdsize;
mmap_mem = (char *)mmap(NULL, mmap_size, PROT_READ | PROT_WRITE,
MAP_PRIVATE | MAP_ANONYMOUS, -1, 0);
if (mmap_mem == MAP_FAILED)
return -errno;
/* We need a THP-aligned memory area. */
mem = (char *)(((uintptr_t)mmap_mem + pmdsize) & ~(pmdsize - 1));
if (madvise_buf == THP_COLLAPSE_MADV_HUGEPAGE)
madvise(mem, pmdsize, MADV_HUGEPAGE);
else if (madvise_buf == THP_COLLAPSE_MADV_NOHUGEPAGE)
madvise(mem, pmdsize, MADV_NOHUGEPAGE);
/* Ensure memory is allocated */
memset(mem, 1, pmdsize);
if (madvise_buf == THP_COLLAPSE_MADV_COLLAPSE)
madvise(mem, pmdsize, MADV_COLLAPSE);
/* HACK: make sure we have a separate VMA that we can check reliably. */
mprotect(mem, pmdsize, PROT_READ);
ret = check_huge_anon(mem, 1, pmdsize);
munmap(mmap_mem, mmap_size);
return ret;
}
static void prctl_thp_disable_completely_test(struct __test_metadata *const _metadata,
size_t pmdsize,
enum thp_enabled thp_policy)
{
ASSERT_EQ(prctl(PR_GET_THP_DISABLE, NULL, NULL, NULL, NULL), 1);
/* tests after prctl overrides global policy */
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_NONE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_NOHUGEPAGE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_HUGEPAGE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_COLLAPSE, pmdsize), 0);
/* Reset to global policy */
ASSERT_EQ(prctl(PR_SET_THP_DISABLE, 0, NULL, NULL, NULL), 0);
/* tests after prctl is cleared, and only global policy is effective */
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_NONE, pmdsize),
thp_policy == THP_ALWAYS ? 1 : 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_NOHUGEPAGE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_HUGEPAGE, pmdsize),
thp_policy == THP_NEVER ? 0 : 1);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_COLLAPSE, pmdsize), 1);
}
FIXTURE(prctl_thp_disable_completely)
{
struct thp_settings settings;
size_t pmdsize;
};
FIXTURE_VARIANT(prctl_thp_disable_completely)
{
enum thp_enabled thp_policy;
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_completely, never)
{
.thp_policy = THP_NEVER,
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_completely, madvise)
{
.thp_policy = THP_MADVISE,
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_completely, always)
{
.thp_policy = THP_ALWAYS,
};
FIXTURE_SETUP(prctl_thp_disable_completely)
{
if (!thp_available())
SKIP(return, "Transparent Hugepages not available\n");
self->pmdsize = read_pmd_pagesize();
if (!self->pmdsize)
SKIP(return, "Unable to read PMD size\n");
if (prctl(PR_SET_THP_DISABLE, 1, NULL, NULL, NULL))
SKIP(return, "Unable to disable THPs completely for the process\n");
thp_save_settings();
thp_read_settings(&self->settings);
self->settings.thp_enabled = variant->thp_policy;
self->settings.hugepages[sz2ord(self->pmdsize, getpagesize())].enabled = THP_INHERIT;
thp_write_settings(&self->settings);
}
FIXTURE_TEARDOWN(prctl_thp_disable_completely)
{
thp_restore_settings();
}
TEST_F(prctl_thp_disable_completely, nofork)
{
prctl_thp_disable_completely_test(_metadata, self->pmdsize, variant->thp_policy);
}
TEST_F(prctl_thp_disable_completely, fork)
{
int ret = 0;
pid_t pid;
/* Make sure prctl changes are carried across fork */
pid = fork();
ASSERT_GE(pid, 0);
if (!pid) {
prctl_thp_disable_completely_test(_metadata, self->pmdsize, variant->thp_policy);
return;
}
wait(&ret);
if (WIFEXITED(ret))
ret = WEXITSTATUS(ret);
else
ret = -EINVAL;
ASSERT_EQ(ret, 0);
}
static void prctl_thp_disable_except_madvise_test(struct __test_metadata *const _metadata,
size_t pmdsize,
enum thp_enabled thp_policy)
{
ASSERT_EQ(prctl(PR_GET_THP_DISABLE, NULL, NULL, NULL, NULL), 3);
/* tests after prctl overrides global policy */
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_NONE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_NOHUGEPAGE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_HUGEPAGE, pmdsize),
thp_policy == THP_NEVER ? 0 : 1);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_COLLAPSE, pmdsize), 1);
/* Reset to global policy */
ASSERT_EQ(prctl(PR_SET_THP_DISABLE, 0, NULL, NULL, NULL), 0);
/* tests after prctl is cleared, and only global policy is effective */
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_NONE, pmdsize),
thp_policy == THP_ALWAYS ? 1 : 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_NOHUGEPAGE, pmdsize), 0);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_HUGEPAGE, pmdsize),
thp_policy == THP_NEVER ? 0 : 1);
ASSERT_EQ(test_mmap_thp(THP_COLLAPSE_MADV_COLLAPSE, pmdsize), 1);
}
FIXTURE(prctl_thp_disable_except_madvise)
{
struct thp_settings settings;
size_t pmdsize;
};
FIXTURE_VARIANT(prctl_thp_disable_except_madvise)
{
enum thp_enabled thp_policy;
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_except_madvise, never)
{
.thp_policy = THP_NEVER,
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_except_madvise, madvise)
{
.thp_policy = THP_MADVISE,
};
FIXTURE_VARIANT_ADD(prctl_thp_disable_except_madvise, always)
{
.thp_policy = THP_ALWAYS,
};
FIXTURE_SETUP(prctl_thp_disable_except_madvise)
{
if (!thp_available())
SKIP(return, "Transparent Hugepages not available\n");
self->pmdsize = read_pmd_pagesize();
if (!self->pmdsize)
SKIP(return, "Unable to read PMD size\n");
if (prctl(PR_SET_THP_DISABLE, 1, PR_THP_DISABLE_EXCEPT_ADVISED, NULL, NULL))
SKIP(return, "Unable to set PR_THP_DISABLE_EXCEPT_ADVISED\n");
thp_save_settings();
thp_read_settings(&self->settings);
self->settings.thp_enabled = variant->thp_policy;
self->settings.hugepages[sz2ord(self->pmdsize, getpagesize())].enabled = THP_INHERIT;
thp_write_settings(&self->settings);
}
FIXTURE_TEARDOWN(prctl_thp_disable_except_madvise)
{
thp_restore_settings();
}
TEST_F(prctl_thp_disable_except_madvise, nofork)
{
prctl_thp_disable_except_madvise_test(_metadata, self->pmdsize, variant->thp_policy);
}
TEST_F(prctl_thp_disable_except_madvise, fork)
{
int ret = 0;
pid_t pid;
/* Make sure prctl changes are carried across fork */
pid = fork();
ASSERT_GE(pid, 0);
if (!pid) {
prctl_thp_disable_except_madvise_test(_metadata, self->pmdsize,
variant->thp_policy);
return;
}
wait(&ret);
if (WIFEXITED(ret))
ret = WEXITSTATUS(ret);
else
ret = -EINVAL;
ASSERT_EQ(ret, 0);
}
TEST_HARNESS_MAIN