1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef _LINUX_COREDUMP_H 3 #define _LINUX_COREDUMP_H 4 5 #include <linux/types.h> 6 #include <linux/mm.h> 7 #include <linux/fs.h> 8 #include <asm/siginfo.h> 9 10 #ifdef CONFIG_COREDUMP 11 struct core_vma_metadata { 12 unsigned long start, end; 13 unsigned long flags; 14 unsigned long dump_size; 15 unsigned long pgoff; 16 struct file *file; 17 }; 18 19 struct coredump_params { 20 const kernel_siginfo_t *siginfo; 21 struct file *file; 22 unsigned long limit; 23 unsigned long mm_flags; 24 int cpu; 25 loff_t written; 26 loff_t pos; 27 loff_t to_skip; 28 int vma_count; 29 size_t vma_data_size; 30 struct core_vma_metadata *vma_meta; 31 }; 32 33 extern unsigned int core_file_note_size_limit; 34 35 /* 36 * These are the only things you should do on a core-file: use only these 37 * functions to write out all the necessary info. 38 */ 39 extern void dump_skip_to(struct coredump_params *cprm, unsigned long to); 40 extern void dump_skip(struct coredump_params *cprm, size_t nr); 41 extern int dump_emit(struct coredump_params *cprm, const void *addr, int nr); 42 extern int dump_align(struct coredump_params *cprm, int align); 43 int dump_user_range(struct coredump_params *cprm, unsigned long start, 44 unsigned long len); 45 extern void do_coredump(const kernel_siginfo_t *siginfo); 46 47 /* 48 * Logging for the coredump code, ratelimited. 49 * The TGID and comm fields are added to the message. 50 */ 51 52 #define __COREDUMP_PRINTK(Level, Format, ...) \ 53 do { \ 54 char comm[TASK_COMM_LEN]; \ 55 /* This will always be NUL terminated. */ \ 56 memcpy(comm, current->comm, sizeof(comm)); \ 57 printk_ratelimited(Level "coredump: %d(%*pE): " Format "\n", \ 58 task_tgid_vnr(current), (int)strlen(comm), comm, ##__VA_ARGS__); \ 59 } while (0) \ 60 61 #define coredump_report(fmt, ...) __COREDUMP_PRINTK(KERN_INFO, fmt, ##__VA_ARGS__) 62 #define coredump_report_failure(fmt, ...) __COREDUMP_PRINTK(KERN_WARNING, fmt, ##__VA_ARGS__) 63 64 #else 65 static inline void do_coredump(const kernel_siginfo_t *siginfo) {} 66 67 #define coredump_report(...) 68 #define coredump_report_failure(...) 69 70 #endif 71 72 #if defined(CONFIG_COREDUMP) && defined(CONFIG_SYSCTL) 73 extern void validate_coredump_safety(void); 74 #else 75 static inline void validate_coredump_safety(void) {} 76 #endif 77 78 #endif /* _LINUX_COREDUMP_H */ 79