Linux内核 -- 参数交互之 module_param_named

module_param_named 用法详解

module_param_named 是 Linux 内核模块编程中的一个宏，用于定义模块参数，并将其导出以供用户在加载模块时或运行时动态设置。与 module_param 不同的是，module_param_named 允许模块参数的变量名与参数名不同。

语法

module_param_named(name, value, type, perm);

• name：用户在加载模块时使用的参数名称。
• value：模块内使用的变量名称。
• type：参数的数据类型。
• perm：文件系统中参数的权限，通常设置为 0 或 0644，以决定参数是否可以通过 sysfs 文件系统查看和修改。

数据类型

module_param_named 支持的主要数据类型包括：

1. int：整数类型，例如 int, unsigned int。
2. long：长整数类型，例如 long, unsigned long。
3. bool：布尔类型，表示为 int，一般用 0 和 1。
4. charp：字符指针，用于字符串。
5. short：短整数类型，例如 short, unsigned short。
6. byte：一个字节大小的类型，例如 unsigned char。
7. ulong：长整数类型，例如 unsigned long。
8. ullong: 长整数64位类型，例如unsigned long long。

示例

假设我们有一个模块，内部有一个整型变量 my_variable，我们希望用户加载模块时可以使用一个名为 user_param 的参数来设置它。

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

static int my_variable = 0;
module_param_named(user_param, my_variable, int, 0644);

static int __init my_module_init(void) {
    printk(KERN_INFO "Module loaded with user_param = %d\n", my_variable);
    return 0;
}

static void __exit my_module_exit(void) {
    printk(KERN_INFO "Module unloaded\n");
}

module_init(my_module_init);
module_exit(my_module_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple example module with a named parameter");

在这个例子中，用户可以在加载模块时通过以下方式设置 my_variable：

sudo insmod my_module.ko user_param=42

权限说明

• 0：参数不能在 sysfs 文件系统中查看或修改。
• 0444：参数只读，可以在 sysfs 文件系统中查看。
• 0644：参数可读写，可以在 sysfs 文件系统中查看和修改。

总结

module_param_named 非常适合在模块中导出用户可配置的参数，并且允许灵活地定义参数名称和变量名称之间的映射关系。它支持多种基本数据类型，允许开发者根据需求在模块中使用不同类型的参数。