With the current implementation of the cgroup-aware oom killer, memory.oom_group defines two behaviors: - consider the footprint of the "group" consisting of the mem cgroup itself and all descendants for comparison with other cgroups, and - when selected as the victim mem cgroup, kill all processes attached to it and its descendants that are eligible to be killed. Now that the memory.oom_policy of "tree" considers the memory footprint of the mem cgroup and all its descendants, separate the memory.oom_group setting from the selection criteria. Now, memory.oom_group only controls whether all processes attached to the victim mem cgroup and its descendants are oom killed (when set to "1") or the single largest memory consuming process attached to the victim mem cgroup and its descendants is killed. This is generally regarded as a property of the workload attached to the subtree: it depends on whether the workload can continue running and be useful if a single process is oom killed or whether it's better to kill all attached processes. Signed-off-by: David Rientjes <rientjes@xxxxxxxxxx> --- Documentation/admin-guide/cgroup-v2.rst | 21 ++++----------------- mm/memcontrol.c | 8 ++++---- 2 files changed, 8 insertions(+), 21 deletions(-) diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-guide/cgroup-v2.rst --- a/Documentation/admin-guide/cgroup-v2.rst +++ b/Documentation/admin-guide/cgroup-v2.rst @@ -1078,25 +1078,12 @@ PAGE_SIZE multiple when read back. A read-write single value file which exists on non-root cgroups. The default is "0". - If set, OOM killer will consider the memory cgroup as an - indivisible memory consumers and compare it with other memory - consumers by it's memory footprint. - If such memory cgroup is selected as an OOM victim, all - processes belonging to it or it's descendants will be killed. + If such memory cgroup is selected as an OOM victim, all processes + attached to it and its descendants that are eligible for oom kill + (their /proc/pid/oom_score_adj is not oom disabled) will be killed. This applies to system-wide OOM conditions and reaching the hard memory limit of the cgroup and their ancestor. - If OOM condition happens in a descendant cgroup with it's own - memory limit, the memory cgroup can't be considered - as an OOM victim, and OOM killer will not kill all belonging - tasks. - - Also, OOM killer respects the /proc/pid/oom_score_adj value -1000, - and will never kill the unkillable task, even if memory.oom_group - is set. - - If cgroup-aware OOM killer is not enabled, ENOTSUPP error - is returned on attempt to access the file. memory.oom_policy @@ -1379,7 +1366,7 @@ When selecting a cgroup as a victim, the OOM killer will kill the process with the largest memory footprint. A user can control this behavior by enabling the per-cgroup memory.oom_group option. If set, it causes the OOM killer to kill all processes attached to the cgroup, except processes -with /proc/pid/oom_score_adj set to -1000 (oom disabled). +with /proc/pid/oom_score_adj set to OOM_SCORE_ADJ_MIN. The root cgroup is treated as a leaf memory cgroup as well, so it is compared with other leaf memory cgroups. diff --git a/mm/memcontrol.c b/mm/memcontrol.c --- a/mm/memcontrol.c +++ b/mm/memcontrol.c @@ -2943,11 +2943,11 @@ static void select_victim_memcg(struct mem_cgroup *root, struct oom_control *oc) continue; /* - * We don't consider non-leaf non-oom_group memory cgroups - * without the oom policy of "tree" as OOM victims. + * We don't consider non-leaf memory cgroups without the oom + * policy of "tree" as OOM victims. */ - if (memcg_has_children(iter) && !mem_cgroup_oom_group(iter) && - iter->oom_policy != MEMCG_OOM_POLICY_TREE) + if (iter->oom_policy != MEMCG_OOM_POLICY_TREE && + memcg_has_children(iter)) continue; /*
