xref: /linux-6.15/include/linux/memcontrol.h (revision 19d7c3ad)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /* memcontrol.h - Memory Controller
3  *
4  * Copyright IBM Corporation, 2007
5  * Author Balbir Singh <[email protected]>
6  *
7  * Copyright 2007 OpenVZ SWsoft Inc
8  * Author: Pavel Emelianov <[email protected]>
9  */
10 
11 #ifndef _LINUX_MEMCONTROL_H
12 #define _LINUX_MEMCONTROL_H
13 #include <linux/cgroup.h>
14 #include <linux/vm_event_item.h>
15 #include <linux/hardirq.h>
16 #include <linux/jump_label.h>
17 #include <linux/kernel.h>
18 #include <linux/page_counter.h>
19 #include <linux/vmpressure.h>
20 #include <linux/eventfd.h>
21 #include <linux/mm.h>
22 #include <linux/vmstat.h>
23 #include <linux/writeback.h>
24 #include <linux/page-flags.h>
25 #include <linux/shrinker.h>
26 
27 struct mem_cgroup;
28 struct obj_cgroup;
29 struct page;
30 struct mm_struct;
31 struct kmem_cache;
32 
33 /* Cgroup-specific page state, on top of universal node page state */
34 enum memcg_stat_item {
35 	MEMCG_SWAP = NR_VM_NODE_STAT_ITEMS,
36 	MEMCG_SOCK,
37 	MEMCG_PERCPU_B,
38 	MEMCG_VMALLOC,
39 	MEMCG_KMEM,
40 	MEMCG_ZSWAP_B,
41 	MEMCG_ZSWAPPED,
42 	MEMCG_NR_STAT,
43 };
44 
45 enum memcg_memory_event {
46 	MEMCG_LOW,
47 	MEMCG_HIGH,
48 	MEMCG_MAX,
49 	MEMCG_OOM,
50 	MEMCG_OOM_KILL,
51 	MEMCG_OOM_GROUP_KILL,
52 	MEMCG_SWAP_HIGH,
53 	MEMCG_SWAP_MAX,
54 	MEMCG_SWAP_FAIL,
55 	MEMCG_NR_MEMORY_EVENTS,
56 };
57 
58 struct mem_cgroup_reclaim_cookie {
59 	pg_data_t *pgdat;
60 	int generation;
61 };
62 
63 #ifdef CONFIG_MEMCG
64 
65 #define MEM_CGROUP_ID_SHIFT	16
66 
67 struct mem_cgroup_id {
68 	int id;
69 	refcount_t ref;
70 };
71 
72 struct memcg_vmstats_percpu;
73 struct memcg1_events_percpu;
74 struct memcg_vmstats;
75 struct lruvec_stats_percpu;
76 struct lruvec_stats;
77 
78 struct mem_cgroup_reclaim_iter {
79 	struct mem_cgroup *position;
80 	/* scan generation, increased every round-trip */
81 	atomic_t generation;
82 };
83 
84 /*
85  * per-node information in memory controller.
86  */
87 struct mem_cgroup_per_node {
88 	/* Keep the read-only fields at the start */
89 	struct mem_cgroup	*memcg;		/* Back pointer, we cannot */
90 						/* use container_of	   */
91 
92 	struct lruvec_stats_percpu __percpu	*lruvec_stats_percpu;
93 	struct lruvec_stats			*lruvec_stats;
94 	struct shrinker_info __rcu	*shrinker_info;
95 
96 #ifdef CONFIG_MEMCG_V1
97 	/*
98 	 * Memcg-v1 only stuff in middle as buffer between read mostly fields
99 	 * and update often fields to avoid false sharing. If v1 stuff is
100 	 * not present, an explicit padding is needed.
101 	 */
102 
103 	struct rb_node		tree_node;	/* RB tree node */
104 	unsigned long		usage_in_excess;/* Set to the value by which */
105 						/* the soft limit is exceeded*/
106 	bool			on_tree;
107 #else
108 	CACHELINE_PADDING(_pad1_);
109 #endif
110 
111 	/* Fields which get updated often at the end. */
112 	struct lruvec		lruvec;
113 	CACHELINE_PADDING(_pad2_);
114 	unsigned long		lru_zone_size[MAX_NR_ZONES][NR_LRU_LISTS];
115 	struct mem_cgroup_reclaim_iter	iter;
116 };
117 
118 struct mem_cgroup_threshold {
119 	struct eventfd_ctx *eventfd;
120 	unsigned long threshold;
121 };
122 
123 /* For threshold */
124 struct mem_cgroup_threshold_ary {
125 	/* An array index points to threshold just below or equal to usage. */
126 	int current_threshold;
127 	/* Size of entries[] */
128 	unsigned int size;
129 	/* Array of thresholds */
130 	struct mem_cgroup_threshold entries[] __counted_by(size);
131 };
132 
133 struct mem_cgroup_thresholds {
134 	/* Primary thresholds array */
135 	struct mem_cgroup_threshold_ary *primary;
136 	/*
137 	 * Spare threshold array.
138 	 * This is needed to make mem_cgroup_unregister_event() "never fail".
139 	 * It must be able to store at least primary->size - 1 entries.
140 	 */
141 	struct mem_cgroup_threshold_ary *spare;
142 };
143 
144 /*
145  * Remember four most recent foreign writebacks with dirty pages in this
146  * cgroup.  Inode sharing is expected to be uncommon and, even if we miss
147  * one in a given round, we're likely to catch it later if it keeps
148  * foreign-dirtying, so a fairly low count should be enough.
149  *
150  * See mem_cgroup_track_foreign_dirty_slowpath() for details.
151  */
152 #define MEMCG_CGWB_FRN_CNT	4
153 
154 struct memcg_cgwb_frn {
155 	u64 bdi_id;			/* bdi->id of the foreign inode */
156 	int memcg_id;			/* memcg->css.id of foreign inode */
157 	u64 at;				/* jiffies_64 at the time of dirtying */
158 	struct wb_completion done;	/* tracks in-flight foreign writebacks */
159 };
160 
161 /*
162  * Bucket for arbitrarily byte-sized objects charged to a memory
163  * cgroup. The bucket can be reparented in one piece when the cgroup
164  * is destroyed, without having to round up the individual references
165  * of all live memory objects in the wild.
166  */
167 struct obj_cgroup {
168 	struct percpu_ref refcnt;
169 	struct mem_cgroup *memcg;
170 	atomic_t nr_charged_bytes;
171 	union {
172 		struct list_head list; /* protected by objcg_lock */
173 		struct rcu_head rcu;
174 	};
175 };
176 
177 /*
178  * The memory controller data structure. The memory controller controls both
179  * page cache and RSS per cgroup. We would eventually like to provide
180  * statistics based on the statistics developed by Rik Van Riel for clock-pro,
181  * to help the administrator determine what knobs to tune.
182  */
183 struct mem_cgroup {
184 	struct cgroup_subsys_state css;
185 
186 	/* Private memcg ID. Used to ID objects that outlive the cgroup */
187 	struct mem_cgroup_id id;
188 
189 	/* Accounted resources */
190 	struct page_counter memory;		/* Both v1 & v2 */
191 
192 	union {
193 		struct page_counter swap;	/* v2 only */
194 		struct page_counter memsw;	/* v1 only */
195 	};
196 
197 	/* registered local peak watchers */
198 	struct list_head memory_peaks;
199 	struct list_head swap_peaks;
200 	spinlock_t	 peaks_lock;
201 
202 	/* Range enforcement for interrupt charges */
203 	struct work_struct high_work;
204 
205 #ifdef CONFIG_ZSWAP
206 	unsigned long zswap_max;
207 
208 	/*
209 	 * Prevent pages from this memcg from being written back from zswap to
210 	 * swap, and from being swapped out on zswap store failures.
211 	 */
212 	bool zswap_writeback;
213 #endif
214 
215 	/* vmpressure notifications */
216 	struct vmpressure vmpressure;
217 
218 	/*
219 	 * Should the OOM killer kill all belonging tasks, had it kill one?
220 	 */
221 	bool oom_group;
222 
223 	int swappiness;
224 
225 	/* memory.events and memory.events.local */
226 	struct cgroup_file events_file;
227 	struct cgroup_file events_local_file;
228 
229 	/* handle for "memory.swap.events" */
230 	struct cgroup_file swap_events_file;
231 
232 	/* memory.stat */
233 	struct memcg_vmstats	*vmstats;
234 
235 	/* memory.events */
236 	atomic_long_t		memory_events[MEMCG_NR_MEMORY_EVENTS];
237 	atomic_long_t		memory_events_local[MEMCG_NR_MEMORY_EVENTS];
238 
239 	/*
240 	 * Hint of reclaim pressure for socket memroy management. Note
241 	 * that this indicator should NOT be used in legacy cgroup mode
242 	 * where socket memory is accounted/charged separately.
243 	 */
244 	unsigned long		socket_pressure;
245 
246 	int kmemcg_id;
247 	/*
248 	 * memcg->objcg is wiped out as a part of the objcg repaprenting
249 	 * process. memcg->orig_objcg preserves a pointer (and a reference)
250 	 * to the original objcg until the end of live of memcg.
251 	 */
252 	struct obj_cgroup __rcu	*objcg;
253 	struct obj_cgroup	*orig_objcg;
254 	/* list of inherited objcgs, protected by objcg_lock */
255 	struct list_head objcg_list;
256 
257 	struct memcg_vmstats_percpu __percpu *vmstats_percpu;
258 
259 #ifdef CONFIG_CGROUP_WRITEBACK
260 	struct list_head cgwb_list;
261 	struct wb_domain cgwb_domain;
262 	struct memcg_cgwb_frn cgwb_frn[MEMCG_CGWB_FRN_CNT];
263 #endif
264 
265 #ifdef CONFIG_TRANSPARENT_HUGEPAGE
266 	struct deferred_split deferred_split_queue;
267 #endif
268 
269 #ifdef CONFIG_LRU_GEN_WALKS_MMU
270 	/* per-memcg mm_struct list */
271 	struct lru_gen_mm_list mm_list;
272 #endif
273 
274 #ifdef CONFIG_MEMCG_V1
275 	/* Legacy consumer-oriented counters */
276 	struct page_counter kmem;		/* v1 only */
277 	struct page_counter tcpmem;		/* v1 only */
278 
279 	struct memcg1_events_percpu __percpu *events_percpu;
280 
281 	unsigned long soft_limit;
282 
283 	/* protected by memcg_oom_lock */
284 	bool oom_lock;
285 	int under_oom;
286 
287 	/* OOM-Killer disable */
288 	int oom_kill_disable;
289 
290 	/* protect arrays of thresholds */
291 	struct mutex thresholds_lock;
292 
293 	/* thresholds for memory usage. RCU-protected */
294 	struct mem_cgroup_thresholds thresholds;
295 
296 	/* thresholds for mem+swap usage. RCU-protected */
297 	struct mem_cgroup_thresholds memsw_thresholds;
298 
299 	/* For oom notifier event fd */
300 	struct list_head oom_notify;
301 
302 	/* Legacy tcp memory accounting */
303 	bool tcpmem_active;
304 	int tcpmem_pressure;
305 
306 	/* List of events which userspace want to receive */
307 	struct list_head event_list;
308 	spinlock_t event_list_lock;
309 #endif /* CONFIG_MEMCG_V1 */
310 
311 	struct mem_cgroup_per_node *nodeinfo[];
312 };
313 
314 /*
315  * size of first charge trial.
316  * TODO: maybe necessary to use big numbers in big irons or dynamic based of the
317  * workload.
318  */
319 #define MEMCG_CHARGE_BATCH 64U
320 
321 extern struct mem_cgroup *root_mem_cgroup;
322 
323 enum page_memcg_data_flags {
324 	/* page->memcg_data is a pointer to an slabobj_ext vector */
325 	MEMCG_DATA_OBJEXTS = (1UL << 0),
326 	/* page has been accounted as a non-slab kernel page */
327 	MEMCG_DATA_KMEM = (1UL << 1),
328 	/* the next bit after the last actual flag */
329 	__NR_MEMCG_DATA_FLAGS  = (1UL << 2),
330 };
331 
332 #define __FIRST_OBJEXT_FLAG	__NR_MEMCG_DATA_FLAGS
333 
334 #else /* CONFIG_MEMCG */
335 
336 #define __FIRST_OBJEXT_FLAG	(1UL << 0)
337 
338 #endif /* CONFIG_MEMCG */
339 
340 enum objext_flags {
341 	/* slabobj_ext vector failed to allocate */
342 	OBJEXTS_ALLOC_FAIL = __FIRST_OBJEXT_FLAG,
343 	/* the next bit after the last actual flag */
344 	__NR_OBJEXTS_FLAGS  = (__FIRST_OBJEXT_FLAG << 1),
345 };
346 
347 #define OBJEXTS_FLAGS_MASK (__NR_OBJEXTS_FLAGS - 1)
348 
349 #ifdef CONFIG_MEMCG
350 
351 static inline bool folio_memcg_kmem(struct folio *folio);
352 
353 /*
354  * After the initialization objcg->memcg is always pointing at
355  * a valid memcg, but can be atomically swapped to the parent memcg.
356  *
357  * The caller must ensure that the returned memcg won't be released.
358  */
359 static inline struct mem_cgroup *obj_cgroup_memcg(struct obj_cgroup *objcg)
360 {
361 	lockdep_assert_once(rcu_read_lock_held() || lockdep_is_held(&cgroup_mutex));
362 	return READ_ONCE(objcg->memcg);
363 }
364 
365 /*
366  * __folio_memcg - Get the memory cgroup associated with a non-kmem folio
367  * @folio: Pointer to the folio.
368  *
369  * Returns a pointer to the memory cgroup associated with the folio,
370  * or NULL. This function assumes that the folio is known to have a
371  * proper memory cgroup pointer. It's not safe to call this function
372  * against some type of folios, e.g. slab folios or ex-slab folios or
373  * kmem folios.
374  */
375 static inline struct mem_cgroup *__folio_memcg(struct folio *folio)
376 {
377 	unsigned long memcg_data = folio->memcg_data;
378 
379 	VM_BUG_ON_FOLIO(folio_test_slab(folio), folio);
380 	VM_BUG_ON_FOLIO(memcg_data & MEMCG_DATA_OBJEXTS, folio);
381 	VM_BUG_ON_FOLIO(memcg_data & MEMCG_DATA_KMEM, folio);
382 
383 	return (struct mem_cgroup *)(memcg_data & ~OBJEXTS_FLAGS_MASK);
384 }
385 
386 /*
387  * __folio_objcg - get the object cgroup associated with a kmem folio.
388  * @folio: Pointer to the folio.
389  *
390  * Returns a pointer to the object cgroup associated with the folio,
391  * or NULL. This function assumes that the folio is known to have a
392  * proper object cgroup pointer. It's not safe to call this function
393  * against some type of folios, e.g. slab folios or ex-slab folios or
394  * LRU folios.
395  */
396 static inline struct obj_cgroup *__folio_objcg(struct folio *folio)
397 {
398 	unsigned long memcg_data = folio->memcg_data;
399 
400 	VM_BUG_ON_FOLIO(folio_test_slab(folio), folio);
401 	VM_BUG_ON_FOLIO(memcg_data & MEMCG_DATA_OBJEXTS, folio);
402 	VM_BUG_ON_FOLIO(!(memcg_data & MEMCG_DATA_KMEM), folio);
403 
404 	return (struct obj_cgroup *)(memcg_data & ~OBJEXTS_FLAGS_MASK);
405 }
406 
407 /*
408  * folio_memcg - Get the memory cgroup associated with a folio.
409  * @folio: Pointer to the folio.
410  *
411  * Returns a pointer to the memory cgroup associated with the folio,
412  * or NULL. This function assumes that the folio is known to have a
413  * proper memory cgroup pointer. It's not safe to call this function
414  * against some type of folios, e.g. slab folios or ex-slab folios.
415  *
416  * For a non-kmem folio any of the following ensures folio and memcg binding
417  * stability:
418  *
419  * - the folio lock
420  * - LRU isolation
421  * - exclusive reference
422  *
423  * For a kmem folio a caller should hold an rcu read lock to protect memcg
424  * associated with a kmem folio from being released.
425  */
426 static inline struct mem_cgroup *folio_memcg(struct folio *folio)
427 {
428 	if (folio_memcg_kmem(folio))
429 		return obj_cgroup_memcg(__folio_objcg(folio));
430 	return __folio_memcg(folio);
431 }
432 
433 /*
434  * folio_memcg_charged - If a folio is charged to a memory cgroup.
435  * @folio: Pointer to the folio.
436  *
437  * Returns true if folio is charged to a memory cgroup, otherwise returns false.
438  */
439 static inline bool folio_memcg_charged(struct folio *folio)
440 {
441 	if (folio_memcg_kmem(folio))
442 		return __folio_objcg(folio) != NULL;
443 	return __folio_memcg(folio) != NULL;
444 }
445 
446 /*
447  * folio_memcg_check - Get the memory cgroup associated with a folio.
448  * @folio: Pointer to the folio.
449  *
450  * Returns a pointer to the memory cgroup associated with the folio,
451  * or NULL. This function unlike folio_memcg() can take any folio
452  * as an argument. It has to be used in cases when it's not known if a folio
453  * has an associated memory cgroup pointer or an object cgroups vector or
454  * an object cgroup.
455  *
456  * For a non-kmem folio any of the following ensures folio and memcg binding
457  * stability:
458  *
459  * - the folio lock
460  * - LRU isolation
461  * - exclusive reference
462  *
463  * For a kmem folio a caller should hold an rcu read lock to protect memcg
464  * associated with a kmem folio from being released.
465  */
466 static inline struct mem_cgroup *folio_memcg_check(struct folio *folio)
467 {
468 	/*
469 	 * Because folio->memcg_data might be changed asynchronously
470 	 * for slabs, READ_ONCE() should be used here.
471 	 */
472 	unsigned long memcg_data = READ_ONCE(folio->memcg_data);
473 
474 	if (memcg_data & MEMCG_DATA_OBJEXTS)
475 		return NULL;
476 
477 	if (memcg_data & MEMCG_DATA_KMEM) {
478 		struct obj_cgroup *objcg;
479 
480 		objcg = (void *)(memcg_data & ~OBJEXTS_FLAGS_MASK);
481 		return obj_cgroup_memcg(objcg);
482 	}
483 
484 	return (struct mem_cgroup *)(memcg_data & ~OBJEXTS_FLAGS_MASK);
485 }
486 
487 static inline struct mem_cgroup *page_memcg_check(struct page *page)
488 {
489 	if (PageTail(page))
490 		return NULL;
491 	return folio_memcg_check((struct folio *)page);
492 }
493 
494 static inline struct mem_cgroup *get_mem_cgroup_from_objcg(struct obj_cgroup *objcg)
495 {
496 	struct mem_cgroup *memcg;
497 
498 	rcu_read_lock();
499 retry:
500 	memcg = obj_cgroup_memcg(objcg);
501 	if (unlikely(!css_tryget(&memcg->css)))
502 		goto retry;
503 	rcu_read_unlock();
504 
505 	return memcg;
506 }
507 
508 /*
509  * folio_memcg_kmem - Check if the folio has the memcg_kmem flag set.
510  * @folio: Pointer to the folio.
511  *
512  * Checks if the folio has MemcgKmem flag set. The caller must ensure
513  * that the folio has an associated memory cgroup. It's not safe to call
514  * this function against some types of folios, e.g. slab folios.
515  */
516 static inline bool folio_memcg_kmem(struct folio *folio)
517 {
518 	VM_BUG_ON_PGFLAGS(PageTail(&folio->page), &folio->page);
519 	VM_BUG_ON_FOLIO(folio->memcg_data & MEMCG_DATA_OBJEXTS, folio);
520 	return folio->memcg_data & MEMCG_DATA_KMEM;
521 }
522 
523 static inline bool PageMemcgKmem(struct page *page)
524 {
525 	return folio_memcg_kmem(page_folio(page));
526 }
527 
528 static inline bool mem_cgroup_is_root(struct mem_cgroup *memcg)
529 {
530 	return (memcg == root_mem_cgroup);
531 }
532 
533 static inline bool mem_cgroup_disabled(void)
534 {
535 	return !cgroup_subsys_enabled(memory_cgrp_subsys);
536 }
537 
538 static inline void mem_cgroup_protection(struct mem_cgroup *root,
539 					 struct mem_cgroup *memcg,
540 					 unsigned long *min,
541 					 unsigned long *low)
542 {
543 	*min = *low = 0;
544 
545 	if (mem_cgroup_disabled())
546 		return;
547 
548 	/*
549 	 * There is no reclaim protection applied to a targeted reclaim.
550 	 * We are special casing this specific case here because
551 	 * mem_cgroup_calculate_protection is not robust enough to keep
552 	 * the protection invariant for calculated effective values for
553 	 * parallel reclaimers with different reclaim target. This is
554 	 * especially a problem for tail memcgs (as they have pages on LRU)
555 	 * which would want to have effective values 0 for targeted reclaim
556 	 * but a different value for external reclaim.
557 	 *
558 	 * Example
559 	 * Let's have global and A's reclaim in parallel:
560 	 *  |
561 	 *  A (low=2G, usage = 3G, max = 3G, children_low_usage = 1.5G)
562 	 *  |\
563 	 *  | C (low = 1G, usage = 2.5G)
564 	 *  B (low = 1G, usage = 0.5G)
565 	 *
566 	 * For the global reclaim
567 	 * A.elow = A.low
568 	 * B.elow = min(B.usage, B.low) because children_low_usage <= A.elow
569 	 * C.elow = min(C.usage, C.low)
570 	 *
571 	 * With the effective values resetting we have A reclaim
572 	 * A.elow = 0
573 	 * B.elow = B.low
574 	 * C.elow = C.low
575 	 *
576 	 * If the global reclaim races with A's reclaim then
577 	 * B.elow = C.elow = 0 because children_low_usage > A.elow)
578 	 * is possible and reclaiming B would be violating the protection.
579 	 *
580 	 */
581 	if (root == memcg)
582 		return;
583 
584 	*min = READ_ONCE(memcg->memory.emin);
585 	*low = READ_ONCE(memcg->memory.elow);
586 }
587 
588 void mem_cgroup_calculate_protection(struct mem_cgroup *root,
589 				     struct mem_cgroup *memcg);
590 
591 static inline bool mem_cgroup_unprotected(struct mem_cgroup *target,
592 					  struct mem_cgroup *memcg)
593 {
594 	/*
595 	 * The root memcg doesn't account charges, and doesn't support
596 	 * protection. The target memcg's protection is ignored, see
597 	 * mem_cgroup_calculate_protection() and mem_cgroup_protection()
598 	 */
599 	return mem_cgroup_disabled() || mem_cgroup_is_root(memcg) ||
600 		memcg == target;
601 }
602 
603 static inline bool mem_cgroup_below_low(struct mem_cgroup *target,
604 					struct mem_cgroup *memcg)
605 {
606 	if (mem_cgroup_unprotected(target, memcg))
607 		return false;
608 
609 	return READ_ONCE(memcg->memory.elow) >=
610 		page_counter_read(&memcg->memory);
611 }
612 
613 static inline bool mem_cgroup_below_min(struct mem_cgroup *target,
614 					struct mem_cgroup *memcg)
615 {
616 	if (mem_cgroup_unprotected(target, memcg))
617 		return false;
618 
619 	return READ_ONCE(memcg->memory.emin) >=
620 		page_counter_read(&memcg->memory);
621 }
622 
623 void mem_cgroup_commit_charge(struct folio *folio, struct mem_cgroup *memcg);
624 
625 int __mem_cgroup_charge(struct folio *folio, struct mm_struct *mm, gfp_t gfp);
626 
627 /**
628  * mem_cgroup_charge - Charge a newly allocated folio to a cgroup.
629  * @folio: Folio to charge.
630  * @mm: mm context of the allocating task.
631  * @gfp: Reclaim mode.
632  *
633  * Try to charge @folio to the memcg that @mm belongs to, reclaiming
634  * pages according to @gfp if necessary.  If @mm is NULL, try to
635  * charge to the active memcg.
636  *
637  * Do not use this for folios allocated for swapin.
638  *
639  * Return: 0 on success. Otherwise, an error code is returned.
640  */
641 static inline int mem_cgroup_charge(struct folio *folio, struct mm_struct *mm,
642 				    gfp_t gfp)
643 {
644 	if (mem_cgroup_disabled())
645 		return 0;
646 	return __mem_cgroup_charge(folio, mm, gfp);
647 }
648 
649 int mem_cgroup_hugetlb_try_charge(struct mem_cgroup *memcg, gfp_t gfp,
650 		long nr_pages);
651 
652 int mem_cgroup_swapin_charge_folio(struct folio *folio, struct mm_struct *mm,
653 				  gfp_t gfp, swp_entry_t entry);
654 
655 void mem_cgroup_swapin_uncharge_swap(swp_entry_t entry, unsigned int nr_pages);
656 
657 void __mem_cgroup_uncharge(struct folio *folio);
658 
659 /**
660  * mem_cgroup_uncharge - Uncharge a folio.
661  * @folio: Folio to uncharge.
662  *
663  * Uncharge a folio previously charged with mem_cgroup_charge().
664  */
665 static inline void mem_cgroup_uncharge(struct folio *folio)
666 {
667 	if (mem_cgroup_disabled())
668 		return;
669 	__mem_cgroup_uncharge(folio);
670 }
671 
672 void __mem_cgroup_uncharge_folios(struct folio_batch *folios);
673 static inline void mem_cgroup_uncharge_folios(struct folio_batch *folios)
674 {
675 	if (mem_cgroup_disabled())
676 		return;
677 	__mem_cgroup_uncharge_folios(folios);
678 }
679 
680 void mem_cgroup_cancel_charge(struct mem_cgroup *memcg, unsigned int nr_pages);
681 void mem_cgroup_replace_folio(struct folio *old, struct folio *new);
682 void mem_cgroup_migrate(struct folio *old, struct folio *new);
683 
684 /**
685  * mem_cgroup_lruvec - get the lru list vector for a memcg & node
686  * @memcg: memcg of the wanted lruvec
687  * @pgdat: pglist_data
688  *
689  * Returns the lru list vector holding pages for a given @memcg &
690  * @pgdat combination. This can be the node lruvec, if the memory
691  * controller is disabled.
692  */
693 static inline struct lruvec *mem_cgroup_lruvec(struct mem_cgroup *memcg,
694 					       struct pglist_data *pgdat)
695 {
696 	struct mem_cgroup_per_node *mz;
697 	struct lruvec *lruvec;
698 
699 	if (mem_cgroup_disabled()) {
700 		lruvec = &pgdat->__lruvec;
701 		goto out;
702 	}
703 
704 	if (!memcg)
705 		memcg = root_mem_cgroup;
706 
707 	mz = memcg->nodeinfo[pgdat->node_id];
708 	lruvec = &mz->lruvec;
709 out:
710 	/*
711 	 * Since a node can be onlined after the mem_cgroup was created,
712 	 * we have to be prepared to initialize lruvec->pgdat here;
713 	 * and if offlined then reonlined, we need to reinitialize it.
714 	 */
715 	if (unlikely(lruvec->pgdat != pgdat))
716 		lruvec->pgdat = pgdat;
717 	return lruvec;
718 }
719 
720 /**
721  * folio_lruvec - return lruvec for isolating/putting an LRU folio
722  * @folio: Pointer to the folio.
723  *
724  * This function relies on folio->mem_cgroup being stable.
725  */
726 static inline struct lruvec *folio_lruvec(struct folio *folio)
727 {
728 	struct mem_cgroup *memcg = folio_memcg(folio);
729 
730 	VM_WARN_ON_ONCE_FOLIO(!memcg && !mem_cgroup_disabled(), folio);
731 	return mem_cgroup_lruvec(memcg, folio_pgdat(folio));
732 }
733 
734 struct mem_cgroup *mem_cgroup_from_task(struct task_struct *p);
735 
736 struct mem_cgroup *get_mem_cgroup_from_mm(struct mm_struct *mm);
737 
738 struct mem_cgroup *get_mem_cgroup_from_current(void);
739 
740 struct mem_cgroup *get_mem_cgroup_from_folio(struct folio *folio);
741 
742 struct lruvec *folio_lruvec_lock(struct folio *folio);
743 struct lruvec *folio_lruvec_lock_irq(struct folio *folio);
744 struct lruvec *folio_lruvec_lock_irqsave(struct folio *folio,
745 						unsigned long *flags);
746 
747 #ifdef CONFIG_DEBUG_VM
748 void lruvec_memcg_debug(struct lruvec *lruvec, struct folio *folio);
749 #else
750 static inline
751 void lruvec_memcg_debug(struct lruvec *lruvec, struct folio *folio)
752 {
753 }
754 #endif
755 
756 static inline
757 struct mem_cgroup *mem_cgroup_from_css(struct cgroup_subsys_state *css){
758 	return css ? container_of(css, struct mem_cgroup, css) : NULL;
759 }
760 
761 static inline bool obj_cgroup_tryget(struct obj_cgroup *objcg)
762 {
763 	return percpu_ref_tryget(&objcg->refcnt);
764 }
765 
766 static inline void obj_cgroup_get(struct obj_cgroup *objcg)
767 {
768 	percpu_ref_get(&objcg->refcnt);
769 }
770 
771 static inline void obj_cgroup_get_many(struct obj_cgroup *objcg,
772 				       unsigned long nr)
773 {
774 	percpu_ref_get_many(&objcg->refcnt, nr);
775 }
776 
777 static inline void obj_cgroup_put(struct obj_cgroup *objcg)
778 {
779 	if (objcg)
780 		percpu_ref_put(&objcg->refcnt);
781 }
782 
783 static inline bool mem_cgroup_tryget(struct mem_cgroup *memcg)
784 {
785 	return !memcg || css_tryget(&memcg->css);
786 }
787 
788 static inline bool mem_cgroup_tryget_online(struct mem_cgroup *memcg)
789 {
790 	return !memcg || css_tryget_online(&memcg->css);
791 }
792 
793 static inline void mem_cgroup_put(struct mem_cgroup *memcg)
794 {
795 	if (memcg)
796 		css_put(&memcg->css);
797 }
798 
799 #define mem_cgroup_from_counter(counter, member)	\
800 	container_of(counter, struct mem_cgroup, member)
801 
802 struct mem_cgroup *mem_cgroup_iter(struct mem_cgroup *,
803 				   struct mem_cgroup *,
804 				   struct mem_cgroup_reclaim_cookie *);
805 void mem_cgroup_iter_break(struct mem_cgroup *, struct mem_cgroup *);
806 void mem_cgroup_scan_tasks(struct mem_cgroup *memcg,
807 			   int (*)(struct task_struct *, void *), void *arg);
808 
809 static inline unsigned short mem_cgroup_id(struct mem_cgroup *memcg)
810 {
811 	if (mem_cgroup_disabled())
812 		return 0;
813 
814 	return memcg->id.id;
815 }
816 struct mem_cgroup *mem_cgroup_from_id(unsigned short id);
817 
818 #ifdef CONFIG_SHRINKER_DEBUG
819 static inline unsigned long mem_cgroup_ino(struct mem_cgroup *memcg)
820 {
821 	return memcg ? cgroup_ino(memcg->css.cgroup) : 0;
822 }
823 
824 struct mem_cgroup *mem_cgroup_get_from_ino(unsigned long ino);
825 #endif
826 
827 static inline struct mem_cgroup *mem_cgroup_from_seq(struct seq_file *m)
828 {
829 	return mem_cgroup_from_css(seq_css(m));
830 }
831 
832 static inline struct mem_cgroup *lruvec_memcg(struct lruvec *lruvec)
833 {
834 	struct mem_cgroup_per_node *mz;
835 
836 	if (mem_cgroup_disabled())
837 		return NULL;
838 
839 	mz = container_of(lruvec, struct mem_cgroup_per_node, lruvec);
840 	return mz->memcg;
841 }
842 
843 /**
844  * parent_mem_cgroup - find the accounting parent of a memcg
845  * @memcg: memcg whose parent to find
846  *
847  * Returns the parent memcg, or NULL if this is the root.
848  */
849 static inline struct mem_cgroup *parent_mem_cgroup(struct mem_cgroup *memcg)
850 {
851 	return mem_cgroup_from_css(memcg->css.parent);
852 }
853 
854 static inline bool mem_cgroup_is_descendant(struct mem_cgroup *memcg,
855 			      struct mem_cgroup *root)
856 {
857 	if (root == memcg)
858 		return true;
859 	return cgroup_is_descendant(memcg->css.cgroup, root->css.cgroup);
860 }
861 
862 static inline bool mm_match_cgroup(struct mm_struct *mm,
863 				   struct mem_cgroup *memcg)
864 {
865 	struct mem_cgroup *task_memcg;
866 	bool match = false;
867 
868 	rcu_read_lock();
869 	task_memcg = mem_cgroup_from_task(rcu_dereference(mm->owner));
870 	if (task_memcg)
871 		match = mem_cgroup_is_descendant(task_memcg, memcg);
872 	rcu_read_unlock();
873 	return match;
874 }
875 
876 struct cgroup_subsys_state *mem_cgroup_css_from_folio(struct folio *folio);
877 ino_t page_cgroup_ino(struct page *page);
878 
879 static inline bool mem_cgroup_online(struct mem_cgroup *memcg)
880 {
881 	if (mem_cgroup_disabled())
882 		return true;
883 	return !!(memcg->css.flags & CSS_ONLINE);
884 }
885 
886 void mem_cgroup_update_lru_size(struct lruvec *lruvec, enum lru_list lru,
887 		int zid, int nr_pages);
888 
889 static inline
890 unsigned long mem_cgroup_get_zone_lru_size(struct lruvec *lruvec,
891 		enum lru_list lru, int zone_idx)
892 {
893 	struct mem_cgroup_per_node *mz;
894 
895 	mz = container_of(lruvec, struct mem_cgroup_per_node, lruvec);
896 	return READ_ONCE(mz->lru_zone_size[zone_idx][lru]);
897 }
898 
899 void mem_cgroup_handle_over_high(gfp_t gfp_mask);
900 
901 unsigned long mem_cgroup_get_max(struct mem_cgroup *memcg);
902 
903 unsigned long mem_cgroup_size(struct mem_cgroup *memcg);
904 
905 void mem_cgroup_print_oom_context(struct mem_cgroup *memcg,
906 				struct task_struct *p);
907 
908 void mem_cgroup_print_oom_meminfo(struct mem_cgroup *memcg);
909 
910 struct mem_cgroup *mem_cgroup_get_oom_group(struct task_struct *victim,
911 					    struct mem_cgroup *oom_domain);
912 void mem_cgroup_print_oom_group(struct mem_cgroup *memcg);
913 
914 void __mod_memcg_state(struct mem_cgroup *memcg, enum memcg_stat_item idx,
915 		       int val);
916 
917 /* idx can be of type enum memcg_stat_item or node_stat_item */
918 static inline void mod_memcg_state(struct mem_cgroup *memcg,
919 				   enum memcg_stat_item idx, int val)
920 {
921 	unsigned long flags;
922 
923 	local_irq_save(flags);
924 	__mod_memcg_state(memcg, idx, val);
925 	local_irq_restore(flags);
926 }
927 
928 static inline void mod_memcg_page_state(struct page *page,
929 					enum memcg_stat_item idx, int val)
930 {
931 	struct mem_cgroup *memcg;
932 
933 	if (mem_cgroup_disabled())
934 		return;
935 
936 	rcu_read_lock();
937 	memcg = folio_memcg(page_folio(page));
938 	if (memcg)
939 		mod_memcg_state(memcg, idx, val);
940 	rcu_read_unlock();
941 }
942 
943 unsigned long memcg_page_state(struct mem_cgroup *memcg, int idx);
944 unsigned long lruvec_page_state(struct lruvec *lruvec, enum node_stat_item idx);
945 unsigned long lruvec_page_state_local(struct lruvec *lruvec,
946 				      enum node_stat_item idx);
947 
948 void mem_cgroup_flush_stats(struct mem_cgroup *memcg);
949 void mem_cgroup_flush_stats_ratelimited(struct mem_cgroup *memcg);
950 
951 void __mod_lruvec_kmem_state(void *p, enum node_stat_item idx, int val);
952 
953 static inline void mod_lruvec_kmem_state(void *p, enum node_stat_item idx,
954 					 int val)
955 {
956 	unsigned long flags;
957 
958 	local_irq_save(flags);
959 	__mod_lruvec_kmem_state(p, idx, val);
960 	local_irq_restore(flags);
961 }
962 
963 void __count_memcg_events(struct mem_cgroup *memcg, enum vm_event_item idx,
964 			  unsigned long count);
965 
966 static inline void count_memcg_events(struct mem_cgroup *memcg,
967 				      enum vm_event_item idx,
968 				      unsigned long count)
969 {
970 	unsigned long flags;
971 
972 	local_irq_save(flags);
973 	__count_memcg_events(memcg, idx, count);
974 	local_irq_restore(flags);
975 }
976 
977 static inline void count_memcg_folio_events(struct folio *folio,
978 		enum vm_event_item idx, unsigned long nr)
979 {
980 	struct mem_cgroup *memcg = folio_memcg(folio);
981 
982 	if (memcg)
983 		count_memcg_events(memcg, idx, nr);
984 }
985 
986 static inline void count_memcg_events_mm(struct mm_struct *mm,
987 					enum vm_event_item idx, unsigned long count)
988 {
989 	struct mem_cgroup *memcg;
990 
991 	if (mem_cgroup_disabled())
992 		return;
993 
994 	rcu_read_lock();
995 	memcg = mem_cgroup_from_task(rcu_dereference(mm->owner));
996 	if (likely(memcg))
997 		count_memcg_events(memcg, idx, count);
998 	rcu_read_unlock();
999 }
1000 
1001 static inline void count_memcg_event_mm(struct mm_struct *mm,
1002 					enum vm_event_item idx)
1003 {
1004 	count_memcg_events_mm(mm, idx, 1);
1005 }
1006 
1007 static inline void memcg_memory_event(struct mem_cgroup *memcg,
1008 				      enum memcg_memory_event event)
1009 {
1010 	bool swap_event = event == MEMCG_SWAP_HIGH || event == MEMCG_SWAP_MAX ||
1011 			  event == MEMCG_SWAP_FAIL;
1012 
1013 	atomic_long_inc(&memcg->memory_events_local[event]);
1014 	if (!swap_event)
1015 		cgroup_file_notify(&memcg->events_local_file);
1016 
1017 	do {
1018 		atomic_long_inc(&memcg->memory_events[event]);
1019 		if (swap_event)
1020 			cgroup_file_notify(&memcg->swap_events_file);
1021 		else
1022 			cgroup_file_notify(&memcg->events_file);
1023 
1024 		if (!cgroup_subsys_on_dfl(memory_cgrp_subsys))
1025 			break;
1026 		if (cgrp_dfl_root.flags & CGRP_ROOT_MEMORY_LOCAL_EVENTS)
1027 			break;
1028 	} while ((memcg = parent_mem_cgroup(memcg)) &&
1029 		 !mem_cgroup_is_root(memcg));
1030 }
1031 
1032 static inline void memcg_memory_event_mm(struct mm_struct *mm,
1033 					 enum memcg_memory_event event)
1034 {
1035 	struct mem_cgroup *memcg;
1036 
1037 	if (mem_cgroup_disabled())
1038 		return;
1039 
1040 	rcu_read_lock();
1041 	memcg = mem_cgroup_from_task(rcu_dereference(mm->owner));
1042 	if (likely(memcg))
1043 		memcg_memory_event(memcg, event);
1044 	rcu_read_unlock();
1045 }
1046 
1047 void split_page_memcg(struct page *head, int old_order, int new_order);
1048 
1049 static inline u64 cgroup_id_from_mm(struct mm_struct *mm)
1050 {
1051 	struct mem_cgroup *memcg;
1052 	u64 id;
1053 
1054 	if (mem_cgroup_disabled())
1055 		return 0;
1056 
1057 	rcu_read_lock();
1058 	memcg = mem_cgroup_from_task(rcu_dereference(mm->owner));
1059 	if (!memcg)
1060 		memcg = root_mem_cgroup;
1061 	id = cgroup_id(memcg->css.cgroup);
1062 	rcu_read_unlock();
1063 	return id;
1064 }
1065 
1066 #else /* CONFIG_MEMCG */
1067 
1068 #define MEM_CGROUP_ID_SHIFT	0
1069 
1070 static inline struct mem_cgroup *folio_memcg(struct folio *folio)
1071 {
1072 	return NULL;
1073 }
1074 
1075 static inline bool folio_memcg_charged(struct folio *folio)
1076 {
1077 	return false;
1078 }
1079 
1080 static inline struct mem_cgroup *folio_memcg_check(struct folio *folio)
1081 {
1082 	return NULL;
1083 }
1084 
1085 static inline struct mem_cgroup *page_memcg_check(struct page *page)
1086 {
1087 	return NULL;
1088 }
1089 
1090 static inline struct mem_cgroup *get_mem_cgroup_from_objcg(struct obj_cgroup *objcg)
1091 {
1092 	return NULL;
1093 }
1094 
1095 static inline bool folio_memcg_kmem(struct folio *folio)
1096 {
1097 	return false;
1098 }
1099 
1100 static inline bool PageMemcgKmem(struct page *page)
1101 {
1102 	return false;
1103 }
1104 
1105 static inline bool mem_cgroup_is_root(struct mem_cgroup *memcg)
1106 {
1107 	return true;
1108 }
1109 
1110 static inline bool mem_cgroup_disabled(void)
1111 {
1112 	return true;
1113 }
1114 
1115 static inline void memcg_memory_event(struct mem_cgroup *memcg,
1116 				      enum memcg_memory_event event)
1117 {
1118 }
1119 
1120 static inline void memcg_memory_event_mm(struct mm_struct *mm,
1121 					 enum memcg_memory_event event)
1122 {
1123 }
1124 
1125 static inline void mem_cgroup_protection(struct mem_cgroup *root,
1126 					 struct mem_cgroup *memcg,
1127 					 unsigned long *min,
1128 					 unsigned long *low)
1129 {
1130 	*min = *low = 0;
1131 }
1132 
1133 static inline void mem_cgroup_calculate_protection(struct mem_cgroup *root,
1134 						   struct mem_cgroup *memcg)
1135 {
1136 }
1137 
1138 static inline bool mem_cgroup_unprotected(struct mem_cgroup *target,
1139 					  struct mem_cgroup *memcg)
1140 {
1141 	return true;
1142 }
1143 static inline bool mem_cgroup_below_low(struct mem_cgroup *target,
1144 					struct mem_cgroup *memcg)
1145 {
1146 	return false;
1147 }
1148 
1149 static inline bool mem_cgroup_below_min(struct mem_cgroup *target,
1150 					struct mem_cgroup *memcg)
1151 {
1152 	return false;
1153 }
1154 
1155 static inline void mem_cgroup_commit_charge(struct folio *folio,
1156 		struct mem_cgroup *memcg)
1157 {
1158 }
1159 
1160 static inline int mem_cgroup_charge(struct folio *folio,
1161 		struct mm_struct *mm, gfp_t gfp)
1162 {
1163 	return 0;
1164 }
1165 
1166 static inline int mem_cgroup_hugetlb_try_charge(struct mem_cgroup *memcg,
1167 		gfp_t gfp, long nr_pages)
1168 {
1169 	return 0;
1170 }
1171 
1172 static inline int mem_cgroup_swapin_charge_folio(struct folio *folio,
1173 			struct mm_struct *mm, gfp_t gfp, swp_entry_t entry)
1174 {
1175 	return 0;
1176 }
1177 
1178 static inline void mem_cgroup_swapin_uncharge_swap(swp_entry_t entry, unsigned int nr)
1179 {
1180 }
1181 
1182 static inline void mem_cgroup_uncharge(struct folio *folio)
1183 {
1184 }
1185 
1186 static inline void mem_cgroup_uncharge_folios(struct folio_batch *folios)
1187 {
1188 }
1189 
1190 static inline void mem_cgroup_cancel_charge(struct mem_cgroup *memcg,
1191 		unsigned int nr_pages)
1192 {
1193 }
1194 
1195 static inline void mem_cgroup_replace_folio(struct folio *old,
1196 		struct folio *new)
1197 {
1198 }
1199 
1200 static inline void mem_cgroup_migrate(struct folio *old, struct folio *new)
1201 {
1202 }
1203 
1204 static inline struct lruvec *mem_cgroup_lruvec(struct mem_cgroup *memcg,
1205 					       struct pglist_data *pgdat)
1206 {
1207 	return &pgdat->__lruvec;
1208 }
1209 
1210 static inline struct lruvec *folio_lruvec(struct folio *folio)
1211 {
1212 	struct pglist_data *pgdat = folio_pgdat(folio);
1213 	return &pgdat->__lruvec;
1214 }
1215 
1216 static inline
1217 void lruvec_memcg_debug(struct lruvec *lruvec, struct folio *folio)
1218 {
1219 }
1220 
1221 static inline struct mem_cgroup *parent_mem_cgroup(struct mem_cgroup *memcg)
1222 {
1223 	return NULL;
1224 }
1225 
1226 static inline bool mm_match_cgroup(struct mm_struct *mm,
1227 		struct mem_cgroup *memcg)
1228 {
1229 	return true;
1230 }
1231 
1232 static inline struct mem_cgroup *get_mem_cgroup_from_mm(struct mm_struct *mm)
1233 {
1234 	return NULL;
1235 }
1236 
1237 static inline struct mem_cgroup *get_mem_cgroup_from_current(void)
1238 {
1239 	return NULL;
1240 }
1241 
1242 static inline struct mem_cgroup *get_mem_cgroup_from_folio(struct folio *folio)
1243 {
1244 	return NULL;
1245 }
1246 
1247 static inline
1248 struct mem_cgroup *mem_cgroup_from_css(struct cgroup_subsys_state *css)
1249 {
1250 	return NULL;
1251 }
1252 
1253 static inline void obj_cgroup_get(struct obj_cgroup *objcg)
1254 {
1255 }
1256 
1257 static inline void obj_cgroup_put(struct obj_cgroup *objcg)
1258 {
1259 }
1260 
1261 static inline bool mem_cgroup_tryget(struct mem_cgroup *memcg)
1262 {
1263 	return true;
1264 }
1265 
1266 static inline bool mem_cgroup_tryget_online(struct mem_cgroup *memcg)
1267 {
1268 	return true;
1269 }
1270 
1271 static inline void mem_cgroup_put(struct mem_cgroup *memcg)
1272 {
1273 }
1274 
1275 static inline struct lruvec *folio_lruvec_lock(struct folio *folio)
1276 {
1277 	struct pglist_data *pgdat = folio_pgdat(folio);
1278 
1279 	spin_lock(&pgdat->__lruvec.lru_lock);
1280 	return &pgdat->__lruvec;
1281 }
1282 
1283 static inline struct lruvec *folio_lruvec_lock_irq(struct folio *folio)
1284 {
1285 	struct pglist_data *pgdat = folio_pgdat(folio);
1286 
1287 	spin_lock_irq(&pgdat->__lruvec.lru_lock);
1288 	return &pgdat->__lruvec;
1289 }
1290 
1291 static inline struct lruvec *folio_lruvec_lock_irqsave(struct folio *folio,
1292 		unsigned long *flagsp)
1293 {
1294 	struct pglist_data *pgdat = folio_pgdat(folio);
1295 
1296 	spin_lock_irqsave(&pgdat->__lruvec.lru_lock, *flagsp);
1297 	return &pgdat->__lruvec;
1298 }
1299 
1300 static inline struct mem_cgroup *
1301 mem_cgroup_iter(struct mem_cgroup *root,
1302 		struct mem_cgroup *prev,
1303 		struct mem_cgroup_reclaim_cookie *reclaim)
1304 {
1305 	return NULL;
1306 }
1307 
1308 static inline void mem_cgroup_iter_break(struct mem_cgroup *root,
1309 					 struct mem_cgroup *prev)
1310 {
1311 }
1312 
1313 static inline void mem_cgroup_scan_tasks(struct mem_cgroup *memcg,
1314 		int (*fn)(struct task_struct *, void *), void *arg)
1315 {
1316 }
1317 
1318 static inline unsigned short mem_cgroup_id(struct mem_cgroup *memcg)
1319 {
1320 	return 0;
1321 }
1322 
1323 static inline struct mem_cgroup *mem_cgroup_from_id(unsigned short id)
1324 {
1325 	WARN_ON_ONCE(id);
1326 	/* XXX: This should always return root_mem_cgroup */
1327 	return NULL;
1328 }
1329 
1330 #ifdef CONFIG_SHRINKER_DEBUG
1331 static inline unsigned long mem_cgroup_ino(struct mem_cgroup *memcg)
1332 {
1333 	return 0;
1334 }
1335 
1336 static inline struct mem_cgroup *mem_cgroup_get_from_ino(unsigned long ino)
1337 {
1338 	return NULL;
1339 }
1340 #endif
1341 
1342 static inline struct mem_cgroup *mem_cgroup_from_seq(struct seq_file *m)
1343 {
1344 	return NULL;
1345 }
1346 
1347 static inline struct mem_cgroup *lruvec_memcg(struct lruvec *lruvec)
1348 {
1349 	return NULL;
1350 }
1351 
1352 static inline bool mem_cgroup_online(struct mem_cgroup *memcg)
1353 {
1354 	return true;
1355 }
1356 
1357 static inline
1358 unsigned long mem_cgroup_get_zone_lru_size(struct lruvec *lruvec,
1359 		enum lru_list lru, int zone_idx)
1360 {
1361 	return 0;
1362 }
1363 
1364 static inline unsigned long mem_cgroup_get_max(struct mem_cgroup *memcg)
1365 {
1366 	return 0;
1367 }
1368 
1369 static inline unsigned long mem_cgroup_size(struct mem_cgroup *memcg)
1370 {
1371 	return 0;
1372 }
1373 
1374 static inline void
1375 mem_cgroup_print_oom_context(struct mem_cgroup *memcg, struct task_struct *p)
1376 {
1377 }
1378 
1379 static inline void
1380 mem_cgroup_print_oom_meminfo(struct mem_cgroup *memcg)
1381 {
1382 }
1383 
1384 static inline void mem_cgroup_handle_over_high(gfp_t gfp_mask)
1385 {
1386 }
1387 
1388 static inline struct mem_cgroup *mem_cgroup_get_oom_group(
1389 	struct task_struct *victim, struct mem_cgroup *oom_domain)
1390 {
1391 	return NULL;
1392 }
1393 
1394 static inline void mem_cgroup_print_oom_group(struct mem_cgroup *memcg)
1395 {
1396 }
1397 
1398 static inline void __mod_memcg_state(struct mem_cgroup *memcg,
1399 				     enum memcg_stat_item idx,
1400 				     int nr)
1401 {
1402 }
1403 
1404 static inline void mod_memcg_state(struct mem_cgroup *memcg,
1405 				   enum memcg_stat_item idx,
1406 				   int nr)
1407 {
1408 }
1409 
1410 static inline void mod_memcg_page_state(struct page *page,
1411 					enum memcg_stat_item idx, int val)
1412 {
1413 }
1414 
1415 static inline unsigned long memcg_page_state(struct mem_cgroup *memcg, int idx)
1416 {
1417 	return 0;
1418 }
1419 
1420 static inline unsigned long lruvec_page_state(struct lruvec *lruvec,
1421 					      enum node_stat_item idx)
1422 {
1423 	return node_page_state(lruvec_pgdat(lruvec), idx);
1424 }
1425 
1426 static inline unsigned long lruvec_page_state_local(struct lruvec *lruvec,
1427 						    enum node_stat_item idx)
1428 {
1429 	return node_page_state(lruvec_pgdat(lruvec), idx);
1430 }
1431 
1432 static inline void mem_cgroup_flush_stats(struct mem_cgroup *memcg)
1433 {
1434 }
1435 
1436 static inline void mem_cgroup_flush_stats_ratelimited(struct mem_cgroup *memcg)
1437 {
1438 }
1439 
1440 static inline void __mod_lruvec_kmem_state(void *p, enum node_stat_item idx,
1441 					   int val)
1442 {
1443 	struct page *page = virt_to_head_page(p);
1444 
1445 	__mod_node_page_state(page_pgdat(page), idx, val);
1446 }
1447 
1448 static inline void mod_lruvec_kmem_state(void *p, enum node_stat_item idx,
1449 					 int val)
1450 {
1451 	struct page *page = virt_to_head_page(p);
1452 
1453 	mod_node_page_state(page_pgdat(page), idx, val);
1454 }
1455 
1456 static inline void count_memcg_events(struct mem_cgroup *memcg,
1457 				      enum vm_event_item idx,
1458 				      unsigned long count)
1459 {
1460 }
1461 
1462 static inline void __count_memcg_events(struct mem_cgroup *memcg,
1463 					enum vm_event_item idx,
1464 					unsigned long count)
1465 {
1466 }
1467 
1468 static inline void count_memcg_folio_events(struct folio *folio,
1469 		enum vm_event_item idx, unsigned long nr)
1470 {
1471 }
1472 
1473 static inline void count_memcg_events_mm(struct mm_struct *mm,
1474 					enum vm_event_item idx, unsigned long count)
1475 {
1476 }
1477 
1478 static inline
1479 void count_memcg_event_mm(struct mm_struct *mm, enum vm_event_item idx)
1480 {
1481 }
1482 
1483 static inline void split_page_memcg(struct page *head, int old_order, int new_order)
1484 {
1485 }
1486 
1487 static inline u64 cgroup_id_from_mm(struct mm_struct *mm)
1488 {
1489 	return 0;
1490 }
1491 #endif /* CONFIG_MEMCG */
1492 
1493 /*
1494  * Extended information for slab objects stored as an array in page->memcg_data
1495  * if MEMCG_DATA_OBJEXTS is set.
1496  */
1497 struct slabobj_ext {
1498 #ifdef CONFIG_MEMCG
1499 	struct obj_cgroup *objcg;
1500 #endif
1501 #ifdef CONFIG_MEM_ALLOC_PROFILING
1502 	union codetag_ref ref;
1503 #endif
1504 } __aligned(8);
1505 
1506 static inline void __inc_lruvec_kmem_state(void *p, enum node_stat_item idx)
1507 {
1508 	__mod_lruvec_kmem_state(p, idx, 1);
1509 }
1510 
1511 static inline void __dec_lruvec_kmem_state(void *p, enum node_stat_item idx)
1512 {
1513 	__mod_lruvec_kmem_state(p, idx, -1);
1514 }
1515 
1516 static inline struct lruvec *parent_lruvec(struct lruvec *lruvec)
1517 {
1518 	struct mem_cgroup *memcg;
1519 
1520 	memcg = lruvec_memcg(lruvec);
1521 	if (!memcg)
1522 		return NULL;
1523 	memcg = parent_mem_cgroup(memcg);
1524 	if (!memcg)
1525 		return NULL;
1526 	return mem_cgroup_lruvec(memcg, lruvec_pgdat(lruvec));
1527 }
1528 
1529 static inline void unlock_page_lruvec(struct lruvec *lruvec)
1530 {
1531 	spin_unlock(&lruvec->lru_lock);
1532 }
1533 
1534 static inline void unlock_page_lruvec_irq(struct lruvec *lruvec)
1535 {
1536 	spin_unlock_irq(&lruvec->lru_lock);
1537 }
1538 
1539 static inline void unlock_page_lruvec_irqrestore(struct lruvec *lruvec,
1540 		unsigned long flags)
1541 {
1542 	spin_unlock_irqrestore(&lruvec->lru_lock, flags);
1543 }
1544 
1545 /* Test requires a stable folio->memcg binding, see folio_memcg() */
1546 static inline bool folio_matches_lruvec(struct folio *folio,
1547 		struct lruvec *lruvec)
1548 {
1549 	return lruvec_pgdat(lruvec) == folio_pgdat(folio) &&
1550 	       lruvec_memcg(lruvec) == folio_memcg(folio);
1551 }
1552 
1553 /* Don't lock again iff page's lruvec locked */
1554 static inline struct lruvec *folio_lruvec_relock_irq(struct folio *folio,
1555 		struct lruvec *locked_lruvec)
1556 {
1557 	if (locked_lruvec) {
1558 		if (folio_matches_lruvec(folio, locked_lruvec))
1559 			return locked_lruvec;
1560 
1561 		unlock_page_lruvec_irq(locked_lruvec);
1562 	}
1563 
1564 	return folio_lruvec_lock_irq(folio);
1565 }
1566 
1567 /* Don't lock again iff folio's lruvec locked */
1568 static inline void folio_lruvec_relock_irqsave(struct folio *folio,
1569 		struct lruvec **lruvecp, unsigned long *flags)
1570 {
1571 	if (*lruvecp) {
1572 		if (folio_matches_lruvec(folio, *lruvecp))
1573 			return;
1574 
1575 		unlock_page_lruvec_irqrestore(*lruvecp, *flags);
1576 	}
1577 
1578 	*lruvecp = folio_lruvec_lock_irqsave(folio, flags);
1579 }
1580 
1581 #ifdef CONFIG_CGROUP_WRITEBACK
1582 
1583 struct wb_domain *mem_cgroup_wb_domain(struct bdi_writeback *wb);
1584 void mem_cgroup_wb_stats(struct bdi_writeback *wb, unsigned long *pfilepages,
1585 			 unsigned long *pheadroom, unsigned long *pdirty,
1586 			 unsigned long *pwriteback);
1587 
1588 void mem_cgroup_track_foreign_dirty_slowpath(struct folio *folio,
1589 					     struct bdi_writeback *wb);
1590 
1591 static inline void mem_cgroup_track_foreign_dirty(struct folio *folio,
1592 						  struct bdi_writeback *wb)
1593 {
1594 	struct mem_cgroup *memcg;
1595 
1596 	if (mem_cgroup_disabled())
1597 		return;
1598 
1599 	memcg = folio_memcg(folio);
1600 	if (unlikely(memcg && &memcg->css != wb->memcg_css))
1601 		mem_cgroup_track_foreign_dirty_slowpath(folio, wb);
1602 }
1603 
1604 void mem_cgroup_flush_foreign(struct bdi_writeback *wb);
1605 
1606 #else	/* CONFIG_CGROUP_WRITEBACK */
1607 
1608 static inline struct wb_domain *mem_cgroup_wb_domain(struct bdi_writeback *wb)
1609 {
1610 	return NULL;
1611 }
1612 
1613 static inline void mem_cgroup_wb_stats(struct bdi_writeback *wb,
1614 				       unsigned long *pfilepages,
1615 				       unsigned long *pheadroom,
1616 				       unsigned long *pdirty,
1617 				       unsigned long *pwriteback)
1618 {
1619 }
1620 
1621 static inline void mem_cgroup_track_foreign_dirty(struct folio *folio,
1622 						  struct bdi_writeback *wb)
1623 {
1624 }
1625 
1626 static inline void mem_cgroup_flush_foreign(struct bdi_writeback *wb)
1627 {
1628 }
1629 
1630 #endif	/* CONFIG_CGROUP_WRITEBACK */
1631 
1632 struct sock;
1633 bool mem_cgroup_charge_skmem(struct mem_cgroup *memcg, unsigned int nr_pages,
1634 			     gfp_t gfp_mask);
1635 void mem_cgroup_uncharge_skmem(struct mem_cgroup *memcg, unsigned int nr_pages);
1636 #ifdef CONFIG_MEMCG
1637 extern struct static_key_false memcg_sockets_enabled_key;
1638 #define mem_cgroup_sockets_enabled static_branch_unlikely(&memcg_sockets_enabled_key)
1639 void mem_cgroup_sk_alloc(struct sock *sk);
1640 void mem_cgroup_sk_free(struct sock *sk);
1641 static inline bool mem_cgroup_under_socket_pressure(struct mem_cgroup *memcg)
1642 {
1643 #ifdef CONFIG_MEMCG_V1
1644 	if (!cgroup_subsys_on_dfl(memory_cgrp_subsys))
1645 		return !!memcg->tcpmem_pressure;
1646 #endif /* CONFIG_MEMCG_V1 */
1647 	do {
1648 		if (time_before(jiffies, READ_ONCE(memcg->socket_pressure)))
1649 			return true;
1650 	} while ((memcg = parent_mem_cgroup(memcg)));
1651 	return false;
1652 }
1653 
1654 int alloc_shrinker_info(struct mem_cgroup *memcg);
1655 void free_shrinker_info(struct mem_cgroup *memcg);
1656 void set_shrinker_bit(struct mem_cgroup *memcg, int nid, int shrinker_id);
1657 void reparent_shrinker_deferred(struct mem_cgroup *memcg);
1658 #else
1659 #define mem_cgroup_sockets_enabled 0
1660 static inline void mem_cgroup_sk_alloc(struct sock *sk) { };
1661 static inline void mem_cgroup_sk_free(struct sock *sk) { };
1662 static inline bool mem_cgroup_under_socket_pressure(struct mem_cgroup *memcg)
1663 {
1664 	return false;
1665 }
1666 
1667 static inline void set_shrinker_bit(struct mem_cgroup *memcg,
1668 				    int nid, int shrinker_id)
1669 {
1670 }
1671 #endif
1672 
1673 #ifdef CONFIG_MEMCG
1674 bool mem_cgroup_kmem_disabled(void);
1675 int __memcg_kmem_charge_page(struct page *page, gfp_t gfp, int order);
1676 void __memcg_kmem_uncharge_page(struct page *page, int order);
1677 
1678 /*
1679  * The returned objcg pointer is safe to use without additional
1680  * protection within a scope. The scope is defined either by
1681  * the current task (similar to the "current" global variable)
1682  * or by set_active_memcg() pair.
1683  * Please, use obj_cgroup_get() to get a reference if the pointer
1684  * needs to be used outside of the local scope.
1685  */
1686 struct obj_cgroup *current_obj_cgroup(void);
1687 struct obj_cgroup *get_obj_cgroup_from_folio(struct folio *folio);
1688 
1689 static inline struct obj_cgroup *get_obj_cgroup_from_current(void)
1690 {
1691 	struct obj_cgroup *objcg = current_obj_cgroup();
1692 
1693 	if (objcg)
1694 		obj_cgroup_get(objcg);
1695 
1696 	return objcg;
1697 }
1698 
1699 int obj_cgroup_charge(struct obj_cgroup *objcg, gfp_t gfp, size_t size);
1700 void obj_cgroup_uncharge(struct obj_cgroup *objcg, size_t size);
1701 
1702 extern struct static_key_false memcg_bpf_enabled_key;
1703 static inline bool memcg_bpf_enabled(void)
1704 {
1705 	return static_branch_likely(&memcg_bpf_enabled_key);
1706 }
1707 
1708 extern struct static_key_false memcg_kmem_online_key;
1709 
1710 static inline bool memcg_kmem_online(void)
1711 {
1712 	return static_branch_likely(&memcg_kmem_online_key);
1713 }
1714 
1715 static inline int memcg_kmem_charge_page(struct page *page, gfp_t gfp,
1716 					 int order)
1717 {
1718 	if (memcg_kmem_online())
1719 		return __memcg_kmem_charge_page(page, gfp, order);
1720 	return 0;
1721 }
1722 
1723 static inline void memcg_kmem_uncharge_page(struct page *page, int order)
1724 {
1725 	if (memcg_kmem_online())
1726 		__memcg_kmem_uncharge_page(page, order);
1727 }
1728 
1729 /*
1730  * A helper for accessing memcg's kmem_id, used for getting
1731  * corresponding LRU lists.
1732  */
1733 static inline int memcg_kmem_id(struct mem_cgroup *memcg)
1734 {
1735 	return memcg ? memcg->kmemcg_id : -1;
1736 }
1737 
1738 struct mem_cgroup *mem_cgroup_from_slab_obj(void *p);
1739 
1740 static inline void count_objcg_events(struct obj_cgroup *objcg,
1741 				      enum vm_event_item idx,
1742 				      unsigned long count)
1743 {
1744 	struct mem_cgroup *memcg;
1745 
1746 	if (!memcg_kmem_online())
1747 		return;
1748 
1749 	rcu_read_lock();
1750 	memcg = obj_cgroup_memcg(objcg);
1751 	count_memcg_events(memcg, idx, count);
1752 	rcu_read_unlock();
1753 }
1754 
1755 #else
1756 static inline bool mem_cgroup_kmem_disabled(void)
1757 {
1758 	return true;
1759 }
1760 
1761 static inline int memcg_kmem_charge_page(struct page *page, gfp_t gfp,
1762 					 int order)
1763 {
1764 	return 0;
1765 }
1766 
1767 static inline void memcg_kmem_uncharge_page(struct page *page, int order)
1768 {
1769 }
1770 
1771 static inline int __memcg_kmem_charge_page(struct page *page, gfp_t gfp,
1772 					   int order)
1773 {
1774 	return 0;
1775 }
1776 
1777 static inline void __memcg_kmem_uncharge_page(struct page *page, int order)
1778 {
1779 }
1780 
1781 static inline struct obj_cgroup *get_obj_cgroup_from_folio(struct folio *folio)
1782 {
1783 	return NULL;
1784 }
1785 
1786 static inline bool memcg_bpf_enabled(void)
1787 {
1788 	return false;
1789 }
1790 
1791 static inline bool memcg_kmem_online(void)
1792 {
1793 	return false;
1794 }
1795 
1796 static inline int memcg_kmem_id(struct mem_cgroup *memcg)
1797 {
1798 	return -1;
1799 }
1800 
1801 static inline struct mem_cgroup *mem_cgroup_from_slab_obj(void *p)
1802 {
1803 	return NULL;
1804 }
1805 
1806 static inline void count_objcg_events(struct obj_cgroup *objcg,
1807 				      enum vm_event_item idx,
1808 				      unsigned long count)
1809 {
1810 }
1811 
1812 #endif /* CONFIG_MEMCG */
1813 
1814 #if defined(CONFIG_MEMCG) && defined(CONFIG_ZSWAP)
1815 bool obj_cgroup_may_zswap(struct obj_cgroup *objcg);
1816 void obj_cgroup_charge_zswap(struct obj_cgroup *objcg, size_t size);
1817 void obj_cgroup_uncharge_zswap(struct obj_cgroup *objcg, size_t size);
1818 bool mem_cgroup_zswap_writeback_enabled(struct mem_cgroup *memcg);
1819 #else
1820 static inline bool obj_cgroup_may_zswap(struct obj_cgroup *objcg)
1821 {
1822 	return true;
1823 }
1824 static inline void obj_cgroup_charge_zswap(struct obj_cgroup *objcg,
1825 					   size_t size)
1826 {
1827 }
1828 static inline void obj_cgroup_uncharge_zswap(struct obj_cgroup *objcg,
1829 					     size_t size)
1830 {
1831 }
1832 static inline bool mem_cgroup_zswap_writeback_enabled(struct mem_cgroup *memcg)
1833 {
1834 	/* if zswap is disabled, do not block pages going to the swapping device */
1835 	return true;
1836 }
1837 #endif
1838 
1839 
1840 /* Cgroup v1-related declarations */
1841 
1842 #ifdef CONFIG_MEMCG_V1
1843 unsigned long memcg1_soft_limit_reclaim(pg_data_t *pgdat, int order,
1844 					gfp_t gfp_mask,
1845 					unsigned long *total_scanned);
1846 
1847 bool mem_cgroup_oom_synchronize(bool wait);
1848 
1849 static inline bool task_in_memcg_oom(struct task_struct *p)
1850 {
1851 	return p->memcg_in_oom;
1852 }
1853 
1854 static inline void mem_cgroup_enter_user_fault(void)
1855 {
1856 	WARN_ON(current->in_user_fault);
1857 	current->in_user_fault = 1;
1858 }
1859 
1860 static inline void mem_cgroup_exit_user_fault(void)
1861 {
1862 	WARN_ON(!current->in_user_fault);
1863 	current->in_user_fault = 0;
1864 }
1865 
1866 #else /* CONFIG_MEMCG_V1 */
1867 static inline
1868 unsigned long memcg1_soft_limit_reclaim(pg_data_t *pgdat, int order,
1869 					gfp_t gfp_mask,
1870 					unsigned long *total_scanned)
1871 {
1872 	return 0;
1873 }
1874 
1875 static inline bool task_in_memcg_oom(struct task_struct *p)
1876 {
1877 	return false;
1878 }
1879 
1880 static inline bool mem_cgroup_oom_synchronize(bool wait)
1881 {
1882 	return false;
1883 }
1884 
1885 static inline void mem_cgroup_enter_user_fault(void)
1886 {
1887 }
1888 
1889 static inline void mem_cgroup_exit_user_fault(void)
1890 {
1891 }
1892 
1893 #endif /* CONFIG_MEMCG_V1 */
1894 
1895 #endif /* _LINUX_MEMCONTROL_H */
1896