跳至主要内容

【转】第一个简单的内核编程实验:hello.c

文章说明:calmarrow(lqm)原创

文章引自:http://piaoxiang.cublog.cn

 
《Linux设备驱动程序》
 
    内核编程入门,就以最为简单的hello.c为例。
    环境:Redhat 9.0,内核版本2.4.20-8。
 
    虽然现在2.6.x的内核很早就就发布了,但是毕竟很多公司还在使用2.4.x的内核。作为新手,从2.4.x的内核入手是可行的。原因有如下几条:
    (1)2.4.x比较成熟。可能你遇到的绝大多数问题,网上都有解决方案。在这个过程中,你可以节省大量的时间,同时还可以对比网上的解决方案,加深认识,总结解决问题的方法,调整自己的学习方法和思路。
    (2)事物的发展总不可能是一蹴而就的。了解发展的历程,对深入理解问题有很大的好处。所以在2.4.x的内核的基础上学习2.6.x的内核,就能够体会到2.6.x的内核在哪些方面要出色,或者为什么要采取这种改进技术。相信理论清晰了,即时2.6.x的内核也会容易上手。
 
    下面总结了第一个内核程序hello.c的学习过程。
 
(一)第一阶段:尽量简单
 

/*
 * hello.c
 */


#define MODULE
#include <linux/module.h>

int init_module(void)
{
        printk("Hello World!\n");
        return 0;
}

void cleanup_module(void)
{
        printk("Goodbye!\n");
}

执行,出现错误一:

[root@lqm drivers]# gcc -c hello.c
[root@lqm drivers]# insmod hello.o
hello.o: kernel-module version mismatch
        hello.o was compiled for kernel version 2.4.20
        while this kernel is version 2.4.20-8.

    这是因为内核源代码版本和编译器版本不一致造成的。

(1)编译器版本/usr/include/linux/version.h

#define UTS_RELEASE "2.4.20"
#define LINUX_VERSION_CODE 132116
#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))

(2)内核源代码版本/usr/src/linux-2.4.20-8/include/linux/version.h

/usr/src/linux-2.4.20-8/include/linux
[root@lqm linux]# cat version.h
#include <linux/rhconfig.h>
#if defined(__module__smp)
#define UTS_RELEASE "2.4.20-8smp"
#elif defined(__module__BOOT)
#define UTS_RELEASE "2.4.20-8BOOT"
#elif defined(__module__bigmem)
#define UTS_RELEASE "2.4.20-8bigmem"
#else
#define UTS_RELEASE "2.4.20-8"
#endif
#define LINUX_VERSION_CODE 132116
#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))

   可以采取修改编译器版本号与内核源代码版本号一致的办法来解决这个问题,即修改/usr/include/linux/version.h中

#define UTS_RELEASE "2.4.20"

#define UTS_RELEASE "2.4.20-8"

执行,出现错误二:

[root@lqm drivers]# gcc -c hello.c
[root@lqm drivers]# insmod hello.o
Warning: loading hello.o will taint the kernel: no license
  See http://www.tux.org/lkml/#export-tainted for information about tainted modules
Module hello loaded, with warnings
[root@lqm drivers]# tail -n 1 /var/log/messages
Jan 30 12:02:08 lqm kernel: Hello

     也就是说出现了no license的警告。GNU的软件需要有GPL,所以修改源代码如下:

/*
 * hello.c
 */


#define MODULE
#include <linux/module.h>

MODULE_LICENSE("GPL");

int init_module(void)
{
        printk("Hello World!\n");
        return 0;
}

void cleanup_module(void)
{
        printk("Goodbye!\n");
}

    这时没有错误了。写了一个脚本,测试流程自动化:

#!/bin/bash

gcc -c hello.c
sleep 1

insmod hello.o && echo -e "Instal module - hello.o\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

rmmod hello && echo -e "Remove module - hello\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" || echo "Module hello has removed"

执行结果如下:

[root@lqm hello]# ./run

Instal module - hello.o

Jan 30 13:31:29 lqm kernel: Hello World!

hello 748 0 (unused)

Module hello has instaled

Remove module - hello

Jan 30 13:31:30 lqm kernel: Goodbye!

Module hello has removed

(二)第二阶段:完善,深入一点

/*
 * hello.c
 */


#ifndef __KERNEL__
        #define __KERNEL__
#endif
#ifndef MODULE
        #define MODULE
#endif

#include <linux/kernel.h> /*printk*/
#include <linux/module.h>

MODULE_LICENSE("GPL");

static int init_module(void)
{
        printk("Hello, world!\n");

        return 0;
}

static void cleanup_module(void)
{
        printk("Goodbye!\n");
}

写Makefile文件如下:

# Kernel Programming
# Shandong University, Linqingmin

# The path of kernel source code
INCLUDEDIR = /usr/src/linux-2.4.20-8/include/

# Compiler
CC = gcc

# Options
CFLAGS = -D__KERNEL__ -DMODULE -O -Wall -I$(INCLUDEDIR)

# Target
OBJS = hello.o

all: $(OBJS)

$(OBJS): hello.c /usr/include/linux/version.h
        $(CC) $(CFLAGS) -c $<

install:
        insmod $(OBJS)

uninstall:
        rmmod hello

.PHONY: clean
clean:
        rm -f *.o

    写Makefile时应该注意,不要用空格来代替<TAB>。否则会出现错误:missing separator. Stop.

修改执行脚本run:

#!/bin/bash

# The first step
make && make install && echo -e "Instal module - hello.o\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

# The second step
make uninstall && echo -e "Remove module - hello\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" || echo "Module hello has removed"

# The last step
make clean

执行结果如下:

[root@lqm hello]# ./run
gcc -D__KERNEL__ -DMODULE -O -Wall -I/usr/src/linux-2.4.20-8/include/ -c hello.c
hello.c:18: warning: `init_module
' defined but not used
hello.c:25: warning: `cleanup_module'
defined but not used
insmod hello.o
Instal module - hello.o

Jan 31 13:40:23 lqm kernel: Hello,
hello 728 0 (unused)
Module hello has instaled

rmmod hello
Remove module - hello

Jan 31 13:40:24 lqm kernel:
Module hello has removed
rm -f *.o

(三)第三阶段:总结

1、一个内核模块至少应该包括两个函数:

(1)init_module:模块插入内核时调用

(2)cleanup_module:模块移除时调用

    这个简单的程序就是只实现了这两个函数,而且只做了打印信息的工作,没有使用价值。典型情况下,init_module为内核中的某些东西注册一个句柄,相当于模块初始化的工作。cleanup_module则是撤销模块前期的处理工作,使模块得以安全卸载。

2、insmod实现动态加载模块。在当前OS上,动态加载模块以测试硬件等,避免了繁琐的工作。但是,在这种情况下,会出现版本不匹配的情况。另外,要分清楚内核源代码路径和编译器路径的不同,知道在编译时该指定那个路径。第二阶段开始出现过几个错误都是因为默认的路径是编译器路径,而不是内核源代码路径。体会内核模块化带来的好处!

3、应用Make工具来管理项目。即使小,也要训练。在2.4内核和2.6内核下,Makefile的编写会有所不同。只是语法形式的不同,先深入掌握一种,另一种注意一下应该可以避免犯错误。

    继续努力!

2007/02/01补记

/*
 * Kernel Programming: hello.c
 */


/*define __KERNEL__ MODULE*/
#ifndef __KERNEL__
        #define __KERNEL__
#endif
#ifndef MODULE
        #define MODULE
#endif

#include <linux/kernel.h> /*printk*/
#include <linux/module.h>
#include <linux/init.h> /*module_init module_exit*/

MODULE_LICENSE("GPL"); /*declaration license*/

static int __init hello_init(void)
{
        printk("<1>Hello, world!\n");

        return 0;
}

static void __exit hello_exit(void)
{
        printk("<1>Goodbye!\n");
}

module_init(hello_init);
module_exit(hello_exit);

 

# Kernel Programming
# Shandong University, Linqingmin

# The path of kernel source code
KERNELDIR = /usr/src/linux-2.4.20-8

# Compiler
CC = gcc

# Options
CFLAGS = -D__KERNEL__ -DMODULE -I$(KERNELDIR)/include -O -Wall

ifdef CONFIG_SMP
        CFLAGS += -D__SMP__ -DSMP
endif

# OBJS
OBJS = hello.c

# Target
TARGET = hello.o

$(TARGET): hello.c
        $(CC) $(CFLAGS) -c $<

install:
        insmod $(TARGET)

uninstall:
        rmmod hello

.PHONY: clean
clean:
        rm -f *.o

 

#!/bin/bash

# The first step
make && make install && echo -e "Instal module - hello.o\n"
sleep 1
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

# The second step
make uninstall && echo -e "Remove module - hello\n"
sleep 1
lsmod | grep "hello" || echo "Module hello has removed"

# The last step
make clean

执行结果:

gcc -D__KERNEL__ -DMODULE -I/usr/src/linux-2.4.20-8/include -O -Wall -c hello.c
insmod hello.o
Hello,World!
Instal module - hello.o

hello 776 0 (unused)
Module hello has instaled

rmmod hello
Goodbye!
Remove module - hello

Module hello has removed
rm -f *.o

说明:

    这个版本采取了显式的初始化和清除函数,显然无论是调试的便利还是编程风格,都比前几个版本要好。这种机制具体描述如下:如果你将模块初始化函数命名为my_init(而不是init_module),将清除函数命名为my_exit,则可以使用下面两行来进行标记(通常在源文件的末尾)

module_init(my_init);

module_exit(my_exit);

注意必须包含头文件<linux/init.h>。

评论

发表评论

此博客中的热门博文

【转】AMBA、AHB、APB总线简介

AMBA 简介 随着深亚微米工艺技术日益成熟,集成电路芯片的规模越来越大。数字IC从基于时序驱动的设计方法,发展到基于IP复用的设计方法,并在SOC设计中得到了广泛应用。在基于IP复用的SoC设计中,片上总线设计是最关键的问题。为此,业界出现了很多片上总线标准。其中,由ARM公司推出的AMBA片上总线受到了广大IP开发商和SoC系统集成者的青睐,已成为一种流行的工业标准片上结构。AMBA规范主要包括了AHB(Advanced High performance Bus)系统总线和APB(Advanced Peripheral Bus)外围总线。   AMBA 片上总线        AMBA 2.0 规范包括四个部分:AHB、ASB、APB和Test Methodology。AHB的相互连接采用了传统的带有主模块和从模块的共享总线,接口与互连功能分离,这对芯片上模块之间的互连具有重要意义。AMBA已不仅是一种总线,更是一种带有接口模块的互连体系。下面将简要介绍比较重要的AHB和APB总线。 基于 AMBA 的片上系统        一个典型的基于AMBA总线的系统框图如图3所示。        大多数挂在总线上的模块(包括处理器)只是单一属性的功能模块:主模块或者从模块。主模块是向从模块发出读写操作的模块,如CPU,DSP等;从模块是接受命令并做出反应的模块,如片上的RAM,AHB/APB 桥等。另外,还有一些模块同时具有两种属性,例如直接存储器存取(DMA)在被编程时是从模块,但在系统读传输数据时必须是主模块。如果总线上存在多个主模块,就需要仲裁器来决定如何控制各种主模块对总线的访问。虽然仲裁规范是AMBA总线规范中的一部分,但具体使用的算法由RTL设计工程师决定,其中两个最常用的算法是固定优先级算法和循环制算法。AHB总线上最多可以有16个主模块和任意多个从模块,如果主模块数目大于16,则需再加一层结构(具体参阅ARM公司推出的Multi-layer AHB规范)。APB 桥既是APB总线上唯一的主模块,也是AHB系统总线上的从模块。其主要功能是锁存来自AHB系统总...

【转】select问题

问: 该串口初始化如下 ioctl(comm2Fd,FIOBAUDRATE,9600) ioctl(comm2Fd,FIOSETOPTIONS,OPT_RAW) 使用如下 FD_ZERO   (&readFds); FD_SET   (comm2Fd,   &readFds);   width   =   comm2Fd   +   1; FD_ISSET   (comm2Fd,   &readFds); FOREVER { if(timeoutvalue==0) { printf("\nselect   start!\n"); selectnum   =   select   (width,   &readFds,   NULL,   NULL,   NULL); printf("\nselect   over!\n"); }                                 ........... } 现在的状况是程序跑一段时间后会死机或这个串口通讯任务死掉,每次死机都是"select   start!"打印出来,而"select   over!"打印不出来,在仅这个串口通讯任务死掉的情况下,用comm1Fd超级终端登陆,查询任务状态,会发现tExcTask任务居然处于挂起状态??? 哪位大哥帮忙分析一下或给予一点提示,小弟不胜感激!! 答: sele...

【转】C++/CLI程序进程之间的通讯

 现在,把大型软件项目分解为一些相交互的小程序似乎变得越来越普遍,程序各部分之间的通讯可使用某种类型的通讯协议,这些程序可能运行在不同的机器上、不同的操作系统中、以不同的语言编写,但也有可能只在同一台机器上,实际上,这些程序可看成是同一程序中的不同线程。而本文主要讨论C++/CLI程序间的通讯,当然,在此是讨论进程间通讯,而不是网络通讯。    简介   试想一个包含数据库查询功能的应用,通常有一个被称为服务端的程序,等待另一个被称为客户端程序发送请求,当接收到请求时,服务端执行相应功能,并把结果(或者错误信息)返回给客户端。在许多情况中,有着多个客户端,所有的请求都会在同一时间发送到同一服务端,这就要求服务端程序要更加高级、完善。   在某些针对此任务的环境中,服务端程序可能只是众多程序中的一个程序,其他可能也是服务端或者客户端程序,实际上,如果我们的数据库服务端需要访问不存在于本机的文件,那么它就可能成为其他某个文件服务器的一个客户端。一个程序中可能会有一个服务线程及一个或多个客户线程,因此,我们需小心使用客户端及服务端这个术语,虽然它们表达了近似的抽象含义,但在具体实现上却大不相同。从一般的观点来看,客户端即为服务端所提供服务的"消费者",而服务端也能成为其他某些服务的客户端。    服务端套接字   让我们从一个具体有代表性的服务端程序开始(请看例1),此程序等待客户端发送一对整数,把它们相加之后返回结果给客户端。   例1: using namespace System; using namespace System::IO; using namespace System::Net; using namespace System::Net::Sockets; int main(array<String^>^ argv) { if (argv->Length != 1) { Console::WriteLine("Usage: Server port"); Environment::Exit(1); } int port = 0; try { port = Int32::Parse(argv[0]); } catch (FormatException^ e) { Console::Wri...