1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_MODULELOADER_H
3 #define _LINUX_MODULELOADER_H
4 /* The stuff needed for archs to support modules. */
5 
6 #include <linux/module.h>
7 #include <linux/elf.h>
8 
9 /* These may be implemented by architectures that need to hook into the
10  * module loader code.  Architectures that don't need to do anything special
11  * can just rely on the 'weak' default hooks defined in kernel/module.c.
12  * Note, however, that at least one of apply_relocate or apply_relocate_add
13  * must be implemented by each architecture.
14  */
15 
16 /* Adjust arch-specific sections.  Return 0 on success.  */
17 int module_frob_arch_sections(Elf_Ehdr *hdr,
18 			      Elf_Shdr *sechdrs,
19 			      char *secstrings,
20 			      struct module *mod);
21 
22 /* Additional bytes needed by arch in front of individual sections */
23 unsigned int arch_mod_section_prepend(struct module *mod, unsigned int section);
24 
25 /* Allocator used for allocating struct module, core sections and init
26    sections.  Returns NULL on failure. */
27 void *module_alloc(unsigned long size);
28 
29 /* Free memory returned from module_alloc. */
30 void module_memfree(void *module_region);
31 
32 /* Determines if the section name is an init section (that is only used during
33  * module loading).
34  */
35 bool module_init_section(const char *name);
36 
37 /* Determines if the section name is an exit section (that is only used during
38  * module unloading)
39  */
40 bool module_exit_section(const char *name);
41 
42 /*
43  * Apply the given relocation to the (simplified) ELF.  Return -error
44  * or 0.
45  */
46 #ifdef CONFIG_MODULES_USE_ELF_REL
47 int apply_relocate(Elf_Shdr *sechdrs,
48 		   const char *strtab,
49 		   unsigned int symindex,
50 		   unsigned int relsec,
51 		   struct module *mod);
52 #else
apply_relocate(Elf_Shdr * sechdrs,const char * strtab,unsigned int symindex,unsigned int relsec,struct module * me)53 static inline int apply_relocate(Elf_Shdr *sechdrs,
54 				 const char *strtab,
55 				 unsigned int symindex,
56 				 unsigned int relsec,
57 				 struct module *me)
58 {
59 	printk(KERN_ERR "module %s: REL relocation unsupported\n",
60 	       module_name(me));
61 	return -ENOEXEC;
62 }
63 #endif
64 
65 /*
66  * Apply the given add relocation to the (simplified) ELF.  Return
67  * -error or 0
68  */
69 #ifdef CONFIG_MODULES_USE_ELF_RELA
70 int apply_relocate_add(Elf_Shdr *sechdrs,
71 		       const char *strtab,
72 		       unsigned int symindex,
73 		       unsigned int relsec,
74 		       struct module *mod);
75 #else
apply_relocate_add(Elf_Shdr * sechdrs,const char * strtab,unsigned int symindex,unsigned int relsec,struct module * me)76 static inline int apply_relocate_add(Elf_Shdr *sechdrs,
77 				     const char *strtab,
78 				     unsigned int symindex,
79 				     unsigned int relsec,
80 				     struct module *me)
81 {
82 	printk(KERN_ERR "module %s: REL relocation unsupported\n",
83 	       module_name(me));
84 	return -ENOEXEC;
85 }
86 #endif
87 
88 /* Any final processing of module before access.  Return -error or 0. */
89 int module_finalize(const Elf_Ehdr *hdr,
90 		    const Elf_Shdr *sechdrs,
91 		    struct module *mod);
92 
93 /* Any cleanup needed when module leaves. */
94 void module_arch_cleanup(struct module *mod);
95 
96 /* Any cleanup before freeing mod->module_init */
97 void module_arch_freeing_init(struct module *mod);
98 
99 #if (defined(CONFIG_KASAN_GENERIC) || defined(CONFIG_KASAN_SW_TAGS)) && \
100 		!defined(CONFIG_KASAN_VMALLOC)
101 #include <linux/kasan.h>
102 #define MODULE_ALIGN (PAGE_SIZE << KASAN_SHADOW_SCALE_SHIFT)
103 #else
104 #define MODULE_ALIGN PAGE_SIZE
105 #endif
106 
107 #endif
108