什么是“struct file_operations”参数?

时间:2013-03-04 16:51:44

标签: linux linux-kernel driver linux-device-driver

我正在实现Linux角色设备驱动程序。

linux / fs.h头文件列出了没有参数名称的file_operations。

e.g。

struct file_operations {
    struct module *owner;
    loff_t (*llseek) (struct file *, loff_t, int);
    ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
    ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
    ssize_t (*aio_read) (struct kiocb *, const struct iovec *, unsigned long, loff_t);
    ssize_t (*aio_write) (struct kiocb *, const struct iovec *, unsigned long, loff_t);
    int (*readdir) (struct file *, void *, filldir_t);
    unsigned int (*poll) (struct file *, struct poll_table_struct *);
    long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
    long (*compat_ioctl) (struct file *, unsigned int, unsigned long);
    int (*mmap) (struct file *, struct vm_area_struct *);
    int (*open) (struct inode *, struct file *);
    int (*flush) (struct file *, fl_owner_t id);
    int (*release) (struct inode *, struct file *);
    int (*fsync) (struct file *, loff_t, loff_t, int datasync);
    int (*aio_fsync) (struct kiocb *, int datasync);
    int (*fasync) (int, struct file *, int);
    int (*lock) (struct file *, int, struct file_lock *);
    ssize_t (*sendpage) (struct file *, struct page *, int, size_t, loff_t *, int);
    unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);
    int (*check_flags)(int);
    int (*flock) (struct file *, int, struct file_lock *);
    ssize_t (*splice_write)(struct pipe_inode_info *, struct file *, loff_t *, size_t, unsigned int);
    ssize_t (*splice_read)(struct file *, loff_t *, struct pipe_inode_info *, size_t, unsigned int);
    int (*setlease)(struct file *, long, struct file_lock **);
    long (*fallocate)(struct file *file, int mode, loff_t offset,
              loff_t len);
};

文档在哪里告诉我每个参数是什么?有些是显而易见的,但有些则不是。如果可以,我更愿意参考官方文档,但我找不到它。

e.g。

int (*fsync) (struct file *, loff_t, loff_t, int datasync);

有两个loff_t参数。我怎么知道他们做了什么?

我一直在谷歌搜索并阅读设备驱动程序书,但我找不到任何文件来解释这些论点的用途。从编写LDD3开始,一些论点也发生了变化。

3 个答案:

答案 0 :(得分:7)

LDD3书籍对于了解大局非常有用,但它对细节没有帮助(对于内核2.6.10,同时我们正在向3.9迈进)。 kernelnewbies drivers page可能是最新,最全面的资源。对于日常更改,LWN会定期对API更改发表评论,并针对新功能发布更长时间的概述。 H-online包含一系列文章,详细介绍了从内核版本到内核版本的更改,以及指向讨论和补丁的链接。

答案 1 :(得分:1)

我不得不暂时实现我的第一个linux驱动程序。到目前为止,我认为你可以做的最好的事情是下载你正在开发的版本的内核源代码。在内核源代码树中,有一个名为/ Documentation的目录。我从那里开始,最后我检查了这是内核的“官方文档”。

话虽这么说,一旦你拥有了源代码,那么确实没有比阅读代码和查看代码更好的文档。对于这样的事情,我会查看/ drivers / fs /并找到这个结构使用位置的示例,看看它们是如何使用它的。

答案 2 :(得分:0)

现在Documentation/filesystems/vfs.rst处出现了一些最小的树内文档,它们位于:https://www.kernel.org/doc/html/latest/filesystems/locking.html#file-operations,但是它并没有真正说出签名中不明显的内容。他们应该将这些内容放到Doxygen评论中。

我还在https://github.com/cirosantilli/linux-kernel-module-cheat/tree/9be19ae1cf3f3f346a5bc25f4a4d1e1cbac23cb3#file-operations上维护了几个可运行的示例,这些示例可能很有趣。