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 #include <asm/errno.h>
   7
   8 struct task_struct;
   9 struct pt_regs;
  10
  11 #ifdef CONFIG_STACKTRACE
  12 void stack_trace_print(const unsigned long *trace, unsigned int nr_entries,
  13                        int spaces);
  14 int stack_trace_snprint(char *buf, size_t size, const unsigned long *entries,
  15                         unsigned int nr_entries, int spaces);
  16 unsigned int stack_trace_save(unsigned long *store, unsigned int size,
  17                               unsigned int skipnr);
  18 unsigned int stack_trace_save_tsk(struct task_struct *task,
  19                                   unsigned long *store, unsigned int size,
  20                                   unsigned int skipnr);
  21 unsigned int stack_trace_save_regs(struct pt_regs *regs, unsigned long *store,
  22                                    unsigned int size, unsigned int skipnr);
  23 unsigned int stack_trace_save_user(unsigned long *store, unsigned int size);
  24
  25 /* Internal interfaces. Do not use in generic code */
  26 #ifdef CONFIG_ARCH_STACKWALK
  27
  28 /**
  29  * stack_trace_consume_fn - Callback for arch_stack_walk()
  30  * @cookie:     Caller supplied pointer handed back by arch_stack_walk()
  31  * @addr:       The stack entry address to consume
  32  *
  33  * Return:      True, if the entry was consumed or skipped
  34  *              False, if there is no space left to store
  35  */
  36 typedef bool (*stack_trace_consume_fn)(void *cookie, unsigned long addr);
  37 /**
  38  * arch_stack_walk - Architecture specific function to walk the stack
  39  * @consume_entry:      Callback which is invoked by the architecture code for
  40  *                      each entry.
  41  * @cookie:             Caller supplied pointer which is handed back to
  42  *                      @consume_entry
  43  * @task:               Pointer to a task struct, can be NULL
  44  * @regs:               Pointer to registers, can be NULL
  45  *
  46  * ============ ======= ============================================
  47  * task         regs
  48  * ============ ======= ============================================
  49  * task         NULL    Stack trace from task (can be current)
  50  * current      regs    Stack trace starting on regs->stackpointer
  51  * ============ ======= ============================================
  52  */
  53 void arch_stack_walk(stack_trace_consume_fn consume_entry, void *cookie,
  54                      struct task_struct *task, struct pt_regs *regs);
  55 int arch_stack_walk_reliable(stack_trace_consume_fn consume_entry, void *cookie,
  56                              struct task_struct *task);
  57 void arch_stack_walk_user(stack_trace_consume_fn consume_entry, void *cookie,
  58                           const struct pt_regs *regs);
  59
  60 #else /* CONFIG_ARCH_STACKWALK */
  61 struct stack_trace {
  62         unsigned int nr_entries, max_entries;
  63         unsigned long *entries;
  64         unsigned int skip;      /* input argument: How many entries to skip */
  65 };
  66
  67 extern void save_stack_trace(struct stack_trace *trace);
  68 extern void save_stack_trace_regs(struct pt_regs *regs,
  69                                   struct stack_trace *trace);
  70 extern void save_stack_trace_tsk(struct task_struct *tsk,
  71                                 struct stack_trace *trace);
  72 extern int save_stack_trace_tsk_reliable(struct task_struct *tsk,
  73                                          struct stack_trace *trace);
  74 extern void save_stack_trace_user(struct stack_trace *trace);
  75 #endif /* !CONFIG_ARCH_STACKWALK */
  76 #endif /* CONFIG_STACKTRACE */
  77
  78 #if defined(CONFIG_STACKTRACE) && defined(CONFIG_HAVE_RELIABLE_STACKTRACE)
  79 int stack_trace_save_tsk_reliable(struct task_struct *tsk, unsigned long *store,
  80                                   unsigned int size);
  81 #else
  82 static inline int stack_trace_save_tsk_reliable(struct task_struct *tsk,
  83                                                 unsigned long *store,
  84                                                 unsigned int size)
  85 {
  86         return -ENOSYS;
  87 }
  88 #endif
  89
  90 #endif /* __LINUX_STACKTRACE_H */