Linux驱动proc接口示例源码分析

最新推荐文章于 2026-05-28 14:43:07 发布
原创 最新推荐文章于 2026-05-28 14:43:07 发布 · 626 阅读 · 9 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#linux #驱动开发 #proc

Linux驱动proc接口示例源码分析

1. 概述

本文档详细分析了一个简单的Linux内核模块示例，该示例展示了如何创建和使用proc文件系统接口。proc文件系统是Linux内核提供的一种特殊文件系统，用于在运行时访问内核内部数据结构、改变内核设置。

本文包含Makefile（Ubuntu系统环境下测试通过），用于编译、安装和管理驱动模块。

2. 源码详细分析

2.1 头文件包含

#include <linux/module.h>     // 模块相关函数和宏定义
#include <linux/kernel.h>     // 内核核心函数和宏定义
#include <linux/proc_fs.h>    // proc文件系统相关函数
#include <linux/uaccess.h>    // 用户空间与内核空间数据传输函数
#include <linux/seq_file.h>   // 序列文件操作相关函数
#include <linux/sched.h>      // 进程调度相关结构体和函数
#include <linux/jiffies.h>    // 系统时钟滴答相关函数
#include <linux/utsname.h>    // 系统名称和版本相关函数

这些头文件提供了编写内核模块和proc接口所需的所有函数、结构体和宏定义。

2.2 宏定义和全局变量

#define PROC_NAME "proc_example"  // proc文件名

// 模块参数，可通过insmod时指定
static int proc_value = 42;
module_param(proc_value, int, 0644);
MODULE_PARM_DESC(proc_value, "A simple integer parameter");
  • PROC_NAME：定义了将在/proc目录下创建的文件名
  • proc_value：模块参数，默认值为42
  • module_param：宏用于将变量声明为模块参数，格式为module_param(name, type, perm)
    • name：参数名
    • type：参数类型
    • perm：参数在/sys/module下的权限
  • MODULE_PARM_DESC：为模块参数添加描述信息

2.3 proc文件读取函数

static int proc_show(struct seq_file *m, void *v)
{
    // 输出一些系统信息到proc文件
    seq_printf(m, "=== Proc Interface Example ===\n");
    seq_printf(m, "Module parameter value: %d\n", proc_value);
    seq_printf(m, "Current PID: %d\n", current->pid);
    seq_printf(m, "Current task name: %s\n", current->comm);
    seq_printf(m, "System uptime: %lu ticks\n", jiffies);
    
    return 0;
}

这是proc文件的读取函数，当用户执行cat /proc/proc_example时会调用此函数：

  • seq_file *m：序列文件指针，用于向用户空间输出数据
  • seq_printf：类似于标准C的printf函数，但用于序列文件
  • current：指向当前进程结构体的指针
    • current->pid：当前进程ID
    • current->comm：当前进程名
  • jiffies：系统启动以来的时钟滴答数

2.4 proc文件打开函数

static int proc_open(struct inode *inode, struct file *file)
{
    return single_open(file, proc_show, NULL);
}

当用户打开/proc/proc_example文件时调用此函数：

  • single_open：内核提供的辅助函数，用于创建简单的序列文件
    • file：文件指针
    • proc_show：读取数据的回调函数
    • NULL：传递给回调函数的私有数据

2.5 proc文件写入函数

static ssize_t proc_write(struct file *file, const char __user *buffer, size_t count, loff_t *pos)
{
    char buf[64];
    int ret;
    
    // 限制写入的长度
    if (count > sizeof(buf) - 1)
        count = sizeof(buf) - 1;
    
    // 从用户空间复制数据到内核空间
    if (copy_from_user(buf, buffer, count))
        return -EFAULT;
    
    buf[count] = '\0';
    
    // 将字符串转换为整数
    ret = kstrtoint(buf, 10, &proc_value);
    if (ret)
        return ret;
    
    printk(KERN_INFO "[proc_example] proc_value updated to %d\n", proc_value);
    
    return count;
}

当用户向/proc/proc_example文件写入数据时调用此函数：

  • const char __user *buffer：用户空间的缓冲区指针
  • size_t count：要写入的字节数
  • loff_t *pos：文件当前位置

关键步骤：

  1. 限制写入长度，防止缓冲区溢出
  2. 使用copy_from_user将数据从用户空间复制到内核空间
  3. 将字符串转换为整数
  4. 更新模块参数
  5. 使用printk记录日志
  6. 返回实际写入的字节数

2.6 文件操作结构体

static const struct file_operations proc_fops = {
    .owner = THIS_MODULE,
    .open = proc_open,
    .read = seq_read,
    .write = proc_write,
    .llseek = seq_lseek,
    .release = single_release,
};

file_operations结构体定义了内核如何处理对文件的各种操作：

  • .owner：指向模块的指针，用于模块引用计数
  • .open：打开文件的回调函数
  • .read：读取文件的回调函数，这里使用内核提供的seq_read
  • .write：写入文件的回调函数
  • .llseek：定位文件指针的回调函数，使用内核提供的seq_lseek
  • .release：关闭文件的回调函数，使用内核提供的single_release

2.7 模块初始化函数

static int __init proc_example_init(void)
{
    // 创建proc文件
    if (!proc_create(PROC_NAME, 0666, NULL, &proc_fops)) {
        printk(KERN_ERR "[proc_example] Failed to create proc file\n");
        return -ENOMEM;
    }
    
    printk(KERN_INFO "[proc_example] Module loaded successfully\n");
    printk(KERN_INFO "[proc_example] Proc file created at /proc/%s\n", PROC_NAME);
    
    return 0;
}

当模块被加载时（insmod命令）调用此函数：

  • proc_create：创建proc文件
    • PROC_NAME：文件名
    • 0666：文件权限
    • NULL：父目录，NULL表示/proc根目录
    • &proc_fops：文件操作结构体
  • printk：在内核日志中记录信息

2.8 模块退出函数

static void __exit proc_example_exit(void)
{
    // 删除proc文件
    remove_proc_entry(PROC_NAME, NULL);
    
    printk(KERN_INFO "[proc_example] Module unloaded successfully\n");
}

当模块被卸载时（rmmod命令）调用此函数：

  • remove_proc_entry：删除proc文件
    • PROC_NAME：文件名
    • NULL：父目录

2.9 模块信息

// 注册模块的初始化和退出函数
module_init(proc_example_init);
module_exit(proc_example_exit);

// 模块信息
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Embedded Linux Strategist");
MODULE_DESCRIPTION("A simple proc interface example module");
MODULE_VERSION("1.0");
  • module_init：注册模块初始化函数
  • module_exit：注册模块退出函数
  • MODULE_LICENSE：声明模块的许可证（必须是GPL兼容的许可证）
  • MODULE_AUTHOR：模块作者信息
  • MODULE_DESCRIPTION：模块功能描述
  • MODULE_VERSION：模块版本信息

3. Makefile分析

# Makefile for proc_example module

# 模块名称
obj-m += proc_example.o

# 内核源码路径
KDIR := /lib/modules/$(shell uname -r)/build

# 当前目录
PWD := $(shell pwd)

# 默认目标：编译模块
default:
	$(MAKE) -C $(KDIR) M=$(PWD) modules

# 清理目标：删除编译生成的文件
clean:
	$(MAKE) -C $(KDIR) M=$(PWD) clean

# 安装模块
install:
	sudo insmod proc_example.ko

# 卸载模块
uninstall:
	sudo rmmod proc_example

# 显示模块信息
info:
	modinfo proc_example.ko

Makefile关键部分解释

  1. 模块名称定义：

    obj-m += proc_example.o

    这行告诉内核构建系统，我们要构建一个名为proc_example的可加载内核模块。

  2. 内核源码路径：

    KDIR := /lib/modules/$(shell uname -r)/build

    $(shell uname -r)获取当前运行内核的版本号，然后构建内核源码树的路径。

  3. 当前目录：

    PWD := $(shell pwd)

    获取当前工作目录的绝对路径。

  4. 默认编译目标：

    default:
    $(MAKE) -C $(KDIR) M=$(PWD) modules

    这是默认的构建规则，它告诉make：

    • -C $(KDIR)：切换到内核源码目录
    • M=$(PWD)：指定模块源码所在目录
    • modules：执行内核模块构建目标

  5. 清理目标：

    clean:
    $(MAKE) -C $(KDIR) M=$(PWD) clean

    清理所有编译生成的文件。

  6. 安装和卸载目标：
    提供了方便的命令来安装和卸载模块。

4. 编译和使用说明

4.1 编译模块

make

4.2 安装模块

sudo insmod proc_example.ko

或带参数安装：

sudo insmod proc_example.ko proc_value=100

4.3 查看proc文件内容

sudo cat /proc/proc_example

输出示例：

=== Proc Interface Example ===
Module parameter value: 42
Current PID: 12345
Current task name: cat
System uptime: 12345678 ticks

4.4 向proc文件写入数据

echo 200 | sudo tee /proc/proc_example

4.5 查看内核日志

sudo dmesg | tail

4.6 卸载模块

sudo rmmod proc_example

5. 技术要点总结

  1. proc文件系统：提供了用户空间与内核空间的通信接口
  2. 序列文件（seq_file）：内核提供的简化文件内容生成的机制
  3. 模块参数：允许在加载模块时配置模块行为
  4. 用户空间与内核空间数据传输：使用copy_from_user等函数确保安全的数据传输
  5. 模块生命周期管理：完整的初始化和退出函数确保资源正确分配和释放
  6. 内核日志：使用printk记录模块运行信息

6. 总结

这个简单的示例展示了Linux内核模块中proc接口的基本实现方法。通过创建proc文件，内核模块可以提供一种简单而有效的方式让用户空间程序访问内核数据或控制内核行为。proc文件系统是Linux内核中非常强大的特性，广泛用于系统监控、调试和配置。

7. 完整源码

7.1 proc_example.c

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/proc_fs.h>
#include <linux/uaccess.h>
#include <linux/seq_file.h>
#include <linux/sched.h>
#include <linux/jiffies.h>
#include <linux/utsname.h>

#define PROC_NAME "proc_example"

// 模块参数，可通过insmod时指定
static int proc_value = 42;
module_param(proc_value, int, 0644);
MODULE_PARM_DESC(proc_value, "A simple integer parameter");

// proc文件的读取函数
static int proc_show(struct seq_file *m, void *v)
{
    // 输出一些系统信息到proc文件
    seq_printf(m, "=== Proc Interface Example ===\n");
    seq_printf(m, "Module parameter value: %d\n", proc_value);
    seq_printf(m, "Current PID: %d\n", current->pid);
    seq_printf(m, "Current task name: %s\n", current->comm);
    seq_printf(m, "System uptime: %lu ticks\n", jiffies);
    
    return 0;
}

// proc文件的打开函数
static int proc_open(struct inode *inode, struct file *file)
{
    return single_open(file, proc_show, NULL);
}

// proc文件的写入函数
static ssize_t proc_write(struct file *file, const char __user *buffer, size_t count, loff_t *pos)
{
    char buf[64];
    int ret;
    
    // 限制写入的长度
    if (count > sizeof(buf) - 1)
        count = sizeof(buf) - 1;
    
    // 从用户空间复制数据到内核空间
    if (copy_from_user(buf, buffer, count))
        return -EFAULT;
    
    buf[count] = '\0';
    
    // 将字符串转换为整数
    ret = kstrtoint(buf, 10, &proc_value);
    if (ret)
        return ret;
    
    printk(KERN_INFO "[proc_example] proc_value updated to %d\n", proc_value);
    
    return count;
}

// 定义proc文件的操作函数集合
static const struct file_operations proc_fops = {
    .owner = THIS_MODULE,
    .open = proc_open,
    .read = seq_read,
    .write = proc_write,
    .llseek = seq_lseek,
    .release = single_release,
};

// 模块初始化函数
static int __init proc_example_init(void)
{
    // 创建proc文件
    if (!proc_create(PROC_NAME, 0666, NULL, &proc_fops)) {
        printk(KERN_ERR "[proc_example] Failed to create proc file\n");
        return -ENOMEM;
    }
    
    printk(KERN_INFO "[proc_example] Module loaded successfully\n");
    printk(KERN_INFO "[proc_example] Proc file created at /proc/%s\n", PROC_NAME);
    
    return 0;
}

// 模块退出函数
static void __exit proc_example_exit(void)
{
    // 删除proc文件
    remove_proc_entry(PROC_NAME, NULL);
    
    printk(KERN_INFO "[proc_example] Module unloaded successfully\n");
}

// 注册模块的初始化和退出函数
module_init(proc_example_init);
module_exit(proc_example_exit);

// 模块信息
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Embedded Linux Strategist");
MODULE_DESCRIPTION("A simple proc interface example module");
MODULE_VERSION("1.0");

7.2 Makefile

# Makefile for proc_example module

# 模块名称
obj-m += proc_example.o

# 内核源码路径
KDIR := /lib/modules/$(shell uname -r)/build

# 当前目录
PWD := $(shell pwd)

# 默认目标：编译模块
default:
	$(MAKE) -C $(KDIR) M=$(PWD) modules

# 清理目标：删除编译生成的文件
clean:
	$(MAKE) -C $(KDIR) M=$(PWD) clean

# 安装模块
install:
	sudo insmod proc_example.ko

# 卸载模块
uninstall:
	sudo rmmod proc_example

# 显示模块信息
info:
	modinfo proc_example.ko
使用SSRS清除Excel数据源中的合并和隐藏单元格
weixin_29443363的博客
08-04 950
数据集（Dataset）是SSRS报表的基础，它们包含用于生成报表的数据。数据集可以是一个简单的查询，也可以是复杂的SQL语句，或者是存储过程。在SSRS中创建数据集的目的是为了将数据源中的数据提取到报表中，使报表能够展示所需的数据。数据集还可以包含参数，使得报表在展示数据时能够根据参数的输入提供不同的数据视图。隐藏行或列是指在Excel工作表中，有选择地使某些行或列不可见，而不删除它们。隐藏数据并不会影响工作表中的计算或数据引用，只是暂时从视图中移除而已。
Reporting Service：纵向合并单元格
翩跹星子的博客
04-26 2457
原需求表格样式： Reporting Service 横向合并单元格没有问题，但是貌似不支持纵向合并单元格。 解决办法：在单元格中插入列表； 注意事项： 1. 插入列表时，默认插入的是两行三列的表格，第一行是“页眉”，第二行是“数据”，需要将“数据”这一行给删除掉，留下“页眉”这一行，在这个基础上添加行，“数据”这一行是一般是用来循环绑定数据的，留下会有问题。 2. 在单元格中插入...
《BI那点儿事—数据的艺术》目录索引
weixin_30662011的博客
12-02 87
《BI那点儿事—数据的艺术》目录索引 原文:《BI那点儿事—数据的艺术》目录索引原创·《BI那点儿事—数据的艺术》教程免费发布 各位园友，大家好，我是Bobby，在学习BI和开发的项目的过程中有一些感悟和想法，整理和编写了一些学习资料，本来只是内部学习使用，但为了方便更多的BI开发者，推动BI企业级应用开发，决定整理成一部教程，并在网络上免...
筑影编辑器 房屋设计 建筑可视化设计工具 个人开发
绀目澄清
05-28 254
筑影编辑器是一款专业的 3D 建筑可视化设计工具，提供场地规划、建筑建模、室内布置、多楼层管理及高清渲染导出等功能，助力建筑师与设计师高效完成从概念到呈现的全流程工作。链接: https://pan.baidu.com/s/1pCZzOamAtvwf5m-ORptW3Q?pwd=5188 提取码: 5188。
springboot测试实例(JUnit 5 + SpringBootTest + MockMvc + H2 + Mockito).rar
06-17
springboot测试实例(JUnit 5 + SpringBootTest + MockMvc + H2 + Mockito).rar本文件为https://andyy.blog.csdn.net/article/details/160367956?spm=1011.2415.3001.5331博客所对应的源代码文件，适合新手小白入门学习
全域GEO智能推广系统 企业线上获客源码
06-17
全域GEO智能推广系统 企业线上获客源码 多平台排名优化搭建
工艺管道支架标准图集.rar
06-17
工艺管道支架标准图集.rar
单片式离合器（用于轿车、卡车等）solid edge.rar
06-17
单片式离合器（用于轿车、卡车等）solid edge.rar
FDTD方法中的完美匹配层（PML）研究（Matlab代码实现）
最新发布
06-17
内容概要：本文系统梳理了多个科研领域的前沿研究与技术实现，重点涵盖FDTD方法中的完美匹配层（PML）研究，以及Matlab/Simulink在电磁、电力、控制、通信、信号处理、图像处理、路径规划、能源系统优化等领域的仿真与算法实现。文中列举了大量基于Matlab和Python的科研案例，如风电功率预测、负荷预测、无人机三维路径规划、电池系统故障诊断、雷达模拟、通信编码、微电网优化调度等，并强调结合智能优化算法（如粒子群、遗传算法、深度学习等）提升系统性能。同时，提供了丰富的代码资源与仿真模型，涵盖永磁同步电机控制、逆变器设计、多智能体任务分配、虚拟电厂调度等复杂系统，助力科研人员快速开展复现实验与创新研究。; 适合人群：具备一定编程基础，熟悉Matlab/Python工具，从事电气工程、自动化、通信、人工智能、新能源、控制科学等相关领域研究的研发人员及研究生。; 使用场景及目标：① 学习并实现FDTD仿真中的PML边界条件以有效抑制数值反射；② 掌握Matlab/Simulink在多物理场建模、控制系统设计与优化算法中的综合应用；③ 借助提供的代码资源完成科研复现、课程设计、竞赛项目或工程原型开发； 阅读建议：此资源以科研实战为导向，不仅提供理论方法，更强调代码实现与仿真验证。建议读者结合自身研究方向，按目录顺序查阅相关模块，下载配套代码进行调试与二次开发，以达到学以致用、融会贯通的目的。
二级展开式减速器（SolidWorks）.rar
06-17
二级展开式减速器（SolidWorks）.rar
接口测试前面知识解读快点学习吧
06-17
接口测试前面知识解读快点学习吧
编译原理法分析实验（报告+源代码）.zip
06-17
编译原理法分析实验（报告+源代码）
电动式钢管接箍打标设备毕业设计图纸（此轮液压泵装配图）.rar
06-17
电动式钢管接箍打标设备毕业设计图纸（此轮液压泵装配图）.rar
风力发电机组增速器（SolidWorks）.rar
06-17
风力发电机组增速器（SolidWorks）.rar
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值