内核模块参数

内核模块参数概述

内核模块参数允许在加载模块时向模块传递配置信息。这对于提升模块的灵活性和可配置性非常重要。通过这些参数，用户可以直接控制模块的行为，而无需重新编译内核或模块。

内核模块传参的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, &param_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");