所有使用 /proc 的模块应当包含 来定义正确的函数.
要创建一个只读 /proc 文件,你的驱动必须实现一个函数来在文件被读时产生数据. 当 某个进程读文件时(使用 read 系统调用),这个请求通过这个函数到达你的模块. 我们先 看看这个函数并在本章后面讨论注册接口.
当一个进程读你的 /proc 文件,内核分配了一页内存(就是说,PAGE_SIZE 字节),驱动 可以写入数据来返回给用户空间. 那个缓存区传递给你的函数,是一个称为 read_proc 的方法:
int (*read_proc)(char *page,char **start,off_t offset,int count,int *eof,void *data);
page 指针是你写你的数据的缓存区; start 是这个函数用来说有关的数据写在页中哪里 (下面更多关于这个); offset 和 count 对于 read 方法有同样的含义. eof 参数指向一 个整数,必须由驱动设置来指示它不再有数据返回,data 是驱动特定的数据指针,你可 以用做内部用途.
这个函数应当返回实际摆放于 page 缓存区的数据的字节数,就象 read 方法对别的文件 所作一样. 别的输出值是 *eof 和 *start. eof 是一个简单的标志,但是 start 值的使 用有些复杂; 它的目的是帮助实现大的(超过一页) /proc 文件.
start 参数有些非传统的用法. 它的目的是指示哪里(哪一页)找到返回给用户的数据. 当 调用你的 proc_read 方法,*start 将会是 NULL. 如果你保持它为 NULL,内核假定数据 已放进 page 偏移是 0; 换句话说,它假定一个头脑简单的 proc_read 版本,它安放虚 拟文件的整个内容到 page,没有注意 offset 参数. 如果,相反,你设置 *start 为一 个 非 NULL 值,内核认为由 *start 指向的数据考虑了 offset,并且准备好直接返回给 用户. 通常,返回少量数据的简单 proc_read 方法只是忽略 start. 更复杂的方法设置
*start 为 page 并且只从请求的 offset 那里开始安放数据.
还有一段距离到 /proc 文件的另一个主要问题,它也打算解答 start. 有时内核数据结 构的 ASCII 表示在连续的 read 调用中改变,因此读进程可能发现从一个调用到下一个 有不一致的数据. 如果 *start 设成一个小的整数值,调用者用它来递增 filp-
注意,有更好的方法实现大的 /proc 文件; 它称为 seq_file,我们很快会讨论它. 首先,然而,是时间举个例子了. 下面是一个简单的(有点丑陋) read_proc 实现,为 scull 设 备: