“struct file_operations”参数是什么？

Question

我正在实现一个 Linux 字符设备驱动程序。

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

例如

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);
};

告诉我每个参数是什么的文档在哪里？ 有些是显而易见的，但有些不是。 如果可以，我更喜欢参考官方文档，但我就是找不到。

例如

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

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

我一直在谷歌搜索并阅读设备驱动程序的书，但我找不到任何解释参数的文件。 从编写 LDD3 时起，一些参数也发生了变化。

Answer 1

LDD3 这本书对于理解大局仍然非常有用，但它对细节没有帮助（它适用于内核 2.6.10，同时我们正在向 3.9 迈进）。 kernelnewbies 驱动程序页面可能是最新、最全面的资源。 对于日常更改， LWN 会定期评论 API 更改并发布新功能的更长概述。 H-online载有一系列文章，详细介绍从内核版本到内核版本的变化，以及讨论和补丁的链接。

Answer 2

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

话虽如此，一旦您拥有源代码，真的没有比阅读代码并查看其用途更好的文档了。 对于这样的事情，我会查看 /drivers/fs/ 并找到使用此结构的示例，并查看他们如何使用它。

Answer 3

现在文档/文件系统/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可能会感兴趣。