02. Hello World

Hello World 是许多人开始写代码的时候第一个编写的例子,这里也延续传统,从Hello World开始。

本节主要学会以下内容:

  • 了解模块相关的内容:模块概念、模块编译、模块加载/卸载命令
  • HelloWorld 模块:编译、加载

1. 模块相关内容

Linux本身是一个单内核,为了提高其可扩展性和可维护性,其提供了模块机制。基于模块机制,开发者可以动态地向内核添加功能,这样测试新驱动时,可以不用经过冗长的开关机重启过程。

模块编译

模块编译的前提是要有内核树,这在《Linux设备驱动程序》——前言中有说明。

有了内核树后,需要编写对应的 Makefile 文件,其内容只要输入以下内容就可以了:

obj-m   +=  helloworld.o

其中,helloworld.o 对应的是模块源码的文件名 “helloworld.c”,后续根据源码文件名修改即可。

当然,要想让上述Makefile文件生效,需要在内核构造系统环境中调用它,有两种方法:

第一种:在前面《Linux设备驱动程序》——前言 也有提到,在 Makefile 相同目录中使用以下make命令来生成模块:

make -C {linux_header_dir} M='pwd' modules

其中,{linux_header_dir}linux-header 的根目录。

这条命令会先去执行 -C 后面指定目录中的Makefile文件,执行完成后即构建了内核构造系统环境,然后跳回到当前目录中,执行当前目录中的 Makefile,编译生成需要的模块。

接下来的学习过程中采用这个方法进行模块编译。这种做法的好处是将模块的代码与内核源码区分开来,一方面不会污染内核源码,另一方面,如果需要针对不同内核编译模块,只需要修改 linux-header 目录即可。

第二种:将模块的代码和 Makefile 放入到内核树中,成为内核树的一部分,并确保 Makefile 被层级 Makefile 包含。这样,在源码根目录下执行以下命令即可编译生成需要的模块。

make modules

模块编译完成后,会在模块代码相同目录下生成一个.ko文件,这就是我们需要的模块。

模块加载/卸载

加载模块使用的命令是 insmod,需要在 su 权限下运行,格式如下:

insmod {name}.ko

其中,{name} 为刚刚编译的文件名。

卸载模块使用的命令是 rmmod,需要在su权限下运行,格式如下:

rmmod {name}

其中,{name} 为刚刚编译的文件名,没有 .ko 后缀。

除此之外,还有以下几个命令可以了解一下:

lsmod 列出当前系统所有模块
modprobe 作用与insmod相同,不同的是它会搜索相关依赖,并一起加载到内核中
modinfo 列出当前模块的信息

2. HelloWorld 模块

终于要开始写模块了。在写代码之前,先创建一些目录,结构如下:

LinuxDeviceDriver(内核源码根目录)
    |- Makefile(文件,项目根目录下创建Makefile文件)
    |- helloworld(HelloWorld模块文件夹)
        |- helloworld.c (HelloWorld模块源码)
        |- Makefile (Helloworld模块的Makefile文件)

首先创建了一个 LinuxDeviceDriver 的目录,作为整个项目的根目录(下面简称根目录);在根目录中创建了一个 Makefile 文件,用于编译整个项目中的模块;在根目录中创建了一个 helloworld 目录,用于存放 HelloWorld 模块的源码和对应的编译文件。

后续新加的模块都会在根目录下新创建一个目录,这样各个模块不会相互干扰,结构更加清晰。

根目录下的 Makefile 文件内容如下:

KERNEL_DIR = /usr/src/linux-headers-5.4.0-40-generic
CUR_DIR = $(shell pwd)
SUB_DIR = helloworld/

ifneq   ($(KERNELRELEASE),)
        obj-y   +=      $(SUB_DIR)
else
default:
        make -C $(KERNEL_DIR) M=$(CUR_DIR) modules
endif

clean:
        @-rm -f *.o *~ *.mod *.mod.c *.cmd *.order *.symvers
        @for n in $(SUB_DIR); do $(MAKE) -C $$n clean; done

这个 Makefile 会被执行两次,第一次执行的时候,由于 KERNELRELEASE 没有定义,所以会执行 else 中的 make -C $(KERNEL_DIR) M=$(CUR_DIR) modules,构建内核系统环境,这个 make 返回前,会回到当前目录中,执行当前目录中 Makefile 文件(即再次执行),此时 KERNELRELEASE 已定义,会执行 obj-y += $(SUB_DIR),即继续去执行 SUB_DIR 中的 Makefile 文件,最终由内核编译出对应的模块。

clean 规则用于清理当前目录和所有子目录中生成的编译产物。

helloworld.c 文件中的内容如下:

#include <linux/init.h>
#include <linux/module.h>

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

static void hello_world_exit(void)
{
    printk(KERN_ALERT "Hello World, Good-Bye!\n");
}

module_init(hello_world_init);
module_exit(hello_world_exit);

MODULE_LICENSE("GPL");

init.hmodule.h 两个头文件在模块编写中基本是必须的。

printk 可以理解为内核中的printf,因为 printf 不能在内核中使用,因为内核不包含printf的库。

module_init()module_exit() 是告诉内核在加载的时候调用哪个函数,在卸载的时候调用哪个函数,其具体的实现过程后面再说,或者也可以看我写的博客:

https://blog.csdn.net/quejing1992/article/details/102468988

MODULE_LICENSE 用于标注当前源码使用的许可证。类似的宏还有如下:

MODULE_AUTHOR("作者");
MODULE_DESCRIPTION("用途描述");
MODULE_VERSION("版本号");
MODULE_ALIAS("模块别名");
MODULE_DEVICE_TABLE("模块支持的设备");

helloworld目录中的 Makefile 内容如下:

obj-m   +=      helloworld.o

clean:
        @-rm -f *.ko* *.mod* *.o* *~ *.order .*?.*?

编译 HelloWorld 模块

准备好以上内容后,即可编译模块。

切换到根目录下,执行 make 命令,即可编译模块,编译结果如下图所示。

编译 HelloWorld 模块结果

此时会在 helloworld 目录下生成 helloworld.ko,这就是我们需要的 HelloWorld 模块。

加载/卸载HelloWorld模块

得到上面的 ko 文件后,即可进行加载和卸载,使用 insmod 命令加载,rmmod 命令卸载,如下图所示。

模块加载卸载操作

至此,HelloWorld 模块完成。

(代码同步放在:https://gitee.com/Quehehe/LinuxDeviceDriver.git)

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,837评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,551评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,417评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,448评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,524评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,554评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,569评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,316评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,766评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,077评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,240评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,912评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,560评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,176评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,425评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,114评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,114评论 2 352

推荐阅读更多精彩内容