/*
* Copyright (C) 2012-2017 Red Hat, Inc.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
* the GNU General Public License for more details.
*
* Descriptions:
*
* There are two tunables overcommit_memory and overcommit_ratio under
* /proc/sys/vm/, which can control memory overcommitment.
*
* The overcommit_memory contains a flag that enables memory
* overcommitment, it has three values:
* - When this flag is 0, the kernel attempts to estimate the amount
* of free memory left when userspace requests more memory.
* - When this flag is 1, the kernel pretends there is always enough
* memory until it actually runs out.
* - When this flag is 2, the kernel uses a "never overcommit" policy
* that attempts to prevent any overcommit of memory.
*
* The overcommit_ratio tunable defines the amount by which the kernel
* overextends its memory resources in the event that overcommit_memory
* is set to the value of 2. The value in this file represents a
* percentage added to the amount of actual RAM in a system when
* considering whether to grant a particular memory request.
* The general formula for this tunable is:
* CommitLimit = SwapTotal + MemTotal * overcommit_ratio
* CommitLimit, SwapTotal and MemTotal can read from /proc/meminfo.
*
* The program is designed to test the two tunables:
*
* When overcommit_memory = 0, allocatable memory can't overextends
* the amount of free memory. I choose the three cases:
* a. less than free_total: free_total / 2, alloc should pass.
* b. greater than free_total: free_total * 2, alloc should fail.
* c. equal to sum_total: sum_tatal, alloc should fail
*
* When overcommit_memory = 1, it can alloc enough much memory, I
* choose the three cases:
* a. less than sum_total: sum_total / 2, alloc should pass
* b. equal to sum_total: sum_total, alloc should pass
* c. greater than sum_total: sum_total * 2, alloc should pass
* *note: sum_total = SwapTotal + MemTotal
*
* When overcommit_memory = 2, the total virtual address space on
* the system is limited to CommitLimit(Swap+RAM*overcommit_ratio)
* commit_left(allocatable memory) = CommitLimit - Committed_AS
* a. less than commit_left: commit_left / 2, alloc should pass
* b. greater than commit_left: commit_left * 2, alloc should fail
* c. overcommit limit: CommitLimit, alloc should fail
* *note: CommitLimit is the current overcommit limit.
* Committed_AS is the amount of memory that system has used.
* it couldn't choose 'equal to commit_left' as a case, because
* commit_left rely on Committed_AS, but the Committed_AS is not stable.
*
* References:
* - Documentation/sysctl/vm.txt
* - Documentation/vm/overcommit-accounting
*/
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <limits.h>
#include "mem.h"
#define DEFAULT_OVER_RATIO 50L
#define EXPECT_PASS 0
#define EXPECT_FAIL 1
static char *R_opt;
static struct tst_option options[] = {
{"R:", &R_opt, " -R n Percentage of overcommitting memory"},
{NULL, NULL, NULL}
};
static long old_overcommit_memory;
static long old_overcommit_ratio;
static long overcommit_ratio;
static long sum_total;
static long free_total;
static long commit_limit;
static long commit_left;
static int heavy_malloc(long size);
static void alloc_and_check(long size, int expect_result);
static void update_mem(void);
static void setup(void)
{
long mem_total, swap_total;
struct rlimit lim;
if (access(PATH_SYSVM "overcommit_memory", F_OK) == -1 ||
access(PATH_SYSVM "overcommit_ratio", F_OK) == -1)
tst_brk(TCONF, "The system "
"can't support to test %s", TCID);
if (R_opt)
overcommit_ratio = SAFE_STRTOL(R_opt, 0, LONG_MAX);
else
overcommit_ratio = DEFAULT_OVER_RATIO;
old_overcommit_memory = get_sys_tune("overcommit_memory");
old_overcommit_ratio = get_sys_tune("overcommit_ratio");
mem_total = SAFE_READ_MEMINFO("MemTotal:");
tst_res(TINFO, "MemTotal is %ld kB", mem_total);
swap_total = SAFE_READ_MEMINFO("SwapTotal:");
tst_res(TINFO, "SwapTotal is %ld kB", swap_total);
sum_total = mem_total + swap_total;
commit_limit = SAFE_READ_MEMINFO("CommitLimit:");
tst_res(TINFO, "CommitLimit is %ld kB", commit_limit);
SAFE_GETRLIMIT(RLIMIT_AS, &lim);
if (lim.rlim_cur != RLIM_INFINITY) {
lim.rlim_cur = RLIM_INFINITY;
lim.rlim_max = RLIM_INFINITY;
tst_res(TINFO, "Increasing RLIM_AS to INFINITY");
SAFE_SETRLIMIT(RLIMIT_AS, &lim);
}
set_sys_tune("overcommit_ratio", overcommit_ratio, 1);
}
static void cleanup(void)
{
set_sys_tune("overcommit_memory", old_overcommit_memory, 0);
set_sys_tune("overcommit_ratio", old_overcommit_ratio, 0);
}
static void overcommit_memory_test(void)
{
#if __WORDSIZE == 32
tst_brk(TCONF, "test is not designed for 32-bit system.");
#endif
/* start to test overcommit_memory=2 */
set_sys_tune("overcommit_memory", 2, 1);
update_mem();
alloc_and_check(commit_left * 2, EXPECT_FAIL);
alloc_and_check(commit_limit, EXPECT_FAIL);
update_mem();
alloc_and_check(commit_left / 2, EXPECT_PASS);
/* start to test overcommit_memory=0 */
set_sys_tune("overcommit_memory", 0, 1);
update_mem();
alloc_and_check(free_total / 2, EXPECT_PASS);
update_mem();
alloc_and_check(free_total * 2, EXPECT_FAIL);
alloc_and_check(sum_total, EXPECT_FAIL);
/* start to test overcommit_memory=1 */
set_sys_tune("overcommit_memory", 1, 1);
alloc_and_check(sum_total / 2, EXPECT_PASS);
alloc_and_check(sum_total, EXPECT_PASS);
alloc_and_check(sum_total * 2, EXPECT_PASS);
}
static int heavy_malloc(long size)
{
char *p;
p = malloc(size * KB);
if (p != NULL) {
tst_res(TINFO, "malloc %ld kB successfully", size);
free(p);
return 0;
} else {
tst_res(TINFO, "malloc %ld kB failed", size);
return 1;
}
}
static void alloc_and_check(long size, int expect_result)
{
int result;
/* try to alloc size kB memory */
result = heavy_malloc(size);
switch (expect_result) {
case EXPECT_PASS:
if (result == 0)
tst_res(TPASS, "alloc passed as expected");
else
tst_res(TFAIL, "alloc failed, expected to pass");
break;
case EXPECT_FAIL:
if (result != 0)
tst_res(TPASS, "alloc failed as expected");
else
tst_res(TFAIL, "alloc passed, expected to fail");
break;
default:
tst_brk(TBROK, "Invaild numbler parameter: %d",
expect_result);
}
}
static void update_mem(void)
{
long mem_free, swap_free;
long committed;
mem_free = SAFE_READ_MEMINFO("MemFree:");
swap_free = SAFE_READ_MEMINFO("SwapFree:");
free_total = mem_free + swap_free;
commit_limit = SAFE_READ_MEMINFO("CommitLimit:");
if (get_sys_tune("overcommit_memory") == 2) {
committed = SAFE_READ_MEMINFO("Committed_AS:");
commit_left = commit_limit - committed;
if (commit_left < 0) {
tst_res(TINFO, "CommitLimit is %ld, Committed_AS"
" is %ld", commit_limit, committed);
tst_brk(TBROK, "Unexpected error: "
"CommitLimit < Committed_AS");
}
}
}
static struct tst_test test = {
.needs_root = 1,
.options = options,
.setup = setup,
.cleanup = cleanup,
.test_all = overcommit_memory_test,
};