xref: /linux-6.15/include/linux/oom.h (revision e8fa600e)
1 #ifndef __INCLUDE_LINUX_OOM_H
2 #define __INCLUDE_LINUX_OOM_H
3 
4 /*
5  * /proc/<pid>/oom_adj is deprecated, see
6  * Documentation/feature-removal-schedule.txt.
7  *
8  * /proc/<pid>/oom_adj set to -17 protects from the oom-killer
9  */
10 #define OOM_DISABLE (-17)
11 /* inclusive */
12 #define OOM_ADJUST_MIN (-16)
13 #define OOM_ADJUST_MAX 15
14 
15 /*
16  * /proc/<pid>/oom_score_adj set to OOM_SCORE_ADJ_MIN disables oom killing for
17  * pid.
18  */
19 #define OOM_SCORE_ADJ_MIN	(-1000)
20 #define OOM_SCORE_ADJ_MAX	1000
21 
22 #ifdef __KERNEL__
23 
24 #include <linux/sched.h>
25 #include <linux/types.h>
26 #include <linux/nodemask.h>
27 
28 struct zonelist;
29 struct notifier_block;
30 struct mem_cgroup;
31 struct task_struct;
32 
33 /*
34  * Types of limitations to the nodes from which allocations may occur
35  */
36 enum oom_constraint {
37 	CONSTRAINT_NONE,
38 	CONSTRAINT_CPUSET,
39 	CONSTRAINT_MEMORY_POLICY,
40 	CONSTRAINT_MEMCG,
41 };
42 
43 enum oom_scan_t {
44 	OOM_SCAN_OK,		/* scan thread and find its badness */
45 	OOM_SCAN_CONTINUE,	/* do not consider thread for oom kill */
46 	OOM_SCAN_ABORT,		/* abort the iteration and return */
47 	OOM_SCAN_SELECT,	/* always select this thread first */
48 };
49 
50 extern void compare_swap_oom_score_adj(int old_val, int new_val);
51 extern int test_set_oom_score_adj(int new_val);
52 
53 extern unsigned long oom_badness(struct task_struct *p,
54 		struct mem_cgroup *memcg, const nodemask_t *nodemask,
55 		unsigned long totalpages);
56 extern void oom_kill_process(struct task_struct *p, gfp_t gfp_mask, int order,
57 			     unsigned int points, unsigned long totalpages,
58 			     struct mem_cgroup *memcg, nodemask_t *nodemask,
59 			     const char *message);
60 
61 extern int try_set_zonelist_oom(struct zonelist *zonelist, gfp_t gfp_flags);
62 extern void clear_zonelist_oom(struct zonelist *zonelist, gfp_t gfp_flags);
63 
64 extern void check_panic_on_oom(enum oom_constraint constraint, gfp_t gfp_mask,
65 			       int order, const nodemask_t *nodemask);
66 
67 extern enum oom_scan_t oom_scan_process_thread(struct task_struct *task,
68 		unsigned long totalpages, const nodemask_t *nodemask,
69 		bool force_kill);
70 extern void mem_cgroup_out_of_memory(struct mem_cgroup *memcg, gfp_t gfp_mask,
71 				     int order);
72 
73 extern void out_of_memory(struct zonelist *zonelist, gfp_t gfp_mask,
74 		int order, nodemask_t *mask, bool force_kill);
75 extern int register_oom_notifier(struct notifier_block *nb);
76 extern int unregister_oom_notifier(struct notifier_block *nb);
77 
78 extern bool oom_killer_disabled;
79 
80 static inline void oom_killer_disable(void)
81 {
82 	oom_killer_disabled = true;
83 }
84 
85 static inline void oom_killer_enable(void)
86 {
87 	oom_killer_disabled = false;
88 }
89 
90 extern struct task_struct *find_lock_task_mm(struct task_struct *p);
91 
92 /* sysctls */
93 extern int sysctl_oom_dump_tasks;
94 extern int sysctl_oom_kill_allocating_task;
95 extern int sysctl_panic_on_oom;
96 #endif /* __KERNEL__*/
97 #endif /* _INCLUDE_LINUX_OOM_H */
98