16.5. 快速參考 · Linux 設備驅動 (第三版)

## 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); ~~~ 驅動使用被標記的命令隊列的支持函數.