blkdev.h 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089
  1. #ifndef _LINUX_BLKDEV_H
  2. #define _LINUX_BLKDEV_H
  3. #ifdef CONFIG_BLOCK
  4. #include <linux/sched.h>
  5. #include <linux/major.h>
  6. #include <linux/genhd.h>
  7. #include <linux/list.h>
  8. #include <linux/timer.h>
  9. #include <linux/workqueue.h>
  10. #include <linux/pagemap.h>
  11. #include <linux/backing-dev.h>
  12. #include <linux/wait.h>
  13. #include <linux/mempool.h>
  14. #include <linux/bio.h>
  15. #include <linux/module.h>
  16. #include <linux/stringify.h>
  17. #include <linux/gfp.h>
  18. #include <linux/bsg.h>
  19. #include <linux/smp.h>
  20. #include <asm/scatterlist.h>
  21. struct scsi_ioctl_command;
  22. struct request_queue;
  23. struct elevator_queue;
  24. typedef struct elevator_queue elevator_t;
  25. struct request_pm_state;
  26. struct blk_trace;
  27. struct request;
  28. struct sg_io_hdr;
  29. #define BLKDEV_MIN_RQ 4
  30. #define BLKDEV_MAX_RQ 128 /* Default maximum */
  31. struct request;
  32. typedef void (rq_end_io_fn)(struct request *, int);
  33. struct request_list {
  34. int count[2];
  35. int starved[2];
  36. int elvpriv;
  37. mempool_t *rq_pool;
  38. wait_queue_head_t wait[2];
  39. };
  40. /*
  41. * request command types
  42. */
  43. enum rq_cmd_type_bits {
  44. REQ_TYPE_FS = 1, /* fs request */
  45. REQ_TYPE_BLOCK_PC, /* scsi command */
  46. REQ_TYPE_SENSE, /* sense request */
  47. REQ_TYPE_PM_SUSPEND, /* suspend request */
  48. REQ_TYPE_PM_RESUME, /* resume request */
  49. REQ_TYPE_PM_SHUTDOWN, /* shutdown request */
  50. REQ_TYPE_SPECIAL, /* driver defined type */
  51. REQ_TYPE_LINUX_BLOCK, /* generic block layer message */
  52. /*
  53. * for ATA/ATAPI devices. this really doesn't belong here, ide should
  54. * use REQ_TYPE_SPECIAL and use rq->cmd[0] with the range of driver
  55. * private REQ_LB opcodes to differentiate what type of request this is
  56. */
  57. REQ_TYPE_ATA_TASKFILE,
  58. REQ_TYPE_ATA_PC,
  59. };
  60. /*
  61. * For request of type REQ_TYPE_LINUX_BLOCK, rq->cmd[0] is the opcode being
  62. * sent down (similar to how REQ_TYPE_BLOCK_PC means that ->cmd[] holds a
  63. * SCSI cdb.
  64. *
  65. * 0x00 -> 0x3f are driver private, to be used for whatever purpose they need,
  66. * typically to differentiate REQ_TYPE_SPECIAL requests.
  67. *
  68. */
  69. enum {
  70. REQ_LB_OP_EJECT = 0x40, /* eject request */
  71. REQ_LB_OP_FLUSH = 0x41, /* flush request */
  72. REQ_LB_OP_DISCARD = 0x42, /* discard sectors */
  73. };
  74. /*
  75. * request type modified bits. first two bits match BIO_RW* bits, important
  76. */
  77. enum rq_flag_bits {
  78. __REQ_RW, /* not set, read. set, write */
  79. __REQ_FAILFAST_DEV, /* no driver retries of device errors */
  80. __REQ_FAILFAST_TRANSPORT, /* no driver retries of transport errors */
  81. __REQ_FAILFAST_DRIVER, /* no driver retries of driver errors */
  82. __REQ_DISCARD, /* request to discard sectors */
  83. __REQ_SORTED, /* elevator knows about this request */
  84. __REQ_SOFTBARRIER, /* may not be passed by ioscheduler */
  85. __REQ_HARDBARRIER, /* may not be passed by drive either */
  86. __REQ_FUA, /* forced unit access */
  87. __REQ_NOMERGE, /* don't touch this for merging */
  88. __REQ_STARTED, /* drive already may have started this one */
  89. __REQ_DONTPREP, /* don't call prep for this one */
  90. __REQ_QUEUED, /* uses queueing */
  91. __REQ_ELVPRIV, /* elevator private data attached */
  92. __REQ_FAILED, /* set if the request failed */
  93. __REQ_QUIET, /* don't worry about errors */
  94. __REQ_PREEMPT, /* set for "ide_preempt" requests */
  95. __REQ_ORDERED_COLOR, /* is before or after barrier */
  96. __REQ_RW_SYNC, /* request is sync (O_DIRECT) */
  97. __REQ_ALLOCED, /* request came from our alloc pool */
  98. __REQ_RW_META, /* metadata io request */
  99. __REQ_COPY_USER, /* contains copies of user pages */
  100. __REQ_INTEGRITY, /* integrity metadata has been remapped */
  101. __REQ_NR_BITS, /* stops here */
  102. };
  103. #define REQ_RW (1 << __REQ_RW)
  104. #define REQ_FAILFAST_DEV (1 << __REQ_FAILFAST_DEV)
  105. #define REQ_FAILFAST_TRANSPORT (1 << __REQ_FAILFAST_TRANSPORT)
  106. #define REQ_FAILFAST_DRIVER (1 << __REQ_FAILFAST_DRIVER)
  107. #define REQ_DISCARD (1 << __REQ_DISCARD)
  108. #define REQ_SORTED (1 << __REQ_SORTED)
  109. #define REQ_SOFTBARRIER (1 << __REQ_SOFTBARRIER)
  110. #define REQ_HARDBARRIER (1 << __REQ_HARDBARRIER)
  111. #define REQ_FUA (1 << __REQ_FUA)
  112. #define REQ_NOMERGE (1 << __REQ_NOMERGE)
  113. #define REQ_STARTED (1 << __REQ_STARTED)
  114. #define REQ_DONTPREP (1 << __REQ_DONTPREP)
  115. #define REQ_QUEUED (1 << __REQ_QUEUED)
  116. #define REQ_ELVPRIV (1 << __REQ_ELVPRIV)
  117. #define REQ_FAILED (1 << __REQ_FAILED)
  118. #define REQ_QUIET (1 << __REQ_QUIET)
  119. #define REQ_PREEMPT (1 << __REQ_PREEMPT)
  120. #define REQ_ORDERED_COLOR (1 << __REQ_ORDERED_COLOR)
  121. #define REQ_RW_SYNC (1 << __REQ_RW_SYNC)
  122. #define REQ_ALLOCED (1 << __REQ_ALLOCED)
  123. #define REQ_RW_META (1 << __REQ_RW_META)
  124. #define REQ_COPY_USER (1 << __REQ_COPY_USER)
  125. #define REQ_INTEGRITY (1 << __REQ_INTEGRITY)
  126. #define BLK_MAX_CDB 16
  127. /*
  128. * try to put the fields that are referenced together in the same cacheline.
  129. * if you modify this structure, be sure to check block/blk-core.c:rq_init()
  130. * as well!
  131. */
  132. struct request {
  133. struct list_head queuelist;
  134. struct call_single_data csd;
  135. int cpu;
  136. struct request_queue *q;
  137. unsigned int cmd_flags;
  138. enum rq_cmd_type_bits cmd_type;
  139. unsigned long atomic_flags;
  140. /* Maintain bio traversal state for part by part I/O submission.
  141. * hard_* are block layer internals, no driver should touch them!
  142. */
  143. sector_t sector; /* next sector to submit */
  144. sector_t hard_sector; /* next sector to complete */
  145. unsigned long nr_sectors; /* no. of sectors left to submit */
  146. unsigned long hard_nr_sectors; /* no. of sectors left to complete */
  147. /* no. of sectors left to submit in the current segment */
  148. unsigned int current_nr_sectors;
  149. /* no. of sectors left to complete in the current segment */
  150. unsigned int hard_cur_sectors;
  151. struct bio *bio;
  152. struct bio *biotail;
  153. struct hlist_node hash; /* merge hash */
  154. /*
  155. * The rb_node is only used inside the io scheduler, requests
  156. * are pruned when moved to the dispatch queue. So let the
  157. * completion_data share space with the rb_node.
  158. */
  159. union {
  160. struct rb_node rb_node; /* sort/lookup */
  161. void *completion_data;
  162. };
  163. /*
  164. * two pointers are available for the IO schedulers, if they need
  165. * more they have to dynamically allocate it.
  166. */
  167. void *elevator_private;
  168. void *elevator_private2;
  169. struct gendisk *rq_disk;
  170. unsigned long start_time;
  171. /* Number of scatter-gather DMA addr+len pairs after
  172. * physical address coalescing is performed.
  173. */
  174. unsigned short nr_phys_segments;
  175. unsigned short ioprio;
  176. void *special;
  177. char *buffer;
  178. int tag;
  179. int errors;
  180. int ref_count;
  181. /*
  182. * when request is used as a packet command carrier
  183. */
  184. unsigned short cmd_len;
  185. unsigned char __cmd[BLK_MAX_CDB];
  186. unsigned char *cmd;
  187. unsigned int data_len;
  188. unsigned int extra_len; /* length of alignment and padding */
  189. unsigned int sense_len;
  190. void *data;
  191. void *sense;
  192. unsigned long deadline;
  193. struct list_head timeout_list;
  194. unsigned int timeout;
  195. int retries;
  196. /*
  197. * completion callback.
  198. */
  199. rq_end_io_fn *end_io;
  200. void *end_io_data;
  201. /* for bidi */
  202. struct request *next_rq;
  203. };
  204. static inline unsigned short req_get_ioprio(struct request *req)
  205. {
  206. return req->ioprio;
  207. }
  208. /*
  209. * State information carried for REQ_TYPE_PM_SUSPEND and REQ_TYPE_PM_RESUME
  210. * requests. Some step values could eventually be made generic.
  211. */
  212. struct request_pm_state
  213. {
  214. /* PM state machine step value, currently driver specific */
  215. int pm_step;
  216. /* requested PM state value (S1, S2, S3, S4, ...) */
  217. u32 pm_state;
  218. void* data; /* for driver use */
  219. };
  220. #include <linux/elevator.h>
  221. typedef void (request_fn_proc) (struct request_queue *q);
  222. typedef int (make_request_fn) (struct request_queue *q, struct bio *bio);
  223. typedef int (prep_rq_fn) (struct request_queue *, struct request *);
  224. typedef void (unplug_fn) (struct request_queue *);
  225. typedef int (prepare_discard_fn) (struct request_queue *, struct request *);
  226. struct bio_vec;
  227. struct bvec_merge_data {
  228. struct block_device *bi_bdev;
  229. sector_t bi_sector;
  230. unsigned bi_size;
  231. unsigned long bi_rw;
  232. };
  233. typedef int (merge_bvec_fn) (struct request_queue *, struct bvec_merge_data *,
  234. struct bio_vec *);
  235. typedef void (prepare_flush_fn) (struct request_queue *, struct request *);
  236. typedef void (softirq_done_fn)(struct request *);
  237. typedef int (dma_drain_needed_fn)(struct request *);
  238. typedef int (lld_busy_fn) (struct request_queue *q);
  239. enum blk_eh_timer_return {
  240. BLK_EH_NOT_HANDLED,
  241. BLK_EH_HANDLED,
  242. BLK_EH_RESET_TIMER,
  243. };
  244. typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
  245. enum blk_queue_state {
  246. Queue_down,
  247. Queue_up,
  248. };
  249. struct blk_queue_tag {
  250. struct request **tag_index; /* map of busy tags */
  251. unsigned long *tag_map; /* bit map of free/busy tags */
  252. int busy; /* current depth */
  253. int max_depth; /* what we will send to device */
  254. int real_max_depth; /* what the array can hold */
  255. atomic_t refcnt; /* map can be shared */
  256. };
  257. #define BLK_SCSI_MAX_CMDS (256)
  258. #define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
  259. struct blk_cmd_filter {
  260. unsigned long read_ok[BLK_SCSI_CMD_PER_LONG];
  261. unsigned long write_ok[BLK_SCSI_CMD_PER_LONG];
  262. struct kobject kobj;
  263. };
  264. struct request_queue
  265. {
  266. /*
  267. * Together with queue_head for cacheline sharing
  268. */
  269. struct list_head queue_head;
  270. struct request *last_merge;
  271. elevator_t *elevator;
  272. /*
  273. * the queue request freelist, one for reads and one for writes
  274. */
  275. struct request_list rq;
  276. request_fn_proc *request_fn;
  277. make_request_fn *make_request_fn;
  278. prep_rq_fn *prep_rq_fn;
  279. unplug_fn *unplug_fn;
  280. prepare_discard_fn *prepare_discard_fn;
  281. merge_bvec_fn *merge_bvec_fn;
  282. prepare_flush_fn *prepare_flush_fn;
  283. softirq_done_fn *softirq_done_fn;
  284. rq_timed_out_fn *rq_timed_out_fn;
  285. dma_drain_needed_fn *dma_drain_needed;
  286. lld_busy_fn *lld_busy_fn;
  287. /*
  288. * Dispatch queue sorting
  289. */
  290. sector_t end_sector;
  291. struct request *boundary_rq;
  292. /*
  293. * Auto-unplugging state
  294. */
  295. struct timer_list unplug_timer;
  296. int unplug_thresh; /* After this many requests */
  297. unsigned long unplug_delay; /* After this many jiffies */
  298. struct work_struct unplug_work;
  299. struct backing_dev_info backing_dev_info;
  300. /*
  301. * The queue owner gets to use this for whatever they like.
  302. * ll_rw_blk doesn't touch it.
  303. */
  304. void *queuedata;
  305. /*
  306. * queue needs bounce pages for pages above this limit
  307. */
  308. unsigned long bounce_pfn;
  309. gfp_t bounce_gfp;
  310. /*
  311. * various queue flags, see QUEUE_* below
  312. */
  313. unsigned long queue_flags;
  314. /*
  315. * protects queue structures from reentrancy. ->__queue_lock should
  316. * _never_ be used directly, it is queue private. always use
  317. * ->queue_lock.
  318. */
  319. spinlock_t __queue_lock;
  320. spinlock_t *queue_lock;
  321. /*
  322. * queue kobject
  323. */
  324. struct kobject kobj;
  325. /*
  326. * queue settings
  327. */
  328. unsigned long nr_requests; /* Max # of requests */
  329. unsigned int nr_congestion_on;
  330. unsigned int nr_congestion_off;
  331. unsigned int nr_batching;
  332. unsigned int max_sectors;
  333. unsigned int max_hw_sectors;
  334. unsigned short max_phys_segments;
  335. unsigned short max_hw_segments;
  336. unsigned short hardsect_size;
  337. unsigned int max_segment_size;
  338. unsigned long seg_boundary_mask;
  339. void *dma_drain_buffer;
  340. unsigned int dma_drain_size;
  341. unsigned int dma_pad_mask;
  342. unsigned int dma_alignment;
  343. struct blk_queue_tag *queue_tags;
  344. struct list_head tag_busy_list;
  345. unsigned int nr_sorted;
  346. unsigned int in_flight;
  347. unsigned int rq_timeout;
  348. struct timer_list timeout;
  349. struct list_head timeout_list;
  350. /*
  351. * sg stuff
  352. */
  353. unsigned int sg_timeout;
  354. unsigned int sg_reserved_size;
  355. int node;
  356. #ifdef CONFIG_BLK_DEV_IO_TRACE
  357. struct blk_trace *blk_trace;
  358. #endif
  359. /*
  360. * reserved for flush operations
  361. */
  362. unsigned int ordered, next_ordered, ordseq;
  363. int orderr, ordcolor;
  364. struct request pre_flush_rq, bar_rq, post_flush_rq;
  365. struct request *orig_bar_rq;
  366. struct mutex sysfs_lock;
  367. #if defined(CONFIG_BLK_DEV_BSG)
  368. struct bsg_class_device bsg_dev;
  369. #endif
  370. struct blk_cmd_filter cmd_filter;
  371. };
  372. #define QUEUE_FLAG_CLUSTER 0 /* cluster several segments into 1 */
  373. #define QUEUE_FLAG_QUEUED 1 /* uses generic tag queueing */
  374. #define QUEUE_FLAG_STOPPED 2 /* queue is stopped */
  375. #define QUEUE_FLAG_READFULL 3 /* read queue has been filled */
  376. #define QUEUE_FLAG_WRITEFULL 4 /* write queue has been filled */
  377. #define QUEUE_FLAG_DEAD 5 /* queue being torn down */
  378. #define QUEUE_FLAG_REENTER 6 /* Re-entrancy avoidance */
  379. #define QUEUE_FLAG_PLUGGED 7 /* queue is plugged */
  380. #define QUEUE_FLAG_ELVSWITCH 8 /* don't use elevator, just do FIFO */
  381. #define QUEUE_FLAG_BIDI 9 /* queue supports bidi requests */
  382. #define QUEUE_FLAG_NOMERGES 10 /* disable merge attempts */
  383. #define QUEUE_FLAG_SAME_COMP 11 /* force complete on same CPU */
  384. #define QUEUE_FLAG_FAIL_IO 12 /* fake timeout */
  385. #define QUEUE_FLAG_STACKABLE 13 /* supports request stacking */
  386. #define QUEUE_FLAG_NONROT 14 /* non-rotational device (SSD) */
  387. #define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
  388. static inline int queue_is_locked(struct request_queue *q)
  389. {
  390. #ifdef CONFIG_SMP
  391. spinlock_t *lock = q->queue_lock;
  392. return lock && spin_is_locked(lock);
  393. #else
  394. return 1;
  395. #endif
  396. }
  397. static inline void queue_flag_set_unlocked(unsigned int flag,
  398. struct request_queue *q)
  399. {
  400. __set_bit(flag, &q->queue_flags);
  401. }
  402. static inline int queue_flag_test_and_clear(unsigned int flag,
  403. struct request_queue *q)
  404. {
  405. WARN_ON_ONCE(!queue_is_locked(q));
  406. if (test_bit(flag, &q->queue_flags)) {
  407. __clear_bit(flag, &q->queue_flags);
  408. return 1;
  409. }
  410. return 0;
  411. }
  412. static inline int queue_flag_test_and_set(unsigned int flag,
  413. struct request_queue *q)
  414. {
  415. WARN_ON_ONCE(!queue_is_locked(q));
  416. if (!test_bit(flag, &q->queue_flags)) {
  417. __set_bit(flag, &q->queue_flags);
  418. return 0;
  419. }
  420. return 1;
  421. }
  422. static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
  423. {
  424. WARN_ON_ONCE(!queue_is_locked(q));
  425. __set_bit(flag, &q->queue_flags);
  426. }
  427. static inline void queue_flag_clear_unlocked(unsigned int flag,
  428. struct request_queue *q)
  429. {
  430. __clear_bit(flag, &q->queue_flags);
  431. }
  432. static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
  433. {
  434. WARN_ON_ONCE(!queue_is_locked(q));
  435. __clear_bit(flag, &q->queue_flags);
  436. }
  437. enum {
  438. /*
  439. * Hardbarrier is supported with one of the following methods.
  440. *
  441. * NONE : hardbarrier unsupported
  442. * DRAIN : ordering by draining is enough
  443. * DRAIN_FLUSH : ordering by draining w/ pre and post flushes
  444. * DRAIN_FUA : ordering by draining w/ pre flush and FUA write
  445. * TAG : ordering by tag is enough
  446. * TAG_FLUSH : ordering by tag w/ pre and post flushes
  447. * TAG_FUA : ordering by tag w/ pre flush and FUA write
  448. */
  449. QUEUE_ORDERED_NONE = 0x00,
  450. QUEUE_ORDERED_DRAIN = 0x01,
  451. QUEUE_ORDERED_TAG = 0x02,
  452. QUEUE_ORDERED_PREFLUSH = 0x10,
  453. QUEUE_ORDERED_POSTFLUSH = 0x20,
  454. QUEUE_ORDERED_FUA = 0x40,
  455. QUEUE_ORDERED_DRAIN_FLUSH = QUEUE_ORDERED_DRAIN |
  456. QUEUE_ORDERED_PREFLUSH | QUEUE_ORDERED_POSTFLUSH,
  457. QUEUE_ORDERED_DRAIN_FUA = QUEUE_ORDERED_DRAIN |
  458. QUEUE_ORDERED_PREFLUSH | QUEUE_ORDERED_FUA,
  459. QUEUE_ORDERED_TAG_FLUSH = QUEUE_ORDERED_TAG |
  460. QUEUE_ORDERED_PREFLUSH | QUEUE_ORDERED_POSTFLUSH,
  461. QUEUE_ORDERED_TAG_FUA = QUEUE_ORDERED_TAG |
  462. QUEUE_ORDERED_PREFLUSH | QUEUE_ORDERED_FUA,
  463. /*
  464. * Ordered operation sequence
  465. */
  466. QUEUE_ORDSEQ_STARTED = 0x01, /* flushing in progress */
  467. QUEUE_ORDSEQ_DRAIN = 0x02, /* waiting for the queue to be drained */
  468. QUEUE_ORDSEQ_PREFLUSH = 0x04, /* pre-flushing in progress */
  469. QUEUE_ORDSEQ_BAR = 0x08, /* original barrier req in progress */
  470. QUEUE_ORDSEQ_POSTFLUSH = 0x10, /* post-flushing in progress */
  471. QUEUE_ORDSEQ_DONE = 0x20,
  472. };
  473. #define blk_queue_plugged(q) test_bit(QUEUE_FLAG_PLUGGED, &(q)->queue_flags)
  474. #define blk_queue_tagged(q) test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
  475. #define blk_queue_stopped(q) test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
  476. #define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
  477. #define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
  478. #define blk_queue_flushing(q) ((q)->ordseq)
  479. #define blk_queue_stackable(q) \
  480. test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
  481. #define blk_fs_request(rq) ((rq)->cmd_type == REQ_TYPE_FS)
  482. #define blk_pc_request(rq) ((rq)->cmd_type == REQ_TYPE_BLOCK_PC)
  483. #define blk_special_request(rq) ((rq)->cmd_type == REQ_TYPE_SPECIAL)
  484. #define blk_sense_request(rq) ((rq)->cmd_type == REQ_TYPE_SENSE)
  485. #define blk_failfast_dev(rq) ((rq)->cmd_flags & REQ_FAILFAST_DEV)
  486. #define blk_failfast_transport(rq) ((rq)->cmd_flags & REQ_FAILFAST_TRANSPORT)
  487. #define blk_failfast_driver(rq) ((rq)->cmd_flags & REQ_FAILFAST_DRIVER)
  488. #define blk_noretry_request(rq) (blk_failfast_dev(rq) || \
  489. blk_failfast_transport(rq) || \
  490. blk_failfast_driver(rq))
  491. #define blk_rq_started(rq) ((rq)->cmd_flags & REQ_STARTED)
  492. #define blk_account_rq(rq) (blk_rq_started(rq) && (blk_fs_request(rq) || blk_discard_rq(rq)))
  493. #define blk_pm_suspend_request(rq) ((rq)->cmd_type == REQ_TYPE_PM_SUSPEND)
  494. #define blk_pm_resume_request(rq) ((rq)->cmd_type == REQ_TYPE_PM_RESUME)
  495. #define blk_pm_request(rq) \
  496. (blk_pm_suspend_request(rq) || blk_pm_resume_request(rq))
  497. #define blk_rq_cpu_valid(rq) ((rq)->cpu != -1)
  498. #define blk_sorted_rq(rq) ((rq)->cmd_flags & REQ_SORTED)
  499. #define blk_barrier_rq(rq) ((rq)->cmd_flags & REQ_HARDBARRIER)
  500. #define blk_fua_rq(rq) ((rq)->cmd_flags & REQ_FUA)
  501. #define blk_discard_rq(rq) ((rq)->cmd_flags & REQ_DISCARD)
  502. #define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
  503. #define blk_empty_barrier(rq) (blk_barrier_rq(rq) && blk_fs_request(rq) && !(rq)->hard_nr_sectors)
  504. /* rq->queuelist of dequeued request must be list_empty() */
  505. #define blk_queued_rq(rq) (!list_empty(&(rq)->queuelist))
  506. #define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
  507. #define rq_data_dir(rq) ((rq)->cmd_flags & 1)
  508. /*
  509. * We regard a request as sync, if it's a READ or a SYNC write.
  510. */
  511. #define rq_is_sync(rq) (rq_data_dir((rq)) == READ || (rq)->cmd_flags & REQ_RW_SYNC)
  512. #define rq_is_meta(rq) ((rq)->cmd_flags & REQ_RW_META)
  513. static inline int blk_queue_full(struct request_queue *q, int rw)
  514. {
  515. if (rw == READ)
  516. return test_bit(QUEUE_FLAG_READFULL, &q->queue_flags);
  517. return test_bit(QUEUE_FLAG_WRITEFULL, &q->queue_flags);
  518. }
  519. static inline void blk_set_queue_full(struct request_queue *q, int rw)
  520. {
  521. if (rw == READ)
  522. queue_flag_set(QUEUE_FLAG_READFULL, q);
  523. else
  524. queue_flag_set(QUEUE_FLAG_WRITEFULL, q);
  525. }
  526. static inline void blk_clear_queue_full(struct request_queue *q, int rw)
  527. {
  528. if (rw == READ)
  529. queue_flag_clear(QUEUE_FLAG_READFULL, q);
  530. else
  531. queue_flag_clear(QUEUE_FLAG_WRITEFULL, q);
  532. }
  533. /*
  534. * mergeable request must not have _NOMERGE or _BARRIER bit set, nor may
  535. * it already be started by driver.
  536. */
  537. #define RQ_NOMERGE_FLAGS \
  538. (REQ_NOMERGE | REQ_STARTED | REQ_HARDBARRIER | REQ_SOFTBARRIER)
  539. #define rq_mergeable(rq) \
  540. (!((rq)->cmd_flags & RQ_NOMERGE_FLAGS) && \
  541. (blk_discard_rq(rq) || blk_fs_request((rq))))
  542. /*
  543. * q->prep_rq_fn return values
  544. */
  545. #define BLKPREP_OK 0 /* serve it */
  546. #define BLKPREP_KILL 1 /* fatal error, kill */
  547. #define BLKPREP_DEFER 2 /* leave on queue */
  548. extern unsigned long blk_max_low_pfn, blk_max_pfn;
  549. /*
  550. * standard bounce addresses:
  551. *
  552. * BLK_BOUNCE_HIGH : bounce all highmem pages
  553. * BLK_BOUNCE_ANY : don't bounce anything
  554. * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
  555. */
  556. #if BITS_PER_LONG == 32
  557. #define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
  558. #else
  559. #define BLK_BOUNCE_HIGH -1ULL
  560. #endif
  561. #define BLK_BOUNCE_ANY (-1ULL)
  562. #define BLK_BOUNCE_ISA (ISA_DMA_THRESHOLD)
  563. /*
  564. * default timeout for SG_IO if none specified
  565. */
  566. #define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
  567. #define BLK_MIN_SG_TIMEOUT (7 * HZ)
  568. #ifdef CONFIG_BOUNCE
  569. extern int init_emergency_isa_pool(void);
  570. extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
  571. #else
  572. static inline int init_emergency_isa_pool(void)
  573. {
  574. return 0;
  575. }
  576. static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
  577. {
  578. }
  579. #endif /* CONFIG_MMU */
  580. struct rq_map_data {
  581. struct page **pages;
  582. int page_order;
  583. int nr_entries;
  584. };
  585. struct req_iterator {
  586. int i;
  587. struct bio *bio;
  588. };
  589. /* This should not be used directly - use rq_for_each_segment */
  590. #define __rq_for_each_bio(_bio, rq) \
  591. if ((rq->bio)) \
  592. for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
  593. #define rq_for_each_segment(bvl, _rq, _iter) \
  594. __rq_for_each_bio(_iter.bio, _rq) \
  595. bio_for_each_segment(bvl, _iter.bio, _iter.i)
  596. #define rq_iter_last(rq, _iter) \
  597. (_iter.bio->bi_next == NULL && _iter.i == _iter.bio->bi_vcnt-1)
  598. extern int blk_register_queue(struct gendisk *disk);
  599. extern void blk_unregister_queue(struct gendisk *disk);
  600. extern void register_disk(struct gendisk *dev);
  601. extern void generic_make_request(struct bio *bio);
  602. extern void blk_rq_init(struct request_queue *q, struct request *rq);
  603. extern void blk_put_request(struct request *);
  604. extern void __blk_put_request(struct request_queue *, struct request *);
  605. extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
  606. extern void blk_insert_request(struct request_queue *, struct request *, int, void *);
  607. extern void blk_requeue_request(struct request_queue *, struct request *);
  608. extern int blk_rq_check_limits(struct request_queue *q, struct request *rq);
  609. extern int blk_lld_busy(struct request_queue *q);
  610. extern int blk_insert_cloned_request(struct request_queue *q,
  611. struct request *rq);
  612. extern void blk_plug_device(struct request_queue *);
  613. extern void blk_plug_device_unlocked(struct request_queue *);
  614. extern int blk_remove_plug(struct request_queue *);
  615. extern void blk_recount_segments(struct request_queue *, struct bio *);
  616. extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
  617. unsigned int, void __user *);
  618. extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
  619. struct scsi_ioctl_command __user *);
  620. /*
  621. * Temporary export, until SCSI gets fixed up.
  622. */
  623. extern int blk_rq_append_bio(struct request_queue *q, struct request *rq,
  624. struct bio *bio);
  625. /*
  626. * A queue has just exitted congestion. Note this in the global counter of
  627. * congested queues, and wake up anyone who was waiting for requests to be
  628. * put back.
  629. */
  630. static inline void blk_clear_queue_congested(struct request_queue *q, int rw)
  631. {
  632. clear_bdi_congested(&q->backing_dev_info, rw);
  633. }
  634. /*
  635. * A queue has just entered congestion. Flag that in the queue's VM-visible
  636. * state flags and increment the global gounter of congested queues.
  637. */
  638. static inline void blk_set_queue_congested(struct request_queue *q, int rw)
  639. {
  640. set_bdi_congested(&q->backing_dev_info, rw);
  641. }
  642. extern void blk_start_queue(struct request_queue *q);
  643. extern void blk_stop_queue(struct request_queue *q);
  644. extern void blk_sync_queue(struct request_queue *q);
  645. extern void __blk_stop_queue(struct request_queue *q);
  646. extern void __blk_run_queue(struct request_queue *);
  647. extern void blk_run_queue(struct request_queue *);
  648. extern void blk_start_queueing(struct request_queue *);
  649. extern int blk_rq_map_user(struct request_queue *, struct request *,
  650. struct rq_map_data *, void __user *, unsigned long,
  651. gfp_t);
  652. extern int blk_rq_unmap_user(struct bio *);
  653. extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
  654. extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
  655. struct rq_map_data *, struct sg_iovec *, int,
  656. unsigned int, gfp_t);
  657. extern int blk_execute_rq(struct request_queue *, struct gendisk *,
  658. struct request *, int);
  659. extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
  660. struct request *, int, rq_end_io_fn *);
  661. extern void blk_unplug(struct request_queue *q);
  662. static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
  663. {
  664. return bdev->bd_disk->queue;
  665. }
  666. static inline void blk_run_backing_dev(struct backing_dev_info *bdi,
  667. struct page *page)
  668. {
  669. if (bdi && bdi->unplug_io_fn)
  670. bdi->unplug_io_fn(bdi, page);
  671. }
  672. static inline void blk_run_address_space(struct address_space *mapping)
  673. {
  674. if (mapping)
  675. blk_run_backing_dev(mapping->backing_dev_info, NULL);
  676. }
  677. extern void blkdev_dequeue_request(struct request *req);
  678. /*
  679. * blk_end_request() and friends.
  680. * __blk_end_request() and end_request() must be called with
  681. * the request queue spinlock acquired.
  682. *
  683. * Several drivers define their own end_request and call
  684. * blk_end_request() for parts of the original function.
  685. * This prevents code duplication in drivers.
  686. */
  687. extern int blk_end_request(struct request *rq, int error,
  688. unsigned int nr_bytes);
  689. extern int __blk_end_request(struct request *rq, int error,
  690. unsigned int nr_bytes);
  691. extern int blk_end_bidi_request(struct request *rq, int error,
  692. unsigned int nr_bytes, unsigned int bidi_bytes);
  693. extern void end_request(struct request *, int);
  694. extern int blk_end_request_callback(struct request *rq, int error,
  695. unsigned int nr_bytes,
  696. int (drv_callback)(struct request *));
  697. extern void blk_complete_request(struct request *);
  698. extern void __blk_complete_request(struct request *);
  699. extern void blk_abort_request(struct request *);
  700. extern void blk_abort_queue(struct request_queue *);
  701. extern void blk_update_request(struct request *rq, int error,
  702. unsigned int nr_bytes);
  703. /*
  704. * blk_end_request() takes bytes instead of sectors as a complete size.
  705. * blk_rq_bytes() returns bytes left to complete in the entire request.
  706. * blk_rq_cur_bytes() returns bytes left to complete in the current segment.
  707. */
  708. extern unsigned int blk_rq_bytes(struct request *rq);
  709. extern unsigned int blk_rq_cur_bytes(struct request *rq);
  710. /*
  711. * Access functions for manipulating queue properties
  712. */
  713. extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
  714. spinlock_t *lock, int node_id);
  715. extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
  716. extern void blk_cleanup_queue(struct request_queue *);
  717. extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
  718. extern void blk_queue_bounce_limit(struct request_queue *, u64);
  719. extern void blk_queue_max_sectors(struct request_queue *, unsigned int);
  720. extern void blk_queue_max_phys_segments(struct request_queue *, unsigned short);
  721. extern void blk_queue_max_hw_segments(struct request_queue *, unsigned short);
  722. extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
  723. extern void blk_queue_hardsect_size(struct request_queue *, unsigned short);
  724. extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
  725. extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
  726. extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
  727. extern int blk_queue_dma_drain(struct request_queue *q,
  728. dma_drain_needed_fn *dma_drain_needed,
  729. void *buf, unsigned int size);
  730. extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
  731. extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
  732. extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
  733. extern void blk_queue_merge_bvec(struct request_queue *, merge_bvec_fn *);
  734. extern void blk_queue_dma_alignment(struct request_queue *, int);
  735. extern void blk_queue_update_dma_alignment(struct request_queue *, int);
  736. extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
  737. extern void blk_queue_set_discard(struct request_queue *, prepare_discard_fn *);
  738. extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
  739. extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
  740. extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
  741. extern int blk_queue_ordered(struct request_queue *, unsigned, prepare_flush_fn *);
  742. extern int blk_do_ordered(struct request_queue *, struct request **);
  743. extern unsigned blk_ordered_cur_seq(struct request_queue *);
  744. extern unsigned blk_ordered_req_seq(struct request *);
  745. extern void blk_ordered_complete_seq(struct request_queue *, unsigned, int);
  746. extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
  747. extern void blk_dump_rq_flags(struct request *, char *);
  748. extern void generic_unplug_device(struct request_queue *);
  749. extern long nr_blockdev_pages(void);
  750. int blk_get_queue(struct request_queue *);
  751. struct request_queue *blk_alloc_queue(gfp_t);
  752. struct request_queue *blk_alloc_queue_node(gfp_t, int);
  753. extern void blk_put_queue(struct request_queue *);
  754. /*
  755. * tag stuff
  756. */
  757. #define blk_rq_tagged(rq) ((rq)->cmd_flags & REQ_QUEUED)
  758. extern int blk_queue_start_tag(struct request_queue *, struct request *);
  759. extern struct request *blk_queue_find_tag(struct request_queue *, int);
  760. extern void blk_queue_end_tag(struct request_queue *, struct request *);
  761. extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *);
  762. extern void blk_queue_free_tags(struct request_queue *);
  763. extern int blk_queue_resize_tags(struct request_queue *, int);
  764. extern void blk_queue_invalidate_tags(struct request_queue *);
  765. extern struct blk_queue_tag *blk_init_tags(int);
  766. extern void blk_free_tags(struct blk_queue_tag *);
  767. static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
  768. int tag)
  769. {
  770. if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
  771. return NULL;
  772. return bqt->tag_index[tag];
  773. }
  774. extern int blkdev_issue_flush(struct block_device *, sector_t *);
  775. extern int blkdev_issue_discard(struct block_device *,
  776. sector_t sector, sector_t nr_sects, gfp_t);
  777. static inline int sb_issue_discard(struct super_block *sb,
  778. sector_t block, sector_t nr_blocks)
  779. {
  780. block <<= (sb->s_blocksize_bits - 9);
  781. nr_blocks <<= (sb->s_blocksize_bits - 9);
  782. return blkdev_issue_discard(sb->s_bdev, block, nr_blocks, GFP_KERNEL);
  783. }
  784. /*
  785. * command filter functions
  786. */
  787. extern int blk_verify_command(struct blk_cmd_filter *filter,
  788. unsigned char *cmd, fmode_t has_write_perm);
  789. extern void blk_unregister_filter(struct gendisk *disk);
  790. extern void blk_set_cmd_filter_defaults(struct blk_cmd_filter *filter);
  791. #define MAX_PHYS_SEGMENTS 128
  792. #define MAX_HW_SEGMENTS 128
  793. #define SAFE_MAX_SECTORS 255
  794. #define BLK_DEF_MAX_SECTORS 1024
  795. #define MAX_SEGMENT_SIZE 65536
  796. #define BLK_SEG_BOUNDARY_MASK 0xFFFFFFFFUL
  797. #define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
  798. static inline int queue_hardsect_size(struct request_queue *q)
  799. {
  800. int retval = 512;
  801. if (q && q->hardsect_size)
  802. retval = q->hardsect_size;
  803. return retval;
  804. }
  805. static inline int bdev_hardsect_size(struct block_device *bdev)
  806. {
  807. return queue_hardsect_size(bdev_get_queue(bdev));
  808. }
  809. static inline int queue_dma_alignment(struct request_queue *q)
  810. {
  811. return q ? q->dma_alignment : 511;
  812. }
  813. static inline int blk_rq_aligned(struct request_queue *q, void *addr,
  814. unsigned int len)
  815. {
  816. unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
  817. return !((unsigned long)addr & alignment) && !(len & alignment);
  818. }
  819. /* assumes size > 256 */
  820. static inline unsigned int blksize_bits(unsigned int size)
  821. {
  822. unsigned int bits = 8;
  823. do {
  824. bits++;
  825. size >>= 1;
  826. } while (size > 256);
  827. return bits;
  828. }
  829. static inline unsigned int block_size(struct block_device *bdev)
  830. {
  831. return bdev->bd_block_size;
  832. }
  833. typedef struct {struct page *v;} Sector;
  834. unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
  835. static inline void put_dev_sector(Sector p)
  836. {
  837. page_cache_release(p.v);
  838. }
  839. struct work_struct;
  840. int kblockd_schedule_work(struct request_queue *q, struct work_struct *work);
  841. #define MODULE_ALIAS_BLOCKDEV(major,minor) \
  842. MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
  843. #define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
  844. MODULE_ALIAS("block-major-" __stringify(major) "-*")
  845. #if defined(CONFIG_BLK_DEV_INTEGRITY)
  846. #define INTEGRITY_FLAG_READ 2 /* verify data integrity on read */
  847. #define INTEGRITY_FLAG_WRITE 4 /* generate data integrity on write */
  848. struct blk_integrity_exchg {
  849. void *prot_buf;
  850. void *data_buf;
  851. sector_t sector;
  852. unsigned int data_size;
  853. unsigned short sector_size;
  854. const char *disk_name;
  855. };
  856. typedef void (integrity_gen_fn) (struct blk_integrity_exchg *);
  857. typedef int (integrity_vrfy_fn) (struct blk_integrity_exchg *);
  858. typedef void (integrity_set_tag_fn) (void *, void *, unsigned int);
  859. typedef void (integrity_get_tag_fn) (void *, void *, unsigned int);
  860. struct blk_integrity {
  861. integrity_gen_fn *generate_fn;
  862. integrity_vrfy_fn *verify_fn;
  863. integrity_set_tag_fn *set_tag_fn;
  864. integrity_get_tag_fn *get_tag_fn;
  865. unsigned short flags;
  866. unsigned short tuple_size;
  867. unsigned short sector_size;
  868. unsigned short tag_size;
  869. const char *name;
  870. struct kobject kobj;
  871. };
  872. extern int blk_integrity_register(struct gendisk *, struct blk_integrity *);
  873. extern void blk_integrity_unregister(struct gendisk *);
  874. extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
  875. extern int blk_rq_map_integrity_sg(struct request *, struct scatterlist *);
  876. extern int blk_rq_count_integrity_sg(struct request *);
  877. static inline
  878. struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
  879. {
  880. return bdev->bd_disk->integrity;
  881. }
  882. static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
  883. {
  884. return disk->integrity;
  885. }
  886. static inline int blk_integrity_rq(struct request *rq)
  887. {
  888. if (rq->bio == NULL)
  889. return 0;
  890. return bio_integrity(rq->bio);
  891. }
  892. #else /* CONFIG_BLK_DEV_INTEGRITY */
  893. #define blk_integrity_rq(rq) (0)
  894. #define blk_rq_count_integrity_sg(a) (0)
  895. #define blk_rq_map_integrity_sg(a, b) (0)
  896. #define bdev_get_integrity(a) (0)
  897. #define blk_get_integrity(a) (0)
  898. #define blk_integrity_compare(a, b) (0)
  899. #define blk_integrity_register(a, b) (0)
  900. #define blk_integrity_unregister(a) do { } while (0);
  901. #endif /* CONFIG_BLK_DEV_INTEGRITY */
  902. struct block_device_operations {
  903. int (*open) (struct block_device *, fmode_t);
  904. int (*release) (struct gendisk *, fmode_t);
  905. int (*locked_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
  906. int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
  907. int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
  908. int (*direct_access) (struct block_device *, sector_t,
  909. void **, unsigned long *);
  910. int (*media_changed) (struct gendisk *);
  911. int (*revalidate_disk) (struct gendisk *);
  912. int (*getgeo)(struct block_device *, struct hd_geometry *);
  913. struct module *owner;
  914. };
  915. extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
  916. unsigned long);
  917. #else /* CONFIG_BLOCK */
  918. /*
  919. * stubs for when the block layer is configured out
  920. */
  921. #define buffer_heads_over_limit 0
  922. static inline long nr_blockdev_pages(void)
  923. {
  924. return 0;
  925. }
  926. #endif /* CONFIG_BLOCK */
  927. #endif