## 16.5.?快速參考
~~~
#include <linux/fs.h>
int register_blkdev(unsigned int major, const char *name);
int unregister_blkdev(unsigned int major, const char *name);
~~~
register_blkdev 注冊一個塊驅動到內核, 并且, 可選地, 獲得一個主編號. 一個驅動可被注銷, 使用 unregister_blkdev.
~~~
struct block_device_operations
~~~
持有大部分塊驅動的方法的結構.
~~~
#include <linux/genhd.h>
struct gendisk;
~~~
描述內核中單個塊設備的結構.
~~~
struct gendisk *alloc_disk(int minors);
void add_disk(struct gendisk *gd);
~~~
分配 gendisk 結構的函數, 并且返回它們到系統.
~~~
void set_capacity(struct gendisk *gd, sector_t sectors);
~~~
存儲設備能力(以 512-字節)在 gendisk 結構中.
~~~
void add_disk(struct gendisk *gd);
~~~
添加一個磁盤到內核. 一旦調用這個函數, 你的磁盤的方法可被內核調用.
~~~
int check_disk_change(struct block_device *bdev);
~~~
一個內核函數, 檢查在給定磁盤驅動器中的介質改變, 并且采取要求的清理動作當檢測到這樣一個改變.
~~~
#include <linux/blkdev.h>
request_queue_t blk_init_queue(request_fn_proc *request, spinlock_t *lock);
void blk_cleanup_queue(request_queue_t *);
~~~
處理塊請求隊列的創建和刪除的函數.
~~~
struct request *elv_next_request(request_queue_t *queue);
void end_request(struct request *req, int success);
~~~
elv_next_request 從一個請求隊列中獲得下一個請求; end_request 可用在每個簡單驅動器中來標識一個(或部分)請求完成.
~~~
void blkdev_dequeue_request(struct request *req);
void elv_requeue_request(request_queue_t *queue, struct request *req);
~~~
從隊列中除去一個請求, 并且放回它的函數如果需要.
~~~
void blk_stop_queue(request_queue_t *queue);
void blk_start_queue(request_queue_t *queue);
~~~
如果你需要阻止對你的請求函數的進一步調用, 調用 blk_stop_queue 來完成. 調用 blk_start_queue 來使你的請求方法被再次調用.
~~~
void blk_queue_bounce_limit(request_queue_t *queue, u64 dma_addr);
void blk_queue_max_sectors(request_queue_t *queue, unsigned short max);
void blk_queue_max_phys_segments(request_queue_t *queue, unsigned short max);
void blk_queue_max_hw_segments(request_queue_t *queue, unsigned short max);
void blk_queue_max_segment_size(request_queue_t *queue, unsigned int max);
blk_queue_segment_boundary(request_queue_t *queue, unsigned long mask);
void blk_queue_dma_alignment(request_queue_t *queue, int mask);
void blk_queue_hardsect_size(request_queue_t *queue, unsigned short max);
~~~
設置各種隊列參數的函數, 來控制請求如何被創建給一個特殊設備; 這些參數在"隊列控制函數"一節中描述.
~~~
#include <linux/bio.h>
struct bio;
~~~
低級函數, 表示一個塊 I/O 請求的一部分.
~~~
bio_sectors(struct bio *bio);
bio_data_dir(struct bio *bio);
~~~
2 個宏定義, 表示一個由 bio 結構描述的傳送的大小和方向.
~~~
bio_for_each_segment(bvec, bio, segno);
~~~
一個偽控制結構, 用來循環組成一個 bio 結構的各個段.
~~~
char *__bio_kmap_atomic(struct bio *bio, int i, enum km_type type);
void __bio_kunmap_atomic(char *buffer, enum km_type type);
~~~
__bio_kmap_atomic 可用來創建一個內核虛擬地址給一個在 bio 結構中的給定的段. 映射必須使用 __bio_kunmap_atomic 來恢復.
~~~
struct page *bio_page(struct bio *bio);
int bio_offset(struct bio *bio);int bio_cur_sectors(struct bio *bio);
char *bio_data(struct bio *bio);
char *bio_kmap_irq(struct bio *bio, unsigned long *flags);
void bio_kunmap_irq(char *buffer, unsigned long *flags);
~~~
一組存取者宏定義, 提供對一個 bio 結構中的"當前"段的存取.
~~~
void blk_queue_ordered(request_queue_t *queue, int flag);
int blk_barrier_rq(struct request *req);
~~~
如果你的驅動實現屏障請求, 調用 blk_queue_ordered -- 如同它應當做的. 宏 blk_barrier_rq 返回一個非零值如果當前請求是一個屏障請求.
~~~
int blk_noretry_request(struct request *req);
~~~
這個宏返回一個非零值, 如果給定的請求不應當在出錯時重新嘗試.
~~~
int end_that_request_first(struct request *req, int success, int count);
void end_that_request_last(struct request *req);
~~~
使用 end_that_request_firest 來指示一個塊 I/O 請求的一部分完成. 當那個函數返回 0, 請求完成并且應當被傳遞給 end_that_request_last.
~~~
rq_for_each_bio(bio, request)
~~~
另一個用宏定義來實現的控制結構; 它步入構成一個請求的每個 bio.
~~~
int blk_rq_map_sg(request_queue_t *queue, struct request *req, struct scatterlist *list);
~~~
為一次 DMA 傳送填充給定的散布表, 用需要來映射給定請求中的緩沖的信息
~~~
typedef int (make_request_fn) (request_queue_t *q, struct bio *bio);
~~~
make_request 函數的原型.
~~~
void bio_endio(struct bio *bio, unsigned int bytes, int error);
~~~
指示一個給定 bio 的完成. 這個函數應當只用在你的驅動直接獲取 bio , 通過 make_request 函數從塊層.
~~~
request_queue_t *blk_alloc_queue(int flags);
void blk_queue_make_request(request_queue_t *queue, make_request_fn *func);
~~~
使用 blk_alloc_queue 來分配由定制的 make_request 函數使用的請求隊列, . 那個函數應當使用 blk_queue_make_request 來設置.
~~~
typedef int (prep_rq_fn) (request_queue_t *queue, struct request *req);
void blk_queue_prep_rq(request_queue_t *queue, prep_rq_fn *func);
~~~
一個命令準備函數的原型和設置函數, 它可用來準備必要的硬件命令, 在請求被傳遞給你的請求函數之前.
~~~
int blk_queue_init_tags(request_queue_t *queue, int depth, struct blk_queue_tag *tags);
int blk_queue_resize_tags(request_queue_t *queue, int new_depth);
int blk_queue_start_tag(request_queue_t *queue, struct request *req);
void blk_queue_end_tag(request_queue_t *queue, struct request *req);
struct request *blk_queue_find_tag(request_queue_t *qeue, int tag);void blk_queue_invalidate_tags(request_queue_t *queue);
~~~
驅動使用被標記的命令隊列的支持函數.
- Linux設備驅動第三版
- 第 1 章 設備驅動簡介
- 1.1. 驅動程序的角色
- 1.2. 劃分內核
- 1.3. 設備和模塊的分類
- 1.4. 安全問題
- 1.5. 版本編號
- 1.6. 版權條款
- 1.7. 加入內核開發社團
- 1.8. 本書的內容
- 第 2 章 建立和運行模塊
- 2.1. 設置你的測試系統
- 2.2. Hello World 模塊
- 2.3. 內核模塊相比于應用程序
- 2.4. 編譯和加載
- 2.5. 內核符號表
- 2.6. 預備知識
- 2.7. 初始化和關停
- 2.8. 模塊參數
- 2.9. 在用戶空間做
- 2.10. 快速參考
- 第 3 章 字符驅動
- 3.1. scull 的設計
- 3.2. 主次編號
- 3.3. 一些重要數據結構
- 3.4. 字符設備注冊
- 3.5. open 和 release
- 3.6. scull 的內存使用
- 3.7. 讀和寫
- 3.8. 使用新設備
- 3.9. 快速參考
- 第 4 章 調試技術
- 4.1. 內核中的調試支持
- 4.2. 用打印調試
- 4.3. 用查詢來調試
- 4.4. 使用觀察來調試
- 4.5. 調試系統故障
- 4.6. 調試器和相關工具
- 第 5 章 并發和競爭情況
- 5.1. scull 中的缺陷
- 5.2. 并發和它的管理
- 5.3. 旗標和互斥體
- 5.4. Completions 機制
- 5.5. 自旋鎖
- 5.6. 鎖陷阱
- 5.7. 加鎖的各種選擇
- 5.8. 快速參考
- 第 6 章 高級字符驅動操作
- 6.1. ioctl 接口
- 6.2. 阻塞 I/O
- 6.3. poll 和 select
- 6.4. 異步通知
- 6.5. 移位一個設備
- 6.6. 在一個設備文件上的存取控制
- 6.7. 快速參考
- 第 7 章 時間, 延時, 和延后工作
- 7.1. 測量時間流失
- 7.2. 獲知當前時間
- 7.3. 延后執行
- 7.4. 內核定時器
- 7.5. Tasklets 機制
- 7.6. 工作隊列
- 7.7. 快速參考
- 第 8 章 分配內存
- 8.1. kmalloc 的真實故事
- 8.2. 后備緩存
- 8.3. get_free_page 和其友
- 8.4. 每-CPU 的變量
- 8.5. 獲得大量緩沖
- 8.6. 快速參考
- 第 9 章 與硬件通訊
- 9.1. I/O 端口和 I/O 內存
- 9.2. 使用 I/O 端口
- 9.3. 一個 I/O 端口例子
- 9.4. 使用 I/O 內存
- 9.5. 快速參考
- 第 10 章 中斷處理
- 10.1. 準備并口
- 10.2. 安裝一個中斷處理
- 10.3. 前和后半部
- 10.4. 中斷共享
- 10.5. 中斷驅動 I/O
- 10.6. 快速參考
- 第 11 章 內核中的數據類型
- 11.1. 標準 C 類型的使用
- 11.2. 安排一個明確大小給數據項
- 11.3. 接口特定的類型
- 11.4. 其他移植性問題
- 11.5. 鏈表
- 11.6. 快速參考
- 第 12 章 PCI 驅動
- 12.1. PCI 接口
- 12.2. 回顧: ISA
- 12.3. PC/104 和 PC/104+
- 12.4. 其他的 PC 總線
- 12.5. SBus
- 12.6. NuBus 總線
- 12.7. 外部總線
- 12.8. 快速參考
- 第 13 章 USB 驅動
- 13.1. USB 設備基礎知識
- 13.2. USB 和 sysfs
- 13.3. USB 的 Urbs
- 13.4. 編寫一個 USB 驅動
- 13.5. 無 urb 的 USB 傳送
- 13.6. 快速參考
- 第 14 章 Linux 設備模型
- 14.1. Kobjects, Ksets 和 Subsystems
- 14.2. 低級 sysfs 操作
- 14.3. 熱插拔事件產生
- 14.4. 總線, 設備, 和驅動
- 14.5. 類
- 14.6. 集成起來
- 14.7. 熱插拔
- 14.8. 處理固件
- 14.9. 快速參考
- 第 15 章 內存映射和 DMA
- 15.1. Linux 中的內存管理
- 15.2. mmap 設備操作
- 15.3. 進行直接 I/O
- 15.4. 直接內存存取
- 15.5. 快速參考
- 第 16 章 塊驅動
- 16.1. 注冊
- 16.2. 塊設備操作
- 16.3. 請求處理
- 16.4. 一些其他的細節
- 16.5. 快速參考
- 第 17 章 網絡驅動
- 17.1. snull 是如何設計的
- 17.2. 連接到內核
- 17.3. net_device 結構的詳情
- 17.4. 打開與關閉
- 17.5. 報文傳送
- 17.6. 報文接收
- 17.7. 中斷處理
- 17.8. 接收中斷緩解
- 17.9. 連接狀態的改變
- 17.10. Socket 緩存
- 17.11. MAC 地址解析
- 17.12. 定制 ioctl 命令
- 17.13. 統計信息
- 17.14. 多播
- 17.15. 幾個其他細節
- 17.16. 快速參考
- 第 18 章 TTY 驅動
- 18.1. 一個小 TTY 驅動
- 18.2. tty_driver 函數指針
- 18.3. TTY 線路設置
- 18.4. ioctls 函數
- 18.5. TTY 設備的 proc 和 sysfs 處理
- 18.6. tty_driver 結構的細節
- 18.7. tty_operaions 結構的細節
- 18.8. tty_struct 結構的細節
- 18.9. 快速參考