LXR linux/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.  */
  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