blkdev.h 50 KB

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