|
第一個 file_operations 成員根本不是一個操作; 它是一個指向擁有這個結構的模塊的指針.
這個成員用來在它的操作還在被使用時阻止模塊被卸載. 幾乎所有時間中, 它被簡單初始化為
THIS_MODULE, 一個在 中定義的宏.這個宏比較復雜，在進行簡單學習操作的時候，一般初始化為THIS_MODULE。
loff_t (*llseek) (struct file * filp , loff_t p, int orig);
(指針參數(shù)filp為進行讀取信息的目標文件結構體指針；參數(shù) p 為文件定位的目標偏移量；參數(shù)orig為對文件定位
的起始地址，這個值可以為文件開頭（SEEK_SET，0,當前位置(SEEK_CUR,1)，文件末尾(SEEK_END,2)）
llseek 方法用作改變文件中的當前讀/寫位置, 并且新位置作為(正的)返回值.
loff_t 參數(shù)是一個"long offset", 并且就算在 32位平臺上也至少 64 位寬. 錯誤由一個負返回值指示.
如果這個函數(shù)指針是 NULL, seek 調(diào)用會以潛在地無法預知的方式修改 file 結構中的位置計數(shù)器( 在"file 結構" 一節(jié)中描述).
ssize_t (*read) (struct file * filp, char __user * buffer, size_t size , loff_t * p);
(指針參數(shù) filp 為進行讀取信息的目標文件，指針參數(shù)buffer 為對應放置信息的緩沖區(qū)（即用戶空間內(nèi)存地址），
參數(shù)size為要讀取的信息長度，參數(shù) p 為讀的位置相對于文件開頭的偏移，在讀取信息后，這個指針一般都會移動，移動的值為要讀取信息的長度值）
這個函數(shù)用來從設備中獲取數(shù)據(jù). 在這個位置的一個空指針導致 read 系統(tǒng)調(diào)用以 -EINVAL("Invalid argument") 失敗.
一個非負返回值代表了成功讀取的字節(jié)數(shù)( 返回值是一個 "signed size" 類型, 常常是目標平臺本地的整數(shù)類型).
ssize_t (*aio_read)(struct kiocb * , char __user * buffer, size_t size , loff_t p);
可以看出，這個函數(shù)的第一、三個參數(shù)和本結構體中的read()函數(shù)的第一、三個參數(shù)是不同 的，
異步讀寫的第三個參數(shù)直接傳遞值，而同步讀寫的第三個參數(shù)傳遞的是指針，因為AIO從來不需要改變文件的位置。
異步讀寫的第一個參數(shù)為指向kiocb結構體的指針，而同步讀寫的第一參數(shù)為指向file結構體的指針，每一個I/O請求都對應一個kiocb結構體);
初始化一個異步讀 -- 可能在函數(shù)返回前不結束的讀操作.如果這個方法是 NULL, 所有的操作會由 read 代替進行(同步地).
(有關linux異步I/O，可以參考有關的資料，《linux設備驅動開發(fā)詳解》中給出了詳細的解答)
ssize_t (*write) (struct file * filp, const char __user * buffer, size_t count, loff_t * ppos);
(參數(shù)filp為目標文件結構體指針，buffer為要寫入文件的信息緩沖區(qū)，count為要寫入信息的長度，
ppos為當前的偏移位置，這個值通常是用來判斷寫文件是否越界）
發(fā)送數(shù)據(jù)給設備. 如果 NULL, -EINVAL 返回給調(diào)用 write 系統(tǒng)調(diào)用的程序. 如果非負, 返回值代表成功寫的字節(jié)數(shù).
(注：這個操作和上面的對文件進行讀的操作均為阻塞操作）
ssize_t (*aio_write)(struct kiocb *, const char __user * buffer, size_t count, loff_t * ppos);
初始化設備上的一個異步寫.參數(shù)類型同aio_read()函數(shù);
int (*readdir) (struct file * filp, void *, filldir_t);
對于設備文件這個成員應當為 NULL; 它用來讀取目錄, 并且僅對文件系統(tǒng)有用.
unsigned int (*poll) (struct file *, struct poll_table_struct *);
(這是一個設備驅動中的輪詢函數(shù)，第一個參數(shù)為file結構指針，第二個為輪詢表指針）
這個函數(shù)返回設備資源的可獲取狀態(tài)，即POLLIN，POLLOUT，POLLPRI，POLLERR，POLLNVAL等宏的位“或”結果。
每個宏都表明設備的一種狀態(tài)，如：POLLIN（定義為0x0001）意味著設備可以無阻塞的讀，POLLOUT（定義為0x0004）意味著設備可以無阻塞的寫。
(poll 方法是 3 個系統(tǒng)調(diào)用的后端: poll, epoll, 和 select, 都用作查詢對一個或多個文件描述符的讀或寫是否會阻塞.
poll 方法應當返回一個位掩碼指示是否非阻塞的讀或寫是可能的, 并且, 可能地, 提供給內(nèi)核信息用來使調(diào)用進程睡眠直到 I/O 變?yōu)榭赡?
如果一個驅動的 poll 方法為 NULL, 設備假定為不阻塞地可讀可寫.
(這里通常將設備看作一個文件進行相關的操作，而輪詢操作的取值直接關系到設備的響應情況，可以是阻塞操作結果，同時也可以是非阻塞操作結果）
int (*ioctl) (struct inode *inode, struct file *filp, unsigned int cmd, unsigned long arg);
(inode 和 filp 指針是對應應用程序傳遞的文件描述符 fd 的值, 和傳遞給 open 方法的相同參數(shù).
cmd 參數(shù)從用戶那里不改變地傳下來, 并且可選的參數(shù) arg 參數(shù)以一個 unsigned long 的形式傳遞, 不管它是否由用戶給定為一個整數(shù)或一個指針.
如果調(diào)用程序不傳遞第 3 個參數(shù), 被驅動操作收到的 arg 值是無定義的.
因為類型檢查在這個額外參數(shù)上被關閉, 編譯器不能警告你如果一個無效的參數(shù)被傳遞給 ioctl, 并且任何關聯(lián)的錯誤將難以查找.）
ioctl 系統(tǒng)調(diào)用提供了發(fā)出設備特定命令的方法(例如格式化軟盤的一個磁道, 這不是讀也不是寫). 另外, 幾個 ioctl 命令被內(nèi)核識別而不必引用 fops 表.
如果設備不提供 ioctl 方法, 對于任何未事先定義的請求(-ENOTTY, "設備無這樣的 ioctl"), 系統(tǒng)調(diào)用返回一個錯誤.
int (*mmap) (struct file *, struct vm_area_struct *);
mmap 用來請求將設備內(nèi)存映射到進程的地址空間. 如果這個方法是 NULL, mmap 系統(tǒng)調(diào)用返回 -ENODEV.
(如果想對這個函數(shù)有個徹底的了解，那么請看有關“進程地址空間”介紹的書籍)
int (*open) (struct inode * inode , struct file * filp ) ;
(inode 為文件節(jié)點,這個節(jié)點只有一個，無論用戶打開多少個文件，都只是對應著一個inode結構；
但是filp就不同，只要打開一個文件，就對應著一個file結構體，file結構體通常用來追蹤文件在運行時的狀態(tài)信息）
盡管這常常是對設備文件進行的第一個操作, 不要求驅動聲明一個對應的方法. 如果這個項是 NULL, 設備打開一直成功, 但是你的驅動不會得到通知.
與open()函數(shù)對應的是release()函數(shù)。
int (*flush) (struct file *);
flush 操作在進程關閉它的設備文件描述符的拷貝時調(diào)用; 它應當執(zhí)行(并且等待)設備的任何未完成的操作.
這個必須不要和用戶查詢請求的 fsync 操作混淆了. 當前, flush 在很少驅動中使用;
SCSI 磁帶驅動使用它, 例如, 為確保所有寫的數(shù)據(jù)在設備關閉前寫到磁帶上. 如果 flush 為 NULL, 內(nèi)核簡單地忽略用戶應用程序的請求.
int (*release) (struct inode *, struct file *);
release ()函數(shù)當最后一個打開設備的用戶進程執(zhí)行close()系統(tǒng)調(diào)用的時候，內(nèi)核將調(diào)用驅動程序release()函數(shù)：
void release(struct inode inode,struct file *file),release函數(shù)的主要任務是清理未結束的輸入輸出操作，釋放資源，用戶自定義排他標志的復位等。
在文件結構被釋放時引用這個操作. 如同 open, release 可以為 NULL.
int(*synch)(struct file *,struct dentry *,int datasync);
刷新待處理的數(shù)據(jù),允許進程把所有的臟緩沖區(qū)刷新到磁盤。
int (*aio_fsync)(struct kiocb *, int);
這是 fsync 方法的異步版本.所謂的fsync方法是一個系統(tǒng)調(diào)用函數(shù)。系統(tǒng)調(diào)用fsync
把文件所指定的文件的所有臟緩沖區(qū)寫到磁盤中（如果需要，還包括存有索引節(jié)點的緩沖區(qū)）。
相應的服務例程獲得文件對象的地址，并隨后調(diào)用fsync方法。通常這個方法以調(diào)用函數(shù)__writeback_single_inode()結束，
這個函數(shù)把與被選中的索引節(jié)點相關的臟頁和索引節(jié)點本身都寫回磁盤。
int (*fasync) (int, struct file *, int);
這個函數(shù)是系統(tǒng)支持異步通知的設備驅動，下面是這個函數(shù)的模板：
static int ***_fasync(int fd,struct file *filp,int mode)
{
struct ***_dev * dev=filp->private_data;
return fasync_helper(fd,filp,mode,&dev->async_queue);//第四個參數(shù)為 fasync_struct結構體指針的指針。
//這個函數(shù)是用來處理FASYNC標志的函數(shù)。（FASYNC：表示兼容BSD的fcntl同步操作）當這個標志改變時，驅動程序中的fasync（）函數(shù)將得到執(zhí)行。 （注：感覺這個‘標志'詞用的并不恰當）
}
此操作用來通知設備它的 FASYNC 標志的改變. 異步通知是一個高級的主題, 在第 6 章中描述.
這個成員可以是NULL 如果驅動不支持異步通知.
int (*lock) (struct file *, int, struct file_lock *);
lock 方法用來實現(xiàn)文件加鎖; 加鎖對常規(guī)文件是必不可少的特性, 但是設備驅動幾乎從不實現(xiàn)它.
ssize_t (*readv) (struct file *, const struct iovec *, unsigned long, loff_t *);
ssize_t (*writev) (struct file *, const struct iovec *, unsigned long, loff_t *);
這些方法實現(xiàn)發(fā)散/匯聚讀和寫操作. 應用程序偶爾需要做一個包含多個內(nèi)存區(qū)的單個讀或寫操作;
這些系統(tǒng)調(diào)用允許它們這樣做而不必對數(shù)據(jù)進行額外拷貝. 如果這些函數(shù)指針為 NULL, read 和 write 方法被調(diào)用( 可能多于一次 ).
ssize_t (*sendfile)(struct file *, loff_t *, size_t, read_actor_t, void *);
這個方法實現(xiàn) sendfile 系統(tǒng)調(diào)用的讀, 使用最少的拷貝從一個文件描述符搬移數(shù)據(jù)到另一個.
例如, 它被一個需要發(fā)送文件內(nèi)容到一個網(wǎng)絡連接的 web 服務器使用. 設備驅動常常使 sendfile 為 NULL.
ssize_t (*sendpage) (struct file *, struct page *, int, size_t, loff_t *, int);
sendpage 是 sendfile 的另一半; 它由內(nèi)核調(diào)用來發(fā)送數(shù)據(jù), 一次一頁, 到對應的文件. 設備驅動實際上不實現(xiàn) sendpage.
unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);
這個方法的目的是在進程的地址空間找一個合適的位置來映射在底層設備上的內(nèi)存段中.
這個任務通常由內(nèi)存管理代碼進行; 這個方法存在為了使驅動能強制特殊設備可能有的任何的對齊請求. 大部分驅動可以置這個方法為 NULL.[10]
int (*check_flags)(int)
這個方法允許模塊檢查傳遞給 fnctl(F_SETFL...) 調(diào)用的標志.
int (*dir_notify)(struct file *, unsigned long);
這個方法在應用程序使用 fcntl 來請求目錄改變通知時調(diào)用. 只對文件系統(tǒng)有用; 驅動不需要實現(xiàn) dir_notify.
一般情況下，進行設備驅動程序的設計只是比較注重下面的幾個方法：
struct file_operations ***_ops={
.owner = THIS_MODULE,
.llseek = ***_llseek,
.read = ***_read,
.write = ***_write,
.ioctl = ***_ioctl,
.open = ***_open,
.release = ***_release,
}; |
