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