blkdev.h 49 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739
  1. #ifndef _LINUX_BLKDEV_H
  2. #define _LINUX_BLKDEV_H
  3. #include <linux/sched.h>
  4. #ifdef CONFIG_BLOCK
  5. #include <linux/major.h>
  6. #include <linux/genhd.h>
  7. #include <linux/list.h>
  8. #include <linux/llist.h>
  9. #include <linux/timer.h>
  10. #include <linux/workqueue.h>
  11. #include <linux/pagemap.h>
  12. #include <linux/backing-dev-defs.h>
  13. #include <linux/wait.h>
  14. #include <linux/mempool.h>
  15. #include <linux/pfn.h>
  16. #include <linux/bio.h>
  17. #include <linux/stringify.h>
  18. #include <linux/gfp.h>
  19. #include <linux/bsg.h>
  20. #include <linux/smp.h>
  21. #include <linux/rcupdate.h>
  22. #include <linux/percpu-refcount.h>
  23. #include <linux/scatterlist.h>
  24. struct module;
  25. struct scsi_ioctl_command;
  26. struct request_queue;
  27. struct elevator_queue;
  28. struct blk_trace;
  29. struct request;
  30. struct sg_io_hdr;
  31. struct bsg_job;
  32. struct blkcg_gq;
  33. struct blk_flush_queue;
  34. struct pr_ops;
  35. #define BLKDEV_MIN_RQ 4
  36. #define BLKDEV_MAX_RQ 128 /* Default maximum */
  37. /*
  38. * Maximum number of blkcg policies allowed to be registered concurrently.
  39. * Defined here to simplify include dependency.
  40. */
  41. #define BLKCG_MAX_POLS 2
  42. struct request;
  43. typedef void (rq_end_io_fn)(struct request *, int);
  44. #define BLK_RL_SYNCFULL (1U << 0)
  45. #define BLK_RL_ASYNCFULL (1U << 1)
  46. struct request_list {
  47. struct request_queue *q; /* the queue this rl belongs to */
  48. #ifdef CONFIG_BLK_CGROUP
  49. struct blkcg_gq *blkg; /* blkg this request pool belongs to */
  50. #endif
  51. /*
  52. * count[], starved[], and wait[] are indexed by
  53. * BLK_RW_SYNC/BLK_RW_ASYNC
  54. */
  55. int count[2];
  56. int starved[2];
  57. mempool_t *rq_pool;
  58. wait_queue_head_t wait[2];
  59. unsigned int flags;
  60. };
  61. /*
  62. * request command types
  63. */
  64. enum rq_cmd_type_bits {
  65. REQ_TYPE_FS = 1, /* fs request */
  66. REQ_TYPE_BLOCK_PC, /* scsi command */
  67. REQ_TYPE_DRV_PRIV, /* driver defined types from here */
  68. };
  69. #define BLK_MAX_CDB 16
  70. /*
  71. * Try to put the fields that are referenced together in the same cacheline.
  72. *
  73. * If you modify this structure, make sure to update blk_rq_init() and
  74. * especially blk_mq_rq_ctx_init() to take care of the added fields.
  75. */
  76. struct request {
  77. struct list_head queuelist;
  78. union {
  79. struct call_single_data csd;
  80. unsigned long fifo_time;
  81. };
  82. struct request_queue *q;
  83. struct blk_mq_ctx *mq_ctx;
  84. u64 cmd_flags;
  85. unsigned cmd_type;
  86. unsigned long atomic_flags;
  87. int cpu;
  88. /* the following two fields are internal, NEVER access directly */
  89. unsigned int __data_len; /* total data len */
  90. sector_t __sector; /* sector cursor */
  91. struct bio *bio;
  92. struct bio *biotail;
  93. /*
  94. * The hash is used inside the scheduler, and killed once the
  95. * request reaches the dispatch list. The ipi_list is only used
  96. * to queue the request for softirq completion, which is long
  97. * after the request has been unhashed (and even removed from
  98. * the dispatch list).
  99. */
  100. union {
  101. struct hlist_node hash; /* merge hash */
  102. struct list_head ipi_list;
  103. };
  104. /*
  105. * The rb_node is only used inside the io scheduler, requests
  106. * are pruned when moved to the dispatch queue. So let the
  107. * completion_data share space with the rb_node.
  108. */
  109. union {
  110. struct rb_node rb_node; /* sort/lookup */
  111. void *completion_data;
  112. };
  113. /*
  114. * Three pointers are available for the IO schedulers, if they need
  115. * more they have to dynamically allocate it. Flush requests are
  116. * never put on the IO scheduler. So let the flush fields share
  117. * space with the elevator data.
  118. */
  119. union {
  120. struct {
  121. struct io_cq *icq;
  122. void *priv[2];
  123. } elv;
  124. struct {
  125. unsigned int seq;
  126. struct list_head list;
  127. rq_end_io_fn *saved_end_io;
  128. } flush;
  129. };
  130. struct gendisk *rq_disk;
  131. struct hd_struct *part;
  132. unsigned long start_time;
  133. #ifdef CONFIG_BLK_CGROUP
  134. struct request_list *rl; /* rl this rq is alloced from */
  135. unsigned long long start_time_ns;
  136. unsigned long long io_start_time_ns; /* when passed to hardware */
  137. #endif
  138. /* Number of scatter-gather DMA addr+len pairs after
  139. * physical address coalescing is performed.
  140. */
  141. unsigned short nr_phys_segments;
  142. #if defined(CONFIG_BLK_DEV_INTEGRITY)
  143. unsigned short nr_integrity_segments;
  144. #endif
  145. unsigned short ioprio;
  146. void *special; /* opaque pointer available for LLD use */
  147. int tag;
  148. int errors;
  149. /*
  150. * when request is used as a packet command carrier
  151. */
  152. unsigned char __cmd[BLK_MAX_CDB];
  153. unsigned char *cmd;
  154. unsigned short cmd_len;
  155. unsigned int extra_len; /* length of alignment and padding */
  156. unsigned int sense_len;
  157. unsigned int resid_len; /* residual count */
  158. void *sense;
  159. unsigned long deadline;
  160. struct list_head timeout_list;
  161. unsigned int timeout;
  162. int retries;
  163. /*
  164. * completion callback.
  165. */
  166. rq_end_io_fn *end_io;
  167. void *end_io_data;
  168. /* for bidi */
  169. struct request *next_rq;
  170. };
  171. static inline unsigned short req_get_ioprio(struct request *req)
  172. {
  173. return req->ioprio;
  174. }
  175. #include <linux/elevator.h>
  176. struct blk_queue_ctx;
  177. typedef void (request_fn_proc) (struct request_queue *q);
  178. typedef blk_qc_t (make_request_fn) (struct request_queue *q, struct bio *bio);
  179. typedef int (prep_rq_fn) (struct request_queue *, struct request *);
  180. typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
  181. struct bio_vec;
  182. typedef void (softirq_done_fn)(struct request *);
  183. typedef int (dma_drain_needed_fn)(struct request *);
  184. typedef int (lld_busy_fn) (struct request_queue *q);
  185. typedef int (bsg_job_fn) (struct bsg_job *);
  186. enum blk_eh_timer_return {
  187. BLK_EH_NOT_HANDLED,
  188. BLK_EH_HANDLED,
  189. BLK_EH_RESET_TIMER,
  190. };
  191. typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
  192. enum blk_queue_state {
  193. Queue_down,
  194. Queue_up,
  195. };
  196. struct blk_queue_tag {
  197. struct request **tag_index; /* map of busy tags */
  198. unsigned long *tag_map; /* bit map of free/busy tags */
  199. int busy; /* current depth */
  200. int max_depth; /* what we will send to device */
  201. int real_max_depth; /* what the array can hold */
  202. atomic_t refcnt; /* map can be shared */
  203. int alloc_policy; /* tag allocation policy */
  204. int next_tag; /* next tag */
  205. };
  206. #define BLK_TAG_ALLOC_FIFO 0 /* allocate starting from 0 */
  207. #define BLK_TAG_ALLOC_RR 1 /* allocate starting from last allocated tag */
  208. #define BLK_SCSI_MAX_CMDS (256)
  209. #define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
  210. struct queue_limits {
  211. unsigned long bounce_pfn;
  212. unsigned long seg_boundary_mask;
  213. unsigned long virt_boundary_mask;
  214. unsigned int max_hw_sectors;
  215. unsigned int max_dev_sectors;
  216. unsigned int chunk_sectors;
  217. unsigned int max_sectors;
  218. unsigned int max_segment_size;
  219. unsigned int physical_block_size;
  220. unsigned int alignment_offset;
  221. unsigned int io_min;
  222. unsigned int io_opt;
  223. unsigned int max_discard_sectors;
  224. unsigned int max_hw_discard_sectors;
  225. unsigned int max_write_same_sectors;
  226. unsigned int discard_granularity;
  227. unsigned int discard_alignment;
  228. unsigned short logical_block_size;
  229. unsigned short max_segments;
  230. unsigned short max_integrity_segments;
  231. unsigned char misaligned;
  232. unsigned char discard_misaligned;
  233. unsigned char cluster;
  234. unsigned char discard_zeroes_data;
  235. unsigned char raid_partial_stripes_expensive;
  236. };
  237. struct request_queue {
  238. /*
  239. * Together with queue_head for cacheline sharing
  240. */
  241. struct list_head queue_head;
  242. struct request *last_merge;
  243. struct elevator_queue *elevator;
  244. int nr_rqs[2]; /* # allocated [a]sync rqs */
  245. int nr_rqs_elvpriv; /* # allocated rqs w/ elvpriv */
  246. /*
  247. * If blkcg is not used, @q->root_rl serves all requests. If blkcg
  248. * is used, root blkg allocates from @q->root_rl and all other
  249. * blkgs from their own blkg->rl. Which one to use should be
  250. * determined using bio_request_list().
  251. */
  252. struct request_list root_rl;
  253. request_fn_proc *request_fn;
  254. make_request_fn *make_request_fn;
  255. prep_rq_fn *prep_rq_fn;
  256. unprep_rq_fn *unprep_rq_fn;
  257. softirq_done_fn *softirq_done_fn;
  258. rq_timed_out_fn *rq_timed_out_fn;
  259. dma_drain_needed_fn *dma_drain_needed;
  260. lld_busy_fn *lld_busy_fn;
  261. struct blk_mq_ops *mq_ops;
  262. unsigned int *mq_map;
  263. /* sw queues */
  264. struct blk_mq_ctx __percpu *queue_ctx;
  265. unsigned int nr_queues;
  266. /* hw dispatch queues */
  267. struct blk_mq_hw_ctx **queue_hw_ctx;
  268. unsigned int nr_hw_queues;
  269. /*
  270. * Dispatch queue sorting
  271. */
  272. sector_t end_sector;
  273. struct request *boundary_rq;
  274. /*
  275. * Delayed queue handling
  276. */
  277. struct delayed_work delay_work;
  278. struct backing_dev_info backing_dev_info;
  279. /*
  280. * The queue owner gets to use this for whatever they like.
  281. * ll_rw_blk doesn't touch it.
  282. */
  283. void *queuedata;
  284. /*
  285. * various queue flags, see QUEUE_* below
  286. */
  287. unsigned long queue_flags;
  288. /*
  289. * ida allocated id for this queue. Used to index queues from
  290. * ioctx.
  291. */
  292. int id;
  293. /*
  294. * queue needs bounce pages for pages above this limit
  295. */
  296. gfp_t bounce_gfp;
  297. /*
  298. * protects queue structures from reentrancy. ->__queue_lock should
  299. * _never_ be used directly, it is queue private. always use
  300. * ->queue_lock.
  301. */
  302. spinlock_t __queue_lock;
  303. spinlock_t *queue_lock;
  304. /*
  305. * queue kobject
  306. */
  307. struct kobject kobj;
  308. /*
  309. * mq queue kobject
  310. */
  311. struct kobject mq_kobj;
  312. #ifdef CONFIG_BLK_DEV_INTEGRITY
  313. struct blk_integrity integrity;
  314. #endif /* CONFIG_BLK_DEV_INTEGRITY */
  315. #ifdef CONFIG_PM
  316. struct device *dev;
  317. int rpm_status;
  318. unsigned int nr_pending;
  319. #endif
  320. /*
  321. * queue settings
  322. */
  323. unsigned long nr_requests; /* Max # of requests */
  324. unsigned int nr_congestion_on;
  325. unsigned int nr_congestion_off;
  326. unsigned int nr_batching;
  327. unsigned int dma_drain_size;
  328. void *dma_drain_buffer;
  329. unsigned int dma_pad_mask;
  330. unsigned int dma_alignment;
  331. struct blk_queue_tag *queue_tags;
  332. struct list_head tag_busy_list;
  333. unsigned int nr_sorted;
  334. unsigned int in_flight[2];
  335. /*
  336. * Number of active block driver functions for which blk_drain_queue()
  337. * must wait. Must be incremented around functions that unlock the
  338. * queue_lock internally, e.g. scsi_request_fn().
  339. */
  340. unsigned int request_fn_active;
  341. unsigned int rq_timeout;
  342. struct timer_list timeout;
  343. struct work_struct timeout_work;
  344. struct list_head timeout_list;
  345. struct list_head icq_list;
  346. #ifdef CONFIG_BLK_CGROUP
  347. DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
  348. struct blkcg_gq *root_blkg;
  349. struct list_head blkg_list;
  350. #endif
  351. struct queue_limits limits;
  352. /*
  353. * sg stuff
  354. */
  355. unsigned int sg_timeout;
  356. unsigned int sg_reserved_size;
  357. int node;
  358. #ifdef CONFIG_BLK_DEV_IO_TRACE
  359. struct blk_trace *blk_trace;
  360. #endif
  361. /*
  362. * for flush operations
  363. */
  364. unsigned int flush_flags;
  365. unsigned int flush_not_queueable:1;
  366. struct blk_flush_queue *fq;
  367. struct list_head requeue_list;
  368. spinlock_t requeue_lock;
  369. struct work_struct requeue_work;
  370. struct mutex sysfs_lock;
  371. int bypass_depth;
  372. atomic_t mq_freeze_depth;
  373. #if defined(CONFIG_BLK_DEV_BSG)
  374. bsg_job_fn *bsg_job_fn;
  375. int bsg_job_size;
  376. struct bsg_class_device bsg_dev;
  377. #endif
  378. #ifdef CONFIG_BLK_DEV_THROTTLING
  379. /* Throttle data */
  380. struct throtl_data *td;
  381. #endif
  382. struct rcu_head rcu_head;
  383. wait_queue_head_t mq_freeze_wq;
  384. struct percpu_ref q_usage_counter;
  385. struct list_head all_q_node;
  386. struct blk_mq_tag_set *tag_set;
  387. struct list_head tag_set_list;
  388. struct bio_set *bio_split;
  389. bool mq_sysfs_init_done;
  390. };
  391. #define QUEUE_FLAG_QUEUED 1 /* uses generic tag queueing */
  392. #define QUEUE_FLAG_STOPPED 2 /* queue is stopped */
  393. #define QUEUE_FLAG_SYNCFULL 3 /* read queue has been filled */
  394. #define QUEUE_FLAG_ASYNCFULL 4 /* write queue has been filled */
  395. #define QUEUE_FLAG_DYING 5 /* queue being torn down */
  396. #define QUEUE_FLAG_BYPASS 6 /* act as dumb FIFO queue */
  397. #define QUEUE_FLAG_BIDI 7 /* queue supports bidi requests */
  398. #define QUEUE_FLAG_NOMERGES 8 /* disable merge attempts */
  399. #define QUEUE_FLAG_SAME_COMP 9 /* complete on same CPU-group */
  400. #define QUEUE_FLAG_FAIL_IO 10 /* fake timeout */
  401. #define QUEUE_FLAG_STACKABLE 11 /* supports request stacking */
  402. #define QUEUE_FLAG_NONROT 12 /* non-rotational device (SSD) */
  403. #define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
  404. #define QUEUE_FLAG_IO_STAT 13 /* do IO stats */
  405. #define QUEUE_FLAG_DISCARD 14 /* supports DISCARD */
  406. #define QUEUE_FLAG_NOXMERGES 15 /* No extended merges */
  407. #define QUEUE_FLAG_ADD_RANDOM 16 /* Contributes to random pool */
  408. #define QUEUE_FLAG_SECDISCARD 17 /* supports SECDISCARD */
  409. #define QUEUE_FLAG_SAME_FORCE 18 /* force complete on same CPU */
  410. #define QUEUE_FLAG_DEAD 19 /* queue tear-down finished */
  411. #define QUEUE_FLAG_INIT_DONE 20 /* queue is initialized */
  412. #define QUEUE_FLAG_NO_SG_MERGE 21 /* don't attempt to merge SG segments*/
  413. #define QUEUE_FLAG_POLL 22 /* IO polling enabled if set */
  414. #define QUEUE_FLAG_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
  415. (1 << QUEUE_FLAG_STACKABLE) | \
  416. (1 << QUEUE_FLAG_SAME_COMP) | \
  417. (1 << QUEUE_FLAG_ADD_RANDOM))
  418. #define QUEUE_FLAG_MQ_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
  419. (1 << QUEUE_FLAG_STACKABLE) | \
  420. (1 << QUEUE_FLAG_SAME_COMP) | \
  421. (1 << QUEUE_FLAG_POLL))
  422. static inline void queue_lockdep_assert_held(struct request_queue *q)
  423. {
  424. if (q->queue_lock)
  425. lockdep_assert_held(q->queue_lock);
  426. }
  427. static inline void queue_flag_set_unlocked(unsigned int flag,
  428. struct request_queue *q)
  429. {
  430. __set_bit(flag, &q->queue_flags);
  431. }
  432. static inline int queue_flag_test_and_clear(unsigned int flag,
  433. struct request_queue *q)
  434. {
  435. queue_lockdep_assert_held(q);
  436. if (test_bit(flag, &q->queue_flags)) {
  437. __clear_bit(flag, &q->queue_flags);
  438. return 1;
  439. }
  440. return 0;
  441. }
  442. static inline int queue_flag_test_and_set(unsigned int flag,
  443. struct request_queue *q)
  444. {
  445. queue_lockdep_assert_held(q);
  446. if (!test_bit(flag, &q->queue_flags)) {
  447. __set_bit(flag, &q->queue_flags);
  448. return 0;
  449. }
  450. return 1;
  451. }
  452. static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
  453. {
  454. queue_lockdep_assert_held(q);
  455. __set_bit(flag, &q->queue_flags);
  456. }
  457. static inline void queue_flag_clear_unlocked(unsigned int flag,
  458. struct request_queue *q)
  459. {
  460. __clear_bit(flag, &q->queue_flags);
  461. }
  462. static inline int queue_in_flight(struct request_queue *q)
  463. {
  464. return q->in_flight[0] + q->in_flight[1];
  465. }
  466. static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
  467. {
  468. queue_lockdep_assert_held(q);
  469. __clear_bit(flag, &q->queue_flags);
  470. }
  471. #define blk_queue_tagged(q) test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
  472. #define blk_queue_stopped(q) test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
  473. #define blk_queue_dying(q) test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
  474. #define blk_queue_dead(q) test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
  475. #define blk_queue_bypass(q) test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
  476. #define blk_queue_init_done(q) test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
  477. #define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
  478. #define blk_queue_noxmerges(q) \
  479. test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
  480. #define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
  481. #define blk_queue_io_stat(q) test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
  482. #define blk_queue_add_random(q) test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
  483. #define blk_queue_stackable(q) \
  484. test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
  485. #define blk_queue_discard(q) test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
  486. #define blk_queue_secdiscard(q) (blk_queue_discard(q) && \
  487. test_bit(QUEUE_FLAG_SECDISCARD, &(q)->queue_flags))
  488. #define blk_noretry_request(rq) \
  489. ((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
  490. REQ_FAILFAST_DRIVER))
  491. #define blk_account_rq(rq) \
  492. (((rq)->cmd_flags & REQ_STARTED) && \
  493. ((rq)->cmd_type == REQ_TYPE_FS))
  494. #define blk_rq_cpu_valid(rq) ((rq)->cpu != -1)
  495. #define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
  496. /* rq->queuelist of dequeued request must be list_empty() */
  497. #define blk_queued_rq(rq) (!list_empty(&(rq)->queuelist))
  498. #define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
  499. #define rq_data_dir(rq) ((int)((rq)->cmd_flags & 1))
  500. /*
  501. * Driver can handle struct request, if it either has an old style
  502. * request_fn defined, or is blk-mq based.
  503. */
  504. static inline bool queue_is_rq_based(struct request_queue *q)
  505. {
  506. return q->request_fn || q->mq_ops;
  507. }
  508. static inline unsigned int blk_queue_cluster(struct request_queue *q)
  509. {
  510. return q->limits.cluster;
  511. }
  512. /*
  513. * We regard a request as sync, if either a read or a sync write
  514. */
  515. static inline bool rw_is_sync(unsigned int rw_flags)
  516. {
  517. return !(rw_flags & REQ_WRITE) || (rw_flags & REQ_SYNC);
  518. }
  519. static inline bool rq_is_sync(struct request *rq)
  520. {
  521. return rw_is_sync(rq->cmd_flags);
  522. }
  523. static inline bool blk_rl_full(struct request_list *rl, bool sync)
  524. {
  525. unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
  526. return rl->flags & flag;
  527. }
  528. static inline void blk_set_rl_full(struct request_list *rl, bool sync)
  529. {
  530. unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
  531. rl->flags |= flag;
  532. }
  533. static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
  534. {
  535. unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
  536. rl->flags &= ~flag;
  537. }
  538. static inline bool rq_mergeable(struct request *rq)
  539. {
  540. if (rq->cmd_type != REQ_TYPE_FS)
  541. return false;
  542. if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
  543. return false;
  544. return true;
  545. }
  546. static inline bool blk_check_merge_flags(unsigned int flags1,
  547. unsigned int flags2)
  548. {
  549. if ((flags1 & REQ_DISCARD) != (flags2 & REQ_DISCARD))
  550. return false;
  551. if ((flags1 & REQ_SECURE) != (flags2 & REQ_SECURE))
  552. return false;
  553. if ((flags1 & REQ_WRITE_SAME) != (flags2 & REQ_WRITE_SAME))
  554. return false;
  555. return true;
  556. }
  557. static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
  558. {
  559. if (bio_data(a) == bio_data(b))
  560. return true;
  561. return false;
  562. }
  563. /*
  564. * q->prep_rq_fn return values
  565. */
  566. enum {
  567. BLKPREP_OK, /* serve it */
  568. BLKPREP_KILL, /* fatal error, kill, return -EIO */
  569. BLKPREP_DEFER, /* leave on queue */
  570. BLKPREP_INVALID, /* invalid command, kill, return -EREMOTEIO */
  571. };
  572. extern unsigned long blk_max_low_pfn, blk_max_pfn;
  573. /*
  574. * standard bounce addresses:
  575. *
  576. * BLK_BOUNCE_HIGH : bounce all highmem pages
  577. * BLK_BOUNCE_ANY : don't bounce anything
  578. * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
  579. */
  580. #if BITS_PER_LONG == 32
  581. #define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
  582. #else
  583. #define BLK_BOUNCE_HIGH -1ULL
  584. #endif
  585. #define BLK_BOUNCE_ANY (-1ULL)
  586. #define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
  587. /*
  588. * default timeout for SG_IO if none specified
  589. */
  590. #define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
  591. #define BLK_MIN_SG_TIMEOUT (7 * HZ)
  592. #ifdef CONFIG_BOUNCE
  593. extern int init_emergency_isa_pool(void);
  594. extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
  595. #else
  596. static inline int init_emergency_isa_pool(void)
  597. {
  598. return 0;
  599. }
  600. static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
  601. {
  602. }
  603. #endif /* CONFIG_MMU */
  604. struct rq_map_data {
  605. struct page **pages;
  606. int page_order;
  607. int nr_entries;
  608. unsigned long offset;
  609. int null_mapped;
  610. int from_user;
  611. };
  612. struct req_iterator {
  613. struct bvec_iter iter;
  614. struct bio *bio;
  615. };
  616. /* This should not be used directly - use rq_for_each_segment */
  617. #define for_each_bio(_bio) \
  618. for (; _bio; _bio = _bio->bi_next)
  619. #define __rq_for_each_bio(_bio, rq) \
  620. if ((rq->bio)) \
  621. for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
  622. #define rq_for_each_segment(bvl, _rq, _iter) \
  623. __rq_for_each_bio(_iter.bio, _rq) \
  624. bio_for_each_segment(bvl, _iter.bio, _iter.iter)
  625. #define rq_iter_last(bvec, _iter) \
  626. (_iter.bio->bi_next == NULL && \
  627. bio_iter_last(bvec, _iter.iter))
  628. #ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
  629. # error "You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
  630. #endif
  631. #if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
  632. extern void rq_flush_dcache_pages(struct request *rq);
  633. #else
  634. static inline void rq_flush_dcache_pages(struct request *rq)
  635. {
  636. }
  637. #endif
  638. #ifdef CONFIG_PRINTK
  639. #define vfs_msg(sb, level, fmt, ...) \
  640. __vfs_msg(sb, level, fmt, ##__VA_ARGS__)
  641. #else
  642. #define vfs_msg(sb, level, fmt, ...) \
  643. do { \
  644. no_printk(fmt, ##__VA_ARGS__); \
  645. __vfs_msg(sb, "", " "); \
  646. } while (0)
  647. #endif
  648. extern int blk_register_queue(struct gendisk *disk);
  649. extern void blk_unregister_queue(struct gendisk *disk);
  650. extern blk_qc_t generic_make_request(struct bio *bio);
  651. extern void blk_rq_init(struct request_queue *q, struct request *rq);
  652. extern void blk_put_request(struct request *);
  653. extern void __blk_put_request(struct request_queue *, struct request *);
  654. extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
  655. extern struct request *blk_make_request(struct request_queue *, struct bio *,
  656. gfp_t);
  657. extern void blk_rq_set_block_pc(struct request *);
  658. extern void blk_requeue_request(struct request_queue *, struct request *);
  659. extern void blk_add_request_payload(struct request *rq, struct page *page,
  660. unsigned int len);
  661. extern int blk_lld_busy(struct request_queue *q);
  662. extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
  663. struct bio_set *bs, gfp_t gfp_mask,
  664. int (*bio_ctr)(struct bio *, struct bio *, void *),
  665. void *data);
  666. extern void blk_rq_unprep_clone(struct request *rq);
  667. extern int blk_insert_cloned_request(struct request_queue *q,
  668. struct request *rq);
  669. extern void blk_delay_queue(struct request_queue *, unsigned long);
  670. extern void blk_queue_split(struct request_queue *, struct bio **,
  671. struct bio_set *);
  672. extern void blk_recount_segments(struct request_queue *, struct bio *);
  673. extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
  674. extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
  675. unsigned int, void __user *);
  676. extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
  677. unsigned int, void __user *);
  678. extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
  679. struct scsi_ioctl_command __user *);
  680. extern int blk_queue_enter(struct request_queue *q, bool nowait);
  681. extern void blk_queue_exit(struct request_queue *q);
  682. extern void blk_start_queue(struct request_queue *q);
  683. extern void blk_start_queue_async(struct request_queue *q);
  684. extern void blk_stop_queue(struct request_queue *q);
  685. extern void blk_sync_queue(struct request_queue *q);
  686. extern void __blk_stop_queue(struct request_queue *q);
  687. extern void __blk_run_queue(struct request_queue *q);
  688. extern void __blk_run_queue_uncond(struct request_queue *q);
  689. extern void blk_run_queue(struct request_queue *);
  690. extern void blk_run_queue_async(struct request_queue *q);
  691. extern int blk_rq_map_user(struct request_queue *, struct request *,
  692. struct rq_map_data *, void __user *, unsigned long,
  693. gfp_t);
  694. extern int blk_rq_unmap_user(struct bio *);
  695. extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
  696. extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
  697. struct rq_map_data *, const struct iov_iter *,
  698. gfp_t);
  699. extern int blk_execute_rq(struct request_queue *, struct gendisk *,
  700. struct request *, int);
  701. extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
  702. struct request *, int, rq_end_io_fn *);
  703. bool blk_poll(struct request_queue *q, blk_qc_t cookie);
  704. static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
  705. {
  706. return bdev->bd_disk->queue; /* this is never NULL */
  707. }
  708. /*
  709. * blk_rq_pos() : the current sector
  710. * blk_rq_bytes() : bytes left in the entire request
  711. * blk_rq_cur_bytes() : bytes left in the current segment
  712. * blk_rq_err_bytes() : bytes left till the next error boundary
  713. * blk_rq_sectors() : sectors left in the entire request
  714. * blk_rq_cur_sectors() : sectors left in the current segment
  715. */
  716. static inline sector_t blk_rq_pos(const struct request *rq)
  717. {
  718. return rq->__sector;
  719. }
  720. static inline unsigned int blk_rq_bytes(const struct request *rq)
  721. {
  722. return rq->__data_len;
  723. }
  724. static inline int blk_rq_cur_bytes(const struct request *rq)
  725. {
  726. return rq->bio ? bio_cur_bytes(rq->bio) : 0;
  727. }
  728. extern unsigned int blk_rq_err_bytes(const struct request *rq);
  729. static inline unsigned int blk_rq_sectors(const struct request *rq)
  730. {
  731. return blk_rq_bytes(rq) >> 9;
  732. }
  733. static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
  734. {
  735. return blk_rq_cur_bytes(rq) >> 9;
  736. }
  737. static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
  738. unsigned int cmd_flags)
  739. {
  740. if (unlikely(cmd_flags & REQ_DISCARD))
  741. return min(q->limits.max_discard_sectors, UINT_MAX >> 9);
  742. if (unlikely(cmd_flags & REQ_WRITE_SAME))
  743. return q->limits.max_write_same_sectors;
  744. return q->limits.max_sectors;
  745. }
  746. /*
  747. * Return maximum size of a request at given offset. Only valid for
  748. * file system requests.
  749. */
  750. static inline unsigned int blk_max_size_offset(struct request_queue *q,
  751. sector_t offset)
  752. {
  753. if (!q->limits.chunk_sectors)
  754. return q->limits.max_sectors;
  755. return q->limits.chunk_sectors -
  756. (offset & (q->limits.chunk_sectors - 1));
  757. }
  758. static inline unsigned int blk_rq_get_max_sectors(struct request *rq)
  759. {
  760. struct request_queue *q = rq->q;
  761. if (unlikely(rq->cmd_type != REQ_TYPE_FS))
  762. return q->limits.max_hw_sectors;
  763. if (!q->limits.chunk_sectors || (rq->cmd_flags & REQ_DISCARD))
  764. return blk_queue_get_max_sectors(q, rq->cmd_flags);
  765. return min(blk_max_size_offset(q, blk_rq_pos(rq)),
  766. blk_queue_get_max_sectors(q, rq->cmd_flags));
  767. }
  768. static inline unsigned int blk_rq_count_bios(struct request *rq)
  769. {
  770. unsigned int nr_bios = 0;
  771. struct bio *bio;
  772. __rq_for_each_bio(bio, rq)
  773. nr_bios++;
  774. return nr_bios;
  775. }
  776. /*
  777. * Request issue related functions.
  778. */
  779. extern struct request *blk_peek_request(struct request_queue *q);
  780. extern void blk_start_request(struct request *rq);
  781. extern struct request *blk_fetch_request(struct request_queue *q);
  782. /*
  783. * Request completion related functions.
  784. *
  785. * blk_update_request() completes given number of bytes and updates
  786. * the request without completing it.
  787. *
  788. * blk_end_request() and friends. __blk_end_request() must be called
  789. * with the request queue spinlock acquired.
  790. *
  791. * Several drivers define their own end_request and call
  792. * blk_end_request() for parts of the original function.
  793. * This prevents code duplication in drivers.
  794. */
  795. extern bool blk_update_request(struct request *rq, int error,
  796. unsigned int nr_bytes);
  797. extern void blk_finish_request(struct request *rq, int error);
  798. extern bool blk_end_request(struct request *rq, int error,
  799. unsigned int nr_bytes);
  800. extern void blk_end_request_all(struct request *rq, int error);
  801. extern bool blk_end_request_cur(struct request *rq, int error);
  802. extern bool blk_end_request_err(struct request *rq, int error);
  803. extern bool __blk_end_request(struct request *rq, int error,
  804. unsigned int nr_bytes);
  805. extern void __blk_end_request_all(struct request *rq, int error);
  806. extern bool __blk_end_request_cur(struct request *rq, int error);
  807. extern bool __blk_end_request_err(struct request *rq, int error);
  808. extern void blk_complete_request(struct request *);
  809. extern void __blk_complete_request(struct request *);
  810. extern void blk_abort_request(struct request *);
  811. extern void blk_unprep_request(struct request *);
  812. /*
  813. * Access functions for manipulating queue properties
  814. */
  815. extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
  816. spinlock_t *lock, int node_id);
  817. extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
  818. extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
  819. request_fn_proc *, spinlock_t *);
  820. extern void blk_cleanup_queue(struct request_queue *);
  821. extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
  822. extern void blk_queue_bounce_limit(struct request_queue *, u64);
  823. extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
  824. extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
  825. extern void blk_queue_max_segments(struct request_queue *, unsigned short);
  826. extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
  827. extern void blk_queue_max_discard_sectors(struct request_queue *q,
  828. unsigned int max_discard_sectors);
  829. extern void blk_queue_max_write_same_sectors(struct request_queue *q,
  830. unsigned int max_write_same_sectors);
  831. extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
  832. extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
  833. extern void blk_queue_alignment_offset(struct request_queue *q,
  834. unsigned int alignment);
  835. extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
  836. extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
  837. extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
  838. extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
  839. extern void blk_set_default_limits(struct queue_limits *lim);
  840. extern void blk_set_stacking_limits(struct queue_limits *lim);
  841. extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
  842. sector_t offset);
  843. extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
  844. sector_t offset);
  845. extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
  846. sector_t offset);
  847. extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
  848. extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
  849. extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
  850. extern int blk_queue_dma_drain(struct request_queue *q,
  851. dma_drain_needed_fn *dma_drain_needed,
  852. void *buf, unsigned int size);
  853. extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
  854. extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
  855. extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
  856. extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
  857. extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
  858. extern void blk_queue_dma_alignment(struct request_queue *, int);
  859. extern void blk_queue_update_dma_alignment(struct request_queue *, int);
  860. extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
  861. extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
  862. extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
  863. extern void blk_queue_flush(struct request_queue *q, unsigned int flush);
  864. extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
  865. extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
  866. extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
  867. extern void blk_dump_rq_flags(struct request *, char *);
  868. extern long nr_blockdev_pages(void);
  869. bool __must_check blk_get_queue(struct request_queue *);
  870. struct request_queue *blk_alloc_queue(gfp_t);
  871. struct request_queue *blk_alloc_queue_node(gfp_t, int);
  872. extern void blk_put_queue(struct request_queue *);
  873. extern void blk_set_queue_dying(struct request_queue *);
  874. /*
  875. * block layer runtime pm functions
  876. */
  877. #ifdef CONFIG_PM
  878. extern void blk_pm_runtime_init(struct request_queue *q, struct device *dev);
  879. extern int blk_pre_runtime_suspend(struct request_queue *q);
  880. extern void blk_post_runtime_suspend(struct request_queue *q, int err);
  881. extern void blk_pre_runtime_resume(struct request_queue *q);
  882. extern void blk_post_runtime_resume(struct request_queue *q, int err);
  883. extern void blk_set_runtime_active(struct request_queue *q);
  884. #else
  885. static inline void blk_pm_runtime_init(struct request_queue *q,
  886. struct device *dev) {}
  887. static inline int blk_pre_runtime_suspend(struct request_queue *q)
  888. {
  889. return -ENOSYS;
  890. }
  891. static inline void blk_post_runtime_suspend(struct request_queue *q, int err) {}
  892. static inline void blk_pre_runtime_resume(struct request_queue *q) {}
  893. static inline void blk_post_runtime_resume(struct request_queue *q, int err) {}
  894. extern inline void blk_set_runtime_active(struct request_queue *q) {}
  895. #endif
  896. /*
  897. * blk_plug permits building a queue of related requests by holding the I/O
  898. * fragments for a short period. This allows merging of sequential requests
  899. * into single larger request. As the requests are moved from a per-task list to
  900. * the device's request_queue in a batch, this results in improved scalability
  901. * as the lock contention for request_queue lock is reduced.
  902. *
  903. * It is ok not to disable preemption when adding the request to the plug list
  904. * or when attempting a merge, because blk_schedule_flush_list() will only flush
  905. * the plug list when the task sleeps by itself. For details, please see
  906. * schedule() where blk_schedule_flush_plug() is called.
  907. */
  908. struct blk_plug {
  909. struct list_head list; /* requests */
  910. struct list_head mq_list; /* blk-mq requests */
  911. struct list_head cb_list; /* md requires an unplug callback */
  912. };
  913. #define BLK_MAX_REQUEST_COUNT 16
  914. struct blk_plug_cb;
  915. typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
  916. struct blk_plug_cb {
  917. struct list_head list;
  918. blk_plug_cb_fn callback;
  919. void *data;
  920. };
  921. extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
  922. void *data, int size);
  923. extern void blk_start_plug(struct blk_plug *);
  924. extern void blk_finish_plug(struct blk_plug *);
  925. extern void blk_flush_plug_list(struct blk_plug *, bool);
  926. static inline void blk_flush_plug(struct task_struct *tsk)
  927. {
  928. struct blk_plug *plug = tsk->plug;
  929. if (plug)
  930. blk_flush_plug_list(plug, false);
  931. }
  932. static inline void blk_schedule_flush_plug(struct task_struct *tsk)
  933. {
  934. struct blk_plug *plug = tsk->plug;
  935. if (plug)
  936. blk_flush_plug_list(plug, true);
  937. }
  938. static inline bool blk_needs_flush_plug(struct task_struct *tsk)
  939. {
  940. struct blk_plug *plug = tsk->plug;
  941. return plug &&
  942. (!list_empty(&plug->list) ||
  943. !list_empty(&plug->mq_list) ||
  944. !list_empty(&plug->cb_list));
  945. }
  946. /*
  947. * tag stuff
  948. */
  949. extern int blk_queue_start_tag(struct request_queue *, struct request *);
  950. extern struct request *blk_queue_find_tag(struct request_queue *, int);
  951. extern void blk_queue_end_tag(struct request_queue *, struct request *);
  952. extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *, int);
  953. extern void blk_queue_free_tags(struct request_queue *);
  954. extern int blk_queue_resize_tags(struct request_queue *, int);
  955. extern void blk_queue_invalidate_tags(struct request_queue *);
  956. extern struct blk_queue_tag *blk_init_tags(int, int);
  957. extern void blk_free_tags(struct blk_queue_tag *);
  958. static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
  959. int tag)
  960. {
  961. if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
  962. return NULL;
  963. return bqt->tag_index[tag];
  964. }
  965. #define BLKDEV_DISCARD_SECURE 0x01 /* secure discard */
  966. extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
  967. extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
  968. sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
  969. extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
  970. sector_t nr_sects, gfp_t gfp_mask, struct page *page);
  971. extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
  972. sector_t nr_sects, gfp_t gfp_mask, bool discard);
  973. static inline int sb_issue_discard(struct super_block *sb, sector_t block,
  974. sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
  975. {
  976. return blkdev_issue_discard(sb->s_bdev, block << (sb->s_blocksize_bits - 9),
  977. nr_blocks << (sb->s_blocksize_bits - 9),
  978. gfp_mask, flags);
  979. }
  980. static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
  981. sector_t nr_blocks, gfp_t gfp_mask)
  982. {
  983. return blkdev_issue_zeroout(sb->s_bdev,
  984. block << (sb->s_blocksize_bits - 9),
  985. nr_blocks << (sb->s_blocksize_bits - 9),
  986. gfp_mask, true);
  987. }
  988. extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
  989. enum blk_default_limits {
  990. BLK_MAX_SEGMENTS = 128,
  991. BLK_SAFE_MAX_SECTORS = 255,
  992. BLK_DEF_MAX_SECTORS = 2560,
  993. BLK_MAX_SEGMENT_SIZE = 65536,
  994. BLK_SEG_BOUNDARY_MASK = 0xFFFFFFFFUL,
  995. };
  996. #define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
  997. static inline unsigned long queue_bounce_pfn(struct request_queue *q)
  998. {
  999. return q->limits.bounce_pfn;
  1000. }
  1001. static inline unsigned long queue_segment_boundary(struct request_queue *q)
  1002. {
  1003. return q->limits.seg_boundary_mask;
  1004. }
  1005. static inline unsigned long queue_virt_boundary(struct request_queue *q)
  1006. {
  1007. return q->limits.virt_boundary_mask;
  1008. }
  1009. static inline unsigned int queue_max_sectors(struct request_queue *q)
  1010. {
  1011. return q->limits.max_sectors;
  1012. }
  1013. static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
  1014. {
  1015. return q->limits.max_hw_sectors;
  1016. }
  1017. static inline unsigned short queue_max_segments(struct request_queue *q)
  1018. {
  1019. return q->limits.max_segments;
  1020. }
  1021. static inline unsigned int queue_max_segment_size(struct request_queue *q)
  1022. {
  1023. return q->limits.max_segment_size;
  1024. }
  1025. static inline unsigned short queue_logical_block_size(struct request_queue *q)
  1026. {
  1027. int retval = 512;
  1028. if (q && q->limits.logical_block_size)
  1029. retval = q->limits.logical_block_size;
  1030. return retval;
  1031. }
  1032. static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
  1033. {
  1034. return queue_logical_block_size(bdev_get_queue(bdev));
  1035. }
  1036. static inline unsigned int queue_physical_block_size(struct request_queue *q)
  1037. {
  1038. return q->limits.physical_block_size;
  1039. }
  1040. static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
  1041. {
  1042. return queue_physical_block_size(bdev_get_queue(bdev));
  1043. }
  1044. static inline unsigned int queue_io_min(struct request_queue *q)
  1045. {
  1046. return q->limits.io_min;
  1047. }
  1048. static inline int bdev_io_min(struct block_device *bdev)
  1049. {
  1050. return queue_io_min(bdev_get_queue(bdev));
  1051. }
  1052. static inline unsigned int queue_io_opt(struct request_queue *q)
  1053. {
  1054. return q->limits.io_opt;
  1055. }
  1056. static inline int bdev_io_opt(struct block_device *bdev)
  1057. {
  1058. return queue_io_opt(bdev_get_queue(bdev));
  1059. }
  1060. static inline int queue_alignment_offset(struct request_queue *q)
  1061. {
  1062. if (q->limits.misaligned)
  1063. return -1;
  1064. return q->limits.alignment_offset;
  1065. }
  1066. static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
  1067. {
  1068. unsigned int granularity = max(lim->physical_block_size, lim->io_min);
  1069. unsigned int alignment = sector_div(sector, granularity >> 9) << 9;
  1070. return (granularity + lim->alignment_offset - alignment) % granularity;
  1071. }
  1072. static inline int bdev_alignment_offset(struct block_device *bdev)
  1073. {
  1074. struct request_queue *q = bdev_get_queue(bdev);
  1075. if (q->limits.misaligned)
  1076. return -1;
  1077. if (bdev != bdev->bd_contains)
  1078. return bdev->bd_part->alignment_offset;
  1079. return q->limits.alignment_offset;
  1080. }
  1081. static inline int queue_discard_alignment(struct request_queue *q)
  1082. {
  1083. if (q->limits.discard_misaligned)
  1084. return -1;
  1085. return q->limits.discard_alignment;
  1086. }
  1087. static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
  1088. {
  1089. unsigned int alignment, granularity, offset;
  1090. if (!lim->max_discard_sectors)
  1091. return 0;
  1092. /* Why are these in bytes, not sectors? */
  1093. alignment = lim->discard_alignment >> 9;
  1094. granularity = lim->discard_granularity >> 9;
  1095. if (!granularity)
  1096. return 0;
  1097. /* Offset of the partition start in 'granularity' sectors */
  1098. offset = sector_div(sector, granularity);
  1099. /* And why do we do this modulus *again* in blkdev_issue_discard()? */
  1100. offset = (granularity + alignment - offset) % granularity;
  1101. /* Turn it back into bytes, gaah */
  1102. return offset << 9;
  1103. }
  1104. static inline int bdev_discard_alignment(struct block_device *bdev)
  1105. {
  1106. struct request_queue *q = bdev_get_queue(bdev);
  1107. if (bdev != bdev->bd_contains)
  1108. return bdev->bd_part->discard_alignment;
  1109. return q->limits.discard_alignment;
  1110. }
  1111. static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
  1112. {
  1113. if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
  1114. return 1;
  1115. return 0;
  1116. }
  1117. static inline unsigned int bdev_discard_zeroes_data(struct block_device *bdev)
  1118. {
  1119. return queue_discard_zeroes_data(bdev_get_queue(bdev));
  1120. }
  1121. static inline unsigned int bdev_write_same(struct block_device *bdev)
  1122. {
  1123. struct request_queue *q = bdev_get_queue(bdev);
  1124. if (q)
  1125. return q->limits.max_write_same_sectors;
  1126. return 0;
  1127. }
  1128. static inline int queue_dma_alignment(struct request_queue *q)
  1129. {
  1130. return q ? q->dma_alignment : 511;
  1131. }
  1132. static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
  1133. unsigned int len)
  1134. {
  1135. unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
  1136. return !(addr & alignment) && !(len & alignment);
  1137. }
  1138. /* assumes size > 256 */
  1139. static inline unsigned int blksize_bits(unsigned int size)
  1140. {
  1141. unsigned int bits = 8;
  1142. do {
  1143. bits++;
  1144. size >>= 1;
  1145. } while (size > 256);
  1146. return bits;
  1147. }
  1148. static inline unsigned int block_size(struct block_device *bdev)
  1149. {
  1150. return bdev->bd_block_size;
  1151. }
  1152. static inline bool queue_flush_queueable(struct request_queue *q)
  1153. {
  1154. return !q->flush_not_queueable;
  1155. }
  1156. typedef struct {struct page *v;} Sector;
  1157. unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
  1158. static inline void put_dev_sector(Sector p)
  1159. {
  1160. put_page(p.v);
  1161. }
  1162. static inline bool __bvec_gap_to_prev(struct request_queue *q,
  1163. struct bio_vec *bprv, unsigned int offset)
  1164. {
  1165. return offset ||
  1166. ((bprv->bv_offset + bprv->bv_len) & queue_virt_boundary(q));
  1167. }
  1168. /*
  1169. * Check if adding a bio_vec after bprv with offset would create a gap in
  1170. * the SG list. Most drivers don't care about this, but some do.
  1171. */
  1172. static inline bool bvec_gap_to_prev(struct request_queue *q,
  1173. struct bio_vec *bprv, unsigned int offset)
  1174. {
  1175. if (!queue_virt_boundary(q))
  1176. return false;
  1177. return __bvec_gap_to_prev(q, bprv, offset);
  1178. }
  1179. static inline bool bio_will_gap(struct request_queue *q, struct bio *prev,
  1180. struct bio *next)
  1181. {
  1182. if (bio_has_data(prev) && queue_virt_boundary(q)) {
  1183. struct bio_vec pb, nb;
  1184. bio_get_last_bvec(prev, &pb);
  1185. bio_get_first_bvec(next, &nb);
  1186. return __bvec_gap_to_prev(q, &pb, nb.bv_offset);
  1187. }
  1188. return false;
  1189. }
  1190. static inline bool req_gap_back_merge(struct request *req, struct bio *bio)
  1191. {
  1192. return bio_will_gap(req->q, req->biotail, bio);
  1193. }
  1194. static inline bool req_gap_front_merge(struct request *req, struct bio *bio)
  1195. {
  1196. return bio_will_gap(req->q, bio, req->bio);
  1197. }
  1198. struct work_struct;
  1199. int kblockd_schedule_work(struct work_struct *work);
  1200. int kblockd_schedule_delayed_work(struct delayed_work *dwork, unsigned long delay);
  1201. int kblockd_schedule_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
  1202. #ifdef CONFIG_BLK_CGROUP
  1203. /*
  1204. * This should not be using sched_clock(). A real patch is in progress
  1205. * to fix this up, until that is in place we need to disable preemption
  1206. * around sched_clock() in this function and set_io_start_time_ns().
  1207. */
  1208. static inline void set_start_time_ns(struct request *req)
  1209. {
  1210. preempt_disable();
  1211. req->start_time_ns = sched_clock();
  1212. preempt_enable();
  1213. }
  1214. static inline void set_io_start_time_ns(struct request *req)
  1215. {
  1216. preempt_disable();
  1217. req->io_start_time_ns = sched_clock();
  1218. preempt_enable();
  1219. }
  1220. static inline uint64_t rq_start_time_ns(struct request *req)
  1221. {
  1222. return req->start_time_ns;
  1223. }
  1224. static inline uint64_t rq_io_start_time_ns(struct request *req)
  1225. {
  1226. return req->io_start_time_ns;
  1227. }
  1228. #else
  1229. static inline void set_start_time_ns(struct request *req) {}
  1230. static inline void set_io_start_time_ns(struct request *req) {}
  1231. static inline uint64_t rq_start_time_ns(struct request *req)
  1232. {
  1233. return 0;
  1234. }
  1235. static inline uint64_t rq_io_start_time_ns(struct request *req)
  1236. {
  1237. return 0;
  1238. }
  1239. #endif
  1240. #define MODULE_ALIAS_BLOCKDEV(major,minor) \
  1241. MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
  1242. #define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
  1243. MODULE_ALIAS("block-major-" __stringify(major) "-*")
  1244. #if defined(CONFIG_BLK_DEV_INTEGRITY)
  1245. enum blk_integrity_flags {
  1246. BLK_INTEGRITY_VERIFY = 1 << 0,
  1247. BLK_INTEGRITY_GENERATE = 1 << 1,
  1248. BLK_INTEGRITY_DEVICE_CAPABLE = 1 << 2,
  1249. BLK_INTEGRITY_IP_CHECKSUM = 1 << 3,
  1250. };
  1251. struct blk_integrity_iter {
  1252. void *prot_buf;
  1253. void *data_buf;
  1254. sector_t seed;
  1255. unsigned int data_size;
  1256. unsigned short interval;
  1257. const char *disk_name;
  1258. };
  1259. typedef int (integrity_processing_fn) (struct blk_integrity_iter *);
  1260. struct blk_integrity_profile {
  1261. integrity_processing_fn *generate_fn;
  1262. integrity_processing_fn *verify_fn;
  1263. const char *name;
  1264. };
  1265. extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
  1266. extern void blk_integrity_unregister(struct gendisk *);
  1267. extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
  1268. extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
  1269. struct scatterlist *);
  1270. extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
  1271. extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
  1272. struct request *);
  1273. extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
  1274. struct bio *);
  1275. static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
  1276. {
  1277. struct blk_integrity *bi = &disk->queue->integrity;
  1278. if (!bi->profile)
  1279. return NULL;
  1280. return bi;
  1281. }
  1282. static inline
  1283. struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
  1284. {
  1285. return blk_get_integrity(bdev->bd_disk);
  1286. }
  1287. static inline bool blk_integrity_rq(struct request *rq)
  1288. {
  1289. return rq->cmd_flags & REQ_INTEGRITY;
  1290. }
  1291. static inline void blk_queue_max_integrity_segments(struct request_queue *q,
  1292. unsigned int segs)
  1293. {
  1294. q->limits.max_integrity_segments = segs;
  1295. }
  1296. static inline unsigned short
  1297. queue_max_integrity_segments(struct request_queue *q)
  1298. {
  1299. return q->limits.max_integrity_segments;
  1300. }
  1301. static inline bool integrity_req_gap_back_merge(struct request *req,
  1302. struct bio *next)
  1303. {
  1304. struct bio_integrity_payload *bip = bio_integrity(req->bio);
  1305. struct bio_integrity_payload *bip_next = bio_integrity(next);
  1306. return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
  1307. bip_next->bip_vec[0].bv_offset);
  1308. }
  1309. static inline bool integrity_req_gap_front_merge(struct request *req,
  1310. struct bio *bio)
  1311. {
  1312. struct bio_integrity_payload *bip = bio_integrity(bio);
  1313. struct bio_integrity_payload *bip_next = bio_integrity(req->bio);
  1314. return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
  1315. bip_next->bip_vec[0].bv_offset);
  1316. }
  1317. #else /* CONFIG_BLK_DEV_INTEGRITY */
  1318. struct bio;
  1319. struct block_device;
  1320. struct gendisk;
  1321. struct blk_integrity;
  1322. static inline int blk_integrity_rq(struct request *rq)
  1323. {
  1324. return 0;
  1325. }
  1326. static inline int blk_rq_count_integrity_sg(struct request_queue *q,
  1327. struct bio *b)
  1328. {
  1329. return 0;
  1330. }
  1331. static inline int blk_rq_map_integrity_sg(struct request_queue *q,
  1332. struct bio *b,
  1333. struct scatterlist *s)
  1334. {
  1335. return 0;
  1336. }
  1337. static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
  1338. {
  1339. return NULL;
  1340. }
  1341. static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
  1342. {
  1343. return NULL;
  1344. }
  1345. static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
  1346. {
  1347. return 0;
  1348. }
  1349. static inline void blk_integrity_register(struct gendisk *d,
  1350. struct blk_integrity *b)
  1351. {
  1352. }
  1353. static inline void blk_integrity_unregister(struct gendisk *d)
  1354. {
  1355. }
  1356. static inline void blk_queue_max_integrity_segments(struct request_queue *q,
  1357. unsigned int segs)
  1358. {
  1359. }
  1360. static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
  1361. {
  1362. return 0;
  1363. }
  1364. static inline bool blk_integrity_merge_rq(struct request_queue *rq,
  1365. struct request *r1,
  1366. struct request *r2)
  1367. {
  1368. return true;
  1369. }
  1370. static inline bool blk_integrity_merge_bio(struct request_queue *rq,
  1371. struct request *r,
  1372. struct bio *b)
  1373. {
  1374. return true;
  1375. }
  1376. static inline bool integrity_req_gap_back_merge(struct request *req,
  1377. struct bio *next)
  1378. {
  1379. return false;
  1380. }
  1381. static inline bool integrity_req_gap_front_merge(struct request *req,
  1382. struct bio *bio)
  1383. {
  1384. return false;
  1385. }
  1386. #endif /* CONFIG_BLK_DEV_INTEGRITY */
  1387. /**
  1388. * struct blk_dax_ctl - control and output parameters for ->direct_access
  1389. * @sector: (input) offset relative to a block_device
  1390. * @addr: (output) kernel virtual address for @sector populated by driver
  1391. * @pfn: (output) page frame number for @addr populated by driver
  1392. * @size: (input) number of bytes requested
  1393. */
  1394. struct blk_dax_ctl {
  1395. sector_t sector;
  1396. void __pmem *addr;
  1397. long size;
  1398. pfn_t pfn;
  1399. };
  1400. struct block_device_operations {
  1401. int (*open) (struct block_device *, fmode_t);
  1402. void (*release) (struct gendisk *, fmode_t);
  1403. int (*rw_page)(struct block_device *, sector_t, struct page *, int rw);
  1404. int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
  1405. int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
  1406. long (*direct_access)(struct block_device *, sector_t, void __pmem **,
  1407. pfn_t *);
  1408. unsigned int (*check_events) (struct gendisk *disk,
  1409. unsigned int clearing);
  1410. /* ->media_changed() is DEPRECATED, use ->check_events() instead */
  1411. int (*media_changed) (struct gendisk *);
  1412. void (*unlock_native_capacity) (struct gendisk *);
  1413. int (*revalidate_disk) (struct gendisk *);
  1414. int (*getgeo)(struct block_device *, struct hd_geometry *);
  1415. /* this callback is with swap_lock and sometimes page table lock held */
  1416. void (*swap_slot_free_notify) (struct block_device *, unsigned long);
  1417. struct module *owner;
  1418. const struct pr_ops *pr_ops;
  1419. };
  1420. extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
  1421. unsigned long);
  1422. extern int bdev_read_page(struct block_device *, sector_t, struct page *);
  1423. extern int bdev_write_page(struct block_device *, sector_t, struct page *,
  1424. struct writeback_control *);
  1425. extern long bdev_direct_access(struct block_device *, struct blk_dax_ctl *);
  1426. extern int bdev_dax_supported(struct super_block *, int);
  1427. #else /* CONFIG_BLOCK */
  1428. struct block_device;
  1429. /*
  1430. * stubs for when the block layer is configured out
  1431. */
  1432. #define buffer_heads_over_limit 0
  1433. static inline long nr_blockdev_pages(void)
  1434. {
  1435. return 0;
  1436. }
  1437. struct blk_plug {
  1438. };
  1439. static inline void blk_start_plug(struct blk_plug *plug)
  1440. {
  1441. }
  1442. static inline void blk_finish_plug(struct blk_plug *plug)
  1443. {
  1444. }
  1445. static inline void blk_flush_plug(struct task_struct *task)
  1446. {
  1447. }
  1448. static inline void blk_schedule_flush_plug(struct task_struct *task)
  1449. {
  1450. }
  1451. static inline bool blk_needs_flush_plug(struct task_struct *tsk)
  1452. {
  1453. return false;
  1454. }
  1455. static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
  1456. sector_t *error_sector)
  1457. {
  1458. return 0;
  1459. }
  1460. #endif /* CONFIG_BLOCK */
  1461. #endif