Linux 模块参数是 Linux 内核模块编程中一项重要功能，它允许用户在加载模块时动态传递配置信息，从而增强模块的灵活性和可配置性，与硬编码在模块代码中的固定值不同，模块参数提供了运行时调整模块行为的途径,使得同一个模块可以根据不同的需求场景进行定制化配置。
模块参数的定义与声明
在 Linux 内核模块中，参数通过宏定义进行声明，最常用的宏是 module_param 和 module_param_array，module_param 用于声明单个参数，其基本语法为 module_param(name, type, perm)，name 是参数名称，type 是参数类型，perm 是参数的权限模式，参数类型支持多种内核数据类型，如 int、bool、charp（字符指针）、short、ushort、uint、ulong 等，module_param(debug_mode, int, 0644) 声明了一个名为 debug_mode 的整型参数，权限为 0644，表示所有用户可读,所有者可写。
对于数组类型的参数，可以使用 module_param_array 宏，其语法为 module_param_array(name, type, nump, perm)，name 是数组名，type 是数组元素类型，nump 是指向数组元素数量的指针，perm 是权限模式，module_param_array(network_ports, ushort, &num_ports, 0444) 声明了一个名为 network_ports 的无符号短整型数组参数，并通过 num_ports 返回数组实际长度。
参数权限模式的意义
参数的权限 perm 决定了用户空间对参数的访问权限，其格式与文件权限类似，由读、写、执行权限组成，分别对应数字 4、2、1，常见的权限模式包括 0444（所有用户可读）、0644（所有用户可读，所有者可写）、0000（完全禁止访问）等，需要注意的是，即使设置了写权限，用户空间也需要通过特定的接口（如 sysfs 文件系统）才能修改参数，直接写入模块参数变量是不被允许的,这确保了内核数据的安全性。
模块参数的使用方法
加载模块时，可以通过 insmod 或 modprobe 命令传递参数，语法为 insmod module.ko parameter_name=value，若有一个模块 my_module.kl 声明了 debug_mode 参数，可以通过 insmod my_module.ko debug_mode=1 来启用调试模式，对于数组参数，可以依次指定多个值，如 insmod my_module.ko network_ports=80,443,8080，modprobe 在加载模块时还会自动解析模块依赖关系，并支持从 /etc/modprobe.d/ 目录下的配置文件中读取默认参数值。
参数的初始化与验证
在模块加载时，参数会被赋予用户传递的值，开发者可以在模块初始化函数中对参数进行有效性验证，对于端口参数，可以检查其是否在有效端口范围内（0-65535），若参数无效，可以通过 printk 输出错误信息，并使用 -EINVAL 返回错误码，阻止模块加载，对于字符指针类型的参数，内核会自动为其分配内存空间并复制用户传递的字符串，开发者无需手动分配内存,但需要注意在模块卸载时释放相关资源。
参数的动态修改与 sysfs 接口
Linux 内核通过 sysfs 文件系统将模块参数暴露到用户空间，允许在模块加载后动态修改参数值，每个参数在 sysfs 中对应一个文件，路径通常为 /sys/module/模块名/parameters/参数名，对于 my_module 模块的 debug_mode 参数，其 sysfs 路径为 /sys/module/my_module/parameters/debug_mode，用户可以通过 echo 命令修改参数值，如 echo 1 > /sys/module/my_module/parameters/debug_mode，需要注意的是，只有权限模式包含写权限的参数才能被修改，且修改后会立即生效,无需重新加载模块。
参数的生命周期管理
模块参数的生命周期与模块的加载和卸载紧密相关，当模块加载时，参数变量被初始化并接收用户传递的值；在模块运行期间，参数值可以通过 sysfs 接口被读取和修改；当模块卸载时，参数变量随之销毁，对于动态分配的参数资源（如字符指针参数的内存），需要在模块清理函数中手动释放，避免内存泄漏，若使用 charp 类型参数，应在模块卸载时调用 kfree() 释放其指向的内存。
参数的高级特性
Linux 模块参数还支持一些高级特性，如参数描述和参数只读属性，通过 MODULE_PARM_DESC 宏，可以为参数添加描述信息，该信息会显示在 modinfo 命令的输出中，方便用户了解参数的用途，MODULE_PARM_DESC(debug_mode, “Enable debug mode (0=disable, 1=enable)”) 为 debug_mode 参数添加了描述，通过设置权限模式为 S_IRUSR（仅所有者可读）或 S_IWUSR（仅所有者可写），可以限制参数的访问权限,增强安全性。
实际应用场景
模块参数在实际开发中具有广泛应用场景，网络驱动模块可以通过参数配置 MTU 值、队列大小等；字符设备驱动模块可以通过参数指定设备号、缓冲区大小等；文件系统模块可以通过参数调整挂载选项，如启用或禁用特定功能，通过参数化配置，开发者可以避免为不同场景编译多个版本的模块，减少了维护成本,同时提高了模块的通用性和可扩展性。
注意事项与最佳实践
在使用模块参数时，需要注意以下几点：一是参数值的有效性验证，避免非法值导致内核崩溃；二是权限设置的合理性，避免开放不必要的写权限；三是资源管理，特别是对于动态分配的内存，确保在模块卸载时正确释放；四是参数命名清晰，使用有意义的名称并添加适当注释，提高代码可读性，对于关键参数，建议在模块初始化函数中记录参数值,便于调试和问题追踪。
Linux 模块参数为内核模块提供了灵活的配置机制，通过简单的宏声明和命令行参数传递，即可实现模块行为的动态调整，结合 sysfs 文件系统，用户还可以在运行时修改参数值，进一步增强了模块的实用性，在实际开发中，合理使用模块参数能够显著提高模块的灵活性和可维护性，是内核模块编程中不可或缺的重要特性，开发者应当充分理解参数的声明、权限、验证和使用方法，遵循最佳实践,确保模块的稳定性和安全性。
