## 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); ~~~ 驱动使用被标记的命令队列的支持函数.