Loadable module support  --->

  [*] Enable loadable module support
  [*]   Module unloading
  [ ]   Module versioning support (EXPERIMENTAL)
  [*]   Automatic kernel module loading

#include 
#include 
#include 

static int __init mymodule_init(void)
{
    printk ("My module worked!＼n");
    return 0;
}

static void __exit mymodule_exit(void)
{
    printk ("Unloading my module.＼n");
    return;
}

module_init(mymodule_init);
module_exit(mymodule_exit);

MODULE_LICENSE("GPL");

obj-m += mymodule.o

# make -C  SUBDIRS=$PWD modules

My module worked!

Unloading my module.

int my_variable = 0;

extern int my_variable;
printk ("my_variable is %d＼n", my_variable);
my_variable++;

# make -C  SUBDIRS=$PWD modules

insmod: error inserting ’./mymodule.ko’: -1 Unknown symbol in module

EXPORT_SYMBOL(my_variable);

my_variable is 0
My module worked!

# rmmod mymodule && insmod ./mymodule.ko

Unloading my module.
my_variable is 1
My module worked!

if (do_print) {
    printk ("Big long obnoxious message＼n");
}

insmod module.ko [param1=value param2=value ...]

b       byte
h       short
i       int
l       long
s       string

编写使用中断的模块

现在我们将编写一个模块，其中有一个函数，当内核接收到某个 IRQ 上的一个中断时会调用他。首先，将文档 mymodule.c 拷贝到 myirqtest.c，然后删除函数的内容，只保留返回语句。在编辑器中打开 myirqtest.c，并使用“myirqtest”替换所出现的“mymodule”来修改函数名。另外删除 printk。为了能够使用中断，将下面一行：

#include 

加入到文档的顶部。

使用 cat /proc/interrupts 找出正在使用的中断。第一列显示出正在使用的中断号，第二列是机器自最后一次引导后在那个 IRQ 上发行了多少次中断，第三列是使用这个 IRQ 的设备。在这个示例中，我们将研究来自网络接口的中断，并使用两个模块参数 interface 和 irq 来指明我们要使用的接口和 IRQ 行。

为了使用模块参数，要声明两个变量来存放他们，并使用 MODULE_PARM 和 MODULE_PARM_DESC 来捕获参数。此代码应该放置在任何函数之外的某个地方：

static int irq;
static char *interface;

MODULE_PARM(interface, "s");
MODULE_PARM_DESC(interface, "A network interface");
MODULE_PARM(irq, "i");
MODULE_PARM_DESC(irq, "The IRQ of the network interface");

函数 request_irq() 将您的函数添加到选定的 IRQ 行的处理程式列表，每当接收到那个行上的一个中断时，能够使用他打印一条消息。现在，我们需要在函数 myirqtest_init 中请求网络设备的 IRQ。 request_irq 的定义如下：

int request_irq(unsigned int irq,
    void (*handler)(int, void *, struct pt_regs *),
    unsigned long irqflags,
    const char *devname,
    void *dev_id);

irq 是中断号。我们将使用从模块参数获得的值。handler 是个指针，指向处理中断的函数。我们将使用 SA_SHIRQ 作为 irqflags 的值，表明我们的处理程式支持和其他处理程式共享 IRQ。 devname 是设备的简称，显示在 /proc/interrupts 列表中。我们将使用 interface 变量中的值，他是作为模块参数接收到的。

dev_id 参数是设备 ID。这个参数通常配置为 NULL，但是，假如需要共享 IRQ，以使得稍后那个 IRQ 被 free_irq() 释放时，正确的设备会被放开，那么他需要是 non-NULL 的。由于他是 void *，所以他能够指向任何内容，但是，通常的做法是传递驱动程式的设备结构体。在此，我们将使用一个指向 irq 变量的指针。

假如成功，request_irq() 将返回 0。

编写完代码后，myirqtest_init() 应该类似如下：

static int __init myirqtest_init(void)
{
    if (request_irq(irq, &myinterrupt, SA_SHIRQ, interface, &irq)) {
        printk(KERN_ERR "myirqtest: cannot register IRQ %d＼n", irq);
        return -EIO;
    }
    printk("Request on IRQ %d succeeded＼n", irq);

    return 0;
}

假如 request_irq() 没有返回 0，则是出了一些错误， IRQ 不能被注册，所以我们打印一条错误消息并返回错误代码。

现在，当卸载那个模块时，我们还需要释放那个 IRQ。此任务由 free_irq 来完成，他使用中断号和设备 ID 作为参数。中断号保存在 irq 变量中，并且我们使用指向他的指针做为设备 ID，所以需要做的就是将下面的代码添加到 myirqtest_exit() 的开头：

    free_irq(irq, &irq);
    printk("Freeing IRQ %d＼n", irq);

其余要做的全部事情就是编写 myinterrupt() 处理程式函数。他的声明已间接通过 request_irq() 的参数说明了：void (*handler)(int, void *, struct pt_regs *)。第一个参数是中断号，第二个参数是在 request_irq 中所使用的设备 ID，第三个参数持有一个指向某个结构体的指针，结构体中容纳的是在服务那个中断之前的处理器寄存器和状态。

假如不去查看处理器寄存器，我们就不能知道中断是来自我们的设备还是来自共享同一 IRQ 的某些其他设备。在本例中，令人满意的是，中断发生在指定的 IRQ 上。当编写真正的驱动程式时，执行对此的检查很重要，假如处理程式发现中断由另一个设备所使用，那么他应该立即返回值 IRQ_NONE，而不去处理那个中断。假如中断来自我们的设备，而且处理程式被正确调用，那么应该返回 IRQ_HANDLED。这些操作是和硬件相关的，在此不再论述。

所以，每当在指定的 IRQ 上有一个中断时，myinterrupt() 函数都会被调用。发生此事件时我们会执行打印输出，但是希望限制输出的数量，所以将像先前建议的那样去做，只打印输出前 10 个中断。

还需要从这个函数返回某些内容。由于这不是个真正的驱动程式，而只是研究中断，所以应该返回 IRQ_NONE。通过返回 IRQ_HANDLED，我们能够宣称这是设备的真正驱动程式，无需任何其他驱动程式来处理这个中断（在本例中并不是这样）。

这里是 myinterrupt() 的最终代码：

static irqreturn_t myinterrupt(int irq, void *dev_id, struct pt_regs *regs)
{
    static int mycount = 0;

    if (mycount < 10) {
        printk("Interrupt!＼n");
        mycount++;
    }

    return IRQ_NONE;
}

这样就完成了！将下面一行：

obj-m += myirqtest.o

添加到此目录中的 Makefile，并使用下面的命令编译模块：

# make -C  SUBDIRS=$PWD modules

现在插入模块（将参数值配置为在系统中能够生效的值，见 cat /proc/interrupts）：

insmod myirqtest.ko interface=eth0 irq=9

查看 dmesg 的打印输出。他应该类似如下：

Request on IRQ 9 succeeded
Interrupt!
Interrupt!
Interrupt!
Interrupt!
Interrupt!

最多有 10 行“Interrupt!”，因为我们限制打印输出的数目最多那么多。现在，卸载模块：

rmmod myirqtest

IRQ 现在应该被我们的处理程式释放了。查看 dmesg 的输出。他应该类似如下：

Freeing IRQ 9

现在就已完成了您自己的使用中断的内核模块！去研究您的新内核模块吧 ?? 模块是很有趣的！