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