📄 module.h
字号:
#ifndef _LINUX_MODULE_H#define _LINUX_MODULE_H/* * Dynamic loading of modules into the kernel. * * Rewritten by Richard Henderson <rth@tamu.edu> Dec 1996 * Rewritten again by Rusty Russell, 2002 */#include <linux/sched.h>#include <linux/cache.h>#include <linux/kmod.h>#include <linux/stringify.h>#include <linux/moduleparam.h>/* Not Yet Implemented */#define MODULE_SUPPORTED_DEVICE(name)/* v850 toolchain uses a `_' prefix for all user symbols */#ifndef MODULE_SYMBOL_PREFIX#define MODULE_SYMBOL_PREFIX ""#endif#define MODULE_NAME_LEN (64 - sizeof(unsigned long))struct kernel_symbol{ unsigned long value; const char *name;};struct modversion_info{ unsigned long crc; char name[MODULE_NAME_LEN];};struct module;struct module_attribute { struct attribute attr; ssize_t (*show)(struct module_attribute *, struct module *, char *); ssize_t (*store)(struct module_attribute *, struct module *, const char *, size_t count);};struct module_kobject{ struct kobject kobj; struct module *mod;};/* These are either module local, or the kernel's dummy ones. */extern int init_module(void);extern void cleanup_module(void);/* Archs provide a method of finding the correct exception table. */struct exception_table_entry;const struct exception_table_entry *search_extable(const struct exception_table_entry *first, const struct exception_table_entry *last, unsigned long value);void sort_extable(struct exception_table_entry *start, struct exception_table_entry *finish);void sort_main_extable(void);extern struct subsystem module_subsys;#ifdef MODULE#define MODULE_GENERIC_TABLE(gtype,name) \extern const struct gtype##_id __mod_##gtype##_table \ __attribute__ ((unused, alias(__stringify(name))))extern struct module __this_module;#define THIS_MODULE (&__this_module)#else /* !MODULE */#define MODULE_GENERIC_TABLE(gtype,name)#define THIS_MODULE ((struct module *)0)#endif/* Generic info of form tag = "info" */#define MODULE_INFO(tag, info) __MODULE_INFO(tag, tag, info)/* For userspace: you can also call me... */#define MODULE_ALIAS(_alias) MODULE_INFO(alias, _alias)/* * The following license idents are currently accepted as indicating free * software modules * * "GPL" [GNU Public License v2 or later] * "GPL v2" [GNU Public License v2] * "GPL and additional rights" [GNU Public License v2 rights and more] * "Dual BSD/GPL" [GNU Public License v2 * or BSD license choice] * "Dual MPL/GPL" [GNU Public License v2 * or Mozilla license choice] * * The following other idents are available * * "Proprietary" [Non free products] * * There are dual licensed components, but when running with Linux it is the * GPL that is relevant so this is a non issue. Similarly LGPL linked with GPL * is a GPL combined work. * * This exists for several reasons * 1. So modinfo can show license info for users wanting to vet their setup * is free * 2. So the community can ignore bug reports including proprietary modules * 3. So vendors can do likewise based on their own policies */#define MODULE_LICENSE(_license) MODULE_INFO(license, _license)/* Author, ideally of form NAME <EMAIL>[, NAME <EMAIL>]*[ and NAME <EMAIL>] */#define MODULE_AUTHOR(_author) MODULE_INFO(author, _author) /* What your module does. */#define MODULE_DESCRIPTION(_description) MODULE_INFO(description, _description)/* One for each parameter, describing how to use it. Some files do multiple of these per line, so can't just use MODULE_INFO. */#define MODULE_PARM_DESC(_parm, desc) \ __MODULE_INFO(parm, _parm, #_parm ":" desc)#define MODULE_DEVICE_TABLE(type,name) \ MODULE_GENERIC_TABLE(type##_device,name)/* Version of form [<epoch>:]<version>[-<extra-version>]. Or for CVS/RCS ID version, everything but the number is stripped. <epoch>: A (small) unsigned integer which allows you to start versions anew. If not mentioned, it's zero. eg. "2:1.0" is after "1:2.0". <version>: The <version> may contain only alphanumerics and the character `.'. Ordered by numeric sort for numeric parts, ascii sort for ascii parts (as per RPM or DEB algorithm). <extraversion>: Like <version>, but inserted for local customizations, eg "rh3" or "rusty1". Using this automatically adds a checksum of the .c files and the local headers in "srcversion".*/#define MODULE_VERSION(_version) MODULE_INFO(version, _version)/* Given an address, look for it in the exception tables */const struct exception_table_entry *search_exception_tables(unsigned long add);struct notifier_block;#ifdef CONFIG_MODULES/* Get/put a kernel symbol (calls must be symmetric) */void *__symbol_get(const char *symbol);void *__symbol_get_gpl(const char *symbol);#define symbol_get(x) ((typeof(&x))(__symbol_get(MODULE_SYMBOL_PREFIX #x)))#ifndef __GENKSYMS__#ifdef CONFIG_MODVERSIONS/* Mark the CRC weak since genksyms apparently decides not to * generate a checksums for some symbols */#define __CRC_SYMBOL(sym, sec) \ extern void *__crc_##sym __attribute__((weak)); \ static const unsigned long __kcrctab_##sym \ __attribute__((section("__kcrctab" sec), unused)) \ = (unsigned long) &__crc_##sym;#else#define __CRC_SYMBOL(sym, sec)#endif/* For every exported symbol, place a struct in the __ksymtab section */#define __EXPORT_SYMBOL(sym, sec) \ __CRC_SYMBOL(sym, sec) \ static const char __kstrtab_##sym[] \ __attribute__((section("__ksymtab_strings"))) \ = MODULE_SYMBOL_PREFIX #sym; \ static const struct kernel_symbol __ksymtab_##sym \ __attribute__((section("__ksymtab" sec), unused)) \ = { (unsigned long)&sym, __kstrtab_##sym }#define EXPORT_SYMBOL(sym) \ __EXPORT_SYMBOL(sym, "")#define EXPORT_SYMBOL_GPL(sym) \ __EXPORT_SYMBOL(sym, "_gpl")#endifstruct module_ref{ local_t count;} ____cacheline_aligned;enum module_state{ MODULE_STATE_LIVE, MODULE_STATE_COMING, MODULE_STATE_GOING,};/* Similar stuff for section attributes. */#define MODULE_SECT_NAME_LEN 32struct module_sect_attr{ struct module_attribute mattr; char name[MODULE_SECT_NAME_LEN]; unsigned long address;};struct module_sect_attrs{ struct attribute_group grp; struct module_sect_attr attrs[0];};struct module_param_attrs;struct module{ enum module_state state; /* Member of list of modules */ struct list_head list; /* Unique handle for this module */ char name[MODULE_NAME_LEN]; /* Sysfs stuff. */ struct module_kobject mkobj; struct module_param_attrs *param_attrs; /* Exported symbols */ const struct kernel_symbol *syms; unsigned int num_syms; const unsigned long *crcs; /* GPL-only exported symbols. */ const struct kernel_symbol *gpl_syms; unsigned int num_gpl_syms; const unsigned long *gpl_crcs; /* Exception table */ unsigned int num_exentries; const struct exception_table_entry *extable; /* Startup function. */ int (*init)(void); /* If this is non-NULL, vfree after init() returns */ void *module_init; /* Here is the actual code + data, vfree'd on unload. */ void *module_core; /* Here are the sizes of the init and core sections */ unsigned long init_size, core_size; /* The size of the executable code in each section. */ unsigned long init_text_size, core_text_size; /* Arch-specific module values */ struct mod_arch_specific arch; /* Am I unsafe to unload? */ int unsafe; /* Am I GPL-compatible */ int license_gplok;#ifdef CONFIG_MODULE_UNLOAD /* Reference counts */ struct module_ref ref[NR_CPUS]; /* What modules depend on me? */ struct list_head modules_which_use_me; /* Who is waiting for us to be unloaded */ struct task_struct *waiter; /* Destruction function. */ void (*exit)(void);#endif#ifdef CONFIG_KALLSYMS /* We keep the symbol and string tables for kallsyms. */ Elf_Sym *symtab; unsigned long num_symtab; char *strtab;
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -