内核驱动常用头文件之--linux/module.h

/*

*写内核驱动的时候 必须加载这个头文件，作用是动态的将模块加载到内核中去

*常用的宏定义如 MODULE_LICESENCE(),MODULE_AUTHOR(),等在此文件中

*而且 kobject，kset结构体题及其操作函数也在这个结构体中，，，其实学习头文件最好的方法就是仔细的看头文件--看看有哪些功能就好用的时候再查阅

*

*

*/

#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/list.h>
#include <linux/stat.h>
#include <linux/compiler.h>
#include <linux/cache.h>
#include <linux/kmod.h>
#include <linux/elf.h>
#include <linux/stringify.h>
#include <linux/kobject.h>
#include <linux/moduleparam.h>
#include <linux/tracepoint.h>


#include <linux/percpu.h>
#include <asm/module.h>


#include <trace/events/module.h>


/* Not Yet Implemented */
#define MODULE_SUPPORTED_DEVICE(name)


/* Some toolchains use a `_' prefix for all user symbols. */
#ifdef CONFIG_SYMBOL_PREFIX
#define MODULE_SYMBOL_PREFIX CONFIG_SYMBOL_PREFIX
#else
#define MODULE_SYMBOL_PREFIX ""
#endif


#define MODULE_NAME_LEN MAX_PARAM_PREFIX_LEN


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);
void (*setup)(struct module *, const char *);
int (*test)(struct module *);
void (*free)(struct module *);
};


struct module_version_attribute {
struct module_attribute mattr;
const char *module_name;
const char *version;
} __attribute__ ((__aligned__(sizeof(void *))));


struct module_kobject
{
struct kobject kobj;
struct module *mod;
struct kobject *drivers_dir;
struct module_param_attrs *mp;
};


/* 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);
void trim_init_extable(struct module *m);


#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 MIT/GPL" [GNU Public License v2
 * or MIT 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(s), use "Name <email>" or just "Name", for multiple
 * authors use multiple MODULE_AUTHOR() statements/lines.
 */
#define MODULE_AUTHOR(_author) MODULE_IN