9

我正在实现一个 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 时相比，一些论点也发生了变化。

4

3 回答 3

6

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

于 2013-03-04T17:11:17.197 回答
1

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

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

于 2013-03-05T12:56:31.440 回答
0

现在在Documentation/filesystems/vfs.rst也有一些最小的树内文档呈现在：https://www.kernel.org/doc/html/latest/filesystems/locking.html#file-operations但它没有t真的说任何从签名中不明显的东西。他们应该把这些东西放在 Doxygen 评论上。

我还在以下位置维护了几个可运行的示例：https ://github.com/cirosantilli/linux-kernel-module-cheat/tree/9be19ae1cf3f3f346a5bc25f4a4d1e1cbac23cb3#file-operations可能会感兴趣。

于 2020-07-11T14:42:22.663 回答