03. Hello Param

之前完成了 Hello World 模块,学会了基本的模块编译、加载和卸载。

作为一个模块,对于不同的系统,可能需要的参数会有所变化,或者对于相同的系统,在不同情况下有不同的参数需求。为了满足这个需求,内核允许在加载驱动模块的过程中指定参数。

本节主要学会以下内容:.

  • 在加载模块过程中设定参数

1. 支持的参数

要在模块加载过程中设定参数,首先我们需要明确我们可以设定哪些参数。

内核支持的模块参数如下:

  • bool 布尔型,取值为 truefalse
  • invbool 反布尔型,就是和 bool 取值相反,truefalsefalsetrue
  • charp 字符指针,内核会为提供的字符串分配内存和指针
  • int 整型,同C语言
  • long 长整型,同C语言
  • short 短整型,同C语言
  • uint 无符号整型
  • ulong 无符号长整型
  • ushort 无符号短整型

除此之外,也还支持数组的设定,后续的例子中会举例说明。

需要说明的是,模块的参数应该给定一个默认值,这样可以根据默认值来判断加载过程中是否指定了参数。

2. 设定参数实例

有之前的 Hello World 模块的基础,我们可以直接上实例代码。在《02. Hello World》中的 LinuxDeviceDriver 目录下新建一个 helloparam 目录,在其中创建原文件和 Makefile 文件,结构如下:

LinuxDeviceDriver(项目根目录)
    |- helloparam(HelloParam模块文件夹)
        |- helloparam.c (HelloParam模块源码)
        |- Makefile (HelloParam模块的Makefile文件)

helloparam.c 文件的内容如下:

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

static char *who = "world";
static int age = 100;
static int id[] = {1, 2, 3, 4, 5};
static unsigned int len = 0;


module_param(who, charp, S_IRUGO);
module_param(age, int, S_IRUGO);
module_param_array(id, int, &len, S_IRUGO);

static int __init hello_param_init(void)
{
    printk(KERN_ALERT "who is %s, age is %d\n", who, age);

    printk(KERN_ALERT "array len is: %d\n", len);
    printk(KERN_ALERT "id is:%d, %d, %d, %d, %d\n",
        id[0], id[1], id[2], id[3], id[4]);

    return 0;
}

static void __exit hello_param_exit(void)
{
    printk(KERN_ALERT "Bye-Bye, %s\n", who);
}

module_init(hello_param_init);
module_exit(hello_param_exit);

MODULE_LICENSE("GPL");

基本内容与之前 Hello World 相同,有几点需要详细说明一下:

#include <linux/moduleparam.h>

moduleparam.h 头文件中定义了后面的 module_param 宏和 module_param_array 宏,这两个宏的作用是让这些参数对于 insmod 可见,这样才能对其进行设定。

module_param 宏:有三个参数:第一个为参数名称(即变量名),第二个参数为参数类型(即上面01支持的类型中说明的参数),第三个参数为访问许可掩码(S_IRUGOS_IRWXUGOS_IXUGO等,U表示user,G表示group,O表示other)。

module_param_array 宏:有四个参数:第一个为数组名,第二个为参数类型,第三个为一个 unsigned int * 指针变量,用于存储输入的个数,第四个参数为访问许可掩码。

__init和__exit标记 :在初始化函数 hello_param_init 前面有一个 __init 标记,在清除函数 hello_param_exit 前面有一个 __exit 标记。__init 标记的作用是表示这个函数只在初始化过程中起作用,初始化完成后会丢弃,不占用代码区的内存;__exit 标记的作用是表示这个函数只在清除过程中起作用,如果内核被配置为不可卸载,则该函数会被丢弃。

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

obj-m   +=  helloparam.o

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

和 Hello World 模块基本相同,只是原文件的名称不同。后续新模块对应的 Makefile 做类似的修改,以后不再说明。

除此之外,还需要在项目根目录下的 Makefile 加入 helloparam 目录,这样编译的时候才会进入到这个目录下进行编译,根目录下的 Makefile 新增内容如下:

SUB_DIR = helloworld/ SUB_DIR = helloworld/ helloparam/

增加了一个 helloparam/。后续有新的模块,也进行相应的目录增加操作,以后不再说明。

完成上面的源码和 Makefile 后,在项目的根目录下执行 make 命令进行编译,得到相应的 ko 模块文件。

3. 模块运行结果

运行上面的模块,看看效果。

首先,不带任何参数运行,结果如下:

无参数运行结果

接下来,为who和age设定值,结果如下:

设定参数运行

接下来,设定数组值。数组的设定使用逗号进行分割,运行结果如下:

数组设定参数运行

可以看到,输入了三个值,打印的结果也变成了 11,22,33,4,5,后面两个没有设定的值保持默认值。同时,len变量由之前的 0 变为现在的 3,表示输入了三个值。

最后看看如果数组输入的个数大于数组的长度会怎样,运行结果如下:

输入输入数量过大

可以看到,插入报错了,插入失败。因此,一定注意设定数组时,设定的数量不要大于数组长度!

(代码同步放在: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

推荐阅读更多精彩内容