#include<linux/fs.h>
intregister_blkdev(unsignedintmajor,constchar*name);
intunregister_blkdev(unsignedintmajor,constchar*name);
register_blkdev注册一个块驱动到内核,并且,可选地,获得一个主编号.一个驱动可被注销,使
用unregister_blkdev.
structblock_device_operations
持有大部分块驱动的方法的结构.
#include<linux/genhd.h>
structgendisk;
描述内核中单个块设备的结构.
structgendisk*alloc_disk(intminors);
voidadd_disk(structgendisk*gd);
分配gendisk结构的函数,并且返回它们到系统.
voidset_capacity(structgendisk*gd,sector_tsectors);
存储设备能力(以512-字节)在gendisk结构中.
voidadd_disk(structgendisk*gd);
添加一个磁盘到内核.一旦调用这个函数,你的磁盘的方法可被内核调用.
intcheck_disk_change(structblock_device*bdev);
一个内核函数,检查在给定磁盘驱动器中的介质改变,并且采取要求的清理动作当检测到这样一个改变.
#include<linux/blkdev.h>
request_queue_tblk_init_queue(request_fn_proc*request,spinlock_t*lock);
voidblk_cleanup_queue(request_queue_t*);
处理块请求队列的创建和删除的函数.
structrequest*elv_next_request(request_queue_t*queue);
voidend_request(structrequest*req,intsuccess);
elv_next_request从一个请求队列中获得下一个请求;end_request可用在每个简单驱动器中来
标识一个(或部分)请求完成.
voidblkdev_dequeue_request(structrequest*req);
voidelv_requeue_request(request_queue_t*queue,structrequest*req);
从队列中除去一个请求,并且放回它的函数如果需要.
voidblk_stop_queue(request_queue_t*queue);
voidblk_start_queue(request_queue_t*queue);
如果你需要阻止对你的请求函数的进一步调用,调用blk_stop_queue来完成.调用
blk_start_queue来使你的请求方法被再次调用.
voidblk_queue_bounce_limit(request_queue_t*queue,u64dma_addr);
voidblk_queue_max_sectors(request_queue_t*queue,unsignedshortmax);
voidblk_queue_max_phys_segments(request_queue_t*queue,unsignedshortmax);
voidblk_queue_max_hw_segments(request_queue_t*queue,unsignedshortmax);
voidblk_queue_max_segment_size(request_queue_t*queue,unsignedintmax);
blk_queue_segment_boundary(request_queue_t*queue,unsignedlongmask);
voidblk_queue_dma_alignment(request_queue_t*queue,intmask);
voidblk_queue_hardsect_size(request_queue_t*queue,unsignedshortmax);
设置各种队列参数的函数,来控制请求如何被创建给一个特殊设备;这些参数在"队列控制函数"一节中描述.
#include<linux/bio.h>
structbio;
低级函数,表示一个块I/O请求的一部分.
bio_sectors(structbio*bio);
bio_data_dir(structbio*bio);
2个宏定义,表示一个由bio结构描述的传送的大小和方向.
bio_for_each_segment(bvec,bio,segno);
一个伪控制结构,用来循环组成一个bio结构的各个段.
char*__bio_kmap_atomic(structbio*bio,inti,enumkm_typetype);
void__bio_kunmap_atomic(char*buffer,enumkm_typetype);
__bio_kmap_atomic可用来创建一个内核虚拟地址给一个在bio结构中的给定的段.映射必须使用__bio_kunmap_atomic来恢复.
structpage*bio_page(structbio*bio);
intbio_offset(structbio*bio);
intbio_cur_sectors(structbio*bio);
char*bio_data(structbio*bio);
char*bio_kmap_irq(structbio*bio,unsignedlong*flags);
voidbio_kunmap_irq(char*buffer,unsignedlong*flags);
一组存取者宏定义,提供对一个bio结构中的"当前"段的存取.
voidblk_queue_ordered(request_queue_t*queue,intflag);
intblk_barrier_rq(structrequest*req);
如果你的驱动实现屏障请求,调用blk_queue_ordered--如同它应当做的.宏blk_barrier_rq返回一个非零值如果当前请求是一个屏障请求.
intblk_noretry_request(structrequest*req);
这个宏返回一个非零值,如果给定的请求不应当在出错时重新尝试.
intend_that_request_first(structrequest*req,intsuccess,intcount);
voidend_that_request_last(structrequest*req);
使用end_that_request_firest来指示一个块I/O请求的一部分完成.当那个函数返回0,请求完成并且应当被传递给end_that_request_last.
rq_for_each_bio(bio,request)
另一个用宏定义来实现的控制结构;它步入构成一个请求的每个bio.
intblk_rq_map_sg(request_queue_t*queue,structrequest*req,structscatterlist*list);
为一次DMA传送填充给定的散布表,用需要来映射给定请求中的缓冲的信息
typedefint(make_request_fn)(request_queue_t*q,structbio*bio);
make_request函数的原型.
voidbio_endio(structbio*bio,unsignedintbytes,interror);
指示一个给定bio的完成.这个函数应当只用在你的驱动直接获取bio,通过make_request函
数从块层.
request_queue_t*blk_alloc_queue(intflags);
voidblk_queue_make_request(request_queue_t*queue,make_request_fn*func);
使用blk_alloc_queue来分配由定制的make_request函数使用的请求队列,.那个函数应当使
用blk_queue_make_request来设置.
typedefint(prep_rq_fn)(request_queue_t*queue,structrequest*req);
voidblk_queue_prep_rq(request_queue_t*queue,prep_rq_fn*func);
一个命令准备函数的原型和设置函数,它可用来准备必要的硬件命令,在请求被传递给你的
请求函数之前.
intblk_queue_init_tags(request_queue_t*queue,intdepth,structblk_queue_tag*tags);
intblk_queue_resize_tags(request_queue_t*queue,intnew_depth);
intblk_queue_start_tag(request_queue_t*queue,structrequest*req);
voidblk_queue_end_tag(request_queue_t*queue,structrequest*req);
structrequest*blk_queue_find_tag(request_queue_t*qeue,inttag);
voidblk_queue_invalidate_tags(request_queue_t*queue);
驱动使用被标记的命令队列的支持函数.