在 Linux 中,内核和内核模块还有另一种机制可以向进程发送信息 --- 那就是/proc文件系统。 最初设计目的是为了方便访问有关进程的信息(因此得名),现在内核的每个部分都使用它来报告一些有趣的东西,例如/proc/modules它提供了模块列表,以及/proc/meminfo它提供内存使用情况统计信息。
使用 proc 文件系统的方法与设备驱动程序中使用的方法非常相似 --- 创建一个结构,其中包含/proc文件所需的所有信息,包括指向任何处理函数的指针(在我们的例子中只有一个,即当有人尝试从/proc文件读取时调用的函数)。 然后,init_module向内核注册该结构,而cleanup_module则取消注册。
我们使用proc_register_dynamic[1] 的原因是,我们不想预先确定用于我们文件的 inode 编号,而是允许内核确定它以防止冲突。 普通文件系统位于磁盘上,而不是仅仅在内存中(/proc就是这种情况),在那种情况下,inode 编号是指向磁盘位置的指针,该位置是文件索引节点(简称 inode)的所在位置。 inode 包含有关文件的信息,例如文件的权限,以及指向可以找到文件数据的磁盘位置的指针。
因为在文件打开或关闭时我们不会被调用,所以我们没有地方放置try_module_get和try_module_put在这个模块中,如果文件被打开然后模块被移除,就无法避免后果。
这里有一个简单的例子,展示了如何使用 /proc 文件。 这是 /proc 文件系统的 HelloWorld。 它分为三个部分:创建文件/proc/helloworld在函数init_module中,当文件/proc/helloworld在回调函数procfs_read中被读取时,返回一个值(和一个缓冲区),以及删除文件/proc/helloworld在函数cleanup_module.
该/proc/helloworld是在加载模块时使用函数create_proc_entry创建的。 返回值是一个 'struct proc_dir_entry *',它将用于配置文件/proc/helloworld(例如,此文件的所有者)。 空返回值表示创建失败。
每次,每次文件/proc/helloworld被读取时,都会调用函数procfs_read。 此函数的两个参数非常重要:缓冲区(第一个参数)和偏移量(第三个参数)。 缓冲区的内容将返回给读取它的应用程序(例如 cat 命令)。 偏移量是文件中的当前位置。 如果函数的返回值不为空,则再次调用此函数。 因此,请小心使用此函数,如果它永远不返回零,则读取函数将被无限调用。
% cat /proc/helloworld HelloWorld! |
例 5-1. procfs1.c
/* * procfs1.c - create a "file" in /proc * */ #include <linux/module.h> /* Specifically, a module */ #include <linux/kernel.h> /* We're doing kernel work */ #include <linux/proc_fs.h> /* Necessary because we use the proc fs */ #define procfs_name "helloworld" /** * This structure hold information about the /proc file * */ struct proc_dir_entry *Our_Proc_File; /* Put data into the proc fs file. * * Arguments * ========= * 1. The buffer where the data is to be inserted, if * you decide to use it. * 2. A pointer to a pointer to characters. This is * useful if you don't want to use the buffer * allocated by the kernel. * 3. The current position in the file * 4. The size of the buffer in the first argument. * 5. Write a "1" here to indicate EOF. * 6. A pointer to data (useful in case one common * read for multiple /proc/... entries) * * Usage and Return Value * ====================== * A return value of zero means you have no further * information at this time (end of file). A negative * return value is an error condition. * * For More Information * ==================== * The way I discovered what to do with this function * wasn't by reading documentation, but by reading the * code which used it. I just looked to see what uses * the get_info field of proc_dir_entry struct (I used a * combination of find and grep, if you're interested), * and I saw that it is used in <kernel source * directory>/fs/proc/array.c. * * If something is unknown about the kernel, this is * usually the way to go. In Linux we have the great * advantage of having the kernel source code for * free - use it. */ int procfile_read(char *buffer, char **buffer_location, off_t offset, int buffer_length, int *eof, void *data) { int ret; printk(KERN_INFO "procfile_read (/proc/%s) called\n", procfs_name); /* * We give all of our information in one go, so if the * user asks us if we have more information the * answer should always be no. * * This is important because the standard read * function from the library would continue to issue * the read system call until the kernel replies * that it has no more information, or until its * buffer is filled. */ if (offset > 0) { /* we have finished to read, return 0 */ ret = 0; } else { /* fill the buffer, return the buffer size */ ret = sprintf(buffer, "HelloWorld!\n"); } return ret; } int init_module() { Our_Proc_File = create_proc_entry(procfs_name, 0644, NULL); if (Our_Proc_File == NULL) { remove_proc_entry(procfs_name, &proc_root); printk(KERN_ALERT "Error: Could not initialize /proc/%s\n", procfs_name); return -ENOMEM; } Our_Proc_File->read_proc = procfile_read; Our_Proc_File->owner = THIS_MODULE; Our_Proc_File->mode = S_IFREG | S_IRUGO; Our_Proc_File->uid = 0; Our_Proc_File->gid = 0; Our_Proc_File->size = 37; printk(KERN_INFO "/proc/%s created\n", procfs_name); return 0; /* everything is ok */ } void cleanup_module() { remove_proc_entry(procfs_name, &proc_root); printk(KERN_INFO "/proc/%s removed\n", procfs_name); } |
[1] | 在 2.0 版本中,在 2.2 版本中,如果我们把 inode 设置为零,这是自动完成的。 |