16.5. 快速参考
最后更新于：2022-04-01 03:00:27
## 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);
~~~
驱动使用被标记的命令队列的支持函数.