linux/include/linux/module.h
<<
>>
Prefs
   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/elf.h>
  15#include <linux/stringify.h>
  16#include <linux/kobject.h>
  17#include <linux/moduleparam.h>
  18#include <linux/marker.h>
  19#include <linux/tracepoint.h>
  20#include <asm/local.h>
  21
  22#include <asm/module.h>
  23
  24/* Not Yet Implemented */
  25#define MODULE_SUPPORTED_DEVICE(name)
  26
  27/* some toolchains uses a `_' prefix for all user symbols */
  28#ifndef MODULE_SYMBOL_PREFIX
  29#define MODULE_SYMBOL_PREFIX ""
  30#endif
  31
  32#define MODULE_NAME_LEN MAX_PARAM_PREFIX_LEN
  33
  34struct kernel_symbol
  35{
  36        unsigned long value;
  37        const char *name;
  38};
  39
  40struct modversion_info
  41{
  42        unsigned long crc;
  43        char name[MODULE_NAME_LEN];
  44};
  45
  46struct module;
  47
  48struct module_attribute {
  49        struct attribute attr;
  50        ssize_t (*show)(struct module_attribute *, struct module *, char *);
  51        ssize_t (*store)(struct module_attribute *, struct module *,
  52                         const char *, size_t count);
  53        void (*setup)(struct module *, const char *);
  54        int (*test)(struct module *);
  55        void (*free)(struct module *);
  56};
  57
  58struct module_kobject
  59{
  60        struct kobject kobj;
  61        struct module *mod;
  62        struct kobject *drivers_dir;
  63        struct module_param_attrs *mp;
  64};
  65
  66/* These are either module local, or the kernel's dummy ones. */
  67extern int init_module(void);
  68extern void cleanup_module(void);
  69
  70/* Archs provide a method of finding the correct exception table. */
  71struct exception_table_entry;
  72
  73const struct exception_table_entry *
  74search_extable(const struct exception_table_entry *first,
  75               const struct exception_table_entry *last,
  76               unsigned long value);
  77void sort_extable(struct exception_table_entry *start,
  78                  struct exception_table_entry *finish);
  79void sort_main_extable(void);
  80
  81#ifdef MODULE
  82#define MODULE_GENERIC_TABLE(gtype,name)                        \
  83extern const struct gtype##_id __mod_##gtype##_table            \
  84  __attribute__ ((unused, alias(__stringify(name))))
  85
  86extern struct module __this_module;
  87#define THIS_MODULE (&__this_module)
  88#else  /* !MODULE */
  89#define MODULE_GENERIC_TABLE(gtype,name)
  90#define THIS_MODULE ((struct module *)0)
  91#endif
  92
  93/* Generic info of form tag = "info" */
  94#define MODULE_INFO(tag, info) __MODULE_INFO(tag, tag, info)
  95
  96/* For userspace: you can also call me... */
  97#define MODULE_ALIAS(_alias) MODULE_INFO(alias, _alias)
  98
  99/*
 100 * The following license idents are currently accepted as indicating free
 101 * software modules
 102 *
 103 *      "GPL"                           [GNU Public License v2 or later]
 104 *      "GPL v2"                        [GNU Public License v2]
 105 *      "GPL and additional rights"     [GNU Public License v2 rights and more]
 106 *      "Dual BSD/GPL"                  [GNU Public License v2
 107 *                                       or BSD license choice]
 108 *      "Dual MIT/GPL"                  [GNU Public License v2
 109 *                                       or MIT license choice]
 110 *      "Dual MPL/GPL"                  [GNU Public License v2
 111 *                                       or Mozilla license choice]
 112 *
 113 * The following other idents are available
 114 *
 115 *      "Proprietary"                   [Non free products]
 116 *
 117 * There are dual licensed components, but when running with Linux it is the
 118 * GPL that is relevant so this is a non issue. Similarly LGPL linked with GPL
 119 * is a GPL combined work.
 120 *
 121 * This exists for several reasons
 122 * 1.   So modinfo can show license info for users wanting to vet their setup 
 123 *      is free
 124 * 2.   So the community can ignore bug reports including proprietary modules
 125 * 3.   So vendors can do likewise based on their own policies
 126 */
 127#define MODULE_LICENSE(_license) MODULE_INFO(license, _license)
 128
 129/* Author, ideally of form NAME[, NAME]*[ and NAME] */
 130#define MODULE_AUTHOR(_author) MODULE_INFO(author, _author)
 131  
 132/* What your module does. */
 133#define MODULE_DESCRIPTION(_description) MODULE_INFO(description, _description)
 134
 135/* One for each parameter, describing how to use it.  Some files do
 136   multiple of these per line, so can't just use MODULE_INFO. */
 137#define MODULE_PARM_DESC(_parm, desc) \
 138        __MODULE_INFO(parm, _parm, #_parm ":" desc)
 139
 140#define MODULE_DEVICE_TABLE(type,name)          \
 141  MODULE_GENERIC_TABLE(type##_device,name)
 142
 143/* Version of form [<epoch>:]<version>[-<extra-version>].
 144   Or for CVS/RCS ID version, everything but the number is stripped.
 145  <epoch>: A (small) unsigned integer which allows you to start versions
 146           anew. If not mentioned, it's zero.  eg. "2:1.0" is after
 147           "1:2.0".
 148  <version>: The <version> may contain only alphanumerics and the
 149           character `.'.  Ordered by numeric sort for numeric parts,
 150           ascii sort for ascii parts (as per RPM or DEB algorithm).
 151  <extraversion>: Like <version>, but inserted for local
 152           customizations, eg "rh3" or "rusty1".
 153
 154  Using this automatically adds a checksum of the .c files and the
 155  local headers in "srcversion".
 156*/
 157#define MODULE_VERSION(_version) MODULE_INFO(version, _version)
 158
 159/* Optional firmware file (or files) needed by the module
 160 * format is simply firmware file name.  Multiple firmware
 161 * files require multiple MODULE_FIRMWARE() specifiers */
 162#define MODULE_FIRMWARE(_firmware) MODULE_INFO(firmware, _firmware)
 163
 164/* Given an address, look for it in the exception tables */
 165const struct exception_table_entry *search_exception_tables(unsigned long add);
 166
 167struct notifier_block;
 168
 169#ifdef CONFIG_MODULES
 170
 171/* Get/put a kernel symbol (calls must be symmetric) */
 172void *__symbol_get(const char *symbol);
 173void *__symbol_get_gpl(const char *symbol);
 174#define symbol_get(x) ((typeof(&x))(__symbol_get(MODULE_SYMBOL_PREFIX #x)))
 175
 176#ifndef __GENKSYMS__
 177#ifdef CONFIG_MODVERSIONS
 178/* Mark the CRC weak since genksyms apparently decides not to
 179 * generate a checksums for some symbols */
 180#define __CRC_SYMBOL(sym, sec)                                  \
 181        extern void *__crc_##sym __attribute__((weak));         \
 182        static const unsigned long __kcrctab_##sym              \
 183        __used                                                  \
 184        __attribute__((section("__kcrctab" sec), unused))       \
 185        = (unsigned long) &__crc_##sym;
 186#else
 187#define __CRC_SYMBOL(sym, sec)
 188#endif
 189
 190/* For every exported symbol, place a struct in the __ksymtab section */
 191#define __EXPORT_SYMBOL(sym, sec)                               \
 192        extern typeof(sym) sym;                                 \
 193        __CRC_SYMBOL(sym, sec)                                  \
 194        static const char __kstrtab_##sym[]                     \
 195        __attribute__((section("__ksymtab_strings"), aligned(1))) \
 196        = MODULE_SYMBOL_PREFIX #sym;                            \
 197        static const struct kernel_symbol __ksymtab_##sym       \
 198        __used                                                  \
 199        __attribute__((section("__ksymtab" sec), unused))       \
 200        = { (unsigned long)&sym, __kstrtab_##sym }
 201
 202#define EXPORT_SYMBOL(sym)                                      \
 203        __EXPORT_SYMBOL(sym, "")
 204
 205#define EXPORT_SYMBOL_GPL(sym)                                  \
 206        __EXPORT_SYMBOL(sym, "_gpl")
 207
 208#define EXPORT_SYMBOL_GPL_FUTURE(sym)                           \
 209        __EXPORT_SYMBOL(sym, "_gpl_future")
 210
 211
 212#ifdef CONFIG_UNUSED_SYMBOLS
 213#define EXPORT_UNUSED_SYMBOL(sym) __EXPORT_SYMBOL(sym, "_unused")
 214#define EXPORT_UNUSED_SYMBOL_GPL(sym) __EXPORT_SYMBOL(sym, "_unused_gpl")
 215#else
 216#define EXPORT_UNUSED_SYMBOL(sym)
 217#define EXPORT_UNUSED_SYMBOL_GPL(sym)
 218#endif
 219
 220#endif
 221
 222enum module_state
 223{
 224        MODULE_STATE_LIVE,
 225        MODULE_STATE_COMING,
 226        MODULE_STATE_GOING,
 227};
 228
 229struct module
 230{
 231        enum module_state state;
 232
 233        /* Member of list of modules */
 234        struct list_head list;
 235
 236        /* Unique handle for this module */
 237        char name[MODULE_NAME_LEN];
 238
 239        /* Sysfs stuff. */
 240        struct module_kobject mkobj;
 241        struct module_attribute *modinfo_attrs;
 242        const char *version;
 243        const char *srcversion;
 244        struct kobject *holders_dir;
 245
 246        /* Exported symbols */
 247        const struct kernel_symbol *syms;
 248        const unsigned long *crcs;
 249        unsigned int num_syms;
 250
 251        /* GPL-only exported symbols. */
 252        unsigned int num_gpl_syms;
 253        const struct kernel_symbol *gpl_syms;
 254        const unsigned long *gpl_crcs;
 255
 256#ifdef CONFIG_UNUSED_SYMBOLS
 257        /* unused exported symbols. */
 258        const struct kernel_symbol *unused_syms;
 259        const unsigned long *unused_crcs;
 260        unsigned int num_unused_syms;
 261
 262        /* GPL-only, unused exported symbols. */
 263        unsigned int num_unused_gpl_syms;
 264        const struct kernel_symbol *unused_gpl_syms;
 265        const unsigned long *unused_gpl_crcs;
 266#endif
 267
 268        /* symbols that will be GPL-only in the near future. */
 269        const struct kernel_symbol *gpl_future_syms;
 270        const unsigned long *gpl_future_crcs;
 271        unsigned int num_gpl_future_syms;
 272
 273        /* Exception table */
 274        unsigned int num_exentries;
 275        struct exception_table_entry *extable;
 276
 277        /* Startup function. */
 278        int (*init)(void);
 279
 280        /* If this is non-NULL, vfree after init() returns */
 281        void *module_init;
 282
 283        /* Here is the actual code + data, vfree'd on unload. */
 284        void *module_core;
 285
 286        /* Here are the sizes of the init and core sections */
 287        unsigned int init_size, core_size;
 288
 289        /* The size of the executable code in each section.  */
 290        unsigned int init_text_size, core_text_size;
 291
 292        /* Arch-specific module values */
 293        struct mod_arch_specific arch;
 294
 295        unsigned int taints;    /* same bits as kernel:tainted */
 296
 297#ifdef CONFIG_GENERIC_BUG
 298        /* Support for BUG */
 299        unsigned num_bugs;
 300        struct list_head bug_list;
 301        struct bug_entry *bug_table;
 302#endif
 303
 304#ifdef CONFIG_KALLSYMS
 305        /* We keep the symbol and string tables for kallsyms. */
 306        Elf_Sym *symtab;
 307        unsigned int num_symtab;
 308        char *strtab;
 309
 310        /* Section attributes */
 311        struct module_sect_attrs *sect_attrs;
 312
 313        /* Notes attributes */
 314        struct module_notes_attrs *notes_attrs;
 315#endif
 316
 317        /* Per-cpu data. */
 318        void *percpu;
 319
 320        /* The command line arguments (may be mangled).  People like
 321           keeping pointers to this stuff */
 322        char *args;
 323#ifdef CONFIG_MARKERS
 324        struct marker *markers;
 325        unsigned int num_markers;
 326#endif
 327#ifdef CONFIG_TRACEPOINTS
 328        struct tracepoint *tracepoints;
 329        unsigned int num_tracepoints;
 330#endif
 331
 332#ifdef CONFIG_MODULE_UNLOAD
 333        /* What modules depend on me? */
 334        struct list_head modules_which_use_me;
 335
 336        /* Who is waiting for us to be unloaded */
 337        struct task_struct *waiter;
 338
 339        /* Destruction function. */
 340        void (*exit)(void);
 341
 342#ifdef CONFIG_SMP
 343        char *refptr;
 344#else
 345        local_t ref;
 346#endif
 347#endif
 348};
 349#ifndef MODULE_ARCH_INIT
 350#define MODULE_ARCH_INIT {}
 351#endif
 352
 353/* FIXME: It'd be nice to isolate modules during init, too, so they
 354   aren't used before they (may) fail.  But presently too much code
 355   (IDE & SCSI) require entry into the module during init.*/
 356static inline int module_is_live(struct module *mod)
 357{
 358        return mod->state != MODULE_STATE_GOING;
 359}
 360
 361/* Is this address in a module? (second is with no locks, for oops) */
 362struct module *module_text_address(unsigned long addr);
 363struct module *__module_text_address(unsigned long addr);
 364int is_module_address(unsigned long addr);
 365
 366static inline int within_module_core(unsigned long addr, struct module *mod)
 367{
 368        return (unsigned long)mod->module_core <= addr &&
 369               addr < (unsigned long)mod->module_core + mod->core_size;
 370}
 371
 372static inline int within_module_init(unsigned long addr, struct module *mod)
 373{
 374        return (unsigned long)mod->module_init <= addr &&
 375               addr < (unsigned long)mod->module_init + mod->init_size;
 376}
 377
 378/* Returns 0 and fills in value, defined and namebuf, or -ERANGE if
 379   symnum out of range. */
 380int module_get_kallsym(unsigned int symnum, unsigned long *value, char *type,
 381                        char *name, char *module_name, int *exported);
 382
 383/* Look for this name: can be of form module:name. */
 384unsigned long module_kallsyms_lookup_name(const char *name);
 385
 386extern void __module_put_and_exit(struct module *mod, long code)
 387        __attribute__((noreturn));
 388#define module_put_and_exit(code) __module_put_and_exit(THIS_MODULE, code);
 389
 390#ifdef CONFIG_MODULE_UNLOAD
 391unsigned int module_refcount(struct module *mod);
 392void __symbol_put(const char *symbol);
 393#define symbol_put(x) __symbol_put(MODULE_SYMBOL_PREFIX #x)
 394void symbol_put_addr(void *addr);
 395
 396static inline local_t *__module_ref_addr(struct module *mod, int cpu)
 397{
 398#ifdef CONFIG_SMP
 399        return (local_t *) (mod->refptr + per_cpu_offset(cpu));
 400#else
 401        return &mod->ref;
 402#endif
 403}
 404
 405/* Sometimes we know we already have a refcount, and it's easier not
 406   to handle the error case (which only happens with rmmod --wait). */
 407static inline void __module_get(struct module *module)
 408{
 409        if (module) {
 410                local_inc(__module_ref_addr(module, get_cpu()));
 411                put_cpu();
 412        }
 413}
 414
 415static inline int try_module_get(struct module *module)
 416{
 417        int ret = 1;
 418
 419        if (module) {
 420                unsigned int cpu = get_cpu();
 421                if (likely(module_is_live(module)))
 422                        local_inc(__module_ref_addr(module, cpu));
 423                else
 424                        ret = 0;
 425                put_cpu();
 426        }
 427        return ret;
 428}
 429
 430extern void module_put(struct module *module);
 431
 432#else /*!CONFIG_MODULE_UNLOAD*/
 433static inline int try_module_get(struct module *module)
 434{
 435        return !module || module_is_live(module);
 436}
 437static inline void module_put(struct module *module)
 438{
 439}
 440static inline void __module_get(struct module *module)
 441{
 442}
 443#define symbol_put(x) do { } while(0)
 444#define symbol_put_addr(p) do { } while(0)
 445
 446#endif /* CONFIG_MODULE_UNLOAD */
 447
 448/* This is a #define so the string doesn't get put in every .o file */
 449#define module_name(mod)                        \
 450({                                              \
 451        struct module *__mod = (mod);           \
 452        __mod ? __mod->name : "kernel";         \
 453})
 454
 455/* For kallsyms to ask for address resolution.  namebuf should be at
 456 * least KSYM_NAME_LEN long: a pointer to namebuf is returned if
 457 * found, otherwise NULL. */
 458const char *module_address_lookup(unsigned long addr,
 459                            unsigned long *symbolsize,
 460                            unsigned long *offset,
 461                            char **modname,
 462                            char *namebuf);
 463int lookup_module_symbol_name(unsigned long addr, char *symname);
 464int lookup_module_symbol_attrs(unsigned long addr, unsigned long *size, unsigned long *offset, char *modname, char *name);
 465
 466/* For extable.c to search modules' exception tables. */
 467const struct exception_table_entry *search_module_extables(unsigned long addr);
 468
 469int register_module_notifier(struct notifier_block * nb);
 470int unregister_module_notifier(struct notifier_block * nb);
 471
 472extern void print_modules(void);
 473
 474extern void module_update_markers(void);
 475
 476extern void module_update_tracepoints(void);
 477extern int module_get_iter_tracepoints(struct tracepoint_iter *iter);
 478
 479#else /* !CONFIG_MODULES... */
 480#define EXPORT_SYMBOL(sym)
 481#define EXPORT_SYMBOL_GPL(sym)
 482#define EXPORT_SYMBOL_GPL_FUTURE(sym)
 483#define EXPORT_UNUSED_SYMBOL(sym)
 484#define EXPORT_UNUSED_SYMBOL_GPL(sym)
 485
 486/* Given an address, look for it in the exception tables. */
 487static inline const struct exception_table_entry *
 488search_module_extables(unsigned long addr)
 489{
 490        return NULL;
 491}
 492
 493/* Is this address in a module? */
 494static inline struct module *module_text_address(unsigned long addr)
 495{
 496        return NULL;
 497}
 498
 499/* Is this address in a module? (don't take a lock, we're oopsing) */
 500static inline struct module *__module_text_address(unsigned long addr)
 501{
 502        return NULL;
 503}
 504
 505static inline int is_module_address(unsigned long addr)
 506{
 507        return 0;
 508}
 509
 510/* Get/put a kernel symbol (calls should be symmetric) */
 511#define symbol_get(x) ({ extern typeof(x) x __attribute__((weak)); &(x); })
 512#define symbol_put(x) do { } while(0)
 513#define symbol_put_addr(x) do { } while(0)
 514
 515static inline void __module_get(struct module *module)
 516{
 517}
 518
 519static inline int try_module_get(struct module *module)
 520{
 521        return 1;
 522}
 523
 524static inline void module_put(struct module *module)
 525{
 526}
 527
 528#define module_name(mod) "kernel"
 529
 530/* For kallsyms to ask for address resolution.  NULL means not found. */
 531static inline const char *module_address_lookup(unsigned long addr,
 532                                          unsigned long *symbolsize,
 533                                          unsigned long *offset,
 534                                          char **modname,
 535                                          char *namebuf)
 536{
 537        return NULL;
 538}
 539
 540static inline int lookup_module_symbol_name(unsigned long addr, char *symname)
 541{
 542        return -ERANGE;
 543}
 544
 545static inline int lookup_module_symbol_attrs(unsigned long addr, unsigned long *size, unsigned long *offset, char *modname, char *name)
 546{
 547        return -ERANGE;
 548}
 549
 550static inline int module_get_kallsym(unsigned int symnum, unsigned long *value,
 551                                        char *type, char *name,
 552                                        char *module_name, int *exported)
 553{
 554        return -ERANGE;
 555}
 556
 557static inline unsigned long module_kallsyms_lookup_name(const char *name)
 558{
 559        return 0;
 560}
 561
 562static inline int register_module_notifier(struct notifier_block * nb)
 563{
 564        /* no events will happen anyway, so this can always succeed */
 565        return 0;
 566}
 567
 568static inline int unregister_module_notifier(struct notifier_block * nb)
 569{
 570        return 0;
 571}
 572
 573#define module_put_and_exit(code) do_exit(code)
 574
 575static inline void print_modules(void)
 576{
 577}
 578
 579static inline void module_update_markers(void)
 580{
 581}
 582
 583static inline void module_update_tracepoints(void)
 584{
 585}
 586
 587static inline int module_get_iter_tracepoints(struct tracepoint_iter *iter)
 588{
 589        return 0;
 590}
 591
 592#endif /* CONFIG_MODULES */
 593
 594struct device_driver;
 595#ifdef CONFIG_SYSFS
 596struct module;
 597
 598extern struct kset *module_kset;
 599extern struct kobj_type module_ktype;
 600extern int module_sysfs_initialized;
 601
 602int mod_sysfs_init(struct module *mod);
 603int mod_sysfs_setup(struct module *mod,
 604                           struct kernel_param *kparam,
 605                           unsigned int num_params);
 606int module_add_modinfo_attrs(struct module *mod);
 607void module_remove_modinfo_attrs(struct module *mod);
 608
 609#else /* !CONFIG_SYSFS */
 610
 611static inline int mod_sysfs_init(struct module *mod)
 612{
 613        return 0;
 614}
 615
 616static inline int mod_sysfs_setup(struct module *mod,
 617                           struct kernel_param *kparam,
 618                           unsigned int num_params)
 619{
 620        return 0;
 621}
 622
 623static inline int module_add_modinfo_attrs(struct module *mod)
 624{
 625        return 0;
 626}
 627
 628static inline void module_remove_modinfo_attrs(struct module *mod)
 629{ }
 630
 631#endif /* CONFIG_SYSFS */
 632
 633#define symbol_request(x) try_then_request_module(symbol_get(x), "symbol:" #x)
 634
 635/* BELOW HERE ALL THESE ARE OBSOLETE AND WILL VANISH */
 636
 637#define __MODULE_STRING(x) __stringify(x)
 638
 639#endif /* _LINUX_MODULE_H */
 640
lxr.linux.no kindly hosted by Redpill Linpro AS, provider of Linux consulting and operations services since 1995.