1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) 2008 Steven Rostedt <srostedt@redhat.com>
6 #include <linux/sched/task_stack.h>
7 #include <linux/stacktrace.h>
8 #include <linux/security.h>
9 #include <linux/kallsyms.h>
10 #include <linux/seq_file.h>
11 #include <linux/spinlock.h>
12 #include <linux/uaccess.h>
13 #include <linux/ftrace.h>
14 #include <linux/module.h>
15 #include <linux/sysctl.h>
16 #include <linux/init.h>
18 #include <asm/setup.h>
22 #define STACK_TRACE_ENTRIES 500
24 static unsigned long stack_dump_trace
[STACK_TRACE_ENTRIES
];
25 static unsigned stack_trace_index
[STACK_TRACE_ENTRIES
];
27 static unsigned int stack_trace_nr_entries
;
28 static unsigned long stack_trace_max_size
;
29 static arch_spinlock_t stack_trace_max_lock
=
30 (arch_spinlock_t
)__ARCH_SPIN_LOCK_UNLOCKED
;
32 DEFINE_PER_CPU(int, disable_stack_tracer
);
33 static DEFINE_MUTEX(stack_sysctl_mutex
);
35 int stack_tracer_enabled
;
37 static void print_max_stack(void)
42 pr_emerg(" Depth Size Location (%d entries)\n"
43 " ----- ---- --------\n",
44 stack_trace_nr_entries
);
46 for (i
= 0; i
< stack_trace_nr_entries
; i
++) {
47 if (i
+ 1 == stack_trace_nr_entries
)
48 size
= stack_trace_index
[i
];
50 size
= stack_trace_index
[i
] - stack_trace_index
[i
+1];
52 pr_emerg("%3ld) %8d %5d %pS\n", i
, stack_trace_index
[i
],
53 size
, (void *)stack_dump_trace
[i
]);
58 * The stack tracer looks for a maximum stack at each call from a function. It
59 * registers a callback from ftrace, and in that callback it examines the stack
60 * size. It determines the stack size from the variable passed in, which is the
61 * address of a local variable in the stack_trace_call() callback function.
62 * The stack size is calculated by the address of the local variable to the top
63 * of the current stack. If that size is smaller than the currently saved max
64 * stack size, nothing more is done.
66 * If the size of the stack is greater than the maximum recorded size, then the
67 * following algorithm takes place.
69 * For architectures (like x86) that store the function's return address before
70 * saving the function's local variables, the stack will look something like
74 * 0: sys call entry frame
75 * 10: return addr to entry code
76 * 11: start of sys_foo frame
77 * 20: return addr to sys_foo
78 * 21: start of kernel_func_bar frame
79 * 30: return addr to kernel_func_bar
80 * 31: [ do trace stack here ]
82 * The save_stack_trace() is called returning all the functions it finds in the
83 * current stack. Which would be (from the bottom of the stack to the top):
85 * return addr to kernel_func_bar
86 * return addr to sys_foo
87 * return addr to entry code
89 * Now to figure out how much each of these functions' local variable size is,
90 * a search of the stack is made to find these values. When a match is made, it
91 * is added to the stack_dump_trace[] array. The offset into the stack is saved
92 * in the stack_trace_index[] array. The above example would show:
94 * stack_dump_trace[] | stack_trace_index[]
95 * ------------------ + -------------------
96 * return addr to kernel_func_bar | 30
97 * return addr to sys_foo | 20
98 * return addr to entry | 10
100 * The print_max_stack() function above, uses these values to print the size of
101 * each function's portion of the stack.
103 * for (i = 0; i < nr_entries; i++) {
104 * size = i == nr_entries - 1 ? stack_trace_index[i] :
105 * stack_trace_index[i] - stack_trace_index[i+1]
106 * print "%d %d %d %s\n", i, stack_trace_index[i], size, stack_dump_trace[i]);
111 * depth size location
112 * ----- ---- --------
113 * 0 30 10 kernel_func_bar
117 * Now for architectures that might save the return address after the functions
118 * local variables (saving the link register before calling nested functions),
119 * this will cause the stack to look a little different:
122 * 0: sys call entry frame
123 * 10: start of sys_foo_frame
124 * 19: return addr to entry code << lr saved before calling kernel_func_bar
125 * 20: start of kernel_func_bar frame
126 * 29: return addr to sys_foo_frame << lr saved before calling next function
127 * 30: [ do trace stack here ]
129 * Although the functions returned by save_stack_trace() may be the same, the
130 * placement in the stack will be different. Using the same algorithm as above
133 * stack_dump_trace[] | stack_trace_index[]
134 * ------------------ + -------------------
135 * return addr to kernel_func_bar | 30
136 * return addr to sys_foo | 29
137 * return addr to entry | 19
139 * Where the mapping is off by one:
141 * kernel_func_bar stack frame size is 29 - 19 not 30 - 29!
143 * To fix this, if the architecture sets ARCH_RET_ADDR_AFTER_LOCAL_VARS the
144 * values in stack_trace_index[] are shifted by one to and the number of
145 * stack trace entries is decremented by one.
147 * stack_dump_trace[] | stack_trace_index[]
148 * ------------------ + -------------------
149 * return addr to kernel_func_bar | 29
150 * return addr to sys_foo | 19
152 * Although the entry function is not displayed, the first function (sys_foo)
153 * will still include the stack size of it.
155 static void check_stack(unsigned long ip
, unsigned long *stack
)
157 unsigned long this_size
, flags
; unsigned long *p
, *top
, *start
;
158 static int tracer_frame
;
159 int frame_size
= READ_ONCE(tracer_frame
);
162 this_size
= ((unsigned long)stack
) & (THREAD_SIZE
-1);
163 this_size
= THREAD_SIZE
- this_size
;
164 /* Remove the frame of the tracer */
165 this_size
-= frame_size
;
167 if (this_size
<= stack_trace_max_size
)
170 /* we do not handle interrupt stacks yet */
171 if (!object_is_on_stack(stack
))
174 /* Can't do this from NMI context (can cause deadlocks) */
178 local_irq_save(flags
);
179 arch_spin_lock(&stack_trace_max_lock
);
181 /* In case another CPU set the tracer_frame on us */
182 if (unlikely(!frame_size
))
183 this_size
-= tracer_frame
;
185 /* a race could have already updated it */
186 if (this_size
<= stack_trace_max_size
)
189 stack_trace_max_size
= this_size
;
191 stack_trace_nr_entries
= stack_trace_save(stack_dump_trace
,
192 ARRAY_SIZE(stack_dump_trace
) - 1,
195 /* Skip over the overhead of the stack tracer itself */
196 for (i
= 0; i
< stack_trace_nr_entries
; i
++) {
197 if (stack_dump_trace
[i
] == ip
)
202 * Some archs may not have the passed in ip in the dump.
203 * If that happens, we need to show everything.
205 if (i
== stack_trace_nr_entries
)
209 * Now find where in the stack these are.
213 top
= (unsigned long *)
214 (((unsigned long)start
& ~(THREAD_SIZE
-1)) + THREAD_SIZE
);
217 * Loop through all the entries. One of the entries may
218 * for some reason be missed on the stack, so we may
219 * have to account for them. If they are all there, this
220 * loop will only happen once. This code only takes place
221 * on a new max, so it is far from a fast path.
223 while (i
< stack_trace_nr_entries
) {
226 stack_trace_index
[x
] = this_size
;
229 for (; p
< top
&& i
< stack_trace_nr_entries
; p
++) {
231 * The READ_ONCE_NOCHECK is used to let KASAN know that
232 * this is not a stack-out-of-bounds error.
234 if ((READ_ONCE_NOCHECK(*p
)) == stack_dump_trace
[i
]) {
235 stack_dump_trace
[x
] = stack_dump_trace
[i
++];
236 this_size
= stack_trace_index
[x
++] =
237 (top
- p
) * sizeof(unsigned long);
239 /* Start the search from here */
242 * We do not want to show the overhead
243 * of the stack tracer stack in the
244 * max stack. If we haven't figured
245 * out what that is, then figure it out
248 if (unlikely(!tracer_frame
)) {
249 tracer_frame
= (p
- stack
) *
250 sizeof(unsigned long);
251 stack_trace_max_size
-= tracer_frame
;
260 #ifdef ARCH_FTRACE_SHIFT_STACK_TRACER
262 * Some archs will store the link register before calling
263 * nested functions. This means the saved return address
264 * comes after the local storage, and we need to shift
268 memmove(&stack_trace_index
[0], &stack_trace_index
[1],
269 sizeof(stack_trace_index
[0]) * (x
- 1));
274 stack_trace_nr_entries
= x
;
276 if (task_stack_end_corrupted(current
)) {
282 arch_spin_unlock(&stack_trace_max_lock
);
283 local_irq_restore(flags
);
286 /* Some archs may not define MCOUNT_INSN_SIZE */
287 #ifndef MCOUNT_INSN_SIZE
288 # define MCOUNT_INSN_SIZE 0
292 stack_trace_call(unsigned long ip
, unsigned long parent_ip
,
293 struct ftrace_ops
*op
, struct ftrace_regs
*fregs
)
297 preempt_disable_notrace();
299 /* no atomic needed, we only modify this variable by this cpu */
300 __this_cpu_inc(disable_stack_tracer
);
301 if (__this_cpu_read(disable_stack_tracer
) != 1)
304 /* If rcu is not watching, then save stack trace can fail */
305 if (!rcu_is_watching())
308 ip
+= MCOUNT_INSN_SIZE
;
310 check_stack(ip
, &stack
);
313 __this_cpu_dec(disable_stack_tracer
);
314 /* prevent recursion in schedule */
315 preempt_enable_notrace();
318 static struct ftrace_ops trace_ops __read_mostly
=
320 .func
= stack_trace_call
,
324 stack_max_size_read(struct file
*filp
, char __user
*ubuf
,
325 size_t count
, loff_t
*ppos
)
327 unsigned long *ptr
= filp
->private_data
;
331 r
= snprintf(buf
, sizeof(buf
), "%ld\n", *ptr
);
334 return simple_read_from_buffer(ubuf
, count
, ppos
, buf
, r
);
338 stack_max_size_write(struct file
*filp
, const char __user
*ubuf
,
339 size_t count
, loff_t
*ppos
)
341 long *ptr
= filp
->private_data
;
342 unsigned long val
, flags
;
345 ret
= kstrtoul_from_user(ubuf
, count
, 10, &val
);
349 local_irq_save(flags
);
352 * In case we trace inside arch_spin_lock() or after (NMI),
353 * we will cause circular lock, so we also need to increase
354 * the percpu disable_stack_tracer here.
356 __this_cpu_inc(disable_stack_tracer
);
358 arch_spin_lock(&stack_trace_max_lock
);
360 arch_spin_unlock(&stack_trace_max_lock
);
362 __this_cpu_dec(disable_stack_tracer
);
363 local_irq_restore(flags
);
368 static const struct file_operations stack_max_size_fops
= {
369 .open
= tracing_open_generic
,
370 .read
= stack_max_size_read
,
371 .write
= stack_max_size_write
,
372 .llseek
= default_llseek
,
376 __next(struct seq_file
*m
, loff_t
*pos
)
380 if (n
>= stack_trace_nr_entries
)
383 m
->private = (void *)n
;
388 t_next(struct seq_file
*m
, void *v
, loff_t
*pos
)
391 return __next(m
, pos
);
394 static void *t_start(struct seq_file
*m
, loff_t
*pos
)
398 __this_cpu_inc(disable_stack_tracer
);
400 arch_spin_lock(&stack_trace_max_lock
);
403 return SEQ_START_TOKEN
;
405 return __next(m
, pos
);
408 static void t_stop(struct seq_file
*m
, void *p
)
410 arch_spin_unlock(&stack_trace_max_lock
);
412 __this_cpu_dec(disable_stack_tracer
);
417 static void trace_lookup_stack(struct seq_file
*m
, long i
)
419 unsigned long addr
= stack_dump_trace
[i
];
421 seq_printf(m
, "%pS\n", (void *)addr
);
424 static void print_disabled(struct seq_file
*m
)
427 "# Stack tracer disabled\n"
429 "# To enable the stack tracer, either add 'stacktrace' to the\n"
430 "# kernel command line\n"
431 "# or 'echo 1 > /proc/sys/kernel/stack_tracer_enabled'\n"
435 static int t_show(struct seq_file
*m
, void *v
)
440 if (v
== SEQ_START_TOKEN
) {
441 seq_printf(m
, " Depth Size Location"
443 " ----- ---- --------\n",
444 stack_trace_nr_entries
);
446 if (!stack_tracer_enabled
&& !stack_trace_max_size
)
454 if (i
>= stack_trace_nr_entries
)
457 if (i
+ 1 == stack_trace_nr_entries
)
458 size
= stack_trace_index
[i
];
460 size
= stack_trace_index
[i
] - stack_trace_index
[i
+1];
462 seq_printf(m
, "%3ld) %8d %5d ", i
, stack_trace_index
[i
], size
);
464 trace_lookup_stack(m
, i
);
469 static const struct seq_operations stack_trace_seq_ops
= {
476 static int stack_trace_open(struct inode
*inode
, struct file
*file
)
480 ret
= security_locked_down(LOCKDOWN_TRACEFS
);
484 return seq_open(file
, &stack_trace_seq_ops
);
487 static const struct file_operations stack_trace_fops
= {
488 .open
= stack_trace_open
,
491 .release
= seq_release
,
494 #ifdef CONFIG_DYNAMIC_FTRACE
497 stack_trace_filter_open(struct inode
*inode
, struct file
*file
)
499 struct ftrace_ops
*ops
= inode
->i_private
;
501 /* Checks for tracefs lockdown */
502 return ftrace_regex_open(ops
, FTRACE_ITER_FILTER
,
506 static const struct file_operations stack_trace_filter_fops
= {
507 .open
= stack_trace_filter_open
,
509 .write
= ftrace_filter_write
,
510 .llseek
= tracing_lseek
,
511 .release
= ftrace_regex_release
,
514 #endif /* CONFIG_DYNAMIC_FTRACE */
517 stack_trace_sysctl(struct ctl_table
*table
, int write
, void *buffer
,
518 size_t *lenp
, loff_t
*ppos
)
523 mutex_lock(&stack_sysctl_mutex
);
524 was_enabled
= !!stack_tracer_enabled
;
526 ret
= proc_dointvec(table
, write
, buffer
, lenp
, ppos
);
528 if (ret
|| !write
|| (was_enabled
== !!stack_tracer_enabled
))
531 if (stack_tracer_enabled
)
532 register_ftrace_function(&trace_ops
);
534 unregister_ftrace_function(&trace_ops
);
536 mutex_unlock(&stack_sysctl_mutex
);
540 static char stack_trace_filter_buf
[COMMAND_LINE_SIZE
+1] __initdata
;
542 static __init
int enable_stacktrace(char *str
)
546 if ((len
= str_has_prefix(str
, "_filter=")))
547 strncpy(stack_trace_filter_buf
, str
+ len
, COMMAND_LINE_SIZE
);
549 stack_tracer_enabled
= 1;
552 __setup("stacktrace", enable_stacktrace
);
554 static __init
int stack_trace_init(void)
558 ret
= tracing_init_dentry();
562 trace_create_file("stack_max_size", 0644, NULL
,
563 &stack_trace_max_size
, &stack_max_size_fops
);
565 trace_create_file("stack_trace", 0444, NULL
,
566 NULL
, &stack_trace_fops
);
568 #ifdef CONFIG_DYNAMIC_FTRACE
569 trace_create_file("stack_trace_filter", 0644, NULL
,
570 &trace_ops
, &stack_trace_filter_fops
);
573 if (stack_trace_filter_buf
[0])
574 ftrace_set_early_filter(&trace_ops
, stack_trace_filter_buf
, 1);
576 if (stack_tracer_enabled
)
577 register_ftrace_function(&trace_ops
);
582 device_initcall(stack_trace_init
);