Now that process handling system oom conditions have access to a small amount of memory reserves, we need a way to notify those process on system oom conditions. When a userspace process waits on the root memcg's memory.oom_control, it will wake up anytime there is a system oom condition. This is a special case of oom notifiers since it doesn't subsequently notify all memcgs under the root memcg (all memcgs on the system). We don't want to trigger those oom handlers which are set aside specifically for true memcg oom notifications that disable their own oom killers to enforce their own oom policy, for example. Signed-off-by: David Rientjes <rientjes@xxxxxxxxxx> --- Documentation/cgroups/memory.txt | 11 ++++++----- include/linux/memcontrol.h | 5 +++++ mm/memcontrol.c | 9 +++++++++ mm/oom_kill.c | 4 ++++ 4 files changed, 24 insertions(+), 5 deletions(-) diff --git a/Documentation/cgroups/memory.txt b/Documentation/cgroups/memory.txt --- a/Documentation/cgroups/memory.txt +++ b/Documentation/cgroups/memory.txt @@ -744,18 +744,19 @@ delivery and gets notification when OOM happens. To register a notifier, an application must: - create an eventfd using eventfd(2) - - open memory.oom_control file + - open memory.oom_control file for reading - write string like "<event_fd> <fd of memory.oom_control>" to cgroup.event_control -The application will be notified through eventfd when OOM happens. -OOM notification doesn't work for the root cgroup. +The application will be notified through eventfd when OOM happens, including +on system oom when used with the root memcg. You can disable the OOM-killer by writing "1" to memory.oom_control file, as: - #echo 1 > memory.oom_control + # echo 1 > memory.oom_control -This operation is only allowed to the top cgroup of a sub-hierarchy. +This operation is only allowed to the top cgroup of a sub-hierarchy and does +not include the root memcg. If OOM-killer is disabled, tasks under cgroup will hang/sleep in memory cgroup's OOM-waitqueue when they request accountable memory. diff --git a/include/linux/memcontrol.h b/include/linux/memcontrol.h --- a/include/linux/memcontrol.h +++ b/include/linux/memcontrol.h @@ -158,6 +158,7 @@ bool mem_cgroup_oom_synchronize(bool wait); extern bool mem_cgroup_alloc_use_oom_reserve(void); extern u64 mem_cgroup_root_oom_reserve(void); +extern void mem_cgroup_root_oom_notify(void); #ifdef CONFIG_MEMCG_SWAP extern int do_swap_account; @@ -410,6 +411,10 @@ static inline u64 mem_cgroup_root_oom_reserve(void) return 0; } +static inline void mem_cgroup_root_oom_notify(void) +{ +} + static inline void mem_cgroup_inc_page_stat(struct page *page, enum mem_cgroup_stat_index idx) { diff --git a/mm/memcontrol.c b/mm/memcontrol.c --- a/mm/memcontrol.c +++ b/mm/memcontrol.c @@ -5721,6 +5721,15 @@ static void mem_cgroup_oom_notify(struct mem_cgroup *memcg) mem_cgroup_oom_notify_cb(iter); } +/* + * Notify any process waiting on the root memcg's memory.oom_control, but do not + * notify any child memcgs to avoid triggering their per-memcg oom handlers. + */ +void mem_cgroup_root_oom_notify(void) +{ + mem_cgroup_oom_notify_cb(root_mem_cgroup); +} + static int __mem_cgroup_usage_register_event(struct mem_cgroup *memcg, struct eventfd_ctx *eventfd, const char *args, enum res_type type) { diff --git a/mm/oom_kill.c b/mm/oom_kill.c --- a/mm/oom_kill.c +++ b/mm/oom_kill.c @@ -643,6 +643,10 @@ void out_of_memory(struct zonelist *zonelist, gfp_t gfp_mask, return; } + /* Avoid waking up processes for oom kills triggered by sysrq */ + if (!force_kill) + mem_cgroup_root_oom_notify(); + /* * Check if there were limitations on the allocation (only relevant for * NUMA) that may require different handling. -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html