blob: 4d0cb9bba93e4650d76b314cc50160e5b8e7e65d [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#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
Jonas Bonn74e08fc2011-06-30 21:22:11 +02008/* 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 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070014
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
Helge Deller088af9a2008-12-31 12:31:18 +010021/* Additional bytes needed by arch in front of individual sections */
22unsigned int arch_mod_section_prepend(struct module *mod, unsigned int section);
23
Linus Torvalds1da177e2005-04-16 15:20:36 -070024/* 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. */
Rusty Russellbe1f2212015-01-20 09:07:05 +103029void module_memfree(void *module_region);
Linus Torvalds1da177e2005-04-16 15:20:36 -070030
David Howells786d35d2012-09-28 14:31:03 +093031/*
32 * Apply the given relocation to the (simplified) ELF. Return -error
33 * or 0.
34 */
35#ifdef CONFIG_MODULES_USE_ELF_REL
Linus Torvalds1da177e2005-04-16 15:20:36 -070036int apply_relocate(Elf_Shdr *sechdrs,
37 const char *strtab,
38 unsigned int symindex,
39 unsigned int relsec,
40 struct module *mod);
David Howells786d35d2012-09-28 14:31:03 +093041#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{
Rusty Russell3a611c32014-07-27 07:23:01 +093048 printk(KERN_ERR "module %s: REL relocation unsupported\n",
49 module_name(me));
David Howells786d35d2012-09-28 14:31:03 +093050 return -ENOEXEC;
51}
52#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070053
David Howells786d35d2012-09-28 14:31:03 +093054/*
55 * Apply the given add relocation to the (simplified) ELF. Return
56 * -error or 0
57 */
58#ifdef CONFIG_MODULES_USE_ELF_RELA
Linus Torvalds1da177e2005-04-16 15:20:36 -070059int apply_relocate_add(Elf_Shdr *sechdrs,
60 const char *strtab,
61 unsigned int symindex,
62 unsigned int relsec,
63 struct module *mod);
David Howells786d35d2012-09-28 14:31:03 +093064#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{
Rusty Russell3a611c32014-07-27 07:23:01 +093071 printk(KERN_ERR "module %s: REL relocation unsupported\n",
72 module_name(me));
David Howells786d35d2012-09-28 14:31:03 +093073 return -ENOEXEC;
74}
75#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070076
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
Rusty Russelld453cde2015-01-20 09:07:04 +103085/* Any cleanup before freeing mod->module_init */
86void module_arch_freeing_init(struct module *mod);
Andrey Ryabinind3733e52015-03-12 16:26:14 -070087
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
Linus Torvalds1da177e2005-04-16 15:20:36 -070095#endif