xref: /linux-6.15/include/linux/blkdev.h (revision 09cbfeaf)
11da177e4SLinus Torvalds #ifndef _LINUX_BLKDEV_H
21da177e4SLinus Torvalds #define _LINUX_BLKDEV_H
31da177e4SLinus Torvalds 
485fd0bc9SRussell King #include <linux/sched.h>
585fd0bc9SRussell King 
6f5ff8422SJens Axboe #ifdef CONFIG_BLOCK
7f5ff8422SJens Axboe 
81da177e4SLinus Torvalds #include <linux/major.h>
91da177e4SLinus Torvalds #include <linux/genhd.h>
101da177e4SLinus Torvalds #include <linux/list.h>
11320ae51fSJens Axboe #include <linux/llist.h>
121da177e4SLinus Torvalds #include <linux/timer.h>
131da177e4SLinus Torvalds #include <linux/workqueue.h>
141da177e4SLinus Torvalds #include <linux/pagemap.h>
1566114cadSTejun Heo #include <linux/backing-dev-defs.h>
161da177e4SLinus Torvalds #include <linux/wait.h>
171da177e4SLinus Torvalds #include <linux/mempool.h>
1834c0fd54SDan Williams #include <linux/pfn.h>
191da177e4SLinus Torvalds #include <linux/bio.h>
201da177e4SLinus Torvalds #include <linux/stringify.h>
213e6053d7SHugh Dickins #include <linux/gfp.h>
22d351af01SFUJITA Tomonori #include <linux/bsg.h>
23c7c22e4dSJens Axboe #include <linux/smp.h>
24548bc8e1STejun Heo #include <linux/rcupdate.h>
25add703fdSTejun Heo #include <linux/percpu-refcount.h>
2684be456fSChristoph Hellwig #include <linux/scatterlist.h>
271da177e4SLinus Torvalds 
28de477254SPaul Gortmaker struct module;
2921b2f0c8SChristoph Hellwig struct scsi_ioctl_command;
3021b2f0c8SChristoph Hellwig 
311da177e4SLinus Torvalds struct request_queue;
321da177e4SLinus Torvalds struct elevator_queue;
332056a782SJens Axboe struct blk_trace;
343d6392cfSJens Axboe struct request;
353d6392cfSJens Axboe struct sg_io_hdr;
36aa387cc8SMike Christie struct bsg_job;
373c798398STejun Heo struct blkcg_gq;
387c94e1c1SMing Lei struct blk_flush_queue;
39bbd3e064SChristoph Hellwig struct pr_ops;
401da177e4SLinus Torvalds 
411da177e4SLinus Torvalds #define BLKDEV_MIN_RQ	4
421da177e4SLinus Torvalds #define BLKDEV_MAX_RQ	128	/* Default maximum */
431da177e4SLinus Torvalds 
448bd435b3STejun Heo /*
458bd435b3STejun Heo  * Maximum number of blkcg policies allowed to be registered concurrently.
468bd435b3STejun Heo  * Defined here to simplify include dependency.
478bd435b3STejun Heo  */
488bd435b3STejun Heo #define BLKCG_MAX_POLS		2
498bd435b3STejun Heo 
501da177e4SLinus Torvalds struct request;
518ffdc655STejun Heo typedef void (rq_end_io_fn)(struct request *, int);
521da177e4SLinus Torvalds 
535b788ce3STejun Heo #define BLK_RL_SYNCFULL		(1U << 0)
545b788ce3STejun Heo #define BLK_RL_ASYNCFULL	(1U << 1)
555b788ce3STejun Heo 
561da177e4SLinus Torvalds struct request_list {
575b788ce3STejun Heo 	struct request_queue	*q;	/* the queue this rl belongs to */
58a051661cSTejun Heo #ifdef CONFIG_BLK_CGROUP
59a051661cSTejun Heo 	struct blkcg_gq		*blkg;	/* blkg this request pool belongs to */
60a051661cSTejun Heo #endif
611faa16d2SJens Axboe 	/*
621faa16d2SJens Axboe 	 * count[], starved[], and wait[] are indexed by
631faa16d2SJens Axboe 	 * BLK_RW_SYNC/BLK_RW_ASYNC
641faa16d2SJens Axboe 	 */
651da177e4SLinus Torvalds 	int			count[2];
661da177e4SLinus Torvalds 	int			starved[2];
671da177e4SLinus Torvalds 	mempool_t		*rq_pool;
681da177e4SLinus Torvalds 	wait_queue_head_t	wait[2];
695b788ce3STejun Heo 	unsigned int		flags;
701da177e4SLinus Torvalds };
711da177e4SLinus Torvalds 
724aff5e23SJens Axboe /*
734aff5e23SJens Axboe  * request command types
744aff5e23SJens Axboe  */
754aff5e23SJens Axboe enum rq_cmd_type_bits {
764aff5e23SJens Axboe 	REQ_TYPE_FS		= 1,	/* fs request */
774aff5e23SJens Axboe 	REQ_TYPE_BLOCK_PC,		/* scsi command */
78b42171efSChristoph Hellwig 	REQ_TYPE_DRV_PRIV,		/* driver defined types from here */
794aff5e23SJens Axboe };
804aff5e23SJens Axboe 
811da177e4SLinus Torvalds #define BLK_MAX_CDB	16
821da177e4SLinus Torvalds 
831da177e4SLinus Torvalds /*
84af76e555SChristoph Hellwig  * Try to put the fields that are referenced together in the same cacheline.
85af76e555SChristoph Hellwig  *
86af76e555SChristoph Hellwig  * If you modify this structure, make sure to update blk_rq_init() and
87af76e555SChristoph Hellwig  * especially blk_mq_rq_ctx_init() to take care of the added fields.
881da177e4SLinus Torvalds  */
891da177e4SLinus Torvalds struct request {
90ff856badSJens Axboe 	struct list_head queuelist;
91320ae51fSJens Axboe 	union {
92c7c22e4dSJens Axboe 		struct call_single_data csd;
938b4922d3SJan Kara 		unsigned long fifo_time;
94320ae51fSJens Axboe 	};
95ff856badSJens Axboe 
96165125e1SJens Axboe 	struct request_queue *q;
97320ae51fSJens Axboe 	struct blk_mq_ctx *mq_ctx;
98e6a1c874SJens Axboe 
995953316dSJens Axboe 	u64 cmd_flags;
100b42171efSChristoph Hellwig 	unsigned cmd_type;
101242f9dcbSJens Axboe 	unsigned long atomic_flags;
1021da177e4SLinus Torvalds 
103181fdde3SRichard Kennedy 	int cpu;
104181fdde3SRichard Kennedy 
105a2dec7b3STejun Heo 	/* the following two fields are internal, NEVER access directly */
106a2dec7b3STejun Heo 	unsigned int __data_len;	/* total data len */
107181fdde3SRichard Kennedy 	sector_t __sector;		/* sector cursor */
1081da177e4SLinus Torvalds 
1091da177e4SLinus Torvalds 	struct bio *bio;
1101da177e4SLinus Torvalds 	struct bio *biotail;
1111da177e4SLinus Torvalds 
112360f92c2SJens Axboe 	/*
113360f92c2SJens Axboe 	 * The hash is used inside the scheduler, and killed once the
114360f92c2SJens Axboe 	 * request reaches the dispatch list. The ipi_list is only used
115360f92c2SJens Axboe 	 * to queue the request for softirq completion, which is long
116360f92c2SJens Axboe 	 * after the request has been unhashed (and even removed from
117360f92c2SJens Axboe 	 * the dispatch list).
118360f92c2SJens Axboe 	 */
119360f92c2SJens Axboe 	union {
1209817064bSJens Axboe 		struct hlist_node hash;	/* merge hash */
121360f92c2SJens Axboe 		struct list_head ipi_list;
122360f92c2SJens Axboe 	};
123360f92c2SJens Axboe 
124e6a1c874SJens Axboe 	/*
125e6a1c874SJens Axboe 	 * The rb_node is only used inside the io scheduler, requests
126e6a1c874SJens Axboe 	 * are pruned when moved to the dispatch queue. So let the
127c186794dSMike Snitzer 	 * completion_data share space with the rb_node.
128e6a1c874SJens Axboe 	 */
129e6a1c874SJens Axboe 	union {
1302e662b65SJens Axboe 		struct rb_node rb_node;	/* sort/lookup */
131c186794dSMike Snitzer 		void *completion_data;
132c186794dSMike Snitzer 	};
133c186794dSMike Snitzer 
134c186794dSMike Snitzer 	/*
135c186794dSMike Snitzer 	 * Three pointers are available for the IO schedulers, if they need
136c186794dSMike Snitzer 	 * more they have to dynamically allocate it.  Flush requests are
137c186794dSMike Snitzer 	 * never put on the IO scheduler. So let the flush fields share
138a612fddfSTejun Heo 	 * space with the elevator data.
139c186794dSMike Snitzer 	 */
140c186794dSMike Snitzer 	union {
141a612fddfSTejun Heo 		struct {
142a612fddfSTejun Heo 			struct io_cq		*icq;
143a612fddfSTejun Heo 			void			*priv[2];
144a612fddfSTejun Heo 		} elv;
145a612fddfSTejun Heo 
146ae1b1539STejun Heo 		struct {
147ae1b1539STejun Heo 			unsigned int		seq;
148ae1b1539STejun Heo 			struct list_head	list;
1494853abaaSJeff Moyer 			rq_end_io_fn		*saved_end_io;
150ae1b1539STejun Heo 		} flush;
151e6a1c874SJens Axboe 	};
1529817064bSJens Axboe 
1538f34ee75SJens Axboe 	struct gendisk *rq_disk;
15409e099d4SJerome Marchand 	struct hd_struct *part;
1551da177e4SLinus Torvalds 	unsigned long start_time;
1569195291eSDivyesh Shah #ifdef CONFIG_BLK_CGROUP
157a051661cSTejun Heo 	struct request_list *rl;		/* rl this rq is alloced from */
1589195291eSDivyesh Shah 	unsigned long long start_time_ns;
1599195291eSDivyesh Shah 	unsigned long long io_start_time_ns;    /* when passed to hardware */
1609195291eSDivyesh Shah #endif
1611da177e4SLinus Torvalds 	/* Number of scatter-gather DMA addr+len pairs after
1621da177e4SLinus Torvalds 	 * physical address coalescing is performed.
1631da177e4SLinus Torvalds 	 */
1641da177e4SLinus Torvalds 	unsigned short nr_phys_segments;
16513f05c8dSMartin K. Petersen #if defined(CONFIG_BLK_DEV_INTEGRITY)
16613f05c8dSMartin K. Petersen 	unsigned short nr_integrity_segments;
16713f05c8dSMartin K. Petersen #endif
1681da177e4SLinus Torvalds 
1698f34ee75SJens Axboe 	unsigned short ioprio;
1708f34ee75SJens Axboe 
171731ec497STejun Heo 	void *special;		/* opaque pointer available for LLD use */
1721da177e4SLinus Torvalds 
173cdd60262SJens Axboe 	int tag;
174cdd60262SJens Axboe 	int errors;
175cdd60262SJens Axboe 
1761da177e4SLinus Torvalds 	/*
1771da177e4SLinus Torvalds 	 * when request is used as a packet command carrier
1781da177e4SLinus Torvalds 	 */
179d7e3c324SFUJITA Tomonori 	unsigned char __cmd[BLK_MAX_CDB];
180d7e3c324SFUJITA Tomonori 	unsigned char *cmd;
181181fdde3SRichard Kennedy 	unsigned short cmd_len;
1821da177e4SLinus Torvalds 
1837a85f889SFUJITA Tomonori 	unsigned int extra_len;	/* length of alignment and padding */
1841da177e4SLinus Torvalds 	unsigned int sense_len;
185c3a4d78cSTejun Heo 	unsigned int resid_len;	/* residual count */
1861da177e4SLinus Torvalds 	void *sense;
1871da177e4SLinus Torvalds 
188242f9dcbSJens Axboe 	unsigned long deadline;
189242f9dcbSJens Axboe 	struct list_head timeout_list;
1901da177e4SLinus Torvalds 	unsigned int timeout;
19117e01f21SMike Christie 	int retries;
1921da177e4SLinus Torvalds 
1931da177e4SLinus Torvalds 	/*
194c00895abSJens Axboe 	 * completion callback.
1951da177e4SLinus Torvalds 	 */
1961da177e4SLinus Torvalds 	rq_end_io_fn *end_io;
1971da177e4SLinus Torvalds 	void *end_io_data;
198abae1fdeSFUJITA Tomonori 
199abae1fdeSFUJITA Tomonori 	/* for bidi */
200abae1fdeSFUJITA Tomonori 	struct request *next_rq;
2011da177e4SLinus Torvalds };
2021da177e4SLinus Torvalds 
203766ca442SFernando Luis Vázquez Cao static inline unsigned short req_get_ioprio(struct request *req)
204766ca442SFernando Luis Vázquez Cao {
205766ca442SFernando Luis Vázquez Cao 	return req->ioprio;
206766ca442SFernando Luis Vázquez Cao }
207766ca442SFernando Luis Vázquez Cao 
2081da177e4SLinus Torvalds #include <linux/elevator.h>
2091da177e4SLinus Torvalds 
210320ae51fSJens Axboe struct blk_queue_ctx;
211320ae51fSJens Axboe 
212165125e1SJens Axboe typedef void (request_fn_proc) (struct request_queue *q);
213dece1635SJens Axboe typedef blk_qc_t (make_request_fn) (struct request_queue *q, struct bio *bio);
214165125e1SJens Axboe typedef int (prep_rq_fn) (struct request_queue *, struct request *);
21528018c24SJames Bottomley typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
2161da177e4SLinus Torvalds 
2171da177e4SLinus Torvalds struct bio_vec;
218ff856badSJens Axboe typedef void (softirq_done_fn)(struct request *);
2192fb98e84STejun Heo typedef int (dma_drain_needed_fn)(struct request *);
220ef9e3facSKiyoshi Ueda typedef int (lld_busy_fn) (struct request_queue *q);
221aa387cc8SMike Christie typedef int (bsg_job_fn) (struct bsg_job *);
2221da177e4SLinus Torvalds 
223242f9dcbSJens Axboe enum blk_eh_timer_return {
224242f9dcbSJens Axboe 	BLK_EH_NOT_HANDLED,
225242f9dcbSJens Axboe 	BLK_EH_HANDLED,
226242f9dcbSJens Axboe 	BLK_EH_RESET_TIMER,
227242f9dcbSJens Axboe };
228242f9dcbSJens Axboe 
229242f9dcbSJens Axboe typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
230242f9dcbSJens Axboe 
2311da177e4SLinus Torvalds enum blk_queue_state {
2321da177e4SLinus Torvalds 	Queue_down,
2331da177e4SLinus Torvalds 	Queue_up,
2341da177e4SLinus Torvalds };
2351da177e4SLinus Torvalds 
2361da177e4SLinus Torvalds struct blk_queue_tag {
2371da177e4SLinus Torvalds 	struct request **tag_index;	/* map of busy tags */
2381da177e4SLinus Torvalds 	unsigned long *tag_map;		/* bit map of free/busy tags */
2391da177e4SLinus Torvalds 	int busy;			/* current depth */
2401da177e4SLinus Torvalds 	int max_depth;			/* what we will send to device */
241ba025082STejun Heo 	int real_max_depth;		/* what the array can hold */
2421da177e4SLinus Torvalds 	atomic_t refcnt;		/* map can be shared */
243ee1b6f7aSShaohua Li 	int alloc_policy;		/* tag allocation policy */
244ee1b6f7aSShaohua Li 	int next_tag;			/* next tag */
2451da177e4SLinus Torvalds };
246ee1b6f7aSShaohua Li #define BLK_TAG_ALLOC_FIFO 0 /* allocate starting from 0 */
247ee1b6f7aSShaohua Li #define BLK_TAG_ALLOC_RR 1 /* allocate starting from last allocated tag */
2481da177e4SLinus Torvalds 
249abf54393SFUJITA Tomonori #define BLK_SCSI_MAX_CMDS	(256)
250abf54393SFUJITA Tomonori #define BLK_SCSI_CMD_PER_LONG	(BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
251abf54393SFUJITA Tomonori 
252025146e1SMartin K. Petersen struct queue_limits {
253025146e1SMartin K. Petersen 	unsigned long		bounce_pfn;
254025146e1SMartin K. Petersen 	unsigned long		seg_boundary_mask;
25503100aadSKeith Busch 	unsigned long		virt_boundary_mask;
256025146e1SMartin K. Petersen 
257025146e1SMartin K. Petersen 	unsigned int		max_hw_sectors;
258ca369d51SMartin K. Petersen 	unsigned int		max_dev_sectors;
259762380adSJens Axboe 	unsigned int		chunk_sectors;
260025146e1SMartin K. Petersen 	unsigned int		max_sectors;
261025146e1SMartin K. Petersen 	unsigned int		max_segment_size;
262c72758f3SMartin K. Petersen 	unsigned int		physical_block_size;
263c72758f3SMartin K. Petersen 	unsigned int		alignment_offset;
264c72758f3SMartin K. Petersen 	unsigned int		io_min;
265c72758f3SMartin K. Petersen 	unsigned int		io_opt;
26667efc925SChristoph Hellwig 	unsigned int		max_discard_sectors;
2670034af03SJens Axboe 	unsigned int		max_hw_discard_sectors;
2684363ac7cSMartin K. Petersen 	unsigned int		max_write_same_sectors;
26986b37281SMartin K. Petersen 	unsigned int		discard_granularity;
27086b37281SMartin K. Petersen 	unsigned int		discard_alignment;
271025146e1SMartin K. Petersen 
272025146e1SMartin K. Petersen 	unsigned short		logical_block_size;
2738a78362cSMartin K. Petersen 	unsigned short		max_segments;
27413f05c8dSMartin K. Petersen 	unsigned short		max_integrity_segments;
275025146e1SMartin K. Petersen 
276c72758f3SMartin K. Petersen 	unsigned char		misaligned;
27786b37281SMartin K. Petersen 	unsigned char		discard_misaligned;
278e692cb66SMartin K. Petersen 	unsigned char		cluster;
279a934a00aSMartin K. Petersen 	unsigned char		discard_zeroes_data;
280c78afc62SKent Overstreet 	unsigned char		raid_partial_stripes_expensive;
281025146e1SMartin K. Petersen };
282025146e1SMartin K. Petersen 
283d7b76301SRichard Kennedy struct request_queue {
2841da177e4SLinus Torvalds 	/*
2851da177e4SLinus Torvalds 	 * Together with queue_head for cacheline sharing
2861da177e4SLinus Torvalds 	 */
2871da177e4SLinus Torvalds 	struct list_head	queue_head;
2881da177e4SLinus Torvalds 	struct request		*last_merge;
289b374d18aSJens Axboe 	struct elevator_queue	*elevator;
2908a5ecdd4STejun Heo 	int			nr_rqs[2];	/* # allocated [a]sync rqs */
2918a5ecdd4STejun Heo 	int			nr_rqs_elvpriv;	/* # allocated rqs w/ elvpriv */
2921da177e4SLinus Torvalds 
2931da177e4SLinus Torvalds 	/*
294a051661cSTejun Heo 	 * If blkcg is not used, @q->root_rl serves all requests.  If blkcg
295a051661cSTejun Heo 	 * is used, root blkg allocates from @q->root_rl and all other
296a051661cSTejun Heo 	 * blkgs from their own blkg->rl.  Which one to use should be
297a051661cSTejun Heo 	 * determined using bio_request_list().
2981da177e4SLinus Torvalds 	 */
299a051661cSTejun Heo 	struct request_list	root_rl;
3001da177e4SLinus Torvalds 
3011da177e4SLinus Torvalds 	request_fn_proc		*request_fn;
3021da177e4SLinus Torvalds 	make_request_fn		*make_request_fn;
3031da177e4SLinus Torvalds 	prep_rq_fn		*prep_rq_fn;
30428018c24SJames Bottomley 	unprep_rq_fn		*unprep_rq_fn;
305ff856badSJens Axboe 	softirq_done_fn		*softirq_done_fn;
306242f9dcbSJens Axboe 	rq_timed_out_fn		*rq_timed_out_fn;
3072fb98e84STejun Heo 	dma_drain_needed_fn	*dma_drain_needed;
308ef9e3facSKiyoshi Ueda 	lld_busy_fn		*lld_busy_fn;
3091da177e4SLinus Torvalds 
310320ae51fSJens Axboe 	struct blk_mq_ops	*mq_ops;
311320ae51fSJens Axboe 
312320ae51fSJens Axboe 	unsigned int		*mq_map;
313320ae51fSJens Axboe 
314320ae51fSJens Axboe 	/* sw queues */
315e6cdb092SMing Lei 	struct blk_mq_ctx __percpu	*queue_ctx;
316320ae51fSJens Axboe 	unsigned int		nr_queues;
317320ae51fSJens Axboe 
318320ae51fSJens Axboe 	/* hw dispatch queues */
319320ae51fSJens Axboe 	struct blk_mq_hw_ctx	**queue_hw_ctx;
320320ae51fSJens Axboe 	unsigned int		nr_hw_queues;
321320ae51fSJens Axboe 
3221da177e4SLinus Torvalds 	/*
3238922e16cSTejun Heo 	 * Dispatch queue sorting
3248922e16cSTejun Heo 	 */
3251b47f531SJens Axboe 	sector_t		end_sector;
3268922e16cSTejun Heo 	struct request		*boundary_rq;
3278922e16cSTejun Heo 
3288922e16cSTejun Heo 	/*
3293cca6dc1SJens Axboe 	 * Delayed queue handling
3301da177e4SLinus Torvalds 	 */
3313cca6dc1SJens Axboe 	struct delayed_work	delay_work;
3321da177e4SLinus Torvalds 
3331da177e4SLinus Torvalds 	struct backing_dev_info	backing_dev_info;
3341da177e4SLinus Torvalds 
3351da177e4SLinus Torvalds 	/*
3361da177e4SLinus Torvalds 	 * The queue owner gets to use this for whatever they like.
3371da177e4SLinus Torvalds 	 * ll_rw_blk doesn't touch it.
3381da177e4SLinus Torvalds 	 */
3391da177e4SLinus Torvalds 	void			*queuedata;
3401da177e4SLinus Torvalds 
3411da177e4SLinus Torvalds 	/*
3421da177e4SLinus Torvalds 	 * various queue flags, see QUEUE_* below
3431da177e4SLinus Torvalds 	 */
3441da177e4SLinus Torvalds 	unsigned long		queue_flags;
3451da177e4SLinus Torvalds 
3461da177e4SLinus Torvalds 	/*
347a73f730dSTejun Heo 	 * ida allocated id for this queue.  Used to index queues from
348a73f730dSTejun Heo 	 * ioctx.
349a73f730dSTejun Heo 	 */
350a73f730dSTejun Heo 	int			id;
351a73f730dSTejun Heo 
352a73f730dSTejun Heo 	/*
353d7b76301SRichard Kennedy 	 * queue needs bounce pages for pages above this limit
354d7b76301SRichard Kennedy 	 */
355d7b76301SRichard Kennedy 	gfp_t			bounce_gfp;
356d7b76301SRichard Kennedy 
357d7b76301SRichard Kennedy 	/*
358152587deS 	 * protects queue structures from reentrancy. ->__queue_lock should
359152587deS 	 * _never_ be used directly, it is queue private. always use
360152587deS 	 * ->queue_lock.
3611da177e4SLinus Torvalds 	 */
362152587deS 	spinlock_t		__queue_lock;
3631da177e4SLinus Torvalds 	spinlock_t		*queue_lock;
3641da177e4SLinus Torvalds 
3651da177e4SLinus Torvalds 	/*
3661da177e4SLinus Torvalds 	 * queue kobject
3671da177e4SLinus Torvalds 	 */
3681da177e4SLinus Torvalds 	struct kobject kobj;
3691da177e4SLinus Torvalds 
370320ae51fSJens Axboe 	/*
371320ae51fSJens Axboe 	 * mq queue kobject
372320ae51fSJens Axboe 	 */
373320ae51fSJens Axboe 	struct kobject mq_kobj;
374320ae51fSJens Axboe 
375ac6fc48cSDan Williams #ifdef  CONFIG_BLK_DEV_INTEGRITY
376ac6fc48cSDan Williams 	struct blk_integrity integrity;
377ac6fc48cSDan Williams #endif	/* CONFIG_BLK_DEV_INTEGRITY */
378ac6fc48cSDan Williams 
37947fafbc7SRafael J. Wysocki #ifdef CONFIG_PM
3806c954667SLin Ming 	struct device		*dev;
3816c954667SLin Ming 	int			rpm_status;
3826c954667SLin Ming 	unsigned int		nr_pending;
3836c954667SLin Ming #endif
3846c954667SLin Ming 
3851da177e4SLinus Torvalds 	/*
3861da177e4SLinus Torvalds 	 * queue settings
3871da177e4SLinus Torvalds 	 */
3881da177e4SLinus Torvalds 	unsigned long		nr_requests;	/* Max # of requests */
3891da177e4SLinus Torvalds 	unsigned int		nr_congestion_on;
3901da177e4SLinus Torvalds 	unsigned int		nr_congestion_off;
3911da177e4SLinus Torvalds 	unsigned int		nr_batching;
3921da177e4SLinus Torvalds 
393fa0ccd83SJames Bottomley 	unsigned int		dma_drain_size;
394d7b76301SRichard Kennedy 	void			*dma_drain_buffer;
395e3790c7dSTejun Heo 	unsigned int		dma_pad_mask;
3961da177e4SLinus Torvalds 	unsigned int		dma_alignment;
3971da177e4SLinus Torvalds 
3981da177e4SLinus Torvalds 	struct blk_queue_tag	*queue_tags;
3996eca9004SJens Axboe 	struct list_head	tag_busy_list;
4001da177e4SLinus Torvalds 
40115853af9STejun Heo 	unsigned int		nr_sorted;
4020a7ae2ffSJens Axboe 	unsigned int		in_flight[2];
40324faf6f6SBart Van Assche 	/*
40424faf6f6SBart Van Assche 	 * Number of active block driver functions for which blk_drain_queue()
40524faf6f6SBart Van Assche 	 * must wait. Must be incremented around functions that unlock the
40624faf6f6SBart Van Assche 	 * queue_lock internally, e.g. scsi_request_fn().
40724faf6f6SBart Van Assche 	 */
40824faf6f6SBart Van Assche 	unsigned int		request_fn_active;
4091da177e4SLinus Torvalds 
410242f9dcbSJens Axboe 	unsigned int		rq_timeout;
411242f9dcbSJens Axboe 	struct timer_list	timeout;
412287922ebSChristoph Hellwig 	struct work_struct	timeout_work;
413242f9dcbSJens Axboe 	struct list_head	timeout_list;
414242f9dcbSJens Axboe 
415a612fddfSTejun Heo 	struct list_head	icq_list;
4164eef3049STejun Heo #ifdef CONFIG_BLK_CGROUP
417a2b1693bSTejun Heo 	DECLARE_BITMAP		(blkcg_pols, BLKCG_MAX_POLS);
4183c798398STejun Heo 	struct blkcg_gq		*root_blkg;
41903aa264aSTejun Heo 	struct list_head	blkg_list;
4204eef3049STejun Heo #endif
421a612fddfSTejun Heo 
422025146e1SMartin K. Petersen 	struct queue_limits	limits;
423025146e1SMartin K. Petersen 
4241da177e4SLinus Torvalds 	/*
4251da177e4SLinus Torvalds 	 * sg stuff
4261da177e4SLinus Torvalds 	 */
4271da177e4SLinus Torvalds 	unsigned int		sg_timeout;
4281da177e4SLinus Torvalds 	unsigned int		sg_reserved_size;
4291946089aSChristoph Lameter 	int			node;
4306c5c9341SAlexey Dobriyan #ifdef CONFIG_BLK_DEV_IO_TRACE
4312056a782SJens Axboe 	struct blk_trace	*blk_trace;
4326c5c9341SAlexey Dobriyan #endif
4331da177e4SLinus Torvalds 	/*
4344913efe4STejun Heo 	 * for flush operations
4351da177e4SLinus Torvalds 	 */
4364913efe4STejun Heo 	unsigned int		flush_flags;
437f3876930S[email protected] 	unsigned int		flush_not_queueable:1;
4387c94e1c1SMing Lei 	struct blk_flush_queue	*fq;
439483f4afcSAl Viro 
4406fca6a61SChristoph Hellwig 	struct list_head	requeue_list;
4416fca6a61SChristoph Hellwig 	spinlock_t		requeue_lock;
4426fca6a61SChristoph Hellwig 	struct work_struct	requeue_work;
4436fca6a61SChristoph Hellwig 
444483f4afcSAl Viro 	struct mutex		sysfs_lock;
445d351af01SFUJITA Tomonori 
446d732580bSTejun Heo 	int			bypass_depth;
4474ecd4fefSChristoph Hellwig 	atomic_t		mq_freeze_depth;
448d732580bSTejun Heo 
449d351af01SFUJITA Tomonori #if defined(CONFIG_BLK_DEV_BSG)
450aa387cc8SMike Christie 	bsg_job_fn		*bsg_job_fn;
451aa387cc8SMike Christie 	int			bsg_job_size;
452d351af01SFUJITA Tomonori 	struct bsg_class_device bsg_dev;
453d351af01SFUJITA Tomonori #endif
454e43473b7SVivek Goyal 
455e43473b7SVivek Goyal #ifdef CONFIG_BLK_DEV_THROTTLING
456e43473b7SVivek Goyal 	/* Throttle data */
457e43473b7SVivek Goyal 	struct throtl_data *td;
458e43473b7SVivek Goyal #endif
459548bc8e1STejun Heo 	struct rcu_head		rcu_head;
460320ae51fSJens Axboe 	wait_queue_head_t	mq_freeze_wq;
4613ef28e83SDan Williams 	struct percpu_ref	q_usage_counter;
462320ae51fSJens Axboe 	struct list_head	all_q_node;
4630d2602caSJens Axboe 
4640d2602caSJens Axboe 	struct blk_mq_tag_set	*tag_set;
4650d2602caSJens Axboe 	struct list_head	tag_set_list;
46654efd50bSKent Overstreet 	struct bio_set		*bio_split;
4674593fdbeSAkinobu Mita 
4684593fdbeSAkinobu Mita 	bool			mq_sysfs_init_done;
4691da177e4SLinus Torvalds };
4701da177e4SLinus Torvalds 
4711da177e4SLinus Torvalds #define QUEUE_FLAG_QUEUED	1	/* uses generic tag queueing */
4721da177e4SLinus Torvalds #define QUEUE_FLAG_STOPPED	2	/* queue is stopped */
4731faa16d2SJens Axboe #define	QUEUE_FLAG_SYNCFULL	3	/* read queue has been filled */
4741faa16d2SJens Axboe #define QUEUE_FLAG_ASYNCFULL	4	/* write queue has been filled */
4753f3299d5SBart Van Assche #define QUEUE_FLAG_DYING	5	/* queue being torn down */
476d732580bSTejun Heo #define QUEUE_FLAG_BYPASS	6	/* act as dumb FIFO queue */
477c21e6bebSJens Axboe #define QUEUE_FLAG_BIDI		7	/* queue supports bidi requests */
478c21e6bebSJens Axboe #define QUEUE_FLAG_NOMERGES     8	/* disable merge attempts */
4795757a6d7SDan Williams #define QUEUE_FLAG_SAME_COMP	9	/* complete on same CPU-group */
480c21e6bebSJens Axboe #define QUEUE_FLAG_FAIL_IO     10	/* fake timeout */
481c21e6bebSJens Axboe #define QUEUE_FLAG_STACKABLE   11	/* supports request stacking */
482c21e6bebSJens Axboe #define QUEUE_FLAG_NONROT      12	/* non-rotational device (SSD) */
48388e740f1SFernando Luis Vázquez Cao #define QUEUE_FLAG_VIRT        QUEUE_FLAG_NONROT /* paravirt device */
484c21e6bebSJens Axboe #define QUEUE_FLAG_IO_STAT     13	/* do IO stats */
485c21e6bebSJens Axboe #define QUEUE_FLAG_DISCARD     14	/* supports DISCARD */
486c21e6bebSJens Axboe #define QUEUE_FLAG_NOXMERGES   15	/* No extended merges */
487c21e6bebSJens Axboe #define QUEUE_FLAG_ADD_RANDOM  16	/* Contributes to random pool */
488c21e6bebSJens Axboe #define QUEUE_FLAG_SECDISCARD  17	/* supports SECDISCARD */
4895757a6d7SDan Williams #define QUEUE_FLAG_SAME_FORCE  18	/* force complete on same CPU */
490c246e80dSBart Van Assche #define QUEUE_FLAG_DEAD        19	/* queue tear-down finished */
491320ae51fSJens Axboe #define QUEUE_FLAG_INIT_DONE   20	/* queue is initialized */
49205f1dd53SJens Axboe #define QUEUE_FLAG_NO_SG_MERGE 21	/* don't attempt to merge SG segments*/
49305229beeSJens Axboe #define QUEUE_FLAG_POLL	       22	/* IO polling enabled if set */
494bc58ba94SJens Axboe 
495bc58ba94SJens Axboe #define QUEUE_FLAG_DEFAULT	((1 << QUEUE_FLAG_IO_STAT) |		\
49601e97f6bSJens Axboe 				 (1 << QUEUE_FLAG_STACKABLE)	|	\
497e2e1a148SJens Axboe 				 (1 << QUEUE_FLAG_SAME_COMP)	|	\
498e2e1a148SJens Axboe 				 (1 << QUEUE_FLAG_ADD_RANDOM))
499797e7dbbSTejun Heo 
50094eddfbeSJens Axboe #define QUEUE_FLAG_MQ_DEFAULT	((1 << QUEUE_FLAG_IO_STAT) |		\
501ad9cf3bbSMike Snitzer 				 (1 << QUEUE_FLAG_STACKABLE)	|	\
5028e0b60b9SChristoph Hellwig 				 (1 << QUEUE_FLAG_SAME_COMP)	|	\
5038e0b60b9SChristoph Hellwig 				 (1 << QUEUE_FLAG_POLL))
50494eddfbeSJens Axboe 
5058bcb6c7dSAndi Kleen static inline void queue_lockdep_assert_held(struct request_queue *q)
5068f45c1a5SLinus Torvalds {
5078bcb6c7dSAndi Kleen 	if (q->queue_lock)
5088bcb6c7dSAndi Kleen 		lockdep_assert_held(q->queue_lock);
5098f45c1a5SLinus Torvalds }
5108f45c1a5SLinus Torvalds 
51175ad23bcSNick Piggin static inline void queue_flag_set_unlocked(unsigned int flag,
51275ad23bcSNick Piggin 					   struct request_queue *q)
51375ad23bcSNick Piggin {
51475ad23bcSNick Piggin 	__set_bit(flag, &q->queue_flags);
51575ad23bcSNick Piggin }
51675ad23bcSNick Piggin 
517e48ec690SJens Axboe static inline int queue_flag_test_and_clear(unsigned int flag,
518e48ec690SJens Axboe 					    struct request_queue *q)
519e48ec690SJens Axboe {
5208bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
521e48ec690SJens Axboe 
522e48ec690SJens Axboe 	if (test_bit(flag, &q->queue_flags)) {
523e48ec690SJens Axboe 		__clear_bit(flag, &q->queue_flags);
524e48ec690SJens Axboe 		return 1;
525e48ec690SJens Axboe 	}
526e48ec690SJens Axboe 
527e48ec690SJens Axboe 	return 0;
528e48ec690SJens Axboe }
529e48ec690SJens Axboe 
530e48ec690SJens Axboe static inline int queue_flag_test_and_set(unsigned int flag,
531e48ec690SJens Axboe 					  struct request_queue *q)
532e48ec690SJens Axboe {
5338bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
534e48ec690SJens Axboe 
535e48ec690SJens Axboe 	if (!test_bit(flag, &q->queue_flags)) {
536e48ec690SJens Axboe 		__set_bit(flag, &q->queue_flags);
537e48ec690SJens Axboe 		return 0;
538e48ec690SJens Axboe 	}
539e48ec690SJens Axboe 
540e48ec690SJens Axboe 	return 1;
541e48ec690SJens Axboe }
542e48ec690SJens Axboe 
54375ad23bcSNick Piggin static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
54475ad23bcSNick Piggin {
5458bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
54675ad23bcSNick Piggin 	__set_bit(flag, &q->queue_flags);
54775ad23bcSNick Piggin }
54875ad23bcSNick Piggin 
54975ad23bcSNick Piggin static inline void queue_flag_clear_unlocked(unsigned int flag,
55075ad23bcSNick Piggin 					     struct request_queue *q)
55175ad23bcSNick Piggin {
55275ad23bcSNick Piggin 	__clear_bit(flag, &q->queue_flags);
55375ad23bcSNick Piggin }
55475ad23bcSNick Piggin 
5550a7ae2ffSJens Axboe static inline int queue_in_flight(struct request_queue *q)
5560a7ae2ffSJens Axboe {
5570a7ae2ffSJens Axboe 	return q->in_flight[0] + q->in_flight[1];
5580a7ae2ffSJens Axboe }
5590a7ae2ffSJens Axboe 
56075ad23bcSNick Piggin static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
56175ad23bcSNick Piggin {
5628bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
56375ad23bcSNick Piggin 	__clear_bit(flag, &q->queue_flags);
56475ad23bcSNick Piggin }
56575ad23bcSNick Piggin 
5661da177e4SLinus Torvalds #define blk_queue_tagged(q)	test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
5671da177e4SLinus Torvalds #define blk_queue_stopped(q)	test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
5683f3299d5SBart Van Assche #define blk_queue_dying(q)	test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
569c246e80dSBart Van Assche #define blk_queue_dead(q)	test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
570d732580bSTejun Heo #define blk_queue_bypass(q)	test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
571320ae51fSJens Axboe #define blk_queue_init_done(q)	test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
572ac9fafa1SAlan D. Brunelle #define blk_queue_nomerges(q)	test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
573488991e2SAlan D. Brunelle #define blk_queue_noxmerges(q)	\
574488991e2SAlan D. Brunelle 	test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
575a68bbddbSJens Axboe #define blk_queue_nonrot(q)	test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
576bc58ba94SJens Axboe #define blk_queue_io_stat(q)	test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
577e2e1a148SJens Axboe #define blk_queue_add_random(q)	test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
5784ee5eaf4SKiyoshi Ueda #define blk_queue_stackable(q)	\
5794ee5eaf4SKiyoshi Ueda 	test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
580c15227deSChristoph Hellwig #define blk_queue_discard(q)	test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
5818d57a98cSAdrian Hunter #define blk_queue_secdiscard(q)	(blk_queue_discard(q) && \
5828d57a98cSAdrian Hunter 	test_bit(QUEUE_FLAG_SECDISCARD, &(q)->queue_flags))
5831da177e4SLinus Torvalds 
58433659ebbSChristoph Hellwig #define blk_noretry_request(rq) \
58533659ebbSChristoph Hellwig 	((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
58633659ebbSChristoph Hellwig 			     REQ_FAILFAST_DRIVER))
5874aff5e23SJens Axboe 
58833659ebbSChristoph Hellwig #define blk_account_rq(rq) \
58933659ebbSChristoph Hellwig 	(((rq)->cmd_flags & REQ_STARTED) && \
590e2a60da7SMartin K. Petersen 	 ((rq)->cmd_type == REQ_TYPE_FS))
5911da177e4SLinus Torvalds 
592ab780f1eSJens Axboe #define blk_rq_cpu_valid(rq)	((rq)->cpu != -1)
593abae1fdeSFUJITA Tomonori #define blk_bidi_rq(rq)		((rq)->next_rq != NULL)
594336cdb40SKiyoshi Ueda /* rq->queuelist of dequeued request must be list_empty() */
595336cdb40SKiyoshi Ueda #define blk_queued_rq(rq)	(!list_empty(&(rq)->queuelist))
5961da177e4SLinus Torvalds 
5971da177e4SLinus Torvalds #define list_entry_rq(ptr)	list_entry((ptr), struct request, queuelist)
5981da177e4SLinus Torvalds 
59910fbd36eSLinus Torvalds #define rq_data_dir(rq)		((int)((rq)->cmd_flags & 1))
6001da177e4SLinus Torvalds 
60149fd524fSJens Axboe /*
60249fd524fSJens Axboe  * Driver can handle struct request, if it either has an old style
60349fd524fSJens Axboe  * request_fn defined, or is blk-mq based.
60449fd524fSJens Axboe  */
60549fd524fSJens Axboe static inline bool queue_is_rq_based(struct request_queue *q)
60649fd524fSJens Axboe {
60749fd524fSJens Axboe 	return q->request_fn || q->mq_ops;
60849fd524fSJens Axboe }
60949fd524fSJens Axboe 
610e692cb66SMartin K. Petersen static inline unsigned int blk_queue_cluster(struct request_queue *q)
611e692cb66SMartin K. Petersen {
612e692cb66SMartin K. Petersen 	return q->limits.cluster;
613e692cb66SMartin K. Petersen }
614e692cb66SMartin K. Petersen 
6159e2585a8SJens Axboe /*
6161faa16d2SJens Axboe  * We regard a request as sync, if either a read or a sync write
6179e2585a8SJens Axboe  */
6181faa16d2SJens Axboe static inline bool rw_is_sync(unsigned int rw_flags)
6191faa16d2SJens Axboe {
6207b6d91daSChristoph Hellwig 	return !(rw_flags & REQ_WRITE) || (rw_flags & REQ_SYNC);
6211faa16d2SJens Axboe }
6221faa16d2SJens Axboe 
6231faa16d2SJens Axboe static inline bool rq_is_sync(struct request *rq)
6241faa16d2SJens Axboe {
6251faa16d2SJens Axboe 	return rw_is_sync(rq->cmd_flags);
6261faa16d2SJens Axboe }
6271faa16d2SJens Axboe 
6285b788ce3STejun Heo static inline bool blk_rl_full(struct request_list *rl, bool sync)
6291da177e4SLinus Torvalds {
6305b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6315b788ce3STejun Heo 
6325b788ce3STejun Heo 	return rl->flags & flag;
6331da177e4SLinus Torvalds }
6341da177e4SLinus Torvalds 
6355b788ce3STejun Heo static inline void blk_set_rl_full(struct request_list *rl, bool sync)
6361da177e4SLinus Torvalds {
6375b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6385b788ce3STejun Heo 
6395b788ce3STejun Heo 	rl->flags |= flag;
6401da177e4SLinus Torvalds }
6411da177e4SLinus Torvalds 
6425b788ce3STejun Heo static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
6431da177e4SLinus Torvalds {
6445b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6455b788ce3STejun Heo 
6465b788ce3STejun Heo 	rl->flags &= ~flag;
6471da177e4SLinus Torvalds }
6481da177e4SLinus Torvalds 
649e2a60da7SMartin K. Petersen static inline bool rq_mergeable(struct request *rq)
650e2a60da7SMartin K. Petersen {
651e2a60da7SMartin K. Petersen 	if (rq->cmd_type != REQ_TYPE_FS)
652e2a60da7SMartin K. Petersen 		return false;
6531da177e4SLinus Torvalds 
654e2a60da7SMartin K. Petersen 	if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
655e2a60da7SMartin K. Petersen 		return false;
656e2a60da7SMartin K. Petersen 
657e2a60da7SMartin K. Petersen 	return true;
658e2a60da7SMartin K. Petersen }
6591da177e4SLinus Torvalds 
660f31dc1cdSMartin K. Petersen static inline bool blk_check_merge_flags(unsigned int flags1,
661f31dc1cdSMartin K. Petersen 					 unsigned int flags2)
662f31dc1cdSMartin K. Petersen {
663f31dc1cdSMartin K. Petersen 	if ((flags1 & REQ_DISCARD) != (flags2 & REQ_DISCARD))
664f31dc1cdSMartin K. Petersen 		return false;
665f31dc1cdSMartin K. Petersen 
666f31dc1cdSMartin K. Petersen 	if ((flags1 & REQ_SECURE) != (flags2 & REQ_SECURE))
667f31dc1cdSMartin K. Petersen 		return false;
668f31dc1cdSMartin K. Petersen 
6694363ac7cSMartin K. Petersen 	if ((flags1 & REQ_WRITE_SAME) != (flags2 & REQ_WRITE_SAME))
6704363ac7cSMartin K. Petersen 		return false;
6714363ac7cSMartin K. Petersen 
672f31dc1cdSMartin K. Petersen 	return true;
673f31dc1cdSMartin K. Petersen }
674f31dc1cdSMartin K. Petersen 
6754363ac7cSMartin K. Petersen static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
6764363ac7cSMartin K. Petersen {
6774363ac7cSMartin K. Petersen 	if (bio_data(a) == bio_data(b))
6784363ac7cSMartin K. Petersen 		return true;
6794363ac7cSMartin K. Petersen 
6804363ac7cSMartin K. Petersen 	return false;
6814363ac7cSMartin K. Petersen }
6824363ac7cSMartin K. Petersen 
6831da177e4SLinus Torvalds /*
6841da177e4SLinus Torvalds  * q->prep_rq_fn return values
6851da177e4SLinus Torvalds  */
6860fb5b1fbSMartin K. Petersen enum {
6870fb5b1fbSMartin K. Petersen 	BLKPREP_OK,		/* serve it */
6880fb5b1fbSMartin K. Petersen 	BLKPREP_KILL,		/* fatal error, kill, return -EIO */
6890fb5b1fbSMartin K. Petersen 	BLKPREP_DEFER,		/* leave on queue */
6900fb5b1fbSMartin K. Petersen 	BLKPREP_INVALID,	/* invalid command, kill, return -EREMOTEIO */
6910fb5b1fbSMartin K. Petersen };
6921da177e4SLinus Torvalds 
6931da177e4SLinus Torvalds extern unsigned long blk_max_low_pfn, blk_max_pfn;
6941da177e4SLinus Torvalds 
6951da177e4SLinus Torvalds /*
6961da177e4SLinus Torvalds  * standard bounce addresses:
6971da177e4SLinus Torvalds  *
6981da177e4SLinus Torvalds  * BLK_BOUNCE_HIGH	: bounce all highmem pages
6991da177e4SLinus Torvalds  * BLK_BOUNCE_ANY	: don't bounce anything
7001da177e4SLinus Torvalds  * BLK_BOUNCE_ISA	: bounce pages above ISA DMA boundary
7011da177e4SLinus Torvalds  */
7022472892aSAndi Kleen 
7032472892aSAndi Kleen #if BITS_PER_LONG == 32
7041da177e4SLinus Torvalds #define BLK_BOUNCE_HIGH		((u64)blk_max_low_pfn << PAGE_SHIFT)
7052472892aSAndi Kleen #else
7062472892aSAndi Kleen #define BLK_BOUNCE_HIGH		-1ULL
7072472892aSAndi Kleen #endif
7082472892aSAndi Kleen #define BLK_BOUNCE_ANY		(-1ULL)
709bfe17231SFUJITA Tomonori #define BLK_BOUNCE_ISA		(DMA_BIT_MASK(24))
7101da177e4SLinus Torvalds 
7113d6392cfSJens Axboe /*
7123d6392cfSJens Axboe  * default timeout for SG_IO if none specified
7133d6392cfSJens Axboe  */
7143d6392cfSJens Axboe #define BLK_DEFAULT_SG_TIMEOUT	(60 * HZ)
715f2f1fa78SLinus Torvalds #define BLK_MIN_SG_TIMEOUT	(7 * HZ)
7163d6392cfSJens Axboe 
7172a7326b5SChristoph Lameter #ifdef CONFIG_BOUNCE
7181da177e4SLinus Torvalds extern int init_emergency_isa_pool(void);
719165125e1SJens Axboe extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
7201da177e4SLinus Torvalds #else
7211da177e4SLinus Torvalds static inline int init_emergency_isa_pool(void)
7221da177e4SLinus Torvalds {
7231da177e4SLinus Torvalds 	return 0;
7241da177e4SLinus Torvalds }
725165125e1SJens Axboe static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
7261da177e4SLinus Torvalds {
7271da177e4SLinus Torvalds }
7281da177e4SLinus Torvalds #endif /* CONFIG_MMU */
7291da177e4SLinus Torvalds 
730152e283fSFUJITA Tomonori struct rq_map_data {
731152e283fSFUJITA Tomonori 	struct page **pages;
732152e283fSFUJITA Tomonori 	int page_order;
733152e283fSFUJITA Tomonori 	int nr_entries;
73456c451f4SFUJITA Tomonori 	unsigned long offset;
73597ae77a1SFUJITA Tomonori 	int null_mapped;
736ecb554a8SFUJITA Tomonori 	int from_user;
737152e283fSFUJITA Tomonori };
738152e283fSFUJITA Tomonori 
7395705f702SNeilBrown struct req_iterator {
7407988613bSKent Overstreet 	struct bvec_iter iter;
7415705f702SNeilBrown 	struct bio *bio;
7425705f702SNeilBrown };
7435705f702SNeilBrown 
7445705f702SNeilBrown /* This should not be used directly - use rq_for_each_segment */
7451e428079SJens Axboe #define for_each_bio(_bio)		\
7461e428079SJens Axboe 	for (; _bio; _bio = _bio->bi_next)
7475705f702SNeilBrown #define __rq_for_each_bio(_bio, rq)	\
7481da177e4SLinus Torvalds 	if ((rq->bio))			\
7491da177e4SLinus Torvalds 		for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
7501da177e4SLinus Torvalds 
7515705f702SNeilBrown #define rq_for_each_segment(bvl, _rq, _iter)			\
7525705f702SNeilBrown 	__rq_for_each_bio(_iter.bio, _rq)			\
7537988613bSKent Overstreet 		bio_for_each_segment(bvl, _iter.bio, _iter.iter)
7545705f702SNeilBrown 
7554550dd6cSKent Overstreet #define rq_iter_last(bvec, _iter)				\
7567988613bSKent Overstreet 		(_iter.bio->bi_next == NULL &&			\
7574550dd6cSKent Overstreet 		 bio_iter_last(bvec, _iter.iter))
7585705f702SNeilBrown 
7592d4dc890SIlya Loginov #ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
7602d4dc890SIlya Loginov # error	"You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
7612d4dc890SIlya Loginov #endif
7622d4dc890SIlya Loginov #if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
7632d4dc890SIlya Loginov extern void rq_flush_dcache_pages(struct request *rq);
7642d4dc890SIlya Loginov #else
7652d4dc890SIlya Loginov static inline void rq_flush_dcache_pages(struct request *rq)
7662d4dc890SIlya Loginov {
7672d4dc890SIlya Loginov }
7682d4dc890SIlya Loginov #endif
7692d4dc890SIlya Loginov 
7701da177e4SLinus Torvalds extern int blk_register_queue(struct gendisk *disk);
7711da177e4SLinus Torvalds extern void blk_unregister_queue(struct gendisk *disk);
772dece1635SJens Axboe extern blk_qc_t generic_make_request(struct bio *bio);
7732a4aa30cSFUJITA Tomonori extern void blk_rq_init(struct request_queue *q, struct request *rq);
7741da177e4SLinus Torvalds extern void blk_put_request(struct request *);
775165125e1SJens Axboe extern void __blk_put_request(struct request_queue *, struct request *);
776165125e1SJens Axboe extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
77779eb63e9SBoaz Harrosh extern struct request *blk_make_request(struct request_queue *, struct bio *,
77879eb63e9SBoaz Harrosh 					gfp_t);
779f27b087bSJens Axboe extern void blk_rq_set_block_pc(struct request *);
780165125e1SJens Axboe extern void blk_requeue_request(struct request_queue *, struct request *);
78166ac0280SChristoph Hellwig extern void blk_add_request_payload(struct request *rq, struct page *page,
78266ac0280SChristoph Hellwig 		unsigned int len);
783ef9e3facSKiyoshi Ueda extern int blk_lld_busy(struct request_queue *q);
78478d8e58aSMike Snitzer extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
78578d8e58aSMike Snitzer 			     struct bio_set *bs, gfp_t gfp_mask,
78678d8e58aSMike Snitzer 			     int (*bio_ctr)(struct bio *, struct bio *, void *),
78778d8e58aSMike Snitzer 			     void *data);
78878d8e58aSMike Snitzer extern void blk_rq_unprep_clone(struct request *rq);
78982124d60SKiyoshi Ueda extern int blk_insert_cloned_request(struct request_queue *q,
79082124d60SKiyoshi Ueda 				     struct request *rq);
7913cca6dc1SJens Axboe extern void blk_delay_queue(struct request_queue *, unsigned long);
79254efd50bSKent Overstreet extern void blk_queue_split(struct request_queue *, struct bio **,
79354efd50bSKent Overstreet 			    struct bio_set *);
794165125e1SJens Axboe extern void blk_recount_segments(struct request_queue *, struct bio *);
7950bfc96cbSPaolo Bonzini extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
796577ebb37SPaolo Bonzini extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
797577ebb37SPaolo Bonzini 			      unsigned int, void __user *);
79874f3c8afSAl Viro extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
79974f3c8afSAl Viro 			  unsigned int, void __user *);
800e915e872SAl Viro extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
801e915e872SAl Viro 			 struct scsi_ioctl_command __user *);
8023fcfab16SAndrew Morton 
8036f3b0e8bSChristoph Hellwig extern int blk_queue_enter(struct request_queue *q, bool nowait);
8042e6edc95SDan Williams extern void blk_queue_exit(struct request_queue *q);
805165125e1SJens Axboe extern void blk_start_queue(struct request_queue *q);
80621491412SJens Axboe extern void blk_start_queue_async(struct request_queue *q);
807165125e1SJens Axboe extern void blk_stop_queue(struct request_queue *q);
8081da177e4SLinus Torvalds extern void blk_sync_queue(struct request_queue *q);
809165125e1SJens Axboe extern void __blk_stop_queue(struct request_queue *q);
81024ecfbe2SChristoph Hellwig extern void __blk_run_queue(struct request_queue *q);
811a7928c15SChristoph Hellwig extern void __blk_run_queue_uncond(struct request_queue *q);
812165125e1SJens Axboe extern void blk_run_queue(struct request_queue *);
813c21e6bebSJens Axboe extern void blk_run_queue_async(struct request_queue *q);
814a3bce90eSFUJITA Tomonori extern int blk_rq_map_user(struct request_queue *, struct request *,
815152e283fSFUJITA Tomonori 			   struct rq_map_data *, void __user *, unsigned long,
816152e283fSFUJITA Tomonori 			   gfp_t);
8178e5cfc45SJens Axboe extern int blk_rq_unmap_user(struct bio *);
818165125e1SJens Axboe extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
819165125e1SJens Axboe extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
82026e49cfcSKent Overstreet 			       struct rq_map_data *, const struct iov_iter *,
82126e49cfcSKent Overstreet 			       gfp_t);
822165125e1SJens Axboe extern int blk_execute_rq(struct request_queue *, struct gendisk *,
823994ca9a1SJames Bottomley  			  struct request *, int);
824165125e1SJens Axboe extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
82515fc858aSJens Axboe 				  struct request *, int, rq_end_io_fn *);
8266e39b69eSMike Christie 
82705229beeSJens Axboe bool blk_poll(struct request_queue *q, blk_qc_t cookie);
82805229beeSJens Axboe 
829165125e1SJens Axboe static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
8301da177e4SLinus Torvalds {
831ff9ea323STejun Heo 	return bdev->bd_disk->queue;	/* this is never NULL */
8321da177e4SLinus Torvalds }
8331da177e4SLinus Torvalds 
8341da177e4SLinus Torvalds /*
8355b93629bSTejun Heo  * blk_rq_pos()			: the current sector
8365b93629bSTejun Heo  * blk_rq_bytes()		: bytes left in the entire request
8375b93629bSTejun Heo  * blk_rq_cur_bytes()		: bytes left in the current segment
83880a761fdSTejun Heo  * blk_rq_err_bytes()		: bytes left till the next error boundary
8395b93629bSTejun Heo  * blk_rq_sectors()		: sectors left in the entire request
8405b93629bSTejun Heo  * blk_rq_cur_sectors()		: sectors left in the current segment
8415efccd17STejun Heo  */
8425b93629bSTejun Heo static inline sector_t blk_rq_pos(const struct request *rq)
8435b93629bSTejun Heo {
844a2dec7b3STejun Heo 	return rq->__sector;
8455b93629bSTejun Heo }
8465b93629bSTejun Heo 
8472e46e8b2STejun Heo static inline unsigned int blk_rq_bytes(const struct request *rq)
8482e46e8b2STejun Heo {
849a2dec7b3STejun Heo 	return rq->__data_len;
8502e46e8b2STejun Heo }
8512e46e8b2STejun Heo 
8522e46e8b2STejun Heo static inline int blk_rq_cur_bytes(const struct request *rq)
8532e46e8b2STejun Heo {
8542e46e8b2STejun Heo 	return rq->bio ? bio_cur_bytes(rq->bio) : 0;
8552e46e8b2STejun Heo }
8565efccd17STejun Heo 
85780a761fdSTejun Heo extern unsigned int blk_rq_err_bytes(const struct request *rq);
85880a761fdSTejun Heo 
8595b93629bSTejun Heo static inline unsigned int blk_rq_sectors(const struct request *rq)
8605b93629bSTejun Heo {
8612e46e8b2STejun Heo 	return blk_rq_bytes(rq) >> 9;
8625b93629bSTejun Heo }
8635b93629bSTejun Heo 
8645b93629bSTejun Heo static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
8655b93629bSTejun Heo {
8662e46e8b2STejun Heo 	return blk_rq_cur_bytes(rq) >> 9;
8675b93629bSTejun Heo }
8685b93629bSTejun Heo 
869f31dc1cdSMartin K. Petersen static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
870f31dc1cdSMartin K. Petersen 						     unsigned int cmd_flags)
871f31dc1cdSMartin K. Petersen {
872f31dc1cdSMartin K. Petersen 	if (unlikely(cmd_flags & REQ_DISCARD))
873871dd928SJames Bottomley 		return min(q->limits.max_discard_sectors, UINT_MAX >> 9);
874f31dc1cdSMartin K. Petersen 
8754363ac7cSMartin K. Petersen 	if (unlikely(cmd_flags & REQ_WRITE_SAME))
8764363ac7cSMartin K. Petersen 		return q->limits.max_write_same_sectors;
8774363ac7cSMartin K. Petersen 
878f31dc1cdSMartin K. Petersen 	return q->limits.max_sectors;
879f31dc1cdSMartin K. Petersen }
880f31dc1cdSMartin K. Petersen 
881762380adSJens Axboe /*
882762380adSJens Axboe  * Return maximum size of a request at given offset. Only valid for
883762380adSJens Axboe  * file system requests.
884762380adSJens Axboe  */
885762380adSJens Axboe static inline unsigned int blk_max_size_offset(struct request_queue *q,
886762380adSJens Axboe 					       sector_t offset)
887762380adSJens Axboe {
888762380adSJens Axboe 	if (!q->limits.chunk_sectors)
889736ed4deSJens Axboe 		return q->limits.max_sectors;
890762380adSJens Axboe 
891762380adSJens Axboe 	return q->limits.chunk_sectors -
892762380adSJens Axboe 			(offset & (q->limits.chunk_sectors - 1));
893762380adSJens Axboe }
894762380adSJens Axboe 
895f31dc1cdSMartin K. Petersen static inline unsigned int blk_rq_get_max_sectors(struct request *rq)
896f31dc1cdSMartin K. Petersen {
897f31dc1cdSMartin K. Petersen 	struct request_queue *q = rq->q;
898f31dc1cdSMartin K. Petersen 
899f2101842SChristoph Hellwig 	if (unlikely(rq->cmd_type != REQ_TYPE_FS))
900f31dc1cdSMartin K. Petersen 		return q->limits.max_hw_sectors;
901f31dc1cdSMartin K. Petersen 
902e548ca4eSJens Axboe 	if (!q->limits.chunk_sectors || (rq->cmd_flags & REQ_DISCARD))
903f31dc1cdSMartin K. Petersen 		return blk_queue_get_max_sectors(q, rq->cmd_flags);
904762380adSJens Axboe 
905762380adSJens Axboe 	return min(blk_max_size_offset(q, blk_rq_pos(rq)),
906762380adSJens Axboe 			blk_queue_get_max_sectors(q, rq->cmd_flags));
907f31dc1cdSMartin K. Petersen }
908f31dc1cdSMartin K. Petersen 
90975afb352SJun'ichi Nomura static inline unsigned int blk_rq_count_bios(struct request *rq)
91075afb352SJun'ichi Nomura {
91175afb352SJun'ichi Nomura 	unsigned int nr_bios = 0;
91275afb352SJun'ichi Nomura 	struct bio *bio;
91375afb352SJun'ichi Nomura 
91475afb352SJun'ichi Nomura 	__rq_for_each_bio(bio, rq)
91575afb352SJun'ichi Nomura 		nr_bios++;
91675afb352SJun'ichi Nomura 
91775afb352SJun'ichi Nomura 	return nr_bios;
91875afb352SJun'ichi Nomura }
91975afb352SJun'ichi Nomura 
9205efccd17STejun Heo /*
9219934c8c0STejun Heo  * Request issue related functions.
9229934c8c0STejun Heo  */
9239934c8c0STejun Heo extern struct request *blk_peek_request(struct request_queue *q);
9249934c8c0STejun Heo extern void blk_start_request(struct request *rq);
9259934c8c0STejun Heo extern struct request *blk_fetch_request(struct request_queue *q);
9269934c8c0STejun Heo 
9279934c8c0STejun Heo /*
9282e60e022STejun Heo  * Request completion related functions.
9292e60e022STejun Heo  *
9302e60e022STejun Heo  * blk_update_request() completes given number of bytes and updates
9312e60e022STejun Heo  * the request without completing it.
9322e60e022STejun Heo  *
933f06d9a2bSTejun Heo  * blk_end_request() and friends.  __blk_end_request() must be called
934f06d9a2bSTejun Heo  * with the request queue spinlock acquired.
9351da177e4SLinus Torvalds  *
9361da177e4SLinus Torvalds  * Several drivers define their own end_request and call
9373bcddeacSKiyoshi Ueda  * blk_end_request() for parts of the original function.
9383bcddeacSKiyoshi Ueda  * This prevents code duplication in drivers.
9391da177e4SLinus Torvalds  */
9402e60e022STejun Heo extern bool blk_update_request(struct request *rq, int error,
94122b13210SJens Axboe 			       unsigned int nr_bytes);
94212120077SChristoph Hellwig extern void blk_finish_request(struct request *rq, int error);
943b1f74493SFUJITA Tomonori extern bool blk_end_request(struct request *rq, int error,
944b1f74493SFUJITA Tomonori 			    unsigned int nr_bytes);
945b1f74493SFUJITA Tomonori extern void blk_end_request_all(struct request *rq, int error);
946b1f74493SFUJITA Tomonori extern bool blk_end_request_cur(struct request *rq, int error);
94780a761fdSTejun Heo extern bool blk_end_request_err(struct request *rq, int error);
948b1f74493SFUJITA Tomonori extern bool __blk_end_request(struct request *rq, int error,
949b1f74493SFUJITA Tomonori 			      unsigned int nr_bytes);
950b1f74493SFUJITA Tomonori extern void __blk_end_request_all(struct request *rq, int error);
951b1f74493SFUJITA Tomonori extern bool __blk_end_request_cur(struct request *rq, int error);
95280a761fdSTejun Heo extern bool __blk_end_request_err(struct request *rq, int error);
9532e60e022STejun Heo 
954ff856badSJens Axboe extern void blk_complete_request(struct request *);
955242f9dcbSJens Axboe extern void __blk_complete_request(struct request *);
956242f9dcbSJens Axboe extern void blk_abort_request(struct request *);
95728018c24SJames Bottomley extern void blk_unprep_request(struct request *);
958ff856badSJens Axboe 
9591da177e4SLinus Torvalds /*
9601da177e4SLinus Torvalds  * Access functions for manipulating queue properties
9611da177e4SLinus Torvalds  */
962165125e1SJens Axboe extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
9631946089aSChristoph Lameter 					spinlock_t *lock, int node_id);
964165125e1SJens Axboe extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
96501effb0dSMike Snitzer extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
96601effb0dSMike Snitzer 						      request_fn_proc *, spinlock_t *);
967165125e1SJens Axboe extern void blk_cleanup_queue(struct request_queue *);
968165125e1SJens Axboe extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
969165125e1SJens Axboe extern void blk_queue_bounce_limit(struct request_queue *, u64);
970086fa5ffSMartin K. Petersen extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
971762380adSJens Axboe extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
9728a78362cSMartin K. Petersen extern void blk_queue_max_segments(struct request_queue *, unsigned short);
973165125e1SJens Axboe extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
97467efc925SChristoph Hellwig extern void blk_queue_max_discard_sectors(struct request_queue *q,
97567efc925SChristoph Hellwig 		unsigned int max_discard_sectors);
9764363ac7cSMartin K. Petersen extern void blk_queue_max_write_same_sectors(struct request_queue *q,
9774363ac7cSMartin K. Petersen 		unsigned int max_write_same_sectors);
978e1defc4fSMartin K. Petersen extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
979892b6f90SMartin K. Petersen extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
980c72758f3SMartin K. Petersen extern void blk_queue_alignment_offset(struct request_queue *q,
981c72758f3SMartin K. Petersen 				       unsigned int alignment);
9827c958e32SMartin K. Petersen extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
983c72758f3SMartin K. Petersen extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
9843c5820c7SMartin K. Petersen extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
985c72758f3SMartin K. Petersen extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
986e475bba2SMartin K. Petersen extern void blk_set_default_limits(struct queue_limits *lim);
987b1bd055dSMartin K. Petersen extern void blk_set_stacking_limits(struct queue_limits *lim);
988c72758f3SMartin K. Petersen extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
989c72758f3SMartin K. Petersen 			    sector_t offset);
99017be8c24SMartin K. Petersen extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
99117be8c24SMartin K. Petersen 			    sector_t offset);
992c72758f3SMartin K. Petersen extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
993c72758f3SMartin K. Petersen 			      sector_t offset);
994165125e1SJens Axboe extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
995e3790c7dSTejun Heo extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
99627f8221aSFUJITA Tomonori extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
9972fb98e84STejun Heo extern int blk_queue_dma_drain(struct request_queue *q,
9982fb98e84STejun Heo 			       dma_drain_needed_fn *dma_drain_needed,
9992fb98e84STejun Heo 			       void *buf, unsigned int size);
1000ef9e3facSKiyoshi Ueda extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
1001165125e1SJens Axboe extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
100203100aadSKeith Busch extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
1003165125e1SJens Axboe extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
100428018c24SJames Bottomley extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
1005165125e1SJens Axboe extern void blk_queue_dma_alignment(struct request_queue *, int);
100611c3e689SJames Bottomley extern void blk_queue_update_dma_alignment(struct request_queue *, int);
1007165125e1SJens Axboe extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
1008242f9dcbSJens Axboe extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
1009242f9dcbSJens Axboe extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
10104913efe4STejun Heo extern void blk_queue_flush(struct request_queue *q, unsigned int flush);
1011f3876930S[email protected] extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
10121da177e4SLinus Torvalds extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
10131da177e4SLinus Torvalds 
1014165125e1SJens Axboe extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
10151da177e4SLinus Torvalds extern void blk_dump_rq_flags(struct request *, char *);
10161da177e4SLinus Torvalds extern long nr_blockdev_pages(void);
10171da177e4SLinus Torvalds 
101809ac46c4STejun Heo bool __must_check blk_get_queue(struct request_queue *);
1019165125e1SJens Axboe struct request_queue *blk_alloc_queue(gfp_t);
1020165125e1SJens Axboe struct request_queue *blk_alloc_queue_node(gfp_t, int);
1021165125e1SJens Axboe extern void blk_put_queue(struct request_queue *);
10223f21c265SJens Axboe extern void blk_set_queue_dying(struct request_queue *);
10231da177e4SLinus Torvalds 
1024316cc67dSShaohua Li /*
10256c954667SLin Ming  * block layer runtime pm functions
10266c954667SLin Ming  */
102747fafbc7SRafael J. Wysocki #ifdef CONFIG_PM
10286c954667SLin Ming extern void blk_pm_runtime_init(struct request_queue *q, struct device *dev);
10296c954667SLin Ming extern int blk_pre_runtime_suspend(struct request_queue *q);
10306c954667SLin Ming extern void blk_post_runtime_suspend(struct request_queue *q, int err);
10316c954667SLin Ming extern void blk_pre_runtime_resume(struct request_queue *q);
10326c954667SLin Ming extern void blk_post_runtime_resume(struct request_queue *q, int err);
1033d07ab6d1SMika Westerberg extern void blk_set_runtime_active(struct request_queue *q);
10346c954667SLin Ming #else
10356c954667SLin Ming static inline void blk_pm_runtime_init(struct request_queue *q,
10366c954667SLin Ming 	struct device *dev) {}
10376c954667SLin Ming static inline int blk_pre_runtime_suspend(struct request_queue *q)
10386c954667SLin Ming {
10396c954667SLin Ming 	return -ENOSYS;
10406c954667SLin Ming }
10416c954667SLin Ming static inline void blk_post_runtime_suspend(struct request_queue *q, int err) {}
10426c954667SLin Ming static inline void blk_pre_runtime_resume(struct request_queue *q) {}
10436c954667SLin Ming static inline void blk_post_runtime_resume(struct request_queue *q, int err) {}
1044d07ab6d1SMika Westerberg extern inline void blk_set_runtime_active(struct request_queue *q) {}
10456c954667SLin Ming #endif
10466c954667SLin Ming 
10476c954667SLin Ming /*
104875df7136SSuresh Jayaraman  * blk_plug permits building a queue of related requests by holding the I/O
104975df7136SSuresh Jayaraman  * fragments for a short period. This allows merging of sequential requests
105075df7136SSuresh Jayaraman  * into single larger request. As the requests are moved from a per-task list to
105175df7136SSuresh Jayaraman  * the device's request_queue in a batch, this results in improved scalability
105275df7136SSuresh Jayaraman  * as the lock contention for request_queue lock is reduced.
105375df7136SSuresh Jayaraman  *
105475df7136SSuresh Jayaraman  * It is ok not to disable preemption when adding the request to the plug list
105575df7136SSuresh Jayaraman  * or when attempting a merge, because blk_schedule_flush_list() will only flush
105675df7136SSuresh Jayaraman  * the plug list when the task sleeps by itself. For details, please see
105775df7136SSuresh Jayaraman  * schedule() where blk_schedule_flush_plug() is called.
1058316cc67dSShaohua Li  */
105973c10101SJens Axboe struct blk_plug {
106075df7136SSuresh Jayaraman 	struct list_head list; /* requests */
1061320ae51fSJens Axboe 	struct list_head mq_list; /* blk-mq requests */
106275df7136SSuresh Jayaraman 	struct list_head cb_list; /* md requires an unplug callback */
106373c10101SJens Axboe };
106455c022bbSShaohua Li #define BLK_MAX_REQUEST_COUNT 16
106555c022bbSShaohua Li 
10669cbb1750SNeilBrown struct blk_plug_cb;
106774018dc3SNeilBrown typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
1068048c9374SNeilBrown struct blk_plug_cb {
1069048c9374SNeilBrown 	struct list_head list;
10709cbb1750SNeilBrown 	blk_plug_cb_fn callback;
10719cbb1750SNeilBrown 	void *data;
1072048c9374SNeilBrown };
10739cbb1750SNeilBrown extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
10749cbb1750SNeilBrown 					     void *data, int size);
107573c10101SJens Axboe extern void blk_start_plug(struct blk_plug *);
107673c10101SJens Axboe extern void blk_finish_plug(struct blk_plug *);
1077f6603783SJens Axboe extern void blk_flush_plug_list(struct blk_plug *, bool);
107873c10101SJens Axboe 
107973c10101SJens Axboe static inline void blk_flush_plug(struct task_struct *tsk)
108073c10101SJens Axboe {
108173c10101SJens Axboe 	struct blk_plug *plug = tsk->plug;
108273c10101SJens Axboe 
108388b996cdSChristoph Hellwig 	if (plug)
1084a237c1c5SJens Axboe 		blk_flush_plug_list(plug, false);
1085a237c1c5SJens Axboe }
1086a237c1c5SJens Axboe 
1087a237c1c5SJens Axboe static inline void blk_schedule_flush_plug(struct task_struct *tsk)
1088a237c1c5SJens Axboe {
1089a237c1c5SJens Axboe 	struct blk_plug *plug = tsk->plug;
1090a237c1c5SJens Axboe 
1091a237c1c5SJens Axboe 	if (plug)
1092f6603783SJens Axboe 		blk_flush_plug_list(plug, true);
109373c10101SJens Axboe }
109473c10101SJens Axboe 
109573c10101SJens Axboe static inline bool blk_needs_flush_plug(struct task_struct *tsk)
109673c10101SJens Axboe {
109773c10101SJens Axboe 	struct blk_plug *plug = tsk->plug;
109873c10101SJens Axboe 
1099320ae51fSJens Axboe 	return plug &&
1100320ae51fSJens Axboe 		(!list_empty(&plug->list) ||
1101320ae51fSJens Axboe 		 !list_empty(&plug->mq_list) ||
1102320ae51fSJens Axboe 		 !list_empty(&plug->cb_list));
110373c10101SJens Axboe }
110473c10101SJens Axboe 
11051da177e4SLinus Torvalds /*
11061da177e4SLinus Torvalds  * tag stuff
11071da177e4SLinus Torvalds  */
1108165125e1SJens Axboe extern int blk_queue_start_tag(struct request_queue *, struct request *);
1109165125e1SJens Axboe extern struct request *blk_queue_find_tag(struct request_queue *, int);
1110165125e1SJens Axboe extern void blk_queue_end_tag(struct request_queue *, struct request *);
1111ee1b6f7aSShaohua Li extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *, int);
1112165125e1SJens Axboe extern void blk_queue_free_tags(struct request_queue *);
1113165125e1SJens Axboe extern int blk_queue_resize_tags(struct request_queue *, int);
1114165125e1SJens Axboe extern void blk_queue_invalidate_tags(struct request_queue *);
1115ee1b6f7aSShaohua Li extern struct blk_queue_tag *blk_init_tags(int, int);
1116492dfb48SJames Bottomley extern void blk_free_tags(struct blk_queue_tag *);
11171da177e4SLinus Torvalds 
1118f583f492SDavid C Somayajulu static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
1119f583f492SDavid C Somayajulu 						int tag)
1120f583f492SDavid C Somayajulu {
1121f583f492SDavid C Somayajulu 	if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
1122f583f492SDavid C Somayajulu 		return NULL;
1123f583f492SDavid C Somayajulu 	return bqt->tag_index[tag];
1124f583f492SDavid C Somayajulu }
1125dd3932edSChristoph Hellwig 
1126dd3932edSChristoph Hellwig #define BLKDEV_DISCARD_SECURE  0x01    /* secure discard */
1127dd3932edSChristoph Hellwig 
1128dd3932edSChristoph Hellwig extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
1129fbd9b09aSDmitry Monakhov extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1130fbd9b09aSDmitry Monakhov 		sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
11314363ac7cSMartin K. Petersen extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
11324363ac7cSMartin K. Petersen 		sector_t nr_sects, gfp_t gfp_mask, struct page *page);
11333f14d792SDmitry Monakhov extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1134d93ba7a5SMartin K. Petersen 		sector_t nr_sects, gfp_t gfp_mask, bool discard);
11352cf6d26aSChristoph Hellwig static inline int sb_issue_discard(struct super_block *sb, sector_t block,
11362cf6d26aSChristoph Hellwig 		sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
1137fb2dce86SDavid Woodhouse {
11382cf6d26aSChristoph Hellwig 	return blkdev_issue_discard(sb->s_bdev, block << (sb->s_blocksize_bits - 9),
11392cf6d26aSChristoph Hellwig 				    nr_blocks << (sb->s_blocksize_bits - 9),
11402cf6d26aSChristoph Hellwig 				    gfp_mask, flags);
1141fb2dce86SDavid Woodhouse }
1142e6fa0be6SLukas Czerner static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
1143a107e5a3STheodore Ts'o 		sector_t nr_blocks, gfp_t gfp_mask)
1144e6fa0be6SLukas Czerner {
1145e6fa0be6SLukas Czerner 	return blkdev_issue_zeroout(sb->s_bdev,
1146e6fa0be6SLukas Czerner 				    block << (sb->s_blocksize_bits - 9),
1147e6fa0be6SLukas Czerner 				    nr_blocks << (sb->s_blocksize_bits - 9),
1148d93ba7a5SMartin K. Petersen 				    gfp_mask, true);
1149e6fa0be6SLukas Czerner }
11501da177e4SLinus Torvalds 
1151018e0446SJens Axboe extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
11520b07de85SAdel Gadllah 
1153eb28d31bSMartin K. Petersen enum blk_default_limits {
1154eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENTS	= 128,
1155eb28d31bSMartin K. Petersen 	BLK_SAFE_MAX_SECTORS	= 255,
1156d2be537cSJeff Moyer 	BLK_DEF_MAX_SECTORS	= 2560,
1157eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENT_SIZE	= 65536,
1158eb28d31bSMartin K. Petersen 	BLK_SEG_BOUNDARY_MASK	= 0xFFFFFFFFUL,
1159eb28d31bSMartin K. Petersen };
11600e435ac2SMilan Broz 
11611da177e4SLinus Torvalds #define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
11621da177e4SLinus Torvalds 
1163ae03bf63SMartin K. Petersen static inline unsigned long queue_bounce_pfn(struct request_queue *q)
1164ae03bf63SMartin K. Petersen {
1165025146e1SMartin K. Petersen 	return q->limits.bounce_pfn;
1166ae03bf63SMartin K. Petersen }
1167ae03bf63SMartin K. Petersen 
1168ae03bf63SMartin K. Petersen static inline unsigned long queue_segment_boundary(struct request_queue *q)
1169ae03bf63SMartin K. Petersen {
1170025146e1SMartin K. Petersen 	return q->limits.seg_boundary_mask;
1171ae03bf63SMartin K. Petersen }
1172ae03bf63SMartin K. Petersen 
117303100aadSKeith Busch static inline unsigned long queue_virt_boundary(struct request_queue *q)
117403100aadSKeith Busch {
117503100aadSKeith Busch 	return q->limits.virt_boundary_mask;
117603100aadSKeith Busch }
117703100aadSKeith Busch 
1178ae03bf63SMartin K. Petersen static inline unsigned int queue_max_sectors(struct request_queue *q)
1179ae03bf63SMartin K. Petersen {
1180025146e1SMartin K. Petersen 	return q->limits.max_sectors;
1181ae03bf63SMartin K. Petersen }
1182ae03bf63SMartin K. Petersen 
1183ae03bf63SMartin K. Petersen static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1184ae03bf63SMartin K. Petersen {
1185025146e1SMartin K. Petersen 	return q->limits.max_hw_sectors;
1186ae03bf63SMartin K. Petersen }
1187ae03bf63SMartin K. Petersen 
11888a78362cSMartin K. Petersen static inline unsigned short queue_max_segments(struct request_queue *q)
1189ae03bf63SMartin K. Petersen {
11908a78362cSMartin K. Petersen 	return q->limits.max_segments;
1191ae03bf63SMartin K. Petersen }
1192ae03bf63SMartin K. Petersen 
1193ae03bf63SMartin K. Petersen static inline unsigned int queue_max_segment_size(struct request_queue *q)
1194ae03bf63SMartin K. Petersen {
1195025146e1SMartin K. Petersen 	return q->limits.max_segment_size;
1196ae03bf63SMartin K. Petersen }
1197ae03bf63SMartin K. Petersen 
1198e1defc4fSMartin K. Petersen static inline unsigned short queue_logical_block_size(struct request_queue *q)
11991da177e4SLinus Torvalds {
12001da177e4SLinus Torvalds 	int retval = 512;
12011da177e4SLinus Torvalds 
1202025146e1SMartin K. Petersen 	if (q && q->limits.logical_block_size)
1203025146e1SMartin K. Petersen 		retval = q->limits.logical_block_size;
12041da177e4SLinus Torvalds 
12051da177e4SLinus Torvalds 	return retval;
12061da177e4SLinus Torvalds }
12071da177e4SLinus Torvalds 
1208e1defc4fSMartin K. Petersen static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
12091da177e4SLinus Torvalds {
1210e1defc4fSMartin K. Petersen 	return queue_logical_block_size(bdev_get_queue(bdev));
12111da177e4SLinus Torvalds }
12121da177e4SLinus Torvalds 
1213c72758f3SMartin K. Petersen static inline unsigned int queue_physical_block_size(struct request_queue *q)
1214c72758f3SMartin K. Petersen {
1215c72758f3SMartin K. Petersen 	return q->limits.physical_block_size;
1216c72758f3SMartin K. Petersen }
1217c72758f3SMartin K. Petersen 
1218892b6f90SMartin K. Petersen static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
1219ac481c20SMartin K. Petersen {
1220ac481c20SMartin K. Petersen 	return queue_physical_block_size(bdev_get_queue(bdev));
1221ac481c20SMartin K. Petersen }
1222ac481c20SMartin K. Petersen 
1223c72758f3SMartin K. Petersen static inline unsigned int queue_io_min(struct request_queue *q)
1224c72758f3SMartin K. Petersen {
1225c72758f3SMartin K. Petersen 	return q->limits.io_min;
1226c72758f3SMartin K. Petersen }
1227c72758f3SMartin K. Petersen 
1228ac481c20SMartin K. Petersen static inline int bdev_io_min(struct block_device *bdev)
1229ac481c20SMartin K. Petersen {
1230ac481c20SMartin K. Petersen 	return queue_io_min(bdev_get_queue(bdev));
1231ac481c20SMartin K. Petersen }
1232ac481c20SMartin K. Petersen 
1233c72758f3SMartin K. Petersen static inline unsigned int queue_io_opt(struct request_queue *q)
1234c72758f3SMartin K. Petersen {
1235c72758f3SMartin K. Petersen 	return q->limits.io_opt;
1236c72758f3SMartin K. Petersen }
1237c72758f3SMartin K. Petersen 
1238ac481c20SMartin K. Petersen static inline int bdev_io_opt(struct block_device *bdev)
1239ac481c20SMartin K. Petersen {
1240ac481c20SMartin K. Petersen 	return queue_io_opt(bdev_get_queue(bdev));
1241ac481c20SMartin K. Petersen }
1242ac481c20SMartin K. Petersen 
1243c72758f3SMartin K. Petersen static inline int queue_alignment_offset(struct request_queue *q)
1244c72758f3SMartin K. Petersen {
1245ac481c20SMartin K. Petersen 	if (q->limits.misaligned)
1246c72758f3SMartin K. Petersen 		return -1;
1247c72758f3SMartin K. Petersen 
1248c72758f3SMartin K. Petersen 	return q->limits.alignment_offset;
1249c72758f3SMartin K. Petersen }
1250c72758f3SMartin K. Petersen 
1251e03a72e1SMartin K. Petersen static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
125281744ee4SMartin K. Petersen {
125381744ee4SMartin K. Petersen 	unsigned int granularity = max(lim->physical_block_size, lim->io_min);
1254b8839b8cSMike Snitzer 	unsigned int alignment = sector_div(sector, granularity >> 9) << 9;
125581744ee4SMartin K. Petersen 
1256b8839b8cSMike Snitzer 	return (granularity + lim->alignment_offset - alignment) % granularity;
1257c72758f3SMartin K. Petersen }
1258c72758f3SMartin K. Petersen 
1259ac481c20SMartin K. Petersen static inline int bdev_alignment_offset(struct block_device *bdev)
1260ac481c20SMartin K. Petersen {
1261ac481c20SMartin K. Petersen 	struct request_queue *q = bdev_get_queue(bdev);
1262ac481c20SMartin K. Petersen 
1263ac481c20SMartin K. Petersen 	if (q->limits.misaligned)
1264ac481c20SMartin K. Petersen 		return -1;
1265ac481c20SMartin K. Petersen 
1266ac481c20SMartin K. Petersen 	if (bdev != bdev->bd_contains)
1267ac481c20SMartin K. Petersen 		return bdev->bd_part->alignment_offset;
1268ac481c20SMartin K. Petersen 
1269ac481c20SMartin K. Petersen 	return q->limits.alignment_offset;
1270ac481c20SMartin K. Petersen }
1271ac481c20SMartin K. Petersen 
127286b37281SMartin K. Petersen static inline int queue_discard_alignment(struct request_queue *q)
127386b37281SMartin K. Petersen {
127486b37281SMartin K. Petersen 	if (q->limits.discard_misaligned)
127586b37281SMartin K. Petersen 		return -1;
127686b37281SMartin K. Petersen 
127786b37281SMartin K. Petersen 	return q->limits.discard_alignment;
127886b37281SMartin K. Petersen }
127986b37281SMartin K. Petersen 
1280e03a72e1SMartin K. Petersen static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
128186b37281SMartin K. Petersen {
128259771079SLinus Torvalds 	unsigned int alignment, granularity, offset;
1283dd3d145dSMartin K. Petersen 
1284a934a00aSMartin K. Petersen 	if (!lim->max_discard_sectors)
1285a934a00aSMartin K. Petersen 		return 0;
1286a934a00aSMartin K. Petersen 
128759771079SLinus Torvalds 	/* Why are these in bytes, not sectors? */
128859771079SLinus Torvalds 	alignment = lim->discard_alignment >> 9;
128959771079SLinus Torvalds 	granularity = lim->discard_granularity >> 9;
129059771079SLinus Torvalds 	if (!granularity)
129159771079SLinus Torvalds 		return 0;
129259771079SLinus Torvalds 
129359771079SLinus Torvalds 	/* Offset of the partition start in 'granularity' sectors */
129459771079SLinus Torvalds 	offset = sector_div(sector, granularity);
129559771079SLinus Torvalds 
129659771079SLinus Torvalds 	/* And why do we do this modulus *again* in blkdev_issue_discard()? */
129759771079SLinus Torvalds 	offset = (granularity + alignment - offset) % granularity;
129859771079SLinus Torvalds 
129959771079SLinus Torvalds 	/* Turn it back into bytes, gaah */
130059771079SLinus Torvalds 	return offset << 9;
130186b37281SMartin K. Petersen }
130286b37281SMartin K. Petersen 
1303c6e66634SPaolo Bonzini static inline int bdev_discard_alignment(struct block_device *bdev)
1304c6e66634SPaolo Bonzini {
1305c6e66634SPaolo Bonzini 	struct request_queue *q = bdev_get_queue(bdev);
1306c6e66634SPaolo Bonzini 
1307c6e66634SPaolo Bonzini 	if (bdev != bdev->bd_contains)
1308c6e66634SPaolo Bonzini 		return bdev->bd_part->discard_alignment;
1309c6e66634SPaolo Bonzini 
1310c6e66634SPaolo Bonzini 	return q->limits.discard_alignment;
1311c6e66634SPaolo Bonzini }
1312c6e66634SPaolo Bonzini 
131398262f27SMartin K. Petersen static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
131498262f27SMartin K. Petersen {
1315a934a00aSMartin K. Petersen 	if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
131698262f27SMartin K. Petersen 		return 1;
131798262f27SMartin K. Petersen 
131898262f27SMartin K. Petersen 	return 0;
131998262f27SMartin K. Petersen }
132098262f27SMartin K. Petersen 
132198262f27SMartin K. Petersen static inline unsigned int bdev_discard_zeroes_data(struct block_device *bdev)
132298262f27SMartin K. Petersen {
132398262f27SMartin K. Petersen 	return queue_discard_zeroes_data(bdev_get_queue(bdev));
132498262f27SMartin K. Petersen }
132598262f27SMartin K. Petersen 
13264363ac7cSMartin K. Petersen static inline unsigned int bdev_write_same(struct block_device *bdev)
13274363ac7cSMartin K. Petersen {
13284363ac7cSMartin K. Petersen 	struct request_queue *q = bdev_get_queue(bdev);
13294363ac7cSMartin K. Petersen 
13304363ac7cSMartin K. Petersen 	if (q)
13314363ac7cSMartin K. Petersen 		return q->limits.max_write_same_sectors;
13324363ac7cSMartin K. Petersen 
13334363ac7cSMartin K. Petersen 	return 0;
13344363ac7cSMartin K. Petersen }
13354363ac7cSMartin K. Petersen 
1336165125e1SJens Axboe static inline int queue_dma_alignment(struct request_queue *q)
13371da177e4SLinus Torvalds {
1338482eb689SPete Wyckoff 	return q ? q->dma_alignment : 511;
13391da177e4SLinus Torvalds }
13401da177e4SLinus Torvalds 
134114417799SNamhyung Kim static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
134287904074SFUJITA Tomonori 				 unsigned int len)
134387904074SFUJITA Tomonori {
134487904074SFUJITA Tomonori 	unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
134514417799SNamhyung Kim 	return !(addr & alignment) && !(len & alignment);
134687904074SFUJITA Tomonori }
134787904074SFUJITA Tomonori 
13481da177e4SLinus Torvalds /* assumes size > 256 */
13491da177e4SLinus Torvalds static inline unsigned int blksize_bits(unsigned int size)
13501da177e4SLinus Torvalds {
13511da177e4SLinus Torvalds 	unsigned int bits = 8;
13521da177e4SLinus Torvalds 	do {
13531da177e4SLinus Torvalds 		bits++;
13541da177e4SLinus Torvalds 		size >>= 1;
13551da177e4SLinus Torvalds 	} while (size > 256);
13561da177e4SLinus Torvalds 	return bits;
13571da177e4SLinus Torvalds }
13581da177e4SLinus Torvalds 
13592befb9e3SAdrian Bunk static inline unsigned int block_size(struct block_device *bdev)
13601da177e4SLinus Torvalds {
13611da177e4SLinus Torvalds 	return bdev->bd_block_size;
13621da177e4SLinus Torvalds }
13631da177e4SLinus Torvalds 
1364f3876930S[email protected] static inline bool queue_flush_queueable(struct request_queue *q)
1365f3876930S[email protected] {
1366f3876930S[email protected] 	return !q->flush_not_queueable;
1367f3876930S[email protected] }
1368f3876930S[email protected] 
13691da177e4SLinus Torvalds typedef struct {struct page *v;} Sector;
13701da177e4SLinus Torvalds 
13711da177e4SLinus Torvalds unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
13721da177e4SLinus Torvalds 
13731da177e4SLinus Torvalds static inline void put_dev_sector(Sector p)
13741da177e4SLinus Torvalds {
1375*09cbfeafSKirill A. Shutemov 	put_page(p.v);
13761da177e4SLinus Torvalds }
13771da177e4SLinus Torvalds 
1378e0af2917SMing Lei static inline bool __bvec_gap_to_prev(struct request_queue *q,
1379e0af2917SMing Lei 				struct bio_vec *bprv, unsigned int offset)
1380e0af2917SMing Lei {
1381e0af2917SMing Lei 	return offset ||
1382e0af2917SMing Lei 		((bprv->bv_offset + bprv->bv_len) & queue_virt_boundary(q));
1383e0af2917SMing Lei }
1384e0af2917SMing Lei 
138503100aadSKeith Busch /*
138603100aadSKeith Busch  * Check if adding a bio_vec after bprv with offset would create a gap in
138703100aadSKeith Busch  * the SG list. Most drivers don't care about this, but some do.
138803100aadSKeith Busch  */
138903100aadSKeith Busch static inline bool bvec_gap_to_prev(struct request_queue *q,
139003100aadSKeith Busch 				struct bio_vec *bprv, unsigned int offset)
139103100aadSKeith Busch {
139203100aadSKeith Busch 	if (!queue_virt_boundary(q))
139303100aadSKeith Busch 		return false;
1394e0af2917SMing Lei 	return __bvec_gap_to_prev(q, bprv, offset);
139503100aadSKeith Busch }
139603100aadSKeith Busch 
13975e7c4274SJens Axboe static inline bool bio_will_gap(struct request_queue *q, struct bio *prev,
13985e7c4274SJens Axboe 			 struct bio *next)
13995e7c4274SJens Axboe {
140025e71a99SMing Lei 	if (bio_has_data(prev) && queue_virt_boundary(q)) {
140125e71a99SMing Lei 		struct bio_vec pb, nb;
14025e7c4274SJens Axboe 
140325e71a99SMing Lei 		bio_get_last_bvec(prev, &pb);
140425e71a99SMing Lei 		bio_get_first_bvec(next, &nb);
140525e71a99SMing Lei 
140625e71a99SMing Lei 		return __bvec_gap_to_prev(q, &pb, nb.bv_offset);
140725e71a99SMing Lei 	}
140825e71a99SMing Lei 
140925e71a99SMing Lei 	return false;
14105e7c4274SJens Axboe }
14115e7c4274SJens Axboe 
14125e7c4274SJens Axboe static inline bool req_gap_back_merge(struct request *req, struct bio *bio)
14135e7c4274SJens Axboe {
14145e7c4274SJens Axboe 	return bio_will_gap(req->q, req->biotail, bio);
14155e7c4274SJens Axboe }
14165e7c4274SJens Axboe 
14175e7c4274SJens Axboe static inline bool req_gap_front_merge(struct request *req, struct bio *bio)
14185e7c4274SJens Axboe {
14195e7c4274SJens Axboe 	return bio_will_gap(req->q, bio, req->bio);
14205e7c4274SJens Axboe }
14215e7c4274SJens Axboe 
14221da177e4SLinus Torvalds struct work_struct;
142359c3d45eSJens Axboe int kblockd_schedule_work(struct work_struct *work);
142459c3d45eSJens Axboe int kblockd_schedule_delayed_work(struct delayed_work *dwork, unsigned long delay);
14258ab14595SJens Axboe int kblockd_schedule_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
14261da177e4SLinus Torvalds 
14279195291eSDivyesh Shah #ifdef CONFIG_BLK_CGROUP
142828f4197eSJens Axboe /*
142928f4197eSJens Axboe  * This should not be using sched_clock(). A real patch is in progress
143028f4197eSJens Axboe  * to fix this up, until that is in place we need to disable preemption
143128f4197eSJens Axboe  * around sched_clock() in this function and set_io_start_time_ns().
143228f4197eSJens Axboe  */
14339195291eSDivyesh Shah static inline void set_start_time_ns(struct request *req)
14349195291eSDivyesh Shah {
143528f4197eSJens Axboe 	preempt_disable();
14369195291eSDivyesh Shah 	req->start_time_ns = sched_clock();
143728f4197eSJens Axboe 	preempt_enable();
14389195291eSDivyesh Shah }
14399195291eSDivyesh Shah 
14409195291eSDivyesh Shah static inline void set_io_start_time_ns(struct request *req)
14419195291eSDivyesh Shah {
144228f4197eSJens Axboe 	preempt_disable();
14439195291eSDivyesh Shah 	req->io_start_time_ns = sched_clock();
144428f4197eSJens Axboe 	preempt_enable();
14459195291eSDivyesh Shah }
144684c124daSDivyesh Shah 
144784c124daSDivyesh Shah static inline uint64_t rq_start_time_ns(struct request *req)
144884c124daSDivyesh Shah {
144984c124daSDivyesh Shah         return req->start_time_ns;
145084c124daSDivyesh Shah }
145184c124daSDivyesh Shah 
145284c124daSDivyesh Shah static inline uint64_t rq_io_start_time_ns(struct request *req)
145384c124daSDivyesh Shah {
145484c124daSDivyesh Shah         return req->io_start_time_ns;
145584c124daSDivyesh Shah }
14569195291eSDivyesh Shah #else
14579195291eSDivyesh Shah static inline void set_start_time_ns(struct request *req) {}
14589195291eSDivyesh Shah static inline void set_io_start_time_ns(struct request *req) {}
145984c124daSDivyesh Shah static inline uint64_t rq_start_time_ns(struct request *req)
146084c124daSDivyesh Shah {
146184c124daSDivyesh Shah 	return 0;
146284c124daSDivyesh Shah }
146384c124daSDivyesh Shah static inline uint64_t rq_io_start_time_ns(struct request *req)
146484c124daSDivyesh Shah {
146584c124daSDivyesh Shah 	return 0;
146684c124daSDivyesh Shah }
14679195291eSDivyesh Shah #endif
14689195291eSDivyesh Shah 
14691da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV(major,minor) \
14701da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
14711da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
14721da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-*")
14731da177e4SLinus Torvalds 
14747ba1ba12SMartin K. Petersen #if defined(CONFIG_BLK_DEV_INTEGRITY)
14757ba1ba12SMartin K. Petersen 
14768288f496SMartin K. Petersen enum blk_integrity_flags {
14778288f496SMartin K. Petersen 	BLK_INTEGRITY_VERIFY		= 1 << 0,
14788288f496SMartin K. Petersen 	BLK_INTEGRITY_GENERATE		= 1 << 1,
14793aec2f41SMartin K. Petersen 	BLK_INTEGRITY_DEVICE_CAPABLE	= 1 << 2,
1480aae7df50SMartin K. Petersen 	BLK_INTEGRITY_IP_CHECKSUM	= 1 << 3,
14818288f496SMartin K. Petersen };
14827ba1ba12SMartin K. Petersen 
148318593088SMartin K. Petersen struct blk_integrity_iter {
14847ba1ba12SMartin K. Petersen 	void			*prot_buf;
14857ba1ba12SMartin K. Petersen 	void			*data_buf;
14863be91c4aSMartin K. Petersen 	sector_t		seed;
14877ba1ba12SMartin K. Petersen 	unsigned int		data_size;
14883be91c4aSMartin K. Petersen 	unsigned short		interval;
14897ba1ba12SMartin K. Petersen 	const char		*disk_name;
14907ba1ba12SMartin K. Petersen };
14917ba1ba12SMartin K. Petersen 
149218593088SMartin K. Petersen typedef int (integrity_processing_fn) (struct blk_integrity_iter *);
14937ba1ba12SMartin K. Petersen 
14940f8087ecSMartin K. Petersen struct blk_integrity_profile {
149518593088SMartin K. Petersen 	integrity_processing_fn		*generate_fn;
149618593088SMartin K. Petersen 	integrity_processing_fn		*verify_fn;
14970f8087ecSMartin K. Petersen 	const char			*name;
14980f8087ecSMartin K. Petersen };
14997ba1ba12SMartin K. Petersen 
150025520d55SMartin K. Petersen extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
15017ba1ba12SMartin K. Petersen extern void blk_integrity_unregister(struct gendisk *);
1502ad7fce93SMartin K. Petersen extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
150313f05c8dSMartin K. Petersen extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
150413f05c8dSMartin K. Petersen 				   struct scatterlist *);
150513f05c8dSMartin K. Petersen extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
15064eaf99beSMartin K. Petersen extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
150713f05c8dSMartin K. Petersen 				   struct request *);
15084eaf99beSMartin K. Petersen extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
150913f05c8dSMartin K. Petersen 				    struct bio *);
15107ba1ba12SMartin K. Petersen 
151125520d55SMartin K. Petersen static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
151225520d55SMartin K. Petersen {
1513ac6fc48cSDan Williams 	struct blk_integrity *bi = &disk->queue->integrity;
151425520d55SMartin K. Petersen 
151525520d55SMartin K. Petersen 	if (!bi->profile)
151625520d55SMartin K. Petersen 		return NULL;
151725520d55SMartin K. Petersen 
151825520d55SMartin K. Petersen 	return bi;
151925520d55SMartin K. Petersen }
152025520d55SMartin K. Petersen 
1521b04accc4SJens Axboe static inline
1522b04accc4SJens Axboe struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1523b04accc4SJens Axboe {
152425520d55SMartin K. Petersen 	return blk_get_integrity(bdev->bd_disk);
1525b02739b0SMartin K. Petersen }
1526b02739b0SMartin K. Petersen 
1527180b2f95SMartin K. Petersen static inline bool blk_integrity_rq(struct request *rq)
15287ba1ba12SMartin K. Petersen {
1529180b2f95SMartin K. Petersen 	return rq->cmd_flags & REQ_INTEGRITY;
15307ba1ba12SMartin K. Petersen }
15317ba1ba12SMartin K. Petersen 
153213f05c8dSMartin K. Petersen static inline void blk_queue_max_integrity_segments(struct request_queue *q,
153313f05c8dSMartin K. Petersen 						    unsigned int segs)
153413f05c8dSMartin K. Petersen {
153513f05c8dSMartin K. Petersen 	q->limits.max_integrity_segments = segs;
153613f05c8dSMartin K. Petersen }
153713f05c8dSMartin K. Petersen 
153813f05c8dSMartin K. Petersen static inline unsigned short
153913f05c8dSMartin K. Petersen queue_max_integrity_segments(struct request_queue *q)
154013f05c8dSMartin K. Petersen {
154113f05c8dSMartin K. Petersen 	return q->limits.max_integrity_segments;
154213f05c8dSMartin K. Petersen }
154313f05c8dSMartin K. Petersen 
15447f39add3SSagi Grimberg static inline bool integrity_req_gap_back_merge(struct request *req,
15457f39add3SSagi Grimberg 						struct bio *next)
15467f39add3SSagi Grimberg {
15477f39add3SSagi Grimberg 	struct bio_integrity_payload *bip = bio_integrity(req->bio);
15487f39add3SSagi Grimberg 	struct bio_integrity_payload *bip_next = bio_integrity(next);
15497f39add3SSagi Grimberg 
15507f39add3SSagi Grimberg 	return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
15517f39add3SSagi Grimberg 				bip_next->bip_vec[0].bv_offset);
15527f39add3SSagi Grimberg }
15537f39add3SSagi Grimberg 
15547f39add3SSagi Grimberg static inline bool integrity_req_gap_front_merge(struct request *req,
15557f39add3SSagi Grimberg 						 struct bio *bio)
15567f39add3SSagi Grimberg {
15577f39add3SSagi Grimberg 	struct bio_integrity_payload *bip = bio_integrity(bio);
15587f39add3SSagi Grimberg 	struct bio_integrity_payload *bip_next = bio_integrity(req->bio);
15597f39add3SSagi Grimberg 
15607f39add3SSagi Grimberg 	return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
15617f39add3SSagi Grimberg 				bip_next->bip_vec[0].bv_offset);
15627f39add3SSagi Grimberg }
15637f39add3SSagi Grimberg 
15647ba1ba12SMartin K. Petersen #else /* CONFIG_BLK_DEV_INTEGRITY */
15657ba1ba12SMartin K. Petersen 
1566fd83240aSStephen Rothwell struct bio;
1567fd83240aSStephen Rothwell struct block_device;
1568fd83240aSStephen Rothwell struct gendisk;
1569fd83240aSStephen Rothwell struct blk_integrity;
1570fd83240aSStephen Rothwell 
1571fd83240aSStephen Rothwell static inline int blk_integrity_rq(struct request *rq)
1572fd83240aSStephen Rothwell {
1573fd83240aSStephen Rothwell 	return 0;
1574fd83240aSStephen Rothwell }
1575fd83240aSStephen Rothwell static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1576fd83240aSStephen Rothwell 					    struct bio *b)
1577fd83240aSStephen Rothwell {
1578fd83240aSStephen Rothwell 	return 0;
1579fd83240aSStephen Rothwell }
1580fd83240aSStephen Rothwell static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1581fd83240aSStephen Rothwell 					  struct bio *b,
1582fd83240aSStephen Rothwell 					  struct scatterlist *s)
1583fd83240aSStephen Rothwell {
1584fd83240aSStephen Rothwell 	return 0;
1585fd83240aSStephen Rothwell }
1586fd83240aSStephen Rothwell static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1587fd83240aSStephen Rothwell {
158861a04e5bSMichele Curti 	return NULL;
1589fd83240aSStephen Rothwell }
1590fd83240aSStephen Rothwell static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1591fd83240aSStephen Rothwell {
1592fd83240aSStephen Rothwell 	return NULL;
1593fd83240aSStephen Rothwell }
1594fd83240aSStephen Rothwell static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1595fd83240aSStephen Rothwell {
1596fd83240aSStephen Rothwell 	return 0;
1597fd83240aSStephen Rothwell }
159825520d55SMartin K. Petersen static inline void blk_integrity_register(struct gendisk *d,
1599fd83240aSStephen Rothwell 					 struct blk_integrity *b)
1600fd83240aSStephen Rothwell {
1601fd83240aSStephen Rothwell }
1602fd83240aSStephen Rothwell static inline void blk_integrity_unregister(struct gendisk *d)
1603fd83240aSStephen Rothwell {
1604fd83240aSStephen Rothwell }
1605fd83240aSStephen Rothwell static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1606fd83240aSStephen Rothwell 						    unsigned int segs)
1607fd83240aSStephen Rothwell {
1608fd83240aSStephen Rothwell }
1609fd83240aSStephen Rothwell static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1610fd83240aSStephen Rothwell {
1611fd83240aSStephen Rothwell 	return 0;
1612fd83240aSStephen Rothwell }
16134eaf99beSMartin K. Petersen static inline bool blk_integrity_merge_rq(struct request_queue *rq,
1614fd83240aSStephen Rothwell 					  struct request *r1,
1615fd83240aSStephen Rothwell 					  struct request *r2)
1616fd83240aSStephen Rothwell {
1617cb1a5ab6SMartin K. Petersen 	return true;
1618fd83240aSStephen Rothwell }
16194eaf99beSMartin K. Petersen static inline bool blk_integrity_merge_bio(struct request_queue *rq,
1620fd83240aSStephen Rothwell 					   struct request *r,
1621fd83240aSStephen Rothwell 					   struct bio *b)
1622fd83240aSStephen Rothwell {
1623cb1a5ab6SMartin K. Petersen 	return true;
1624fd83240aSStephen Rothwell }
162525520d55SMartin K. Petersen 
16267f39add3SSagi Grimberg static inline bool integrity_req_gap_back_merge(struct request *req,
16277f39add3SSagi Grimberg 						struct bio *next)
16287f39add3SSagi Grimberg {
16297f39add3SSagi Grimberg 	return false;
16307f39add3SSagi Grimberg }
16317f39add3SSagi Grimberg static inline bool integrity_req_gap_front_merge(struct request *req,
16327f39add3SSagi Grimberg 						 struct bio *bio)
16337f39add3SSagi Grimberg {
16347f39add3SSagi Grimberg 	return false;
16357f39add3SSagi Grimberg }
16367ba1ba12SMartin K. Petersen 
16377ba1ba12SMartin K. Petersen #endif /* CONFIG_BLK_DEV_INTEGRITY */
16387ba1ba12SMartin K. Petersen 
1639b2e0d162SDan Williams /**
1640b2e0d162SDan Williams  * struct blk_dax_ctl - control and output parameters for ->direct_access
1641b2e0d162SDan Williams  * @sector: (input) offset relative to a block_device
1642b2e0d162SDan Williams  * @addr: (output) kernel virtual address for @sector populated by driver
1643b2e0d162SDan Williams  * @pfn: (output) page frame number for @addr populated by driver
1644b2e0d162SDan Williams  * @size: (input) number of bytes requested
1645b2e0d162SDan Williams  */
1646b2e0d162SDan Williams struct blk_dax_ctl {
1647b2e0d162SDan Williams 	sector_t sector;
1648b2e0d162SDan Williams 	void __pmem *addr;
1649b2e0d162SDan Williams 	long size;
165034c0fd54SDan Williams 	pfn_t pfn;
1651b2e0d162SDan Williams };
1652b2e0d162SDan Williams 
165308f85851SAl Viro struct block_device_operations {
1654d4430d62SAl Viro 	int (*open) (struct block_device *, fmode_t);
1655db2a144bSAl Viro 	void (*release) (struct gendisk *, fmode_t);
165647a191fdSMatthew Wilcox 	int (*rw_page)(struct block_device *, sector_t, struct page *, int rw);
1657d4430d62SAl Viro 	int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1658d4430d62SAl Viro 	int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1659e2e05394SRoss Zwisler 	long (*direct_access)(struct block_device *, sector_t, void __pmem **,
166034c0fd54SDan Williams 			pfn_t *);
166177ea887eSTejun Heo 	unsigned int (*check_events) (struct gendisk *disk,
166277ea887eSTejun Heo 				      unsigned int clearing);
166377ea887eSTejun Heo 	/* ->media_changed() is DEPRECATED, use ->check_events() instead */
166408f85851SAl Viro 	int (*media_changed) (struct gendisk *);
1665c3e33e04STejun Heo 	void (*unlock_native_capacity) (struct gendisk *);
166608f85851SAl Viro 	int (*revalidate_disk) (struct gendisk *);
166708f85851SAl Viro 	int (*getgeo)(struct block_device *, struct hd_geometry *);
1668b3a27d05SNitin Gupta 	/* this callback is with swap_lock and sometimes page table lock held */
1669b3a27d05SNitin Gupta 	void (*swap_slot_free_notify) (struct block_device *, unsigned long);
167008f85851SAl Viro 	struct module *owner;
1671bbd3e064SChristoph Hellwig 	const struct pr_ops *pr_ops;
167208f85851SAl Viro };
167308f85851SAl Viro 
1674633a08b8SAl Viro extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1675633a08b8SAl Viro 				 unsigned long);
167647a191fdSMatthew Wilcox extern int bdev_read_page(struct block_device *, sector_t, struct page *);
167747a191fdSMatthew Wilcox extern int bdev_write_page(struct block_device *, sector_t, struct page *,
167847a191fdSMatthew Wilcox 						struct writeback_control *);
1679b2e0d162SDan Williams extern long bdev_direct_access(struct block_device *, struct blk_dax_ctl *);
16809361401eSDavid Howells #else /* CONFIG_BLOCK */
1681ac13a829SFabian Frederick 
1682ac13a829SFabian Frederick struct block_device;
1683ac13a829SFabian Frederick 
16849361401eSDavid Howells /*
16859361401eSDavid Howells  * stubs for when the block layer is configured out
16869361401eSDavid Howells  */
16879361401eSDavid Howells #define buffer_heads_over_limit 0
16889361401eSDavid Howells 
16899361401eSDavid Howells static inline long nr_blockdev_pages(void)
16909361401eSDavid Howells {
16919361401eSDavid Howells 	return 0;
16929361401eSDavid Howells }
16939361401eSDavid Howells 
16941f940bdfSJens Axboe struct blk_plug {
16951f940bdfSJens Axboe };
16961f940bdfSJens Axboe 
16971f940bdfSJens Axboe static inline void blk_start_plug(struct blk_plug *plug)
169873c10101SJens Axboe {
169973c10101SJens Axboe }
170073c10101SJens Axboe 
17011f940bdfSJens Axboe static inline void blk_finish_plug(struct blk_plug *plug)
170273c10101SJens Axboe {
170373c10101SJens Axboe }
170473c10101SJens Axboe 
17051f940bdfSJens Axboe static inline void blk_flush_plug(struct task_struct *task)
170673c10101SJens Axboe {
170773c10101SJens Axboe }
170873c10101SJens Axboe 
1709a237c1c5SJens Axboe static inline void blk_schedule_flush_plug(struct task_struct *task)
1710a237c1c5SJens Axboe {
1711a237c1c5SJens Axboe }
1712a237c1c5SJens Axboe 
1713a237c1c5SJens Axboe 
171473c10101SJens Axboe static inline bool blk_needs_flush_plug(struct task_struct *tsk)
171573c10101SJens Axboe {
171673c10101SJens Axboe 	return false;
171773c10101SJens Axboe }
171873c10101SJens Axboe 
1719ac13a829SFabian Frederick static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
1720ac13a829SFabian Frederick 				     sector_t *error_sector)
1721ac13a829SFabian Frederick {
1722ac13a829SFabian Frederick 	return 0;
1723ac13a829SFabian Frederick }
1724ac13a829SFabian Frederick 
17259361401eSDavid Howells #endif /* CONFIG_BLOCK */
17269361401eSDavid Howells 
17271da177e4SLinus Torvalds #endif
1728