📄 program-proc.html
字号:
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Author" content="Edward Fu">
<meta name="GENERATOR" content="Mozilla/4.05 [zh-CN] (X11; I; Linux 2.1.127 i686) [Netscape]">
<title>Freesoft Linux FAQ -- 如何在/proc下加入一个档案</title>
</head>
<body>
<br>如何在proc中加入一个文件
<p>简介
<p>PROC是一个特殊的文件系统，核心藉由这个文件系统可以提供应用程序一个 安全的界
<br>面来存取某些特别的资料。例如硬件/内存的使用状况，或者是某 个进程开启了那些
<br>文件。
<p>当我们在核心中加入某个新的功能或是驱动程序后，可能会想提供一个方法 让应用程
<br>序可以取得驱动程序中某些状态，一般来说这个功能可能需要经过写出 一个处理ioctl
<br>的调用来完成。这个界面对于一些比较“功能性”的信息可能是很 适合的，因为使用
<br>者程序可能必须将这些信息读出后再做一定的处理。但对于一 些“实时性”的信息，
<br>例如内存的使用状况，或者是驱动设备的统计资料等。 我们可能需要一个比较简单
<br>易用的界面来取得它们。
<p>PROC文件系统便提供了我们这样的一个界面，我们可以用cat,more或任何的 文本编辑
<br>程序来查看这些信息，例如来查看一个系统内存的使用状况可以用
<p># cat /proc/meminfo
<br>total: used: free: shared: buffers: cached:
<br>Mem: 31698944 12648448 19050496 6770688 1581056 6815744
<br>Swap: 0 0 0
<br>MemTotal: 30956 kB
<br>MemFree: 18604 kB
<br>MemShared: 6612 kB
<br>Buffers: 1544 kB
<br>Cached: 6656 kB
<br>SwapTotal: 0 kB
<br>SwapFree: 0 kB
<p>目前在Linux中几乎所有的信息都可以经过PROC文件系统取得一些统计性甚或功能
性的
<br>信息。有些驱动程序甚至允许经过PROC文件系统改变某个功能变量的值，例
如JAVA执
<br>行格式的驱动程式允许我们经由PROC文件系统设定JAVA直译程序的执 行文件名称。
<p>加入一个文件
<p>如果你的驱动程序不是很复杂，那直接在PROC的根目录底下加入一个文件是比较简
单
<br>的做法。下面举一个例子告诉大家这是多麻简单的一件事，但如果你想要提供比
较复
<br>杂的信息，后面会有更进一步的说明。
<p>接下来我以一个很简单的例子做说明，在这个例子之中我们在PROC的根目录底
下加入
<br>一个叫做test的文件，你可以用下面的命令读出其中的值。
<p># cat /proc/test
<br>test status
<p>要达到这个目的我们必须改变三个文件，第一个是include/linux/proc_fs.h这个文件。
<p>enum root_directory_inos {
<br>PROC_ROOT_INO = 1,
<br>PROC_LOADAVG,
<br>PROC_UPTIME,
<br>PROC_MEMINFO,
<br>PROC_KMSG,
<br>PROC_VERSION,
<br>PROC_CPUINFO,
<br>PROC_PCI,
<br>PROC_SELF, /* will change inode # */
<br>PROC_NET,
<br>PROC_SCSI,
<br>PROC_MALLOC,
<br>PROC_KCORE,
<br>PROC_MODULES,
<br>PROC_STAT,
<br>PROC_DEVICES,
<br>PROC_INTERRUPTS,
<br>PROC_FILESYSTEMS,
<br>PROC_KSYMS,
<br>PROC_DMA,
<br>PROC_IOPORTS,
<br>#ifdef __SMP_PROF__
<br>PROC_SMP_PROF,
<br>#endif
<br>PROC_PROFILE, /* whether enabled or not */
<br>PROC_CMDLINE,
<br>PROC_SYS,
<br>PROC_MTAB,
<br>PROC_MD,
<br>PROC_RTC,
<br>PROC_LOCKS
<br>#ifdef CONFIG_TESTPROC
<br>,PROC_TEST
<br>#endif
<br>};
<p>在CONFIG_TESTPROC中的程序是我们新加入的部份，这个enumerate中申明的是在PROC
<br>根目录下的一些文件代码。PROC是一个虚拟的文件系统，所以实际上的信息可能散见
<br>于各驱动程序之中，而非在任何设备之上。那INODE中的位置栏位记载些什么呢?
对一
<br>般的文件系统而言它们应该是设备的逻辑位置，而在PROC中记载的就是上列的数值了。
<p>PROC提供了一些其本的支持给驱动程序可以很容易的在文件系统中加入一个文件，
而
<br>不必各自去做一些处理INODE的动作。在我们的要求中只需在根目录中加入一个叫
test
<br>的文件就可以了。所以我们可以直接修改root.c这个文件的proc_root_init这
个函
<br>数，这个函数负责在根目录中加入各种不同驱动程序需要的文件。
<p>#ifdef CONFIG_TESTPROC
<br>proc_register(&proc_root, &(struct proc_dir_entry) {
<br>PROC_TEST, 4, "test",
<br>S_IFREG | S_IRUGO, 1, 0, 0,
<br>});
<br>#endif
<p>请注意"test"和PROC_TEST这二个参数，前者是在目录中的文件名称，而后者是这个文
<br>件所对映的代码。接下来我们会看到，这个代码被用来调用定义于驱动程序中的函
<br>数。这个函数的功能是提供这个文件的内容。
<p>到此PROC文件系统中的修改已经完成了，当核心被重新建立后已经可以在文件系统中
<br>看见test这个文件了。但这个文件的内容是空的，如何为它加入内容呢? 这
件工作应
<br>该由驱动程序来做，但如何将二者连起来呢? 这就要靠刚才定义的PROC_TEST
这个代码
<br>来完成，在array.c中的get_root_array是用来将代码转换为函式的位置， 它的程序为
<p>static int get_root_array(char * page, int type, char **start, off_t
offset, int length)
<br>{
<br>switch (type) {
<br>case PROC_LOADAVG:
<br>return get_loadavg(page);
<p>case PROC_UPTIME:
<br>return get_uptime(page);
<p>case PROC_MEMINFO:
<br>return get_meminfo(page);
<p>#ifdef CONFIG_PCI
<br>case PROC_PCI:
<br>return get_pci_list(page);
<br>#endif
<p>case PROC_CPUINFO:
<br>return get_cpuinfo(page);
<p>case PROC_VERSION:
<br>return get_version(page);
<p>#ifdef CONFIG_DEBUG_MALLOC
<br>case PROC_MALLOC:
<br>return get_malloc(page);
<br>#endif
<p>#ifdef CONFIG_MODULES
<br>case PROC_MODULES:
<br>return get_module_list(page);
<p>case PROC_KSYMS:
<br>return get_ksyms_list(page, start, offset, length);
<br>#endif
<p>case PROC_STAT:
<br>return get_kstat(page);
<p>case PROC_DEVICES:
<br>return get_device_list(page);
<p>case PROC_INTERRUPTS:
<br>return get_irq_list(page);
<p>case PROC_FILESYSTEMS:
<br>return get_filesystem_list(page);
<p>case PROC_DMA:
<br>return get_dma_list(page);
<p>case PROC_IOPORTS:
<br>return get_ioport_list(page);
<br>#ifdef CONFIG_BLK_DEV_MD
<br>case PROC_MD:
<br>return get_md_status(page);
<br>#endif
<br>#ifdef __SMP_PROF__
<br>case PROC_SMP_PROF:
<br>return get_smp_prof_list(page);
<br>#endif
<br>case PROC_CMDLINE:
<br>return get_cmdline(page);
<p>case PROC_MTAB:
<br>return get_filesystem_info( page );
<br>#ifdef CONFIG_RTC
<br>case PROC_RTC:
<br>return get_rtc_status(page);
<br>#endif
<br>#ifdef CONFIG_TESTPROC
<br>case PROC_TEST:
<br>return get_test_status(page);
<br>#endif
<br>case PROC_LOCKS:
<br>return get_locks_status(page);
<br>}
<br>return -EBADF;
<br>}
<p>这段程序我们不需要解释了吧! 如果各位有兴趣看看核心是如何由文件系统 连结到这
<br>个函数的过程，请看下一节的说明。接下来我们就看一下，我们所 加入的
<br>get_test_status这个函数的内容。通常这个函数应该位于驱动程序或 核心之中，所以
<br>我把它放在drivers/char之中，这个位置只是一个任意的选 择，没有其它的意义，你
<br>可以因自已的需要做不同的选择。
<p>我将文件的名称取做testproc.c，内容是
<p>#include
<p>int get_test_status(char *buf)
<br>{
<br>char *p;
<p>p = buf;
<p>p += sprintf(p,"test status\n");
<br>return p - buf;
<br>}
<p>这个程序好像....好像....太简单了一点吧，不过如果你去找一下其它的函数，结构
<br>几乎是一样的，我们只要将字串或任何信息填入buf之中，并且将实际的长度传
回即
<br>可。因为buf是一个传入的缓冲区，那一定有长度的限制吧! 当然有，它的长
度是一个
<br>内存页的长度，在X86中就是4096个字节。超过了可能会毁了核心， 一定要小心。
<p>至此整个工作已经完成，但如果你此时就去做编译核心的工作，你会得到一个
<br>'get_test_status undefined'的错误，这是因为我们并没有告诉核心多了testproc
这
<br>个文件。我们必须修改在drivers/char中的Config.in和Makefile二个文件，在
<br>Config.in中加入
<p>bool 'Test proc' CONFIG_TESTPROC
<p>这会让我们在做make menuconfig或make config时会多出一个选项，让我们可以设定
<br>是否要加入这个功能。还记得前面的代码吗? 所有的代码都被放在
<p>#ifdef CONFIG_TESTPROC
<p>#endif
<p>之间。但testproc.c这个文件如何加入呢? 这个要靠在Makefile中加入
<p>ifeq ($(CONFIG_TESTPROC),y)
<br>L_OBJS += testproc.o
<br>endif
<p>你可以看到只有在CONFIG_TESTPROC被选择的情况下testproc.c才会被编译且
连结至核
<br>心之中。至此你便可以重新建立一个核心了，记得在编译前先执行 make menuconfig并
<br>将CONFIG_TESTPROC的选项打开。
<p>遥远的行程
<p>[未完成.....]
<p>加入一个子目录
<p>[未完成....]
<p>
<br>注：这是一位台湾同胞写的，我见到时已经由BIG5码转位GB码了，而且没有作者名字。
<br> 我在收录时将"程式"改为"程序","引数"改为"参数"等等，不一而足。
<br>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -