xref: /linux-6.15/include/linux/coredump.h (revision 7828b7bb)
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 #else
47 static inline void do_coredump(const kernel_siginfo_t *siginfo) {}
48 #endif
49 
50 #if defined(CONFIG_COREDUMP) && defined(CONFIG_SYSCTL)
51 extern void validate_coredump_safety(void);
52 #else
53 static inline void validate_coredump_safety(void) {}
54 #endif
55 
56 #endif /* _LINUX_COREDUMP_H */
57