blkdev.h 57 KB

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