include/linux/stacktrace.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef __LINUX_STACKTRACE_H
   3 #define __LINUX_STACKTRACE_H
   4
   5 #include <linux/types.h>
   6
   7 struct task_struct;
   8 struct pt_regs;
   9
  10 #ifdef CONFIG_STACKTRACE
  11 struct stack_trace {
  12         unsigned int nr_entries, max_entries;
  13         unsigned long *entries;
  14         int skip;       /* input argument: How many entries to skip */
  15 };
  16
  17 extern void save_stack_trace(struct stack_trace *trace);
  18 extern void save_stack_trace_regs(struct pt_regs *regs,
  19                                   struct stack_trace *trace);
  20 extern void save_stack_trace_tsk(struct task_struct *tsk,
  21                                 struct stack_trace *trace);
  22 extern int save_stack_trace_tsk_reliable(struct task_struct *tsk,
  23                                          struct stack_trace *trace);
  24
  25 extern void print_stack_trace(struct stack_trace *trace, int spaces);
  26 extern int snprint_stack_trace(char *buf, size_t size,
  27                         struct stack_trace *trace, int spaces);
  28
  29 #ifdef CONFIG_USER_STACKTRACE_SUPPORT
  30 extern void save_stack_trace_user(struct stack_trace *trace);
  31 #else
  32 # define save_stack_trace_user(trace)              do { } while (0)
  33 #endif
  34
  35 #else /* !CONFIG_STACKTRACE */
  36 # define save_stack_trace(trace)                        do { } while (0)
  37 # define save_stack_trace_tsk(tsk, trace)               do { } while (0)
  38 # define save_stack_trace_user(trace)                   do { } while (0)
  39 # define print_stack_trace(trace, spaces)               do { } while (0)
  40 # define snprint_stack_trace(buf, size, trace, spaces)  do { } while (0)
  41 # define save_stack_trace_tsk_reliable(tsk, trace)      ({ -ENOSYS; })
  42 #endif /* CONFIG_STACKTRACE */
  43
  44 #endif /* __LINUX_STACKTRACE_H */