proc_fs 使用說明

建立一個 proc 文件
根據對 proc 文件的不一樣使用，內核提供了多種包裝函數來建立一個 proc 文件。

方法一：
struct proc_dir_entry *create_proc_entry(const char *name, mode_t mode, struct proc_dir_entry *parent)
這是最直接，包裝最少的建立方法。
參數 name 是要建立的 proc 文件名。mode 是該文件權限值，例如 S_IRUGO，可傳入0表示採用系統默認值。parent 指定該文件的上層 proc 目錄項，若是爲 NULL，表示建立在 /proc 根目錄下。
create_proc_entry() 完成的任務主要包括：檢測 mode 值，分配 proc_dir_entry 結構，註冊 proc_dir_entry。

方法二：
static inline 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)
{
    struct proc_dir_entry *res=create_proc_entry(name,mode,base);
    if (res) {
        res->read_proc=read_proc;
        res->data=data;
    }
    return res;
}
若是要建立一個只讀的 proc 文件，能夠採用 create_proc_read_entry() 這個接口。這個接口其實就是給 proc_dir_entry 多賦了兩個值，其中 read_proc 是一個函數指針， data 是 read_proc 調用時傳給它一個參數。關於 read_proc 函數，接下來會另行分析。

方法三：
struct proc_dir_entry *proc_create(const char *name, mode_t mode, struct proc_dir_entry *parent, const struct file_operations *proc_fops)
若是要建立一個 proc 文件，而且不用 proc_fs 默認提供的 file_operations 的話，可使用 proc_create() 這個函數，經過最後一個參數來指定要建立的 proc 文件的 file_operations。
每一個 proc 文件也都會用到 file_operations，在調用 create_proc_entry() 建立 proc 文件時，其中一步是調用 proc_register()，proc_register() 會爲 proc_dir_entry 提供一個默認的 file_operations，而 proc_create() 與 create_proc_entry() 惟一差異就是在調用 proc_register() 前先設置好 proc_dir_entry 的 file_operations，這樣在 proc_register() 時就不會設置使用 proc_fs 默認的 file_operations 了。
proc_fs 默認的 file_operations 定義以下：
static const struct file_operations proc_file_operations = {
    .llseek        = proc_file_lseek,
    .read        = proc_file_read,
    .write        = proc_file_write,
};
關於這個 proc_file_operations，後面會繼續講到。
proc_create() 通常在建立使用 seq_file 接口的 proc 文件時會使用。

建立一個 proc 目錄
建立一個 proc 目錄就調用 struct proc_dir_entry *proc_mkdir(const char *name, struct proc_dir_entry *parent) 這個函數。參數name 是目錄名，parent 是該目錄的上層 proc 目錄項，若是爲 NULL，表示建立在 /proc 根目錄下。

刪除一個 proc 項
要刪除一個 proc 文件或目錄就調用 void remove_proc_entry(const char *name, struct proc_dir_entry *parent)

注意事項
proc 項建立時要避免已經存在同名的 proc 項，不然註冊時內核會報錯（但仍是會成功返回那個 proc 項），在刪除時有時會刪不掉（尤爲是 proc 目錄）。
刪除一個 proc 目錄會把這個目錄全部的 proc 文件都刪除。

讀 proc 文件
proc 文件的讀須要本身提供一個 read_proc_t 類型的函數放在 proc_dir_entry 結構中供 proc_file_read() 函數調用。下面是 read_proc_t 類型函數的定義：
typedef int (read_proc_t)(char *page, char **start, off_t off, int count, int *eof, void *data);
這個函數的定義很複雜，不過當 proc 文件返回的數據量老是小於一個 PAGE_SIZE 時能夠簡化使用。關於這個函數以及它的那一大串參數我以爲再怎麼解釋都解釋不全，因此仍是留給本身去看 proc_file_read() 的代碼就明白了。

寫 proc 文件
proc 文件的寫很簡單。若是是使用 proc_fs 默認提供的 file_operations 的話，要本身實現一個 write_proc_t 類型的函數放在 proc_dir_entry 結構中供 proc_file_write() 函數調用。write_proc_t 類型函數的定義以下：
typedef int (write_proc_t)(struct file *file, const char __user *buffer, unsigned long count, void *data);
下面是 proc_file_write() 的實現：
static ssize_t proc_file_write(struct file *file, const char __user *buffer, size_t count, loff_t *ppos)
{
    struct inode *inode = file->f_path.dentry->d_inode;
    struct proc_dir_entry * dp;
  
    dp = PDE(inode);

    f (!dp->write_proc)
        return -EIO;

    /* FIXME: does this routine need ppos? probably... */
    return dp->write_proc(file, buffer, count, dp->data);
}
可見 proc 文件的寫忽略了使用偏移量。

若是是使用本身提供的 file_operations 的話，那仍是要本身實現一個 write 函數賦給 file_operations 的 .write 指針。

一個例子
#include <linux/module.h>
#include <linux/proc_fs.h>
#include <asm/uaccess.h>

static struct proc_dir_entry *mydir;
static struct proc_dir_entry *pfile;

static char msg[255];

static int myproc_read(char *page, char **start, off_t off, int count, int *eof, void *data)
{
        int len = strlen(msg);

        if (off >= len)
                return 0;

        if (count > len - off)
                count = len - off;

        memcpy(page + off, msg + off, count);
        return off + count;
}

static int myproc_write(struct file *file, const char __user *buffer, unsigned long count, void *data)
{
        unsigned long count2 = count;

        if (count2 >= sizeof(msg))
                count2 = sizeof(msg) - 1;

        if (copy_from_user(msg, buffer, count2))
                return -EFAULT;

        msg[count2] = '/0';
        return count;
}

static int __init myproc_init(void)
{
        mydir = proc_mkdir("mydir", NULL);
        if (!mydir) {
                printk(KERN_ERR "Can't create /proc/mydir/n");
                return -1;
        }

        pfile = create_proc_entry("pool", 0666, mydir);
        if (!pfile) {
                printk(KERN_ERR "Can't create /proc/mydir/pool/n");
                remove_proc_entry("mydir", NULL);
                return -1;
        }

        pfile->read_proc = myproc_read;
        pfile->write_proc = myproc_write;

        return 0;
}

static void __exit myproc_exit(void)
{
        remove_proc_entry("pool", mydir);
        remove_proc_entry("mydir", NULL);
}

module_init(myproc_init);
module_exit(myproc_exit);

這個例子建立一個 /proc/mydir/pool，它至關於一個池子，你向它寫什麼，你讀它的時候它就返回什麼，固然它的容量是有限的 :)