module.h 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840
  1. #ifndef _LINUX_MODULE_H
  2. #define _LINUX_MODULE_H
  3. /*
  4. * Dynamic loading of modules into the kernel.
  5. *
  6. * Rewritten by Richard Henderson <rth@tamu.edu> Dec 1996
  7. * Rewritten again by Rusty Russell, 2002
  8. */
  9. #include <linux/list.h>
  10. #include <linux/stat.h>
  11. #include <linux/compiler.h>
  12. #include <linux/cache.h>
  13. #include <linux/kmod.h>
  14. #include <linux/init.h>
  15. #include <linux/elf.h>
  16. #include <linux/stringify.h>
  17. #include <linux/kobject.h>
  18. #include <linux/moduleparam.h>
  19. #include <linux/jump_label.h>
  20. #include <linux/export.h>
  21. #include <linux/rbtree_latch.h>
  22. #include <linux/error-injection.h>
  23. #include <linux/percpu.h>
  24. #include <asm/module.h>
  25. /* In stripped ARM and x86-64 modules, ~ is surprisingly rare. */
  26. #define MODULE_SIG_STRING "~Module signature appended~\n"
  27. /* Not Yet Implemented */
  28. #define MODULE_SUPPORTED_DEVICE(name)
  29. #define MODULE_NAME_LEN MAX_PARAM_PREFIX_LEN
  30. struct modversion_info {
  31. unsigned long crc;
  32. char name[MODULE_NAME_LEN];
  33. };
  34. struct module;
  35. struct exception_table_entry;
  36. struct module_kobject {
  37. struct kobject kobj;
  38. struct module *mod;
  39. struct kobject *drivers_dir;
  40. struct module_param_attrs *mp;
  41. struct completion *kobj_completion;
  42. } __randomize_layout;
  43. struct module_attribute {
  44. struct attribute attr;
  45. ssize_t (*show)(struct module_attribute *, struct module_kobject *,
  46. char *);
  47. ssize_t (*store)(struct module_attribute *, struct module_kobject *,
  48. const char *, size_t count);
  49. void (*setup)(struct module *, const char *);
  50. int (*test)(struct module *);
  51. void (*free)(struct module *);
  52. };
  53. struct module_version_attribute {
  54. struct module_attribute mattr;
  55. const char *module_name;
  56. const char *version;
  57. } __attribute__ ((__aligned__(sizeof(void *))));
  58. extern ssize_t __modver_version_show(struct module_attribute *,
  59. struct module_kobject *, char *);
  60. extern struct module_attribute module_uevent;
  61. /* These are either module local, or the kernel's dummy ones. */
  62. extern int init_module(void);
  63. extern void cleanup_module(void);
  64. #ifndef MODULE
  65. /**
  66. * module_init() - driver initialization entry point
  67. * @x: function to be run at kernel boot time or module insertion
  68. *
  69. * module_init() will either be called during do_initcalls() (if
  70. * builtin) or at module insertion time (if a module). There can only
  71. * be one per module.
  72. */
  73. #define module_init(x) __initcall(x);
  74. /**
  75. * module_exit() - driver exit entry point
  76. * @x: function to be run when driver is removed
  77. *
  78. * module_exit() will wrap the driver clean-up code
  79. * with cleanup_module() when used with rmmod when
  80. * the driver is a module. If the driver is statically
  81. * compiled into the kernel, module_exit() has no effect.
  82. * There can only be one per module.
  83. */
  84. #define module_exit(x) __exitcall(x);
  85. #else /* MODULE */
  86. /*
  87. * In most cases loadable modules do not need custom
  88. * initcall levels. There are still some valid cases where
  89. * a driver may be needed early if built in, and does not
  90. * matter when built as a loadable module. Like bus
  91. * snooping debug drivers.
  92. */
  93. #define early_initcall(fn) module_init(fn)
  94. #define core_initcall(fn) module_init(fn)
  95. #define core_initcall_sync(fn) module_init(fn)
  96. #define postcore_initcall(fn) module_init(fn)
  97. #define postcore_initcall_sync(fn) module_init(fn)
  98. #define arch_initcall(fn) module_init(fn)
  99. #define subsys_initcall(fn) module_init(fn)
  100. #define subsys_initcall_sync(fn) module_init(fn)
  101. #define fs_initcall(fn) module_init(fn)
  102. #define fs_initcall_sync(fn) module_init(fn)
  103. #define rootfs_initcall(fn) module_init(fn)
  104. #define device_initcall(fn) module_init(fn)
  105. #define device_initcall_sync(fn) module_init(fn)
  106. #define late_initcall(fn) module_init(fn)
  107. #define late_initcall_sync(fn) module_init(fn)
  108. #define console_initcall(fn) module_init(fn)
  109. /* Each module must use one module_init(). */
  110. #define module_init(initfn) \
  111. static inline initcall_t __maybe_unused __inittest(void) \
  112. { return initfn; } \
  113. int init_module(void) __attribute__((alias(#initfn)));
  114. /* This is only required if you want to be unloadable. */
  115. #define module_exit(exitfn) \
  116. static inline exitcall_t __maybe_unused __exittest(void) \
  117. { return exitfn; } \
  118. void cleanup_module(void) __attribute__((alias(#exitfn)));
  119. #endif
  120. /* This means "can be init if no module support, otherwise module load
  121. may call it." */
  122. #ifdef CONFIG_MODULES
  123. #define __init_or_module
  124. #define __initdata_or_module
  125. #define __initconst_or_module
  126. #define __INIT_OR_MODULE .text
  127. #define __INITDATA_OR_MODULE .data
  128. #define __INITRODATA_OR_MODULE .section ".rodata","a",%progbits
  129. #else
  130. #define __init_or_module __init
  131. #define __initdata_or_module __initdata
  132. #define __initconst_or_module __initconst
  133. #define __INIT_OR_MODULE __INIT
  134. #define __INITDATA_OR_MODULE __INITDATA
  135. #define __INITRODATA_OR_MODULE __INITRODATA
  136. #endif /*CONFIG_MODULES*/
  137. /* Generic info of form tag = "info" */
  138. #define MODULE_INFO(tag, info) __MODULE_INFO(tag, tag, info)
  139. /* For userspace: you can also call me... */
  140. #define MODULE_ALIAS(_alias) MODULE_INFO(alias, _alias)
  141. /* Soft module dependencies. See man modprobe.d for details.
  142. * Example: MODULE_SOFTDEP("pre: module-foo module-bar post: module-baz")
  143. */
  144. #define MODULE_SOFTDEP(_softdep) MODULE_INFO(softdep, _softdep)
  145. /*
  146. * The following license idents are currently accepted as indicating free
  147. * software modules
  148. *
  149. * "GPL" [GNU Public License v2 or later]
  150. * "GPL v2" [GNU Public License v2]
  151. * "GPL and additional rights" [GNU Public License v2 rights and more]
  152. * "Dual BSD/GPL" [GNU Public License v2
  153. * or BSD license choice]
  154. * "Dual MIT/GPL" [GNU Public License v2
  155. * or MIT license choice]
  156. * "Dual MPL/GPL" [GNU Public License v2
  157. * or Mozilla license choice]
  158. *
  159. * The following other idents are available
  160. *
  161. * "Proprietary" [Non free products]
  162. *
  163. * There are dual licensed components, but when running with Linux it is the
  164. * GPL that is relevant so this is a non issue. Similarly LGPL linked with GPL
  165. * is a GPL combined work.
  166. *
  167. * This exists for several reasons
  168. * 1. So modinfo can show license info for users wanting to vet their setup
  169. * is free
  170. * 2. So the community can ignore bug reports including proprietary modules
  171. * 3. So vendors can do likewise based on their own policies
  172. */
  173. #define MODULE_LICENSE(_license) MODULE_INFO(license, _license)
  174. /*
  175. * Author(s), use "Name <email>" or just "Name", for multiple
  176. * authors use multiple MODULE_AUTHOR() statements/lines.
  177. */
  178. #define MODULE_AUTHOR(_author) MODULE_INFO(author, _author)
  179. /* What your module does. */
  180. #define MODULE_DESCRIPTION(_description) MODULE_INFO(description, _description)
  181. #ifdef MODULE
  182. /* Creates an alias so file2alias.c can find device table. */
  183. #define MODULE_DEVICE_TABLE(type, name) \
  184. extern typeof(name) __mod_##type##__##name##_device_table \
  185. __attribute__ ((unused, alias(__stringify(name))))
  186. #else /* !MODULE */
  187. #define MODULE_DEVICE_TABLE(type, name)
  188. #endif
  189. /* Version of form [<epoch>:]<version>[-<extra-version>].
  190. * Or for CVS/RCS ID version, everything but the number is stripped.
  191. * <epoch>: A (small) unsigned integer which allows you to start versions
  192. * anew. If not mentioned, it's zero. eg. "2:1.0" is after
  193. * "1:2.0".
  194. * <version>: The <version> may contain only alphanumerics and the
  195. * character `.'. Ordered by numeric sort for numeric parts,
  196. * ascii sort for ascii parts (as per RPM or DEB algorithm).
  197. * <extraversion>: Like <version>, but inserted for local
  198. * customizations, eg "rh3" or "rusty1".
  199. * Using this automatically adds a checksum of the .c files and the
  200. * local headers in "srcversion".
  201. */
  202. #if defined(MODULE) || !defined(CONFIG_SYSFS)
  203. #define MODULE_VERSION(_version) MODULE_INFO(version, _version)
  204. #else
  205. #define MODULE_VERSION(_version) \
  206. static struct module_version_attribute ___modver_attr = { \
  207. .mattr = { \
  208. .attr = { \
  209. .name = "version", \
  210. .mode = S_IRUGO, \
  211. }, \
  212. .show = __modver_version_show, \
  213. }, \
  214. .module_name = KBUILD_MODNAME, \
  215. .version = _version, \
  216. }; \
  217. static const struct module_version_attribute \
  218. __used __attribute__ ((__section__ ("__modver"))) \
  219. * __moduleparam_const __modver_attr = &___modver_attr
  220. #endif
  221. /* Optional firmware file (or files) needed by the module
  222. * format is simply firmware file name. Multiple firmware
  223. * files require multiple MODULE_FIRMWARE() specifiers */
  224. #define MODULE_FIRMWARE(_firmware) MODULE_INFO(firmware, _firmware)
  225. struct notifier_block;
  226. #ifdef CONFIG_MODULES
  227. extern int modules_disabled; /* for sysctl */
  228. /* Get/put a kernel symbol (calls must be symmetric) */
  229. void *__symbol_get(const char *symbol);
  230. void *__symbol_get_gpl(const char *symbol);
  231. #define symbol_get(x) ((typeof(&x))(__symbol_get(__stringify(x))))
  232. /* modules using other modules: kdb wants to see this. */
  233. struct module_use {
  234. struct list_head source_list;
  235. struct list_head target_list;
  236. struct module *source, *target;
  237. };
  238. enum module_state {
  239. MODULE_STATE_LIVE, /* Normal state. */
  240. MODULE_STATE_COMING, /* Full formed, running module_init. */
  241. MODULE_STATE_GOING, /* Going away. */
  242. MODULE_STATE_UNFORMED, /* Still setting it up. */
  243. };
  244. struct mod_tree_node {
  245. struct module *mod;
  246. struct latch_tree_node node;
  247. };
  248. struct module_layout {
  249. /* The actual code + data. */
  250. void *base;
  251. /* Total size. */
  252. unsigned int size;
  253. /* The size of the executable code. */
  254. unsigned int text_size;
  255. /* Size of RO section of the module (text+rodata) */
  256. unsigned int ro_size;
  257. /* Size of RO after init section */
  258. unsigned int ro_after_init_size;
  259. #ifdef CONFIG_MODULES_TREE_LOOKUP
  260. struct mod_tree_node mtn;
  261. #endif
  262. };
  263. #ifdef CONFIG_MODULES_TREE_LOOKUP
  264. /* Only touch one cacheline for common rbtree-for-core-layout case. */
  265. #define __module_layout_align ____cacheline_aligned
  266. #else
  267. #define __module_layout_align
  268. #endif
  269. struct mod_kallsyms {
  270. Elf_Sym *symtab;
  271. unsigned int num_symtab;
  272. char *strtab;
  273. };
  274. #ifdef CONFIG_LIVEPATCH
  275. struct klp_modinfo {
  276. Elf_Ehdr hdr;
  277. Elf_Shdr *sechdrs;
  278. char *secstrings;
  279. unsigned int symndx;
  280. };
  281. #endif
  282. struct module {
  283. enum module_state state;
  284. /* Member of list of modules */
  285. struct list_head list;
  286. /* Unique handle for this module */
  287. char name[MODULE_NAME_LEN];
  288. /* Sysfs stuff. */
  289. struct module_kobject mkobj;
  290. struct module_attribute *modinfo_attrs;
  291. const char *version;
  292. const char *srcversion;
  293. struct kobject *holders_dir;
  294. /* Exported symbols */
  295. const struct kernel_symbol *syms;
  296. const s32 *crcs;
  297. unsigned int num_syms;
  298. /* Kernel parameters. */
  299. #ifdef CONFIG_SYSFS
  300. struct mutex param_lock;
  301. #endif
  302. struct kernel_param *kp;
  303. unsigned int num_kp;
  304. /* GPL-only exported symbols. */
  305. unsigned int num_gpl_syms;
  306. const struct kernel_symbol *gpl_syms;
  307. const s32 *gpl_crcs;
  308. #ifdef CONFIG_UNUSED_SYMBOLS
  309. /* unused exported symbols. */
  310. const struct kernel_symbol *unused_syms;
  311. const s32 *unused_crcs;
  312. unsigned int num_unused_syms;
  313. /* GPL-only, unused exported symbols. */
  314. unsigned int num_unused_gpl_syms;
  315. const struct kernel_symbol *unused_gpl_syms;
  316. const s32 *unused_gpl_crcs;
  317. #endif
  318. #ifdef CONFIG_MODULE_SIG
  319. /* Signature was verified. */
  320. bool sig_ok;
  321. #endif
  322. bool async_probe_requested;
  323. /* symbols that will be GPL-only in the near future. */
  324. const struct kernel_symbol *gpl_future_syms;
  325. const s32 *gpl_future_crcs;
  326. unsigned int num_gpl_future_syms;
  327. /* Exception table */
  328. unsigned int num_exentries;
  329. struct exception_table_entry *extable;
  330. /* Startup function. */
  331. int (*init)(void);
  332. /* Core layout: rbtree is accessed frequently, so keep together. */
  333. struct module_layout core_layout __module_layout_align;
  334. struct module_layout init_layout;
  335. /* Arch-specific module values */
  336. struct mod_arch_specific arch;
  337. unsigned long taints; /* same bits as kernel:taint_flags */
  338. #ifdef CONFIG_GENERIC_BUG
  339. /* Support for BUG */
  340. unsigned num_bugs;
  341. struct list_head bug_list;
  342. struct bug_entry *bug_table;
  343. #endif
  344. #ifdef CONFIG_KALLSYMS
  345. /* Protected by RCU and/or module_mutex: use rcu_dereference() */
  346. struct mod_kallsyms *kallsyms;
  347. struct mod_kallsyms core_kallsyms;
  348. /* Section attributes */
  349. struct module_sect_attrs *sect_attrs;
  350. /* Notes attributes */
  351. struct module_notes_attrs *notes_attrs;
  352. #endif
  353. /* The command line arguments (may be mangled). People like
  354. keeping pointers to this stuff */
  355. char *args;
  356. #ifdef CONFIG_SMP
  357. /* Per-cpu data. */
  358. void __percpu *percpu;
  359. unsigned int percpu_size;
  360. #endif
  361. #ifdef CONFIG_TRACEPOINTS
  362. unsigned int num_tracepoints;
  363. struct tracepoint * const *tracepoints_ptrs;
  364. #endif
  365. #ifdef HAVE_JUMP_LABEL
  366. struct jump_entry *jump_entries;
  367. unsigned int num_jump_entries;
  368. #endif
  369. #ifdef CONFIG_TRACING
  370. unsigned int num_trace_bprintk_fmt;
  371. const char **trace_bprintk_fmt_start;
  372. #endif
  373. #ifdef CONFIG_EVENT_TRACING
  374. struct trace_event_call **trace_events;
  375. unsigned int num_trace_events;
  376. struct trace_eval_map **trace_evals;
  377. unsigned int num_trace_evals;
  378. #endif
  379. #ifdef CONFIG_FTRACE_MCOUNT_RECORD
  380. unsigned int num_ftrace_callsites;
  381. unsigned long *ftrace_callsites;
  382. #endif
  383. #ifdef CONFIG_LIVEPATCH
  384. bool klp; /* Is this a livepatch module? */
  385. bool klp_alive;
  386. /* Elf information */
  387. struct klp_modinfo *klp_info;
  388. #endif
  389. #ifdef CONFIG_MODULE_UNLOAD
  390. /* What modules depend on me? */
  391. struct list_head source_list;
  392. /* What modules do I depend on? */
  393. struct list_head target_list;
  394. /* Destruction function. */
  395. void (*exit)(void);
  396. atomic_t refcnt;
  397. #endif
  398. #ifdef CONFIG_CONSTRUCTORS
  399. /* Constructor functions. */
  400. ctor_fn_t *ctors;
  401. unsigned int num_ctors;
  402. #endif
  403. #ifdef CONFIG_FUNCTION_ERROR_INJECTION
  404. struct error_injection_entry *ei_funcs;
  405. unsigned int num_ei_funcs;
  406. #endif
  407. } ____cacheline_aligned __randomize_layout;
  408. #ifndef MODULE_ARCH_INIT
  409. #define MODULE_ARCH_INIT {}
  410. #endif
  411. extern struct mutex module_mutex;
  412. /* FIXME: It'd be nice to isolate modules during init, too, so they
  413. aren't used before they (may) fail. But presently too much code
  414. (IDE & SCSI) require entry into the module during init.*/
  415. static inline bool module_is_live(struct module *mod)
  416. {
  417. return mod->state != MODULE_STATE_GOING;
  418. }
  419. struct module *__module_text_address(unsigned long addr);
  420. struct module *__module_address(unsigned long addr);
  421. bool is_module_address(unsigned long addr);
  422. bool __is_module_percpu_address(unsigned long addr, unsigned long *can_addr);
  423. bool is_module_percpu_address(unsigned long addr);
  424. bool is_module_text_address(unsigned long addr);
  425. static inline bool within_module_core(unsigned long addr,
  426. const struct module *mod)
  427. {
  428. return (unsigned long)mod->core_layout.base <= addr &&
  429. addr < (unsigned long)mod->core_layout.base + mod->core_layout.size;
  430. }
  431. static inline bool within_module_init(unsigned long addr,
  432. const struct module *mod)
  433. {
  434. return (unsigned long)mod->init_layout.base <= addr &&
  435. addr < (unsigned long)mod->init_layout.base + mod->init_layout.size;
  436. }
  437. static inline bool within_module(unsigned long addr, const struct module *mod)
  438. {
  439. return within_module_init(addr, mod) || within_module_core(addr, mod);
  440. }
  441. /* Search for module by name: must hold module_mutex. */
  442. struct module *find_module(const char *name);
  443. struct symsearch {
  444. const struct kernel_symbol *start, *stop;
  445. const s32 *crcs;
  446. enum {
  447. NOT_GPL_ONLY,
  448. GPL_ONLY,
  449. WILL_BE_GPL_ONLY,
  450. } licence;
  451. bool unused;
  452. };
  453. /*
  454. * Search for an exported symbol by name.
  455. *
  456. * Must be called with module_mutex held or preemption disabled.
  457. */
  458. const struct kernel_symbol *find_symbol(const char *name,
  459. struct module **owner,
  460. const s32 **crc,
  461. bool gplok,
  462. bool warn);
  463. /*
  464. * Walk the exported symbol table
  465. *
  466. * Must be called with module_mutex held or preemption disabled.
  467. */
  468. bool each_symbol_section(bool (*fn)(const struct symsearch *arr,
  469. struct module *owner,
  470. void *data), void *data);
  471. /* Returns 0 and fills in value, defined and namebuf, or -ERANGE if
  472. symnum out of range. */
  473. int module_get_kallsym(unsigned int symnum, unsigned long *value, char *type,
  474. char *name, char *module_name, int *exported);
  475. /* Look for this name: can be of form module:name. */
  476. unsigned long module_kallsyms_lookup_name(const char *name);
  477. int module_kallsyms_on_each_symbol(int (*fn)(void *, const char *,
  478. struct module *, unsigned long),
  479. void *data);
  480. extern void __noreturn __module_put_and_exit(struct module *mod,
  481. long code);
  482. #define module_put_and_exit(code) __module_put_and_exit(THIS_MODULE, code)
  483. #ifdef CONFIG_MODULE_UNLOAD
  484. int module_refcount(struct module *mod);
  485. void __symbol_put(const char *symbol);
  486. #define symbol_put(x) __symbol_put(__stringify(x))
  487. void symbol_put_addr(void *addr);
  488. /* Sometimes we know we already have a refcount, and it's easier not
  489. to handle the error case (which only happens with rmmod --wait). */
  490. extern void __module_get(struct module *module);
  491. /* This is the Right Way to get a module: if it fails, it's being removed,
  492. * so pretend it's not there. */
  493. extern bool try_module_get(struct module *module);
  494. extern void module_put(struct module *module);
  495. #else /*!CONFIG_MODULE_UNLOAD*/
  496. static inline bool try_module_get(struct module *module)
  497. {
  498. return !module || module_is_live(module);
  499. }
  500. static inline void module_put(struct module *module)
  501. {
  502. }
  503. static inline void __module_get(struct module *module)
  504. {
  505. }
  506. #define symbol_put(x) do { } while (0)
  507. #define symbol_put_addr(p) do { } while (0)
  508. #endif /* CONFIG_MODULE_UNLOAD */
  509. int ref_module(struct module *a, struct module *b);
  510. /* This is a #define so the string doesn't get put in every .o file */
  511. #define module_name(mod) \
  512. ({ \
  513. struct module *__mod = (mod); \
  514. __mod ? __mod->name : "kernel"; \
  515. })
  516. /* Dereference module function descriptor */
  517. void *dereference_module_function_descriptor(struct module *mod, void *ptr);
  518. /* For kallsyms to ask for address resolution. namebuf should be at
  519. * least KSYM_NAME_LEN long: a pointer to namebuf is returned if
  520. * found, otherwise NULL. */
  521. const char *module_address_lookup(unsigned long addr,
  522. unsigned long *symbolsize,
  523. unsigned long *offset,
  524. char **modname,
  525. char *namebuf);
  526. int lookup_module_symbol_name(unsigned long addr, char *symname);
  527. int lookup_module_symbol_attrs(unsigned long addr, unsigned long *size, unsigned long *offset, char *modname, char *name);
  528. int register_module_notifier(struct notifier_block *nb);
  529. int unregister_module_notifier(struct notifier_block *nb);
  530. extern void print_modules(void);
  531. static inline bool module_requested_async_probing(struct module *module)
  532. {
  533. return module && module->async_probe_requested;
  534. }
  535. #ifdef CONFIG_LIVEPATCH
  536. static inline bool is_livepatch_module(struct module *mod)
  537. {
  538. return mod->klp;
  539. }
  540. #else /* !CONFIG_LIVEPATCH */
  541. static inline bool is_livepatch_module(struct module *mod)
  542. {
  543. return false;
  544. }
  545. #endif /* CONFIG_LIVEPATCH */
  546. bool is_module_sig_enforced(void);
  547. #else /* !CONFIG_MODULES... */
  548. static inline struct module *__module_address(unsigned long addr)
  549. {
  550. return NULL;
  551. }
  552. static inline struct module *__module_text_address(unsigned long addr)
  553. {
  554. return NULL;
  555. }
  556. static inline bool is_module_address(unsigned long addr)
  557. {
  558. return false;
  559. }
  560. static inline bool is_module_percpu_address(unsigned long addr)
  561. {
  562. return false;
  563. }
  564. static inline bool __is_module_percpu_address(unsigned long addr, unsigned long *can_addr)
  565. {
  566. return false;
  567. }
  568. static inline bool is_module_text_address(unsigned long addr)
  569. {
  570. return false;
  571. }
  572. /* Get/put a kernel symbol (calls should be symmetric) */
  573. #define symbol_get(x) ({ extern typeof(x) x __attribute__((weak)); &(x); })
  574. #define symbol_put(x) do { } while (0)
  575. #define symbol_put_addr(x) do { } while (0)
  576. static inline void __module_get(struct module *module)
  577. {
  578. }
  579. static inline bool try_module_get(struct module *module)
  580. {
  581. return true;
  582. }
  583. static inline void module_put(struct module *module)
  584. {
  585. }
  586. #define module_name(mod) "kernel"
  587. /* For kallsyms to ask for address resolution. NULL means not found. */
  588. static inline const char *module_address_lookup(unsigned long addr,
  589. unsigned long *symbolsize,
  590. unsigned long *offset,
  591. char **modname,
  592. char *namebuf)
  593. {
  594. return NULL;
  595. }
  596. static inline int lookup_module_symbol_name(unsigned long addr, char *symname)
  597. {
  598. return -ERANGE;
  599. }
  600. static inline int lookup_module_symbol_attrs(unsigned long addr, unsigned long *size, unsigned long *offset, char *modname, char *name)
  601. {
  602. return -ERANGE;
  603. }
  604. static inline int module_get_kallsym(unsigned int symnum, unsigned long *value,
  605. char *type, char *name,
  606. char *module_name, int *exported)
  607. {
  608. return -ERANGE;
  609. }
  610. static inline unsigned long module_kallsyms_lookup_name(const char *name)
  611. {
  612. return 0;
  613. }
  614. static inline int module_kallsyms_on_each_symbol(int (*fn)(void *, const char *,
  615. struct module *,
  616. unsigned long),
  617. void *data)
  618. {
  619. return 0;
  620. }
  621. static inline int register_module_notifier(struct notifier_block *nb)
  622. {
  623. /* no events will happen anyway, so this can always succeed */
  624. return 0;
  625. }
  626. static inline int unregister_module_notifier(struct notifier_block *nb)
  627. {
  628. return 0;
  629. }
  630. #define module_put_and_exit(code) do_exit(code)
  631. static inline void print_modules(void)
  632. {
  633. }
  634. static inline bool module_requested_async_probing(struct module *module)
  635. {
  636. return false;
  637. }
  638. static inline bool is_module_sig_enforced(void)
  639. {
  640. return false;
  641. }
  642. /* Dereference module function descriptor */
  643. static inline
  644. void *dereference_module_function_descriptor(struct module *mod, void *ptr)
  645. {
  646. return ptr;
  647. }
  648. #endif /* CONFIG_MODULES */
  649. #ifdef CONFIG_SYSFS
  650. extern struct kset *module_kset;
  651. extern struct kobj_type module_ktype;
  652. extern int module_sysfs_initialized;
  653. #endif /* CONFIG_SYSFS */
  654. #define symbol_request(x) try_then_request_module(symbol_get(x), "symbol:" #x)
  655. /* BELOW HERE ALL THESE ARE OBSOLETE AND WILL VANISH */
  656. #define __MODULE_STRING(x) __stringify(x)
  657. #ifdef CONFIG_STRICT_MODULE_RWX
  658. extern void set_all_modules_text_rw(void);
  659. extern void set_all_modules_text_ro(void);
  660. extern void module_enable_ro(const struct module *mod, bool after_init);
  661. extern void module_disable_ro(const struct module *mod);
  662. #else
  663. static inline void set_all_modules_text_rw(void) { }
  664. static inline void set_all_modules_text_ro(void) { }
  665. static inline void module_enable_ro(const struct module *mod, bool after_init) { }
  666. static inline void module_disable_ro(const struct module *mod) { }
  667. #endif
  668. #ifdef CONFIG_GENERIC_BUG
  669. void module_bug_finalize(const Elf_Ehdr *, const Elf_Shdr *,
  670. struct module *);
  671. void module_bug_cleanup(struct module *);
  672. #else /* !CONFIG_GENERIC_BUG */
  673. static inline void module_bug_finalize(const Elf_Ehdr *hdr,
  674. const Elf_Shdr *sechdrs,
  675. struct module *mod)
  676. {
  677. }
  678. static inline void module_bug_cleanup(struct module *mod) {}
  679. #endif /* CONFIG_GENERIC_BUG */
  680. #ifdef RETPOLINE
  681. extern bool retpoline_module_ok(bool has_retpoline);
  682. #else
  683. static inline bool retpoline_module_ok(bool has_retpoline)
  684. {
  685. return true;
  686. }
  687. #endif
  688. #ifdef CONFIG_MODULE_SIG
  689. static inline bool module_sig_ok(struct module *module)
  690. {
  691. return module->sig_ok;
  692. }
  693. #else /* !CONFIG_MODULE_SIG */
  694. static inline bool module_sig_ok(struct module *module)
  695. {
  696. return true;
  697. }
  698. #endif /* CONFIG_MODULE_SIG */
  699. #endif /* _LINUX_MODULE_H */