file_operation

[cpp]view plain copy

  1. struct file_operations{
  2. struct module *owner;
  3. // 指向拥有该结构的模块的指针,避免正在操作时被卸载,一般为初始化为THIS_MODULES
  4. loff_t (*llseek) (struct file *, loff_t, int);
  5. // llseek用来修改文件当前的读写位置,返回新位置
  6. // loff_t为一个"长偏移量"。当此函数指针为空,seek调用将会以不可预期的方式修改file结构中的位置计数器。
  7. ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
  8. // 从设备中同步读取数据。读取成功返回读取的字节数。设置为NULL,调用时返回-EINVAL
  9. ssize_t (*aio_read) (struct kiocb *, char __user *, size_t, loff_t);
  10. // 初始化一个异步的读取操作,为NULL时全部通过read处理
  11. ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
  12. // 向设备发送数据。
  13. ssize_t (*aio_write) (struct kiocb *, const char __user *, size_t, loff_t);
  14. // 初始化一个异步的写入操作。
  15. int (*readdir) (struct file *, void *, filldir_t);
  16. // 仅用于读取目录,对于设备文件,该字段为 NULL
  17. unsigned int (*poll) (struct file *, struct poll_table_struct *);
  18. // 返回一个位掩码,用来指出非阻塞的读取或写入是否可能。
  19. // 将pool定义为 NULL,设备会被认为即可读也可写。
  20. int (*ioctl) (struct inode *, struct file *, unsigned int, unsigned long);
  21. // 提供一种执行设备特殊命令的方法。不设置入口点,返回-ENOTTY
  22. long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
  23. // 不使用BLK的文件系统,将使用此种函数指针代替ioctl
  24. long (*compat_ioctl) (struct file *, unsigned int, unsigned long);
  25. // 在64位系统上,32位的ioctl调用,将使用此函数指针代替
  26. int (*mmap) (struct file *, struct vm_area_struct *);
  27. // 用于请求将设备内存映射到进程地址空间。如果无此方法,将访问-ENODEV。
  28. int (*open) (struct inode *, struct file *);
  29. // 如果为空,设备的打开操作永远成功,但系统不会通知驱动程序
  30. // 由VFS调用,当VFS打开一个文件,即建立了一个新的"struct file",之后调用open方法分配文件结构。open属于struct
  31. inode_operations。
  32. int (*flush) (struct file *);
  33. // 发生在进程关闭设备文件描述符副本,执行并等待,若设置为NULL,内核将忽略用户应用程序的请求。
  34. int (*release) (struct inode *, struct file *);
  35. // file结构释放时,将调用此指针函数,release与open相同可设置为NULL
  36. int (*fsync) (struct file *, struct dentry *, int datasync);
  37. // 刷新待处理的数据,如果驱动程序没有实现,fsync调用将返回-EINVAL
  38. int (*aio_fsync) (struct kiocb *, int datasync);
  39. // 异步fsync
  40. int (*fasync) (int, struct file *, int);
  41. // 通知设备FASYNC标志发生变化,如果设备不支持异步通知,该字段可以为NULL
  42. int (*lock) (struct file *, int, struct file_lock *);
  43. // 实现文件锁,设备驱动常不去实现此lock
  44. ssize_t (*readv) (struct file *, const struct iovec *, unsigned long, loff_t *);
  45. ssize_t (*writev) (struct file *, const struct iovec *, unsigned long, loff_t *);
  46. // readv和writev 分散/聚集型的读写操作,实现进行涉及多个内存区域的单次读或写操作。
  47. ssize_t (*sendfile) (struct file *, loff_t *, size_t, read_actor_t, void *);
  48. // 实现sendfile调用的读取部分,将数据从一个文件描述符移到另一个,设备驱动通常将其设置为 NULL
  49. ssize_t (*sendpage) (struct file *, struct page *, int, size_t, loff_t *, int);
  50. // 实现sendfile调用的另一部分,内核调用将其数据发送到对应文件,每次一个数据页,设备驱动通常将其设置为NULL
  51. unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned
  52. long);
  53. // 在进程地址空间找到一个合适的位置,以便将底层设备中的内存段映射到该位置。大部分驱动可将其设置为NULL
  54. int (*check_flags)(int);
  55. // 允许模块检查传递给fcntl(F_SETEL…)调用的标志
  56. int (*dir_notify)(struct file *filp, unsigned long arg);
  57. // 应用程序使用fcntl来请求目录改变通知时,调用该方法。仅对文件系统有效,驱动程序不必实现。
  58. int (*flock) (struct file *, int, struct file_lock *);
  59. // 实现文件锁
  60. };

    推荐阅读