[LTP] [PATCH v7] hugetlb/hugemmap: add hugemmap33 to test hugetlbfs quota accounting
Pavithra
pavrampu@linux.ibm.com
Sat Sep 5 14:45:22 CEST 2026
Test hugetlbfs quota accounting with filesystem size limits to check
for regressions in quota handling for MAP_PRIVATE and MAP_SHARED pages.
Signed-off-by: Pavithra <pavrampu@linux.ibm.com>
---
v6 -> v7:
- Name function pointer parameters 'size' and 'mmap_flags' to fix make
check warnings.
Link to v6: https://lore.kernel.org/ltp/20260902075156.240295-1-pavrampu@linux.ibm.com/
---
runtest/hugetlb | 1 +
testcases/kernel/mem/.gitignore | 1 +
.../kernel/mem/hugetlb/hugemmap/hugemmap33.c | 260 ++++++++++++++++++
3 files changed, 262 insertions(+)
create mode 100644 testcases/kernel/mem/hugetlb/hugemmap/hugemmap33.c
diff --git a/runtest/hugetlb b/runtest/hugetlb
index 621c9718a..e3ee42c2f 100644
--- a/runtest/hugetlb
+++ b/runtest/hugetlb
@@ -35,6 +35,7 @@ hugemmap29 hugemmap29
hugemmap30 hugemmap30
hugemmap31 hugemmap31
hugemmap32 hugemmap32
+hugemmap33 hugemmap33
hugemmap34 hugemmap34
hugemmap35 hugemmap35
hugemmap36 hugemmap36
diff --git a/testcases/kernel/mem/.gitignore b/testcases/kernel/mem/.gitignore
index 9e706e1c8..763f134dd 100644
--- a/testcases/kernel/mem/.gitignore
+++ b/testcases/kernel/mem/.gitignore
@@ -35,6 +35,7 @@
/hugetlb/hugemmap/hugemmap30
/hugetlb/hugemmap/hugemmap31
/hugetlb/hugemmap/hugemmap32
+/hugetlb/hugemmap/hugemmap33
/hugetlb/hugemmap/hugemmap34
/hugetlb/hugemmap/hugemmap35
/hugetlb/hugemmap/hugemmap36
diff --git a/testcases/kernel/mem/hugetlb/hugemmap/hugemmap33.c b/testcases/kernel/mem/hugetlb/hugemmap/hugemmap33.c
new file mode 100644
index 000000000..910b699f2
--- /dev/null
+++ b/testcases/kernel/mem/hugetlb/hugemmap/hugemmap33.c
@@ -0,0 +1,260 @@
+// SPDX-License-Identifier: LGPL-2.1-or-later
+/*
+ * Copyright (C) 2005-2007 David Gibson & Adam Litke, IBM Corporation.
+ * Copyright (c) Linux Test Project, 2024
+ * Copyright (C) 2025-2026 Naveed & Pavithra, IBM Corporation.
+ * Assisted with AI tools
+ */
+
+/*\
+ * Test hugetlbfs quota accounting with filesystem size limits.
+ *
+ * The number of global huge pages available to a mounted hugetlbfs filesystem
+ * can be limited using a quota mechanism by setting the size attribute at
+ * mount time. Older kernels did not properly handle quota accounting for
+ * MAP_PRIVATE pages and MAP_SHARED reservations.
+ *
+ * Commit a1e78772d72b introduced MAP_PRIVATE reservations at mmap() time,
+ * so quota is checked upfront and mmap() fails with ENOMEM when over quota.
+ * Before this, quota was only checked at fault time resulting in SIGBUS.
+ *
+ * Root is required to mount the quota-limited hugetlbfs instance.
+ */
+
+#define _GNU_SOURCE
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <sys/vfs.h>
+#include <sys/mount.h>
+#include "hugetlb.h"
+
+#define MNTPOINT "hugetlbfs/"
+
+static long hpage_size;
+static int quota_mounted;
+
+static void verify_quota_stat(long tot, long free, long avail)
+{
+ struct statfs s;
+
+ SAFE_STATFS(MNTPOINT, &s);
+
+ if ((long)s.f_blocks != tot || (long)s.f_bfree != free || (long)s.f_bavail != avail) {
+ tst_res(TFAIL, "Bad quota counters: total=%li free=%li avail=%li, expected %li %li %li",
+ (long)s.f_blocks, (long)s.f_bfree, (long)s.f_bavail,
+ tot, free, avail);
+ return;
+ }
+ tst_res(TPASS, "Quota counters are correct: total=%li free=%li avail=%li",
+ tot, free, avail);
+}
+
+static void verify_quota_map_unmap(unsigned long size, int mmap_flags)
+{
+ int fd;
+ char path[PATH_MAX];
+
+ snprintf(path, sizeof(path), "%s/test_file_%d", MNTPOINT, getpid());
+ fd = SAFE_OPEN(path, O_CREAT | O_RDWR, 0600);
+ SAFE_UNLINK(path);
+
+ TESTPTR(mmap(NULL, size, PROT_READ | PROT_WRITE, mmap_flags, fd, 0));
+ if (TST_RET_PTR == MAP_FAILED) {
+ tst_res(TFAIL | TERRNO, "mmap failed unexpectedly");
+ SAFE_CLOSE(fd);
+ return;
+ }
+
+ tst_res(TPASS, "Untouched mapping quota test passed as expected");
+ SAFE_CLOSE(fd);
+}
+
+static void verify_quota_ok(unsigned long size, int mmap_flags)
+{
+ int fd;
+ char *a, *b;
+ char path[PATH_MAX];
+
+ snprintf(path, sizeof(path), "%s/test_file_%d", MNTPOINT, getpid());
+ fd = SAFE_OPEN(path, O_CREAT | O_RDWR, 0600);
+ SAFE_UNLINK(path);
+
+ TESTPTR(mmap(NULL, size, PROT_READ | PROT_WRITE, mmap_flags, fd, 0));
+ a = TST_RET_PTR;
+ if (a == MAP_FAILED) {
+ tst_res(TFAIL | TERRNO, "mmap failed unexpectedly");
+ SAFE_CLOSE(fd);
+ return;
+ }
+
+ for (b = a; b < a + size; b += hpage_size)
+ *b = 1;
+
+ tst_res(TPASS, "Quota test passed as expected");
+ SAFE_MUNMAP(a, size);
+ SAFE_CLOSE(fd);
+}
+
+static void verify_quota_fail(unsigned long size, int mmap_flags)
+{
+ int fd;
+ char *a;
+ char path[PATH_MAX];
+
+ snprintf(path, sizeof(path), "%s/test_file_%d", MNTPOINT, getpid());
+ fd = SAFE_OPEN(path, O_CREAT | O_RDWR, 0600);
+ SAFE_UNLINK(path);
+
+ TESTPTR(mmap(NULL, size, PROT_READ | PROT_WRITE, mmap_flags, fd, 0));
+ a = TST_RET_PTR;
+ if (a == MAP_FAILED) {
+ if (TST_ERR == ENOMEM) {
+ tst_res(TPASS | TERRNO, "mmap failed as expected due to quota");
+ SAFE_CLOSE(fd);
+ return;
+ }
+ tst_res(TFAIL | TERRNO, "mmap failed unexpectedly");
+ SAFE_CLOSE(fd);
+ return;
+ }
+
+ tst_res(TFAIL, "mmap succeeded but quota exhaustion was expected");
+ SAFE_MUNMAP(a, size);
+ SAFE_CLOSE(fd);
+}
+
+static void verify_quota_private_resv_fail(unsigned long size, int mmap_flags)
+{
+ int fd;
+ char *a, *b, *c;
+ char path[PATH_MAX];
+
+ snprintf(path, sizeof(path), "%s/test_file_%d", MNTPOINT, getpid());
+ fd = SAFE_OPEN(path, O_CREAT | O_RDWR, 0600);
+ SAFE_UNLINK(path);
+
+ TESTPTR(mmap(NULL, size, PROT_READ | PROT_WRITE, mmap_flags, fd, 0));
+ a = TST_RET_PTR;
+ if (a == MAP_FAILED) {
+ tst_res(TFAIL | TERRNO, "mmap failed unexpectedly");
+ SAFE_CLOSE(fd);
+ return;
+ }
+
+ for (b = a; b < a + size; b += hpage_size)
+ *b = 1;
+
+ TESTPTR(mmap(NULL, size, PROT_READ | PROT_WRITE, MAP_PRIVATE, fd, 0));
+ c = TST_RET_PTR;
+ if (c == MAP_FAILED) {
+ if (TST_ERR == ENOMEM) {
+ tst_res(TPASS | TERRNO,
+ "MAP_PRIVATE mmap failed as expected due to quota");
+ SAFE_MUNMAP(a, size);
+ SAFE_CLOSE(fd);
+ return;
+ }
+ tst_res(TFAIL | TERRNO, "MAP_PRIVATE mmap failed unexpectedly");
+ SAFE_MUNMAP(a, size);
+ SAFE_CLOSE(fd);
+ return;
+ }
+
+ tst_res(TFAIL, "MAP_PRIVATE mmap succeeded but quota exhaustion was expected");
+ SAFE_MUNMAP(c, size);
+ SAFE_MUNMAP(a, size);
+ SAFE_CLOSE(fd);
+}
+
+static struct tcase {
+ void (*fn)(unsigned long size, int mmap_flags);
+ unsigned long size_mult; /* multiplied by hpage_size at runtime */
+ int mmap_flags;
+ const char *desc;
+ int check_stat; /* call verify_quota_stat(1,1,1) after */
+} tcases[] = {
+ { verify_quota_map_unmap, 1, MAP_PRIVATE,
+ "Unused quota cleanup for untouched MAP_PRIVATE mapping", 1 },
+ { verify_quota_map_unmap, 1, MAP_SHARED,
+ "Unused quota cleanup for untouched MAP_SHARED mapping", 1 },
+ { verify_quota_ok, 1, MAP_PRIVATE,
+ "Page instantiation within quota (MAP_PRIVATE)", 0 },
+ { verify_quota_ok, 1, MAP_SHARED,
+ "Page instantiation within quota (MAP_SHARED)", 0 },
+ { verify_quota_fail, 2, MAP_SHARED,
+ "Page instantiation over quota (MAP_SHARED)", 0 },
+ { verify_quota_fail, 2, MAP_PRIVATE,
+ "Private mapping quota check (MAP_PRIVATE)", 0 },
+ { verify_quota_private_resv_fail, 1, MAP_SHARED,
+ "Second MAP_PRIVATE reservation over quota (MAP_SHARED base)", 0 },
+ { verify_quota_private_resv_fail, 1, MAP_PRIVATE,
+ "Second MAP_PRIVATE reservation over quota (MAP_PRIVATE base)", 0 },
+ { verify_quota_ok, 1, MAP_SHARED,
+ "Operation within quota after failures (MAP_SHARED)", 0 },
+ { verify_quota_ok, 1, MAP_PRIVATE,
+ "Operation within quota after failures (MAP_PRIVATE)", 0 },
+};
+
+static void run_test(unsigned int i)
+{
+ const struct tcase *tc = &tcases[i];
+ pid_t pid;
+ int status;
+
+ tst_res(TINFO, "%s", tc->desc);
+
+ pid = SAFE_FORK();
+ if (pid == 0) {
+ tc->fn(tc->size_mult * hpage_size, tc->mmap_flags);
+ exit(0);
+ }
+
+ SAFE_WAITPID(pid, &status, 0);
+
+ if (WIFSIGNALED(status))
+ tst_res(TFAIL, "Child killed by signal %d", WTERMSIG(status));
+
+ if (tc->check_stat)
+ verify_quota_stat(1, 1, 1);
+}
+
+static void setup(void)
+{
+ char mount_opts[BUFSIZ];
+
+ hpage_size = tst_get_hugepage_size();
+
+ snprintf(mount_opts, sizeof(mount_opts), "size=%luK",
+ hpage_size / 1024);
+
+ if (mount("none", MNTPOINT, "hugetlbfs", 0, mount_opts) == -1) {
+ if (errno == ENODEV)
+ tst_brk(TCONF, "hugetlbfs not supported");
+ tst_brk(TBROK | TERRNO, "mount() failed");
+ }
+ quota_mounted = 1;
+
+ tst_res(TINFO, "Mounted hugetlbfs with quota at %s (size=%luK)",
+ MNTPOINT, hpage_size / 1024);
+}
+
+static void cleanup(void)
+{
+ if (quota_mounted)
+ SAFE_UMOUNT(MNTPOINT);
+}
+
+static struct tst_test test = {
+ .tags = (struct tst_tag[]) {
+ {"linux-git", "a1e78772d72b"},
+ {}
+ },
+ .needs_root = 1,
+ .mntpoint = MNTPOINT,
+ .forks_child = 1,
+ .setup = setup,
+ .cleanup = cleanup,
+ .test = run_test,
+ .tcnt = ARRAY_SIZE(tcases),
+ .hugepages = {2, TST_NEEDS},
+};
--
2.55.0
More information about the ltp
mailing list