linux 内核编程之proc虚拟文件系统

http://blog.csdn.net/shallnet/article/details/17734619 

【版权声明：转载请保留出处：blog.csdn.net/gentleliu。邮箱：shallnew*163.com】

在 Linux 系统中,/proc 文件系统十分有用,它被用于内核向用户导出信息。/proc 文件系统是一个虚拟文件系统,通过它可以使用一种新的方法在 Linux 内核空间和用户空间之间进行通信。在/proc 文件系统中,我们可以将对虚拟文件的读写作为与内核中实体进行通信的一种手段,与普通文件不同的是,这些虚拟文件的内容都是动态创建的。Linux 系统的许多命令本身都是通过分析/proc 下的文件来完成,如 ps、top、uptime 和 free等。
在 Linux 设备驱动程序中,驱动工程师自定义/proc 节点以向外界传递信息的方法还是比较常见的。

下列函数用于创建/proc 目录:

[cpp]  view plain copy

1. struct proc_dir_entry *proc_mkdir(const char *name, struct proc_dir_entry *parent);  

下列函数创建/proc 节点:

[cpp]  view plain copy

1. struct proc_dir_entry *create_proc_entry(const char *name, mode_t mode,struct proc_dir_entry *parent);  
2. struct proc_dir_entry *create_proc_read_entry(const char *name, mode_t mode, struct proc_dir_entry *base, read_proc_t *read_proc, void * data);  

结合 create_proc_entry()和 proc_mkdir(),可用于先在/proc 下创建一个目录,而后在该目录下创建一个文件。
可用如下函数删除/proc 节点:

[cpp]  view plain copy

1. void remove_proc_entry(const char *name, struct proc_dir_entry *parent);  

上述函数各返回值的 proc_dir_entry 结构体中包含了/proc 节点的读函数指针(read_proc_t*read_proc)、写函数指针(write_proc_t *write_proc)以及父节点、子节点信息等。/proc 节点的读写函数的类型分别为:

[cpp]  view plain copy

1. typedef int (read_proc_t)(char *page, char **start, off_t off,int count, int *eof, void *data);  
2. typedef int (write_proc_t)(struct file *file, const char __user *buffer,unsigned long count, void *data);  

这两函数需要我们来实现。
读函数中 page 指针指向用于写入数据的缓冲区,start 用于返回实际的数据写到内存页的位置,eof 是用于返回读结束标志,offset 是读的偏移,count 是要读的数据长度。start 参数比较复杂,对于/proc 只包含简单数据的情况,通常不需要在读函数中设置*start,意味着内核将认为数据保存在内存页偏移 0 的地方。如果将*start 设置为非 0 值,意味着内核将认为*start 指向的数据是 offset 偏移处的数据。写函数与 file_operations 中的 write()成员类似,需要一次从用户缓冲区到内存空间的复制过程。
下面给一个示例，该示例只是简单的在/proc目录下创建一个文件夹和文件，用户可以在用户态向该文件写入文件，并读出文件内容。

[cpp]  view plain copy

1. #include <linux/init.h>  
2. #include <linux/module.h>  
3. #include <linux/kernel.h>  
4. #include <linux/proc_fs.h>  
5. #include <asm/uaccess.h>  
6.   
7. #define USER_ROOT_DIR   "slndir"  
8. #define USER_ENTRY      "slnfile"  
9.   
10. struct proc_dir_entry    *root_dir, *entry;  
11. char                    kbuff[1024];  
12.   
13. static int proc_write(struct file *filep, const char __user *buffer,  
14.         unsigned long len, void *data)  
15. {  
16.     if (copy_from_user(kbuff, buffer, len)) {  
17.         return -1;  
18.     }  
19.   
20.     kbuff[len] = '\0';  
21.     return len;  
22. }  
23.   
24. static int proc_read(char *page, char **start, off_t off, int count, int *eof, void *data)  
25. {  
26.     int     len;  
27.   
28.     len = sprintf(page, "%s", kbuff);  
29.   
30.     return len;  
31. }  
32.   
33. static int __init sln_init(void)  
34. {  
35.     printk("Hello, %s\n", __func__);  
36.   
37.     root_dir = proc_mkdir(USER_ROOT_DIR, NULL);  
38.     if (NULL == root_dir) {  
39.         printk("proc_mkdir create dir %s failed!\n", USER_ROOT_DIR);  
40.         return -1;  
41.     }  
42.   
43.     entry = create_proc_entry(USER_ENTRY, 0666, root_dir);  
44.     if (NULL == entry) {  
45.         printk("create_proc_entry create entry %s failed\n", USER_ENTRY);  
46.         goto err;  
47.     }  
48.   
49.     entry->read_proc = proc_read;  
50.     entry->write_proc = proc_write;  
51.     return 0;  
52.   
53. err:  
54.     remove_proc_entry(USER_ROOT_DIR, NULL);  
55.     return -1;  
56. }  
57.   
58. static void __exit sln_exit(void)  
59. {  
60.     printk("Bye, %s\n", __func__);  
61.   
62.     remove_proc_entry(USER_ENTRY, root_dir);  
63.     remove_proc_entry(USER_ROOT_DIR, NULL);  
64. }  
65.   
66. module_init(sln_init);  
67. module_exit(sln_exit);  
68.   
69. MODULE_LICENSE("GPL");