52b84b
From 04f21709ff081a5f1a2b5ca746582a9c5c03db7f Mon Sep 17 00:00:00 2001
52b84b
From: Tejun Heo <tj@kernel.org>
52b84b
Date: Fri, 8 Jun 2018 17:33:14 -0700
52b84b
Subject: [PATCH] core: add MemoryMin
52b84b
52b84b
The kernel added support for a new cgroup memory controller knob memory.min in
52b84b
bf8d5d52ffe8 ("memcg: introduce memory.min") which was merged during v4.18
52b84b
merge window.
52b84b
52b84b
Add MemoryMin to support memory.min.
52b84b
52b84b
(cherry picked from commit 484226357789991de0b3363beb69258be06b4c92)
52b84b
52b84b
Resolves: #1763435
52b84b
---
52b84b
 doc/TRANSIENT-SETTINGS.md             |  1 +
52b84b
 man/systemd.resource-control.xml      | 21 +++++++++++++++++++++
52b84b
 src/core/cgroup.c                     |  5 ++++-
52b84b
 src/core/cgroup.h                     |  1 +
52b84b
 src/core/dbus-cgroup.c                |  7 +++++++
52b84b
 src/core/load-fragment-gperf.gperf.m4 |  1 +
52b84b
 src/core/load-fragment.c              |  4 +++-
52b84b
 src/shared/bus-unit-util.c            |  2 +-
52b84b
 src/systemctl/systemctl.c             | 11 +++++++++--
52b84b
 9 files changed, 48 insertions(+), 5 deletions(-)
52b84b
52b84b
diff --git a/doc/TRANSIENT-SETTINGS.md b/doc/TRANSIENT-SETTINGS.md
52b84b
index 0d2d3e9065..93865c0333 100644
52b84b
--- a/doc/TRANSIENT-SETTINGS.md
52b84b
+++ b/doc/TRANSIENT-SETTINGS.md
52b84b
@@ -222,6 +222,7 @@ All cgroup/resource control settings are available for transient units
52b84b
 ✓ AllowedCPUs=
52b84b
 ✓ AllowedMemoryNodes=
52b84b
 ✓ MemoryAccounting=
52b84b
+✓ MemoryMin=
52b84b
 ✓ MemoryLow=
52b84b
 ✓ MemoryHigh=
52b84b
 ✓ MemoryMax=
52b84b
diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
52b84b
index cfe19a6574..63a0c87565 100644
52b84b
--- a/man/systemd.resource-control.xml
52b84b
+++ b/man/systemd.resource-control.xml
52b84b
@@ -265,6 +265,27 @@
52b84b
         </listitem>
52b84b
       </varlistentry>
52b84b
 
52b84b
+      <varlistentry>
52b84b
+        <term><varname>MemoryMin=<replaceable>bytes</replaceable></varname></term>
52b84b
+
52b84b
+        <listitem>
52b84b
+          <para>Specify the memory usage protection of the executed processes in this unit. If the memory usages of
52b84b
+          this unit and all its ancestors are below their minimum boundaries, this unit's memory won't be reclaimed.</para>
52b84b
+
52b84b
+          <para>Takes a memory size in bytes. If the value is suffixed with K, M, G or T, the specified memory size is
52b84b
+          parsed as Kilobytes, Megabytes, Gigabytes, or Terabytes (with the base 1024), respectively. Alternatively, a
52b84b
+          percentage value may be specified, which is taken relative to the installed physical memory on the
52b84b
+          system. This controls the <literal>memory.min</literal> control group attribute. For details about this
52b84b
+          control group attribute, see 
52b84b
+          url="https://www.kernel.org/doc/Documentation/cgroup-v2.txt">cgroup-v2.txt</ulink>.</para>
52b84b
+
52b84b
+          <para>Implies <literal>MemoryAccounting=true</literal>.</para>
52b84b
+
52b84b
+          <para>This setting is supported only if the unified control group hierarchy is used and disables
52b84b
+          <varname>MemoryLimit=</varname>.</para>
52b84b
+        </listitem>
52b84b
+      </varlistentry>
52b84b
+
52b84b
       <varlistentry>
52b84b
         <term><varname>MemoryLow=<replaceable>bytes</replaceable></varname></term>
52b84b
 
52b84b
diff --git a/src/core/cgroup.c b/src/core/cgroup.c
52b84b
index f8b351a65d..9d09c65453 100644
52b84b
--- a/src/core/cgroup.c
52b84b
+++ b/src/core/cgroup.c
52b84b
@@ -220,6 +220,7 @@ void cgroup_context_dump(CGroupContext *c, FILE* f, const char *prefix) {
52b84b
                 "%sStartupIOWeight=%" PRIu64 "\n"
52b84b
                 "%sBlockIOWeight=%" PRIu64 "\n"
52b84b
                 "%sStartupBlockIOWeight=%" PRIu64 "\n"
52b84b
+                "%sMemoryMin=%" PRIu64 "\n"
52b84b
                 "%sMemoryLow=%" PRIu64 "\n"
52b84b
                 "%sMemoryHigh=%" PRIu64 "\n"
52b84b
                 "%sMemoryMax=%" PRIu64 "\n"
52b84b
@@ -246,6 +247,7 @@ void cgroup_context_dump(CGroupContext *c, FILE* f, const char *prefix) {
52b84b
                 prefix, c->startup_io_weight,
52b84b
                 prefix, c->blockio_weight,
52b84b
                 prefix, c->startup_blockio_weight,
52b84b
+                prefix, c->memory_min,
52b84b
                 prefix, c->memory_low,
52b84b
                 prefix, c->memory_high,
52b84b
                 prefix, c->memory_max,
52b84b
@@ -777,7 +779,7 @@ static void cgroup_apply_blkio_device_limit(Unit *u, const char *dev_path, uint6
52b84b
 }
52b84b
 
52b84b
 static bool cgroup_context_has_unified_memory_config(CGroupContext *c) {
52b84b
-        return c->memory_low > 0 || c->memory_high != CGROUP_LIMIT_MAX || c->memory_max != CGROUP_LIMIT_MAX || c->memory_swap_max != CGROUP_LIMIT_MAX;
52b84b
+        return c->memory_min > 0 || c->memory_low > 0 || c->memory_high != CGROUP_LIMIT_MAX || c->memory_max != CGROUP_LIMIT_MAX || c->memory_swap_max != CGROUP_LIMIT_MAX;
52b84b
 }
52b84b
 
52b84b
 static void cgroup_apply_unified_memory_limit(Unit *u, const char *file, uint64_t v) {
52b84b
@@ -1035,6 +1037,7 @@ static void cgroup_context_apply(
52b84b
                                         log_cgroup_compat(u, "Applying MemoryLimit %" PRIu64 " as MemoryMax", max);
52b84b
                         }
52b84b
 
52b84b
+                        cgroup_apply_unified_memory_limit(u, "memory.min", c->memory_min);
52b84b
                         cgroup_apply_unified_memory_limit(u, "memory.low", c->memory_low);
52b84b
                         cgroup_apply_unified_memory_limit(u, "memory.high", c->memory_high);
52b84b
                         cgroup_apply_unified_memory_limit(u, "memory.max", max);
52b84b
diff --git a/src/core/cgroup.h b/src/core/cgroup.h
52b84b
index 2ba57d3ded..5e1be87b20 100644
52b84b
--- a/src/core/cgroup.h
52b84b
+++ b/src/core/cgroup.h
52b84b
@@ -95,6 +95,7 @@ struct CGroupContext {
52b84b
         LIST_HEAD(CGroupIODeviceLimit, io_device_limits);
52b84b
         LIST_HEAD(CGroupIODeviceLatency, io_device_latencies);
52b84b
 
52b84b
+        uint64_t memory_min;
52b84b
         uint64_t memory_low;
52b84b
         uint64_t memory_high;
52b84b
         uint64_t memory_max;
52b84b
diff --git a/src/core/dbus-cgroup.c b/src/core/dbus-cgroup.c
52b84b
index 4555b33b1f..6ce5984a02 100644
52b84b
--- a/src/core/dbus-cgroup.c
52b84b
+++ b/src/core/dbus-cgroup.c
52b84b
@@ -353,6 +353,7 @@ const sd_bus_vtable bus_cgroup_vtable[] = {
52b84b
         SD_BUS_PROPERTY("BlockIOReadBandwidth", "a(st)", property_get_blockio_device_bandwidths, 0, 0),
52b84b
         SD_BUS_PROPERTY("BlockIOWriteBandwidth", "a(st)", property_get_blockio_device_bandwidths, 0, 0),
52b84b
         SD_BUS_PROPERTY("MemoryAccounting", "b", bus_property_get_bool, offsetof(CGroupContext, memory_accounting), 0),
52b84b
+        SD_BUS_PROPERTY("MemoryMin", "t", NULL, offsetof(CGroupContext, memory_min), 0),
52b84b
         SD_BUS_PROPERTY("MemoryLow", "t", NULL, offsetof(CGroupContext, memory_low), 0),
52b84b
         SD_BUS_PROPERTY("MemoryHigh", "t", NULL, offsetof(CGroupContext, memory_high), 0),
52b84b
         SD_BUS_PROPERTY("MemoryMax", "t", NULL, offsetof(CGroupContext, memory_max), 0),
52b84b
@@ -661,6 +662,9 @@ int bus_cgroup_set_property(
52b84b
         if (streq(name, "MemoryAccounting"))
52b84b
                 return bus_cgroup_set_boolean(u, name, &c->memory_accounting, CGROUP_MASK_MEMORY, message, flags, error);
52b84b
 
52b84b
+        if (streq(name, "MemoryMin"))
52b84b
+                return bus_cgroup_set_memory(u, name, &c->memory_min, message, flags, error);
52b84b
+
52b84b
         if (streq(name, "MemoryLow"))
52b84b
                 return bus_cgroup_set_memory(u, name, &c->memory_low, message, flags, error);
52b84b
 
52b84b
@@ -676,6 +680,9 @@ int bus_cgroup_set_property(
52b84b
         if (streq(name, "MemoryLimit"))
52b84b
                 return bus_cgroup_set_memory(u, name, &c->memory_limit, message, flags, error);
52b84b
 
52b84b
+        if (streq(name, "MemoryMinScale"))
52b84b
+                return bus_cgroup_set_memory_scale(u, name, &c->memory_min, message, flags, error);
52b84b
+
52b84b
         if (streq(name, "MemoryLowScale"))
52b84b
                 return bus_cgroup_set_memory_scale(u, name, &c->memory_low, message, flags, error);
52b84b
 
52b84b
diff --git a/src/core/load-fragment-gperf.gperf.m4 b/src/core/load-fragment-gperf.gperf.m4
52b84b
index 4defa82ac1..1c6e539f30 100644
52b84b
--- a/src/core/load-fragment-gperf.gperf.m4
52b84b
+++ b/src/core/load-fragment-gperf.gperf.m4
52b84b
@@ -171,6 +171,7 @@ $1.StartupCPUShares,             config_parse_cpu_shares,            0,
52b84b
 $1.CPUQuota,                     config_parse_cpu_quota,             0,                             offsetof($1, cgroup_context)
52b84b
 $1.CPUQuotaPeriodSec,            config_parse_sec_def_infinity,      0,                             offsetof($1, cgroup_context.cpu_quota_period_usec)
52b84b
 $1.MemoryAccounting,             config_parse_bool,                  0,                             offsetof($1, cgroup_context.memory_accounting)
52b84b
+$1.MemoryMin,                    config_parse_memory_limit,          0,                             offsetof($1, cgroup_context)
52b84b
 $1.MemoryLow,                    config_parse_memory_limit,          0,                             offsetof($1, cgroup_context)
52b84b
 $1.MemoryHigh,                   config_parse_memory_limit,          0,                             offsetof($1, cgroup_context)
52b84b
 $1.MemoryMax,                    config_parse_memory_limit,          0,                             offsetof($1, cgroup_context)
52b84b
diff --git a/src/core/load-fragment.c b/src/core/load-fragment.c
52b84b
index 762b106007..d43b0f08f9 100644
52b84b
--- a/src/core/load-fragment.c
52b84b
+++ b/src/core/load-fragment.c
52b84b
@@ -3096,7 +3096,9 @@ int config_parse_memory_limit(
52b84b
                 }
52b84b
         }
52b84b
 
52b84b
-        if (streq(lvalue, "MemoryLow"))
52b84b
+        if (streq(lvalue, "MemoryMin"))
52b84b
+                c->memory_min = bytes;
52b84b
+        else if (streq(lvalue, "MemoryLow"))
52b84b
                 c->memory_low = bytes;
52b84b
         else if (streq(lvalue, "MemoryHigh"))
52b84b
                 c->memory_high = bytes;
52b84b
diff --git a/src/shared/bus-unit-util.c b/src/shared/bus-unit-util.c
52b84b
index ec45d6f86d..203c068d02 100644
52b84b
--- a/src/shared/bus-unit-util.c
52b84b
+++ b/src/shared/bus-unit-util.c
52b84b
@@ -429,7 +429,7 @@ static int bus_append_cgroup_property(sd_bus_message *m, const char *field, cons
52b84b
                 return 1;
52b84b
         }
52b84b
 
52b84b
-        if (STR_IN_SET(field, "MemoryLow", "MemoryHigh", "MemoryMax", "MemorySwapMax", "MemoryLimit", "TasksMax")) {
52b84b
+        if (STR_IN_SET(field, "MemoryMin", "MemoryLow", "MemoryHigh", "MemoryMax", "MemorySwapMax", "MemoryLimit", "TasksMax")) {
52b84b
 
52b84b
                 if (isempty(eq) || streq(eq, "infinity")) {
52b84b
                         r = sd_bus_message_append(m, "(sv)", field, "t", CGROUP_LIMIT_MAX);
52b84b
diff --git a/src/systemctl/systemctl.c b/src/systemctl/systemctl.c
52b84b
index 559e49f104..35ad20f510 100644
52b84b
--- a/src/systemctl/systemctl.c
52b84b
+++ b/src/systemctl/systemctl.c
52b84b
@@ -3905,6 +3905,7 @@ typedef struct UnitStatusInfo {
52b84b
 
52b84b
         /* CGroup */
52b84b
         uint64_t memory_current;
52b84b
+        uint64_t memory_min;
52b84b
         uint64_t memory_low;
52b84b
         uint64_t memory_high;
52b84b
         uint64_t memory_max;
52b84b
@@ -4284,12 +4285,17 @@ static void print_status_info(
52b84b
 
52b84b
                 printf("   Memory: %s", format_bytes(buf, sizeof(buf), i->memory_current));
52b84b
 
52b84b
-                if (i->memory_low > 0 || i->memory_high != CGROUP_LIMIT_MAX ||
52b84b
-                    i->memory_max != CGROUP_LIMIT_MAX || i->memory_swap_max != CGROUP_LIMIT_MAX ||
52b84b
+                if (i->memory_min > 0 || i->memory_low > 0 ||
52b84b
+                    i->memory_high != CGROUP_LIMIT_MAX || i->memory_max != CGROUP_LIMIT_MAX ||
52b84b
+                    i->memory_swap_max != CGROUP_LIMIT_MAX ||
52b84b
                     i->memory_limit != CGROUP_LIMIT_MAX) {
52b84b
                         const char *prefix = "";
52b84b
 
52b84b
                         printf(" (");
52b84b
+                        if (i->memory_min > 0) {
52b84b
+                                printf("%smin: %s", prefix, format_bytes(buf, sizeof(buf), i->memory_min));
52b84b
+                                prefix = " ";
52b84b
+                        }
52b84b
                         if (i->memory_low > 0) {
52b84b
                                 printf("%slow: %s", prefix, format_bytes(buf, sizeof(buf), i->memory_low));
52b84b
                                 prefix = " ";
52b84b
@@ -5022,6 +5028,7 @@ static int show_one(
52b84b
                 { "Where",                          "s",              NULL,           offsetof(UnitStatusInfo, where)                             },
52b84b
                 { "What",                           "s",              NULL,           offsetof(UnitStatusInfo, what)                              },
52b84b
                 { "MemoryCurrent",                  "t",              NULL,           offsetof(UnitStatusInfo, memory_current)                    },
52b84b
+                { "MemoryMin",                      "t",              NULL,           offsetof(UnitStatusInfo, memory_min)                        },
52b84b
                 { "MemoryLow",                      "t",              NULL,           offsetof(UnitStatusInfo, memory_low)                        },
52b84b
                 { "MemoryHigh",                     "t",              NULL,           offsetof(UnitStatusInfo, memory_high)                       },
52b84b
                 { "MemoryMax",                      "t",              NULL,           offsetof(UnitStatusInfo, memory_max)                        },