file_operation

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

你可能感兴趣的:(linux驱动)