include/linux/moduleloader.h

   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.  */
  16 int 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 */
  22 unsigned 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. */
  26 void *module_alloc(unsigned long size);
  27
  28 /* Free memory returned from module_alloc. */
  29 void 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
  36 int apply_relocate(Elf_Shdr *sechdrs,
  37                    const char *strtab,
  38                    unsigned int symindex,
  39                    unsigned int relsec,
  40                    struct module *mod);
  41 #else
  42 static 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
  59 int apply_relocate_add(Elf_Shdr *sechdrs,
  60                        const char *strtab,
  61                        unsigned int symindex,
  62                        unsigned int relsec,
  63                        struct module *mod);
  64 #else
  65 static 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. */
  78 int module_finalize(const Elf_Ehdr *hdr,
  79                     const Elf_Shdr *sechdrs,
  80                     struct module *mod);
  81
  82 /* Any cleanup needed when module leaves. */
  83 void module_arch_cleanup(struct module *mod);
  84
  85 /* Any cleanup before freeing mod->module_init */
  86 void 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