内核模块参数概述
内核模块参数允许在加载模块时向模块传递配置信息。这对于提升模块的灵活性和可配置性非常重要。通过这些参数,用户可以直接控制模块的行为,而无需重新编译内核或模块。
内核模块传参的API
内核模块传参主要通过以下几个API来实现:
1. module_param 宏
module_param 宏用于定义模块参数。它有三个参数:参数名、参数类型和权限标志。
module_param(name, type, perm);
name:参数名,用于在模块代码中访问参数值。
type:参数类型,可以是 int、charp(字符串)、bool(布尔值)等。
perm:权限标志,用于指定参数在 /sys/module/<module_name>/parameters/ 目录下的权限。
2. module_param_array 宏
module_param_array 宏用于定义数组类型的模块参数。它有四个参数:参数名、参数类型、数组长度指针和权限标志。
module_param_array(name, type, nump, perm);
name:参数名,用于在模块代码中访问参数值。
type:参数类型,可以是 int、charp(字符串)、bool(布尔值)等。
nump:数组长度指针,用于存储数组的长度。
perm:权限标志,用于指定参数在 /sys/module/<module_name>/parameters/ 目录下的权限。
3. module_param_cb 宏
module_param_cb 宏用于定义回调函数类型的模块参数。它有两个参数:参数名和回调函数结构体。
module_param_cb(name, ¶m_ops, &value, perm);
name:参数名,用于在模块代码中访问参数值。
param_ops:回调函数结构体,定义了参数的读取和写入操作。
value:参数值,用于存储参数的值。
perm:权限标志,用于指定参数在 /sys/module/<module_name>/parameters/ 目录下的权限。
示例
#include <linux/module.h>
#include <linux/init.h>
#include <linux/moduleparam.h>
// 定义模块参数
static int my_int = 0;
module_param(my_int, int, 0644);
static char *my_string = "default_string";
module_param(my_string, charp, 0644);
static bool my_bool = false;
module_param(my_bool, bool, 0644);
static int my_array[3];
static int my_array_num;
module_param_array(my_array, int, &my_array_num, 0644);
// 模块初始化函数
static int __init my_module_init(void) {
int i;
printk(KERN_INFO "my_module: Module initialized\n");
printk(KERN_INFO "my_module: my_int = %d\n", my_int);
printk(KERN_INFO "my_module: my_string = %s\n", my_string);
printk(KERN_INFO "my_module: my_bool = %d\n", my_bool);
for (i = 0; i < my_array_num; i++) {
printk(KERN_INFO "my_module: my_array[%d] = %d\n", i, my_array[i]);
}
return 0;
}
// 模块退出函数
static void __exit my_module_exit(void) {
printk(KERN_INFO "my_module: Module exited\n");
}
module_init(my_module_init);
module_exit(my_module_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("gopher");
MODULE_DESCRIPTION("A simple module parameter example");