1 /* memcontrol.h - Memory Controller
3 * Copyright IBM Corporation, 2007
4 * Author Balbir Singh <balbir@linux.vnet.ibm.com>
6 * Copyright 2007 OpenVZ SWsoft Inc
7 * Author: Pavel Emelianov <xemul@openvz.org>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
20 #ifndef _LINUX_MEMCONTROL_H
21 #define _LINUX_MEMCONTROL_H
22 #include <linux/cgroup.h>
23 #include <linux/vm_event_item.h>
24 #include <linux/hardirq.h>
25 #include <linux/jump_label.h>
33 /* Stats that can be updated by kernel. */
34 enum mem_cgroup_page_stat_item {
35 MEMCG_NR_FILE_MAPPED, /* # of pages charged as file rss */
38 struct mem_cgroup_reclaim_cookie {
41 unsigned int generation;
44 enum mem_cgroup_filter_t {
45 VISIT, /* visit current node */
46 SKIP, /* skip the current node and continue traversal */
47 SKIP_TREE, /* skip the whole subtree and continue traversal */
51 * mem_cgroup_filter_t predicate might instruct mem_cgroup_iter_cond how to
52 * iterate through the hierarchy tree. Each tree element is checked by the
53 * predicate before it is returned by the iterator. If a filter returns
54 * SKIP or SKIP_TREE then the iterator code continues traversal (with the
55 * next node down the hierarchy or the next node that doesn't belong under the
58 typedef enum mem_cgroup_filter_t
59 (*mem_cgroup_iter_filter)(struct mem_cgroup *memcg, struct mem_cgroup *root);
63 * All "charge" functions with gfp_mask should use GFP_KERNEL or
64 * (gfp_mask & GFP_RECLAIM_MASK). In current implementatin, memcg doesn't
65 * alloc memory but reclaims memory from all available zones. So, "where I want
66 * memory from" bits of gfp_mask has no meaning. So any bits of that field is
67 * available but adding a rule is better. charge functions' gfp_mask should
68 * be set to GFP_KERNEL or gfp_mask & GFP_RECLAIM_MASK for avoiding ambiguous
70 * (Of course, if memcg does memory allocation in future, GFP_KERNEL is sane.)
73 extern int mem_cgroup_newpage_charge(struct page *page, struct mm_struct *mm,
75 /* for swap handling */
76 extern int mem_cgroup_try_charge_swapin(struct mm_struct *mm,
77 struct page *page, gfp_t mask, struct mem_cgroup **memcgp);
78 extern void mem_cgroup_commit_charge_swapin(struct page *page,
79 struct mem_cgroup *memcg);
80 extern void mem_cgroup_cancel_charge_swapin(struct mem_cgroup *memcg);
82 extern int mem_cgroup_cache_charge(struct page *page, struct mm_struct *mm,
85 struct lruvec *mem_cgroup_zone_lruvec(struct zone *, struct mem_cgroup *);
86 struct lruvec *mem_cgroup_page_lruvec(struct page *, struct zone *);
88 /* For coalescing uncharge for reducing memcg' overhead*/
89 extern void mem_cgroup_uncharge_start(void);
90 extern void mem_cgroup_uncharge_end(void);
92 extern void mem_cgroup_uncharge_page(struct page *page);
93 extern void mem_cgroup_uncharge_cache_page(struct page *page);
95 bool __mem_cgroup_same_or_subtree(const struct mem_cgroup *root_memcg,
96 struct mem_cgroup *memcg);
97 bool task_in_mem_cgroup(struct task_struct *task,
98 const struct mem_cgroup *memcg);
100 extern struct mem_cgroup *try_get_mem_cgroup_from_page(struct page *page);
101 extern struct mem_cgroup *mem_cgroup_from_task(struct task_struct *p);
102 extern struct mem_cgroup *try_get_mem_cgroup_from_mm(struct mm_struct *mm);
104 extern struct mem_cgroup *parent_mem_cgroup(struct mem_cgroup *memcg);
105 extern struct mem_cgroup *mem_cgroup_from_css(struct cgroup_subsys_state *css);
108 bool mm_match_cgroup(const struct mm_struct *mm, const struct mem_cgroup *memcg)
110 struct mem_cgroup *task_memcg;
114 task_memcg = mem_cgroup_from_task(rcu_dereference(mm->owner));
115 match = __mem_cgroup_same_or_subtree(memcg, task_memcg);
120 extern struct cgroup_subsys_state *mem_cgroup_css(struct mem_cgroup *memcg);
123 mem_cgroup_prepare_migration(struct page *page, struct page *newpage,
124 struct mem_cgroup **memcgp);
125 extern void mem_cgroup_end_migration(struct mem_cgroup *memcg,
126 struct page *oldpage, struct page *newpage, bool migration_ok);
128 struct mem_cgroup *mem_cgroup_iter_cond(struct mem_cgroup *root,
129 struct mem_cgroup *prev,
130 struct mem_cgroup_reclaim_cookie *reclaim,
131 mem_cgroup_iter_filter cond);
133 static inline struct mem_cgroup *mem_cgroup_iter(struct mem_cgroup *root,
134 struct mem_cgroup *prev,
135 struct mem_cgroup_reclaim_cookie *reclaim)
137 return mem_cgroup_iter_cond(root, prev, reclaim, NULL);
140 void mem_cgroup_iter_break(struct mem_cgroup *, struct mem_cgroup *);
143 * For memory reclaim.
145 int mem_cgroup_inactive_anon_is_low(struct lruvec *lruvec);
146 int mem_cgroup_select_victim_node(struct mem_cgroup *memcg);
147 unsigned long mem_cgroup_get_lru_size(struct lruvec *lruvec, enum lru_list);
148 void mem_cgroup_update_lru_size(struct lruvec *, enum lru_list, int);
149 extern void mem_cgroup_print_oom_info(struct mem_cgroup *memcg,
150 struct task_struct *p);
151 extern void mem_cgroup_replace_page_cache(struct page *oldpage,
152 struct page *newpage);
155 * mem_cgroup_toggle_oom - toggle the memcg OOM killer for the current task
156 * @new: true to enable, false to disable
158 * Toggle whether a failed memcg charge should invoke the OOM killer
159 * or just return -ENOMEM. Returns the previous toggle state.
161 * NOTE: Any path that enables the OOM killer before charging must
162 * call mem_cgroup_oom_synchronize() afterward to finalize the
163 * OOM handling and clean up.
165 static inline bool mem_cgroup_toggle_oom(bool new)
169 old = current->memcg_oom.may_oom;
170 current->memcg_oom.may_oom = new;
175 static inline void mem_cgroup_enable_oom(void)
177 bool old = mem_cgroup_toggle_oom(true);
179 WARN_ON(old == true);
182 static inline void mem_cgroup_disable_oom(void)
184 bool old = mem_cgroup_toggle_oom(false);
186 WARN_ON(old == false);
189 static inline bool task_in_memcg_oom(struct task_struct *p)
191 return p->memcg_oom.in_memcg_oom;
194 bool mem_cgroup_oom_synchronize(void);
196 #ifdef CONFIG_MEMCG_SWAP
197 extern int do_swap_account;
200 static inline bool mem_cgroup_disabled(void)
202 if (mem_cgroup_subsys.disabled)
207 void __mem_cgroup_begin_update_page_stat(struct page *page, bool *locked,
208 unsigned long *flags);
210 extern atomic_t memcg_moving;
212 static inline void mem_cgroup_begin_update_page_stat(struct page *page,
213 bool *locked, unsigned long *flags)
215 if (mem_cgroup_disabled())
219 if (atomic_read(&memcg_moving))
220 __mem_cgroup_begin_update_page_stat(page, locked, flags);
223 void __mem_cgroup_end_update_page_stat(struct page *page,
224 unsigned long *flags);
225 static inline void mem_cgroup_end_update_page_stat(struct page *page,
226 bool *locked, unsigned long *flags)
228 if (mem_cgroup_disabled())
231 __mem_cgroup_end_update_page_stat(page, flags);
235 void mem_cgroup_update_page_stat(struct page *page,
236 enum mem_cgroup_page_stat_item idx,
239 static inline void mem_cgroup_inc_page_stat(struct page *page,
240 enum mem_cgroup_page_stat_item idx)
242 mem_cgroup_update_page_stat(page, idx, 1);
245 static inline void mem_cgroup_dec_page_stat(struct page *page,
246 enum mem_cgroup_page_stat_item idx)
248 mem_cgroup_update_page_stat(page, idx, -1);
251 enum mem_cgroup_filter_t
252 mem_cgroup_soft_reclaim_eligible(struct mem_cgroup *memcg,
253 struct mem_cgroup *root);
255 void __mem_cgroup_count_vm_event(struct mm_struct *mm, enum vm_event_item idx);
256 static inline void mem_cgroup_count_vm_event(struct mm_struct *mm,
257 enum vm_event_item idx)
259 if (mem_cgroup_disabled())
261 __mem_cgroup_count_vm_event(mm, idx);
263 #ifdef CONFIG_TRANSPARENT_HUGEPAGE
264 void mem_cgroup_split_huge_fixup(struct page *head);
267 #ifdef CONFIG_DEBUG_VM
268 bool mem_cgroup_bad_page_check(struct page *page);
269 void mem_cgroup_print_bad_page(struct page *page);
271 #else /* CONFIG_MEMCG */
274 static inline int mem_cgroup_newpage_charge(struct page *page,
275 struct mm_struct *mm, gfp_t gfp_mask)
280 static inline int mem_cgroup_cache_charge(struct page *page,
281 struct mm_struct *mm, gfp_t gfp_mask)
286 static inline int mem_cgroup_try_charge_swapin(struct mm_struct *mm,
287 struct page *page, gfp_t gfp_mask, struct mem_cgroup **memcgp)
292 static inline void mem_cgroup_commit_charge_swapin(struct page *page,
293 struct mem_cgroup *memcg)
297 static inline void mem_cgroup_cancel_charge_swapin(struct mem_cgroup *memcg)
301 static inline void mem_cgroup_uncharge_start(void)
305 static inline void mem_cgroup_uncharge_end(void)
309 static inline void mem_cgroup_uncharge_page(struct page *page)
313 static inline void mem_cgroup_uncharge_cache_page(struct page *page)
317 static inline struct lruvec *mem_cgroup_zone_lruvec(struct zone *zone,
318 struct mem_cgroup *memcg)
320 return &zone->lruvec;
323 static inline struct lruvec *mem_cgroup_page_lruvec(struct page *page,
326 return &zone->lruvec;
329 static inline struct mem_cgroup *try_get_mem_cgroup_from_page(struct page *page)
334 static inline struct mem_cgroup *try_get_mem_cgroup_from_mm(struct mm_struct *mm)
339 static inline bool mm_match_cgroup(struct mm_struct *mm,
340 struct mem_cgroup *memcg)
345 static inline bool task_in_mem_cgroup(struct task_struct *task,
346 const struct mem_cgroup *memcg)
351 static inline struct cgroup_subsys_state
352 *mem_cgroup_css(struct mem_cgroup *memcg)
358 mem_cgroup_prepare_migration(struct page *page, struct page *newpage,
359 struct mem_cgroup **memcgp)
363 static inline void mem_cgroup_end_migration(struct mem_cgroup *memcg,
364 struct page *oldpage, struct page *newpage, bool migration_ok)
367 static inline struct mem_cgroup *
368 mem_cgroup_iter_cond(struct mem_cgroup *root,
369 struct mem_cgroup *prev,
370 struct mem_cgroup_reclaim_cookie *reclaim,
371 mem_cgroup_iter_filter cond)
373 /* first call must return non-NULL, second return NULL */
374 return (struct mem_cgroup *)(unsigned long)!prev;
377 static inline struct mem_cgroup *
378 mem_cgroup_iter(struct mem_cgroup *root,
379 struct mem_cgroup *prev,
380 struct mem_cgroup_reclaim_cookie *reclaim)
385 static inline void mem_cgroup_iter_break(struct mem_cgroup *root,
386 struct mem_cgroup *prev)
390 static inline bool mem_cgroup_disabled(void)
396 mem_cgroup_inactive_anon_is_low(struct lruvec *lruvec)
401 static inline unsigned long
402 mem_cgroup_get_lru_size(struct lruvec *lruvec, enum lru_list lru)
408 mem_cgroup_update_lru_size(struct lruvec *lruvec, enum lru_list lru,
414 mem_cgroup_print_oom_info(struct mem_cgroup *memcg, struct task_struct *p)
418 static inline void mem_cgroup_begin_update_page_stat(struct page *page,
419 bool *locked, unsigned long *flags)
423 static inline void mem_cgroup_end_update_page_stat(struct page *page,
424 bool *locked, unsigned long *flags)
428 static inline bool mem_cgroup_toggle_oom(bool new)
433 static inline void mem_cgroup_enable_oom(void)
437 static inline void mem_cgroup_disable_oom(void)
441 static inline bool task_in_memcg_oom(struct task_struct *p)
446 static inline bool mem_cgroup_oom_synchronize(void)
451 static inline void mem_cgroup_inc_page_stat(struct page *page,
452 enum mem_cgroup_page_stat_item idx)
456 static inline void mem_cgroup_dec_page_stat(struct page *page,
457 enum mem_cgroup_page_stat_item idx)
462 enum mem_cgroup_filter_t
463 mem_cgroup_soft_reclaim_eligible(struct mem_cgroup *memcg,
464 struct mem_cgroup *root)
469 static inline void mem_cgroup_split_huge_fixup(struct page *head)
474 void mem_cgroup_count_vm_event(struct mm_struct *mm, enum vm_event_item idx)
477 static inline void mem_cgroup_replace_page_cache(struct page *oldpage,
478 struct page *newpage)
481 #endif /* CONFIG_MEMCG */
483 #if !defined(CONFIG_MEMCG) || !defined(CONFIG_DEBUG_VM)
485 mem_cgroup_bad_page_check(struct page *page)
491 mem_cgroup_print_bad_page(struct page *page)
503 #if defined(CONFIG_INET) && defined(CONFIG_MEMCG_KMEM)
504 void sock_update_memcg(struct sock *sk);
505 void sock_release_memcg(struct sock *sk);
507 static inline void sock_update_memcg(struct sock *sk)
510 static inline void sock_release_memcg(struct sock *sk)
513 #endif /* CONFIG_INET && CONFIG_MEMCG_KMEM */
515 #ifdef CONFIG_MEMCG_KMEM
516 extern struct static_key memcg_kmem_enabled_key;
518 extern int memcg_limited_groups_array_size;
521 * Helper macro to loop through all memcg-specific caches. Callers must still
522 * check if the cache is valid (it is either valid or NULL).
523 * the slab_mutex must be held when looping through those caches
525 #define for_each_memcg_cache_index(_idx) \
526 for ((_idx) = 0; (_idx) < memcg_limited_groups_array_size; (_idx)++)
528 static inline bool memcg_kmem_enabled(void)
530 return static_key_false(&memcg_kmem_enabled_key);
534 * In general, we'll do everything in our power to not incur in any overhead
535 * for non-memcg users for the kmem functions. Not even a function call, if we
538 * Therefore, we'll inline all those functions so that in the best case, we'll
539 * see that kmemcg is off for everybody and proceed quickly. If it is on,
540 * we'll still do most of the flag checking inline. We check a lot of
541 * conditions, but because they are pretty simple, they are expected to be
544 bool __memcg_kmem_newpage_charge(gfp_t gfp, struct mem_cgroup **memcg,
546 void __memcg_kmem_commit_charge(struct page *page,
547 struct mem_cgroup *memcg, int order);
548 void __memcg_kmem_uncharge_pages(struct page *page, int order);
550 int memcg_cache_id(struct mem_cgroup *memcg);
551 int memcg_register_cache(struct mem_cgroup *memcg, struct kmem_cache *s,
552 struct kmem_cache *root_cache);
553 void memcg_release_cache(struct kmem_cache *cachep);
554 void memcg_cache_list_add(struct mem_cgroup *memcg, struct kmem_cache *cachep);
556 int memcg_update_cache_size(struct kmem_cache *s, int num_groups);
557 void memcg_update_array_size(int num_groups);
560 __memcg_kmem_get_cache(struct kmem_cache *cachep, gfp_t gfp);
562 void mem_cgroup_destroy_cache(struct kmem_cache *cachep);
563 void kmem_cache_destroy_memcg_children(struct kmem_cache *s);
566 * memcg_kmem_newpage_charge: verify if a new kmem allocation is allowed.
567 * @gfp: the gfp allocation flags.
568 * @memcg: a pointer to the memcg this was charged against.
569 * @order: allocation order.
571 * returns true if the memcg where the current task belongs can hold this
574 * We return true automatically if this allocation is not to be accounted to
578 memcg_kmem_newpage_charge(gfp_t gfp, struct mem_cgroup **memcg, int order)
580 if (!memcg_kmem_enabled())
584 * __GFP_NOFAIL allocations will move on even if charging is not
585 * possible. Therefore we don't even try, and have this allocation
586 * unaccounted. We could in theory charge it with
587 * res_counter_charge_nofail, but we hope those allocations are rare,
588 * and won't be worth the trouble.
590 if (!(gfp & __GFP_KMEMCG) || (gfp & __GFP_NOFAIL))
592 if (in_interrupt() || (!current->mm) || (current->flags & PF_KTHREAD))
595 /* If the test is dying, just let it go. */
596 if (unlikely(fatal_signal_pending(current)))
599 return __memcg_kmem_newpage_charge(gfp, memcg, order);
603 * memcg_kmem_uncharge_pages: uncharge pages from memcg
604 * @page: pointer to struct page being freed
605 * @order: allocation order.
607 * there is no need to specify memcg here, since it is embedded in page_cgroup
610 memcg_kmem_uncharge_pages(struct page *page, int order)
612 if (memcg_kmem_enabled())
613 __memcg_kmem_uncharge_pages(page, order);
617 * memcg_kmem_commit_charge: embeds correct memcg in a page
618 * @page: pointer to struct page recently allocated
619 * @memcg: the memcg structure we charged against
620 * @order: allocation order.
622 * Needs to be called after memcg_kmem_newpage_charge, regardless of success or
623 * failure of the allocation. if @page is NULL, this function will revert the
624 * charges. Otherwise, it will commit the memcg given by @memcg to the
625 * corresponding page_cgroup.
628 memcg_kmem_commit_charge(struct page *page, struct mem_cgroup *memcg, int order)
630 if (memcg_kmem_enabled() && memcg)
631 __memcg_kmem_commit_charge(page, memcg, order);
635 * memcg_kmem_get_cache: selects the correct per-memcg cache for allocation
636 * @cachep: the original global kmem cache
637 * @gfp: allocation flags.
639 * This function assumes that the task allocating, which determines the memcg
640 * in the page allocator, belongs to the same cgroup throughout the whole
641 * process. Misacounting can happen if the task calls memcg_kmem_get_cache()
642 * while belonging to a cgroup, and later on changes. This is considered
643 * acceptable, and should only happen upon task migration.
645 * Before the cache is created by the memcg core, there is also a possible
646 * imbalance: the task belongs to a memcg, but the cache being allocated from
647 * is the global cache, since the child cache is not yet guaranteed to be
648 * ready. This case is also fine, since in this case the GFP_KMEMCG will not be
649 * passed and the page allocator will not attempt any cgroup accounting.
651 static __always_inline struct kmem_cache *
652 memcg_kmem_get_cache(struct kmem_cache *cachep, gfp_t gfp)
654 if (!memcg_kmem_enabled())
656 if (gfp & __GFP_NOFAIL)
658 if (in_interrupt() || (!current->mm) || (current->flags & PF_KTHREAD))
660 if (unlikely(fatal_signal_pending(current)))
663 return __memcg_kmem_get_cache(cachep, gfp);
666 #define for_each_memcg_cache_index(_idx) \
669 static inline bool memcg_kmem_enabled(void)
675 memcg_kmem_newpage_charge(gfp_t gfp, struct mem_cgroup **memcg, int order)
680 static inline void memcg_kmem_uncharge_pages(struct page *page, int order)
685 memcg_kmem_commit_charge(struct page *page, struct mem_cgroup *memcg, int order)
689 static inline int memcg_cache_id(struct mem_cgroup *memcg)
695 memcg_register_cache(struct mem_cgroup *memcg, struct kmem_cache *s,
696 struct kmem_cache *root_cache)
701 static inline void memcg_release_cache(struct kmem_cache *cachep)
705 static inline void memcg_cache_list_add(struct mem_cgroup *memcg,
706 struct kmem_cache *s)
710 static inline struct kmem_cache *
711 memcg_kmem_get_cache(struct kmem_cache *cachep, gfp_t gfp)
716 static inline void kmem_cache_destroy_memcg_children(struct kmem_cache *s)
719 #endif /* CONFIG_MEMCG_KMEM */
720 #endif /* _LINUX_MEMCONTROL_H */