xref: /linux-6.15/include/linux/blkdev.h (revision e950fdf7)
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 
2034e1b2d52SMike Christie #define REQ_OP_SHIFT (8 * sizeof(u64) - REQ_OP_BITS)
2044e1b2d52SMike Christie #define req_op(req)  ((req)->cmd_flags >> REQ_OP_SHIFT)
2054e1b2d52SMike Christie 
2064e1b2d52SMike Christie #define req_set_op(req, op) do {				\
2074e1b2d52SMike Christie 	WARN_ON(op >= (1 << REQ_OP_BITS));			\
2084e1b2d52SMike Christie 	(req)->cmd_flags &= ((1ULL << REQ_OP_SHIFT) - 1);	\
2094e1b2d52SMike Christie 	(req)->cmd_flags |= ((u64) (op) << REQ_OP_SHIFT);	\
2104e1b2d52SMike Christie } while (0)
2114e1b2d52SMike Christie 
212f2150821SMike Christie #define req_set_op_attrs(req, op, flags) do {	\
213f2150821SMike Christie 	req_set_op(req, op);			\
214f2150821SMike Christie 	(req)->cmd_flags |= flags;		\
215f2150821SMike Christie } while (0)
216f2150821SMike Christie 
217766ca442SFernando Luis Vázquez Cao static inline unsigned short req_get_ioprio(struct request *req)
218766ca442SFernando Luis Vázquez Cao {
219766ca442SFernando Luis Vázquez Cao 	return req->ioprio;
220766ca442SFernando Luis Vázquez Cao }
221766ca442SFernando Luis Vázquez Cao 
2221da177e4SLinus Torvalds #include <linux/elevator.h>
2231da177e4SLinus Torvalds 
224320ae51fSJens Axboe struct blk_queue_ctx;
225320ae51fSJens Axboe 
226165125e1SJens Axboe typedef void (request_fn_proc) (struct request_queue *q);
227dece1635SJens Axboe typedef blk_qc_t (make_request_fn) (struct request_queue *q, struct bio *bio);
228165125e1SJens Axboe typedef int (prep_rq_fn) (struct request_queue *, struct request *);
22928018c24SJames Bottomley typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
2301da177e4SLinus Torvalds 
2311da177e4SLinus Torvalds struct bio_vec;
232ff856badSJens Axboe typedef void (softirq_done_fn)(struct request *);
2332fb98e84STejun Heo typedef int (dma_drain_needed_fn)(struct request *);
234ef9e3facSKiyoshi Ueda typedef int (lld_busy_fn) (struct request_queue *q);
235aa387cc8SMike Christie typedef int (bsg_job_fn) (struct bsg_job *);
2361da177e4SLinus Torvalds 
237242f9dcbSJens Axboe enum blk_eh_timer_return {
238242f9dcbSJens Axboe 	BLK_EH_NOT_HANDLED,
239242f9dcbSJens Axboe 	BLK_EH_HANDLED,
240242f9dcbSJens Axboe 	BLK_EH_RESET_TIMER,
241242f9dcbSJens Axboe };
242242f9dcbSJens Axboe 
243242f9dcbSJens Axboe typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
244242f9dcbSJens Axboe 
2451da177e4SLinus Torvalds enum blk_queue_state {
2461da177e4SLinus Torvalds 	Queue_down,
2471da177e4SLinus Torvalds 	Queue_up,
2481da177e4SLinus Torvalds };
2491da177e4SLinus Torvalds 
2501da177e4SLinus Torvalds struct blk_queue_tag {
2511da177e4SLinus Torvalds 	struct request **tag_index;	/* map of busy tags */
2521da177e4SLinus Torvalds 	unsigned long *tag_map;		/* bit map of free/busy tags */
2531da177e4SLinus Torvalds 	int busy;			/* current depth */
2541da177e4SLinus Torvalds 	int max_depth;			/* what we will send to device */
255ba025082STejun Heo 	int real_max_depth;		/* what the array can hold */
2561da177e4SLinus Torvalds 	atomic_t refcnt;		/* map can be shared */
257ee1b6f7aSShaohua Li 	int alloc_policy;		/* tag allocation policy */
258ee1b6f7aSShaohua Li 	int next_tag;			/* next tag */
2591da177e4SLinus Torvalds };
260ee1b6f7aSShaohua Li #define BLK_TAG_ALLOC_FIFO 0 /* allocate starting from 0 */
261ee1b6f7aSShaohua Li #define BLK_TAG_ALLOC_RR 1 /* allocate starting from last allocated tag */
2621da177e4SLinus Torvalds 
263abf54393SFUJITA Tomonori #define BLK_SCSI_MAX_CMDS	(256)
264abf54393SFUJITA Tomonori #define BLK_SCSI_CMD_PER_LONG	(BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
265abf54393SFUJITA Tomonori 
266025146e1SMartin K. Petersen struct queue_limits {
267025146e1SMartin K. Petersen 	unsigned long		bounce_pfn;
268025146e1SMartin K. Petersen 	unsigned long		seg_boundary_mask;
26903100aadSKeith Busch 	unsigned long		virt_boundary_mask;
270025146e1SMartin K. Petersen 
271025146e1SMartin K. Petersen 	unsigned int		max_hw_sectors;
272ca369d51SMartin K. Petersen 	unsigned int		max_dev_sectors;
273762380adSJens Axboe 	unsigned int		chunk_sectors;
274025146e1SMartin K. Petersen 	unsigned int		max_sectors;
275025146e1SMartin K. Petersen 	unsigned int		max_segment_size;
276c72758f3SMartin K. Petersen 	unsigned int		physical_block_size;
277c72758f3SMartin K. Petersen 	unsigned int		alignment_offset;
278c72758f3SMartin K. Petersen 	unsigned int		io_min;
279c72758f3SMartin K. Petersen 	unsigned int		io_opt;
28067efc925SChristoph Hellwig 	unsigned int		max_discard_sectors;
2810034af03SJens Axboe 	unsigned int		max_hw_discard_sectors;
2824363ac7cSMartin K. Petersen 	unsigned int		max_write_same_sectors;
28386b37281SMartin K. Petersen 	unsigned int		discard_granularity;
28486b37281SMartin K. Petersen 	unsigned int		discard_alignment;
285025146e1SMartin K. Petersen 
286025146e1SMartin K. Petersen 	unsigned short		logical_block_size;
2878a78362cSMartin K. Petersen 	unsigned short		max_segments;
28813f05c8dSMartin K. Petersen 	unsigned short		max_integrity_segments;
289025146e1SMartin K. Petersen 
290c72758f3SMartin K. Petersen 	unsigned char		misaligned;
29186b37281SMartin K. Petersen 	unsigned char		discard_misaligned;
292e692cb66SMartin K. Petersen 	unsigned char		cluster;
293a934a00aSMartin K. Petersen 	unsigned char		discard_zeroes_data;
294c78afc62SKent Overstreet 	unsigned char		raid_partial_stripes_expensive;
295025146e1SMartin K. Petersen };
296025146e1SMartin K. Petersen 
297d7b76301SRichard Kennedy struct request_queue {
2981da177e4SLinus Torvalds 	/*
2991da177e4SLinus Torvalds 	 * Together with queue_head for cacheline sharing
3001da177e4SLinus Torvalds 	 */
3011da177e4SLinus Torvalds 	struct list_head	queue_head;
3021da177e4SLinus Torvalds 	struct request		*last_merge;
303b374d18aSJens Axboe 	struct elevator_queue	*elevator;
3048a5ecdd4STejun Heo 	int			nr_rqs[2];	/* # allocated [a]sync rqs */
3058a5ecdd4STejun Heo 	int			nr_rqs_elvpriv;	/* # allocated rqs w/ elvpriv */
3061da177e4SLinus Torvalds 
3071da177e4SLinus Torvalds 	/*
308a051661cSTejun Heo 	 * If blkcg is not used, @q->root_rl serves all requests.  If blkcg
309a051661cSTejun Heo 	 * is used, root blkg allocates from @q->root_rl and all other
310a051661cSTejun Heo 	 * blkgs from their own blkg->rl.  Which one to use should be
311a051661cSTejun Heo 	 * determined using bio_request_list().
3121da177e4SLinus Torvalds 	 */
313a051661cSTejun Heo 	struct request_list	root_rl;
3141da177e4SLinus Torvalds 
3151da177e4SLinus Torvalds 	request_fn_proc		*request_fn;
3161da177e4SLinus Torvalds 	make_request_fn		*make_request_fn;
3171da177e4SLinus Torvalds 	prep_rq_fn		*prep_rq_fn;
31828018c24SJames Bottomley 	unprep_rq_fn		*unprep_rq_fn;
319ff856badSJens Axboe 	softirq_done_fn		*softirq_done_fn;
320242f9dcbSJens Axboe 	rq_timed_out_fn		*rq_timed_out_fn;
3212fb98e84STejun Heo 	dma_drain_needed_fn	*dma_drain_needed;
322ef9e3facSKiyoshi Ueda 	lld_busy_fn		*lld_busy_fn;
3231da177e4SLinus Torvalds 
324320ae51fSJens Axboe 	struct blk_mq_ops	*mq_ops;
325320ae51fSJens Axboe 
326320ae51fSJens Axboe 	unsigned int		*mq_map;
327320ae51fSJens Axboe 
328320ae51fSJens Axboe 	/* sw queues */
329e6cdb092SMing Lei 	struct blk_mq_ctx __percpu	*queue_ctx;
330320ae51fSJens Axboe 	unsigned int		nr_queues;
331320ae51fSJens Axboe 
332320ae51fSJens Axboe 	/* hw dispatch queues */
333320ae51fSJens Axboe 	struct blk_mq_hw_ctx	**queue_hw_ctx;
334320ae51fSJens Axboe 	unsigned int		nr_hw_queues;
335320ae51fSJens Axboe 
3361da177e4SLinus Torvalds 	/*
3378922e16cSTejun Heo 	 * Dispatch queue sorting
3388922e16cSTejun Heo 	 */
3391b47f531SJens Axboe 	sector_t		end_sector;
3408922e16cSTejun Heo 	struct request		*boundary_rq;
3418922e16cSTejun Heo 
3428922e16cSTejun Heo 	/*
3433cca6dc1SJens Axboe 	 * Delayed queue handling
3441da177e4SLinus Torvalds 	 */
3453cca6dc1SJens Axboe 	struct delayed_work	delay_work;
3461da177e4SLinus Torvalds 
3471da177e4SLinus Torvalds 	struct backing_dev_info	backing_dev_info;
3481da177e4SLinus Torvalds 
3491da177e4SLinus Torvalds 	/*
3501da177e4SLinus Torvalds 	 * The queue owner gets to use this for whatever they like.
3511da177e4SLinus Torvalds 	 * ll_rw_blk doesn't touch it.
3521da177e4SLinus Torvalds 	 */
3531da177e4SLinus Torvalds 	void			*queuedata;
3541da177e4SLinus Torvalds 
3551da177e4SLinus Torvalds 	/*
3561da177e4SLinus Torvalds 	 * various queue flags, see QUEUE_* below
3571da177e4SLinus Torvalds 	 */
3581da177e4SLinus Torvalds 	unsigned long		queue_flags;
3591da177e4SLinus Torvalds 
3601da177e4SLinus Torvalds 	/*
361a73f730dSTejun Heo 	 * ida allocated id for this queue.  Used to index queues from
362a73f730dSTejun Heo 	 * ioctx.
363a73f730dSTejun Heo 	 */
364a73f730dSTejun Heo 	int			id;
365a73f730dSTejun Heo 
366a73f730dSTejun Heo 	/*
367d7b76301SRichard Kennedy 	 * queue needs bounce pages for pages above this limit
368d7b76301SRichard Kennedy 	 */
369d7b76301SRichard Kennedy 	gfp_t			bounce_gfp;
370d7b76301SRichard Kennedy 
371d7b76301SRichard Kennedy 	/*
372152587deS 	 * protects queue structures from reentrancy. ->__queue_lock should
373152587deS 	 * _never_ be used directly, it is queue private. always use
374152587deS 	 * ->queue_lock.
3751da177e4SLinus Torvalds 	 */
376152587deS 	spinlock_t		__queue_lock;
3771da177e4SLinus Torvalds 	spinlock_t		*queue_lock;
3781da177e4SLinus Torvalds 
3791da177e4SLinus Torvalds 	/*
3801da177e4SLinus Torvalds 	 * queue kobject
3811da177e4SLinus Torvalds 	 */
3821da177e4SLinus Torvalds 	struct kobject kobj;
3831da177e4SLinus Torvalds 
384320ae51fSJens Axboe 	/*
385320ae51fSJens Axboe 	 * mq queue kobject
386320ae51fSJens Axboe 	 */
387320ae51fSJens Axboe 	struct kobject mq_kobj;
388320ae51fSJens Axboe 
389ac6fc48cSDan Williams #ifdef  CONFIG_BLK_DEV_INTEGRITY
390ac6fc48cSDan Williams 	struct blk_integrity integrity;
391ac6fc48cSDan Williams #endif	/* CONFIG_BLK_DEV_INTEGRITY */
392ac6fc48cSDan Williams 
39347fafbc7SRafael J. Wysocki #ifdef CONFIG_PM
3946c954667SLin Ming 	struct device		*dev;
3956c954667SLin Ming 	int			rpm_status;
3966c954667SLin Ming 	unsigned int		nr_pending;
3976c954667SLin Ming #endif
3986c954667SLin Ming 
3991da177e4SLinus Torvalds 	/*
4001da177e4SLinus Torvalds 	 * queue settings
4011da177e4SLinus Torvalds 	 */
4021da177e4SLinus Torvalds 	unsigned long		nr_requests;	/* Max # of requests */
4031da177e4SLinus Torvalds 	unsigned int		nr_congestion_on;
4041da177e4SLinus Torvalds 	unsigned int		nr_congestion_off;
4051da177e4SLinus Torvalds 	unsigned int		nr_batching;
4061da177e4SLinus Torvalds 
407fa0ccd83SJames Bottomley 	unsigned int		dma_drain_size;
408d7b76301SRichard Kennedy 	void			*dma_drain_buffer;
409e3790c7dSTejun Heo 	unsigned int		dma_pad_mask;
4101da177e4SLinus Torvalds 	unsigned int		dma_alignment;
4111da177e4SLinus Torvalds 
4121da177e4SLinus Torvalds 	struct blk_queue_tag	*queue_tags;
4136eca9004SJens Axboe 	struct list_head	tag_busy_list;
4141da177e4SLinus Torvalds 
41515853af9STejun Heo 	unsigned int		nr_sorted;
4160a7ae2ffSJens Axboe 	unsigned int		in_flight[2];
41724faf6f6SBart Van Assche 	/*
41824faf6f6SBart Van Assche 	 * Number of active block driver functions for which blk_drain_queue()
41924faf6f6SBart Van Assche 	 * must wait. Must be incremented around functions that unlock the
42024faf6f6SBart Van Assche 	 * queue_lock internally, e.g. scsi_request_fn().
42124faf6f6SBart Van Assche 	 */
42224faf6f6SBart Van Assche 	unsigned int		request_fn_active;
4231da177e4SLinus Torvalds 
424242f9dcbSJens Axboe 	unsigned int		rq_timeout;
425242f9dcbSJens Axboe 	struct timer_list	timeout;
426287922ebSChristoph Hellwig 	struct work_struct	timeout_work;
427242f9dcbSJens Axboe 	struct list_head	timeout_list;
428242f9dcbSJens Axboe 
429a612fddfSTejun Heo 	struct list_head	icq_list;
4304eef3049STejun Heo #ifdef CONFIG_BLK_CGROUP
431a2b1693bSTejun Heo 	DECLARE_BITMAP		(blkcg_pols, BLKCG_MAX_POLS);
4323c798398STejun Heo 	struct blkcg_gq		*root_blkg;
43303aa264aSTejun Heo 	struct list_head	blkg_list;
4344eef3049STejun Heo #endif
435a612fddfSTejun Heo 
436025146e1SMartin K. Petersen 	struct queue_limits	limits;
437025146e1SMartin K. Petersen 
4381da177e4SLinus Torvalds 	/*
4391da177e4SLinus Torvalds 	 * sg stuff
4401da177e4SLinus Torvalds 	 */
4411da177e4SLinus Torvalds 	unsigned int		sg_timeout;
4421da177e4SLinus Torvalds 	unsigned int		sg_reserved_size;
4431946089aSChristoph Lameter 	int			node;
4446c5c9341SAlexey Dobriyan #ifdef CONFIG_BLK_DEV_IO_TRACE
4452056a782SJens Axboe 	struct blk_trace	*blk_trace;
4466c5c9341SAlexey Dobriyan #endif
4471da177e4SLinus Torvalds 	/*
4484913efe4STejun Heo 	 * for flush operations
4491da177e4SLinus Torvalds 	 */
4507c94e1c1SMing Lei 	struct blk_flush_queue	*fq;
451483f4afcSAl Viro 
4526fca6a61SChristoph Hellwig 	struct list_head	requeue_list;
4536fca6a61SChristoph Hellwig 	spinlock_t		requeue_lock;
4546fca6a61SChristoph Hellwig 	struct work_struct	requeue_work;
4556fca6a61SChristoph Hellwig 
456483f4afcSAl Viro 	struct mutex		sysfs_lock;
457d351af01SFUJITA Tomonori 
458d732580bSTejun Heo 	int			bypass_depth;
4594ecd4fefSChristoph Hellwig 	atomic_t		mq_freeze_depth;
460d732580bSTejun Heo 
461d351af01SFUJITA Tomonori #if defined(CONFIG_BLK_DEV_BSG)
462aa387cc8SMike Christie 	bsg_job_fn		*bsg_job_fn;
463aa387cc8SMike Christie 	int			bsg_job_size;
464d351af01SFUJITA Tomonori 	struct bsg_class_device bsg_dev;
465d351af01SFUJITA Tomonori #endif
466e43473b7SVivek Goyal 
467e43473b7SVivek Goyal #ifdef CONFIG_BLK_DEV_THROTTLING
468e43473b7SVivek Goyal 	/* Throttle data */
469e43473b7SVivek Goyal 	struct throtl_data *td;
470e43473b7SVivek Goyal #endif
471548bc8e1STejun Heo 	struct rcu_head		rcu_head;
472320ae51fSJens Axboe 	wait_queue_head_t	mq_freeze_wq;
4733ef28e83SDan Williams 	struct percpu_ref	q_usage_counter;
474320ae51fSJens Axboe 	struct list_head	all_q_node;
4750d2602caSJens Axboe 
4760d2602caSJens Axboe 	struct blk_mq_tag_set	*tag_set;
4770d2602caSJens Axboe 	struct list_head	tag_set_list;
47854efd50bSKent Overstreet 	struct bio_set		*bio_split;
4794593fdbeSAkinobu Mita 
4804593fdbeSAkinobu Mita 	bool			mq_sysfs_init_done;
4811da177e4SLinus Torvalds };
4821da177e4SLinus Torvalds 
4831da177e4SLinus Torvalds #define QUEUE_FLAG_QUEUED	1	/* uses generic tag queueing */
4841da177e4SLinus Torvalds #define QUEUE_FLAG_STOPPED	2	/* queue is stopped */
4851faa16d2SJens Axboe #define	QUEUE_FLAG_SYNCFULL	3	/* read queue has been filled */
4861faa16d2SJens Axboe #define QUEUE_FLAG_ASYNCFULL	4	/* write queue has been filled */
4873f3299d5SBart Van Assche #define QUEUE_FLAG_DYING	5	/* queue being torn down */
488d732580bSTejun Heo #define QUEUE_FLAG_BYPASS	6	/* act as dumb FIFO queue */
489c21e6bebSJens Axboe #define QUEUE_FLAG_BIDI		7	/* queue supports bidi requests */
490c21e6bebSJens Axboe #define QUEUE_FLAG_NOMERGES     8	/* disable merge attempts */
4915757a6d7SDan Williams #define QUEUE_FLAG_SAME_COMP	9	/* complete on same CPU-group */
492c21e6bebSJens Axboe #define QUEUE_FLAG_FAIL_IO     10	/* fake timeout */
493c21e6bebSJens Axboe #define QUEUE_FLAG_STACKABLE   11	/* supports request stacking */
494c21e6bebSJens Axboe #define QUEUE_FLAG_NONROT      12	/* non-rotational device (SSD) */
49588e740f1SFernando Luis Vázquez Cao #define QUEUE_FLAG_VIRT        QUEUE_FLAG_NONROT /* paravirt device */
496c21e6bebSJens Axboe #define QUEUE_FLAG_IO_STAT     13	/* do IO stats */
497c21e6bebSJens Axboe #define QUEUE_FLAG_DISCARD     14	/* supports DISCARD */
498c21e6bebSJens Axboe #define QUEUE_FLAG_NOXMERGES   15	/* No extended merges */
499c21e6bebSJens Axboe #define QUEUE_FLAG_ADD_RANDOM  16	/* Contributes to random pool */
500288dab8aSChristoph Hellwig #define QUEUE_FLAG_SECERASE    17	/* supports secure erase */
5015757a6d7SDan Williams #define QUEUE_FLAG_SAME_FORCE  18	/* force complete on same CPU */
502c246e80dSBart Van Assche #define QUEUE_FLAG_DEAD        19	/* queue tear-down finished */
503320ae51fSJens Axboe #define QUEUE_FLAG_INIT_DONE   20	/* queue is initialized */
50405f1dd53SJens Axboe #define QUEUE_FLAG_NO_SG_MERGE 21	/* don't attempt to merge SG segments*/
50505229beeSJens Axboe #define QUEUE_FLAG_POLL	       22	/* IO polling enabled if set */
50693e9d8e8SJens Axboe #define QUEUE_FLAG_WC	       23	/* Write back caching */
50793e9d8e8SJens Axboe #define QUEUE_FLAG_FUA	       24	/* device supports FUA writes */
508c888a8f9SJens Axboe #define QUEUE_FLAG_FLUSH_NQ    25	/* flush not queueuable */
509bc58ba94SJens Axboe 
510bc58ba94SJens Axboe #define QUEUE_FLAG_DEFAULT	((1 << QUEUE_FLAG_IO_STAT) |		\
51101e97f6bSJens Axboe 				 (1 << QUEUE_FLAG_STACKABLE)	|	\
512e2e1a148SJens Axboe 				 (1 << QUEUE_FLAG_SAME_COMP)	|	\
513e2e1a148SJens Axboe 				 (1 << QUEUE_FLAG_ADD_RANDOM))
514797e7dbbSTejun Heo 
51594eddfbeSJens Axboe #define QUEUE_FLAG_MQ_DEFAULT	((1 << QUEUE_FLAG_IO_STAT) |		\
516ad9cf3bbSMike Snitzer 				 (1 << QUEUE_FLAG_STACKABLE)	|	\
5178e0b60b9SChristoph Hellwig 				 (1 << QUEUE_FLAG_SAME_COMP)	|	\
5188e0b60b9SChristoph Hellwig 				 (1 << QUEUE_FLAG_POLL))
51994eddfbeSJens Axboe 
5208bcb6c7dSAndi Kleen static inline void queue_lockdep_assert_held(struct request_queue *q)
5218f45c1a5SLinus Torvalds {
5228bcb6c7dSAndi Kleen 	if (q->queue_lock)
5238bcb6c7dSAndi Kleen 		lockdep_assert_held(q->queue_lock);
5248f45c1a5SLinus Torvalds }
5258f45c1a5SLinus Torvalds 
52675ad23bcSNick Piggin static inline void queue_flag_set_unlocked(unsigned int flag,
52775ad23bcSNick Piggin 					   struct request_queue *q)
52875ad23bcSNick Piggin {
52975ad23bcSNick Piggin 	__set_bit(flag, &q->queue_flags);
53075ad23bcSNick Piggin }
53175ad23bcSNick Piggin 
532e48ec690SJens Axboe static inline int queue_flag_test_and_clear(unsigned int flag,
533e48ec690SJens Axboe 					    struct request_queue *q)
534e48ec690SJens Axboe {
5358bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
536e48ec690SJens Axboe 
537e48ec690SJens Axboe 	if (test_bit(flag, &q->queue_flags)) {
538e48ec690SJens Axboe 		__clear_bit(flag, &q->queue_flags);
539e48ec690SJens Axboe 		return 1;
540e48ec690SJens Axboe 	}
541e48ec690SJens Axboe 
542e48ec690SJens Axboe 	return 0;
543e48ec690SJens Axboe }
544e48ec690SJens Axboe 
545e48ec690SJens Axboe static inline int queue_flag_test_and_set(unsigned int flag,
546e48ec690SJens Axboe 					  struct request_queue *q)
547e48ec690SJens Axboe {
5488bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
549e48ec690SJens Axboe 
550e48ec690SJens Axboe 	if (!test_bit(flag, &q->queue_flags)) {
551e48ec690SJens Axboe 		__set_bit(flag, &q->queue_flags);
552e48ec690SJens Axboe 		return 0;
553e48ec690SJens Axboe 	}
554e48ec690SJens Axboe 
555e48ec690SJens Axboe 	return 1;
556e48ec690SJens Axboe }
557e48ec690SJens Axboe 
55875ad23bcSNick Piggin static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
55975ad23bcSNick Piggin {
5608bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
56175ad23bcSNick Piggin 	__set_bit(flag, &q->queue_flags);
56275ad23bcSNick Piggin }
56375ad23bcSNick Piggin 
56475ad23bcSNick Piggin static inline void queue_flag_clear_unlocked(unsigned int flag,
56575ad23bcSNick Piggin 					     struct request_queue *q)
56675ad23bcSNick Piggin {
56775ad23bcSNick Piggin 	__clear_bit(flag, &q->queue_flags);
56875ad23bcSNick Piggin }
56975ad23bcSNick Piggin 
5700a7ae2ffSJens Axboe static inline int queue_in_flight(struct request_queue *q)
5710a7ae2ffSJens Axboe {
5720a7ae2ffSJens Axboe 	return q->in_flight[0] + q->in_flight[1];
5730a7ae2ffSJens Axboe }
5740a7ae2ffSJens Axboe 
57575ad23bcSNick Piggin static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
57675ad23bcSNick Piggin {
5778bcb6c7dSAndi Kleen 	queue_lockdep_assert_held(q);
57875ad23bcSNick Piggin 	__clear_bit(flag, &q->queue_flags);
57975ad23bcSNick Piggin }
58075ad23bcSNick Piggin 
5811da177e4SLinus Torvalds #define blk_queue_tagged(q)	test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
5821da177e4SLinus Torvalds #define blk_queue_stopped(q)	test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
5833f3299d5SBart Van Assche #define blk_queue_dying(q)	test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
584c246e80dSBart Van Assche #define blk_queue_dead(q)	test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
585d732580bSTejun Heo #define blk_queue_bypass(q)	test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
586320ae51fSJens Axboe #define blk_queue_init_done(q)	test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
587ac9fafa1SAlan D. Brunelle #define blk_queue_nomerges(q)	test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
588488991e2SAlan D. Brunelle #define blk_queue_noxmerges(q)	\
589488991e2SAlan D. Brunelle 	test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
590a68bbddbSJens Axboe #define blk_queue_nonrot(q)	test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
591bc58ba94SJens Axboe #define blk_queue_io_stat(q)	test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
592e2e1a148SJens Axboe #define blk_queue_add_random(q)	test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
5934ee5eaf4SKiyoshi Ueda #define blk_queue_stackable(q)	\
5944ee5eaf4SKiyoshi Ueda 	test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
595c15227deSChristoph Hellwig #define blk_queue_discard(q)	test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
596288dab8aSChristoph Hellwig #define blk_queue_secure_erase(q) \
597288dab8aSChristoph Hellwig 	(test_bit(QUEUE_FLAG_SECERASE, &(q)->queue_flags))
5981da177e4SLinus Torvalds 
59933659ebbSChristoph Hellwig #define blk_noretry_request(rq) \
60033659ebbSChristoph Hellwig 	((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
60133659ebbSChristoph Hellwig 			     REQ_FAILFAST_DRIVER))
6024aff5e23SJens Axboe 
60333659ebbSChristoph Hellwig #define blk_account_rq(rq) \
60433659ebbSChristoph Hellwig 	(((rq)->cmd_flags & REQ_STARTED) && \
605e2a60da7SMartin K. Petersen 	 ((rq)->cmd_type == REQ_TYPE_FS))
6061da177e4SLinus Torvalds 
607ab780f1eSJens Axboe #define blk_rq_cpu_valid(rq)	((rq)->cpu != -1)
608abae1fdeSFUJITA Tomonori #define blk_bidi_rq(rq)		((rq)->next_rq != NULL)
609336cdb40SKiyoshi Ueda /* rq->queuelist of dequeued request must be list_empty() */
610336cdb40SKiyoshi Ueda #define blk_queued_rq(rq)	(!list_empty(&(rq)->queuelist))
6111da177e4SLinus Torvalds 
6121da177e4SLinus Torvalds #define list_entry_rq(ptr)	list_entry((ptr), struct request, queuelist)
6131da177e4SLinus Torvalds 
6144e1b2d52SMike Christie #define rq_data_dir(rq)		(op_is_write(req_op(rq)) ? WRITE : READ)
6151da177e4SLinus Torvalds 
61649fd524fSJens Axboe /*
61749fd524fSJens Axboe  * Driver can handle struct request, if it either has an old style
61849fd524fSJens Axboe  * request_fn defined, or is blk-mq based.
61949fd524fSJens Axboe  */
62049fd524fSJens Axboe static inline bool queue_is_rq_based(struct request_queue *q)
62149fd524fSJens Axboe {
62249fd524fSJens Axboe 	return q->request_fn || q->mq_ops;
62349fd524fSJens Axboe }
62449fd524fSJens Axboe 
625e692cb66SMartin K. Petersen static inline unsigned int blk_queue_cluster(struct request_queue *q)
626e692cb66SMartin K. Petersen {
627e692cb66SMartin K. Petersen 	return q->limits.cluster;
628e692cb66SMartin K. Petersen }
629e692cb66SMartin K. Petersen 
6309e2585a8SJens Axboe /*
6311faa16d2SJens Axboe  * We regard a request as sync, if either a read or a sync write
6329e2585a8SJens Axboe  */
633d9d8c5c4SMike Christie static inline bool rw_is_sync(int op, unsigned int rw_flags)
6341faa16d2SJens Axboe {
635d9d8c5c4SMike Christie 	return op == REQ_OP_READ || (rw_flags & REQ_SYNC);
6361faa16d2SJens Axboe }
6371faa16d2SJens Axboe 
6381faa16d2SJens Axboe static inline bool rq_is_sync(struct request *rq)
6391faa16d2SJens Axboe {
640d9d8c5c4SMike Christie 	return rw_is_sync(req_op(rq), rq->cmd_flags);
6411faa16d2SJens Axboe }
6421faa16d2SJens Axboe 
6435b788ce3STejun Heo static inline bool blk_rl_full(struct request_list *rl, bool sync)
6441da177e4SLinus Torvalds {
6455b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6465b788ce3STejun Heo 
6475b788ce3STejun Heo 	return rl->flags & flag;
6481da177e4SLinus Torvalds }
6491da177e4SLinus Torvalds 
6505b788ce3STejun Heo static inline void blk_set_rl_full(struct request_list *rl, bool sync)
6511da177e4SLinus Torvalds {
6525b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6535b788ce3STejun Heo 
6545b788ce3STejun Heo 	rl->flags |= flag;
6551da177e4SLinus Torvalds }
6561da177e4SLinus Torvalds 
6575b788ce3STejun Heo static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
6581da177e4SLinus Torvalds {
6595b788ce3STejun Heo 	unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
6605b788ce3STejun Heo 
6615b788ce3STejun Heo 	rl->flags &= ~flag;
6621da177e4SLinus Torvalds }
6631da177e4SLinus Torvalds 
664e2a60da7SMartin K. Petersen static inline bool rq_mergeable(struct request *rq)
665e2a60da7SMartin K. Petersen {
666e2a60da7SMartin K. Petersen 	if (rq->cmd_type != REQ_TYPE_FS)
667e2a60da7SMartin K. Petersen 		return false;
6681da177e4SLinus Torvalds 
6693a5e02ceSMike Christie 	if (req_op(rq) == REQ_OP_FLUSH)
6703a5e02ceSMike Christie 		return false;
6713a5e02ceSMike Christie 
672e2a60da7SMartin K. Petersen 	if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
673e2a60da7SMartin K. Petersen 		return false;
674e2a60da7SMartin K. Petersen 
675e2a60da7SMartin K. Petersen 	return true;
676e2a60da7SMartin K. Petersen }
6771da177e4SLinus Torvalds 
6784363ac7cSMartin K. Petersen static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
6794363ac7cSMartin K. Petersen {
6804363ac7cSMartin K. Petersen 	if (bio_data(a) == bio_data(b))
6814363ac7cSMartin K. Petersen 		return true;
6824363ac7cSMartin K. Petersen 
6834363ac7cSMartin K. Petersen 	return false;
6844363ac7cSMartin K. Petersen }
6854363ac7cSMartin K. Petersen 
6861da177e4SLinus Torvalds /*
6871da177e4SLinus Torvalds  * q->prep_rq_fn return values
6881da177e4SLinus Torvalds  */
6890fb5b1fbSMartin K. Petersen enum {
6900fb5b1fbSMartin K. Petersen 	BLKPREP_OK,		/* serve it */
6910fb5b1fbSMartin K. Petersen 	BLKPREP_KILL,		/* fatal error, kill, return -EIO */
6920fb5b1fbSMartin K. Petersen 	BLKPREP_DEFER,		/* leave on queue */
6930fb5b1fbSMartin K. Petersen 	BLKPREP_INVALID,	/* invalid command, kill, return -EREMOTEIO */
6940fb5b1fbSMartin K. Petersen };
6951da177e4SLinus Torvalds 
6961da177e4SLinus Torvalds extern unsigned long blk_max_low_pfn, blk_max_pfn;
6971da177e4SLinus Torvalds 
6981da177e4SLinus Torvalds /*
6991da177e4SLinus Torvalds  * standard bounce addresses:
7001da177e4SLinus Torvalds  *
7011da177e4SLinus Torvalds  * BLK_BOUNCE_HIGH	: bounce all highmem pages
7021da177e4SLinus Torvalds  * BLK_BOUNCE_ANY	: don't bounce anything
7031da177e4SLinus Torvalds  * BLK_BOUNCE_ISA	: bounce pages above ISA DMA boundary
7041da177e4SLinus Torvalds  */
7052472892aSAndi Kleen 
7062472892aSAndi Kleen #if BITS_PER_LONG == 32
7071da177e4SLinus Torvalds #define BLK_BOUNCE_HIGH		((u64)blk_max_low_pfn << PAGE_SHIFT)
7082472892aSAndi Kleen #else
7092472892aSAndi Kleen #define BLK_BOUNCE_HIGH		-1ULL
7102472892aSAndi Kleen #endif
7112472892aSAndi Kleen #define BLK_BOUNCE_ANY		(-1ULL)
712bfe17231SFUJITA Tomonori #define BLK_BOUNCE_ISA		(DMA_BIT_MASK(24))
7131da177e4SLinus Torvalds 
7143d6392cfSJens Axboe /*
7153d6392cfSJens Axboe  * default timeout for SG_IO if none specified
7163d6392cfSJens Axboe  */
7173d6392cfSJens Axboe #define BLK_DEFAULT_SG_TIMEOUT	(60 * HZ)
718f2f1fa78SLinus Torvalds #define BLK_MIN_SG_TIMEOUT	(7 * HZ)
7193d6392cfSJens Axboe 
7202a7326b5SChristoph Lameter #ifdef CONFIG_BOUNCE
7211da177e4SLinus Torvalds extern int init_emergency_isa_pool(void);
722165125e1SJens Axboe extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
7231da177e4SLinus Torvalds #else
7241da177e4SLinus Torvalds static inline int init_emergency_isa_pool(void)
7251da177e4SLinus Torvalds {
7261da177e4SLinus Torvalds 	return 0;
7271da177e4SLinus Torvalds }
728165125e1SJens Axboe static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
7291da177e4SLinus Torvalds {
7301da177e4SLinus Torvalds }
7311da177e4SLinus Torvalds #endif /* CONFIG_MMU */
7321da177e4SLinus Torvalds 
733152e283fSFUJITA Tomonori struct rq_map_data {
734152e283fSFUJITA Tomonori 	struct page **pages;
735152e283fSFUJITA Tomonori 	int page_order;
736152e283fSFUJITA Tomonori 	int nr_entries;
73756c451f4SFUJITA Tomonori 	unsigned long offset;
73897ae77a1SFUJITA Tomonori 	int null_mapped;
739ecb554a8SFUJITA Tomonori 	int from_user;
740152e283fSFUJITA Tomonori };
741152e283fSFUJITA Tomonori 
7425705f702SNeilBrown struct req_iterator {
7437988613bSKent Overstreet 	struct bvec_iter iter;
7445705f702SNeilBrown 	struct bio *bio;
7455705f702SNeilBrown };
7465705f702SNeilBrown 
7475705f702SNeilBrown /* This should not be used directly - use rq_for_each_segment */
7481e428079SJens Axboe #define for_each_bio(_bio)		\
7491e428079SJens Axboe 	for (; _bio; _bio = _bio->bi_next)
7505705f702SNeilBrown #define __rq_for_each_bio(_bio, rq)	\
7511da177e4SLinus Torvalds 	if ((rq->bio))			\
7521da177e4SLinus Torvalds 		for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
7531da177e4SLinus Torvalds 
7545705f702SNeilBrown #define rq_for_each_segment(bvl, _rq, _iter)			\
7555705f702SNeilBrown 	__rq_for_each_bio(_iter.bio, _rq)			\
7567988613bSKent Overstreet 		bio_for_each_segment(bvl, _iter.bio, _iter.iter)
7575705f702SNeilBrown 
7584550dd6cSKent Overstreet #define rq_iter_last(bvec, _iter)				\
7597988613bSKent Overstreet 		(_iter.bio->bi_next == NULL &&			\
7604550dd6cSKent Overstreet 		 bio_iter_last(bvec, _iter.iter))
7615705f702SNeilBrown 
7622d4dc890SIlya Loginov #ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
7632d4dc890SIlya Loginov # error	"You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
7642d4dc890SIlya Loginov #endif
7652d4dc890SIlya Loginov #if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
7662d4dc890SIlya Loginov extern void rq_flush_dcache_pages(struct request *rq);
7672d4dc890SIlya Loginov #else
7682d4dc890SIlya Loginov static inline void rq_flush_dcache_pages(struct request *rq)
7692d4dc890SIlya Loginov {
7702d4dc890SIlya Loginov }
7712d4dc890SIlya Loginov #endif
7722d4dc890SIlya Loginov 
7732af3a815SToshi Kani #ifdef CONFIG_PRINTK
7742af3a815SToshi Kani #define vfs_msg(sb, level, fmt, ...)				\
7752af3a815SToshi Kani 	__vfs_msg(sb, level, fmt, ##__VA_ARGS__)
7762af3a815SToshi Kani #else
7772af3a815SToshi Kani #define vfs_msg(sb, level, fmt, ...)				\
7782af3a815SToshi Kani do {								\
7792af3a815SToshi Kani 	no_printk(fmt, ##__VA_ARGS__);				\
7802af3a815SToshi Kani 	__vfs_msg(sb, "", " ");					\
7812af3a815SToshi Kani } while (0)
7822af3a815SToshi Kani #endif
7832af3a815SToshi Kani 
7841da177e4SLinus Torvalds extern int blk_register_queue(struct gendisk *disk);
7851da177e4SLinus Torvalds extern void blk_unregister_queue(struct gendisk *disk);
786dece1635SJens Axboe extern blk_qc_t generic_make_request(struct bio *bio);
7872a4aa30cSFUJITA Tomonori extern void blk_rq_init(struct request_queue *q, struct request *rq);
7881da177e4SLinus Torvalds extern void blk_put_request(struct request *);
789165125e1SJens Axboe extern void __blk_put_request(struct request_queue *, struct request *);
790165125e1SJens Axboe extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
79179eb63e9SBoaz Harrosh extern struct request *blk_make_request(struct request_queue *, struct bio *,
79279eb63e9SBoaz Harrosh 					gfp_t);
793f27b087bSJens Axboe extern void blk_rq_set_block_pc(struct request *);
794165125e1SJens Axboe extern void blk_requeue_request(struct request_queue *, struct request *);
79566ac0280SChristoph Hellwig extern void blk_add_request_payload(struct request *rq, struct page *page,
79637e58237SMing Lin 		int offset, unsigned int len);
797ef9e3facSKiyoshi Ueda extern int blk_lld_busy(struct request_queue *q);
79878d8e58aSMike Snitzer extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
79978d8e58aSMike Snitzer 			     struct bio_set *bs, gfp_t gfp_mask,
80078d8e58aSMike Snitzer 			     int (*bio_ctr)(struct bio *, struct bio *, void *),
80178d8e58aSMike Snitzer 			     void *data);
80278d8e58aSMike Snitzer extern void blk_rq_unprep_clone(struct request *rq);
80382124d60SKiyoshi Ueda extern int blk_insert_cloned_request(struct request_queue *q,
80482124d60SKiyoshi Ueda 				     struct request *rq);
8053cca6dc1SJens Axboe extern void blk_delay_queue(struct request_queue *, unsigned long);
80654efd50bSKent Overstreet extern void blk_queue_split(struct request_queue *, struct bio **,
80754efd50bSKent Overstreet 			    struct bio_set *);
808165125e1SJens Axboe extern void blk_recount_segments(struct request_queue *, struct bio *);
8090bfc96cbSPaolo Bonzini extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
810577ebb37SPaolo Bonzini extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
811577ebb37SPaolo Bonzini 			      unsigned int, void __user *);
81274f3c8afSAl Viro extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
81374f3c8afSAl Viro 			  unsigned int, void __user *);
814e915e872SAl Viro extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
815e915e872SAl Viro 			 struct scsi_ioctl_command __user *);
8163fcfab16SAndrew Morton 
8176f3b0e8bSChristoph Hellwig extern int blk_queue_enter(struct request_queue *q, bool nowait);
8182e6edc95SDan Williams extern void blk_queue_exit(struct request_queue *q);
819165125e1SJens Axboe extern void blk_start_queue(struct request_queue *q);
82021491412SJens Axboe extern void blk_start_queue_async(struct request_queue *q);
821165125e1SJens Axboe extern void blk_stop_queue(struct request_queue *q);
8221da177e4SLinus Torvalds extern void blk_sync_queue(struct request_queue *q);
823165125e1SJens Axboe extern void __blk_stop_queue(struct request_queue *q);
82424ecfbe2SChristoph Hellwig extern void __blk_run_queue(struct request_queue *q);
825a7928c15SChristoph Hellwig extern void __blk_run_queue_uncond(struct request_queue *q);
826165125e1SJens Axboe extern void blk_run_queue(struct request_queue *);
827c21e6bebSJens Axboe extern void blk_run_queue_async(struct request_queue *q);
828a3bce90eSFUJITA Tomonori extern int blk_rq_map_user(struct request_queue *, struct request *,
829152e283fSFUJITA Tomonori 			   struct rq_map_data *, void __user *, unsigned long,
830152e283fSFUJITA Tomonori 			   gfp_t);
8318e5cfc45SJens Axboe extern int blk_rq_unmap_user(struct bio *);
832165125e1SJens Axboe extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
833165125e1SJens Axboe extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
83426e49cfcSKent Overstreet 			       struct rq_map_data *, const struct iov_iter *,
83526e49cfcSKent Overstreet 			       gfp_t);
836165125e1SJens Axboe extern int blk_execute_rq(struct request_queue *, struct gendisk *,
837994ca9a1SJames Bottomley  			  struct request *, int);
838165125e1SJens Axboe extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
83915fc858aSJens Axboe 				  struct request *, int, rq_end_io_fn *);
8406e39b69eSMike Christie 
84105229beeSJens Axboe bool blk_poll(struct request_queue *q, blk_qc_t cookie);
84205229beeSJens Axboe 
843165125e1SJens Axboe static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
8441da177e4SLinus Torvalds {
845ff9ea323STejun Heo 	return bdev->bd_disk->queue;	/* this is never NULL */
8461da177e4SLinus Torvalds }
8471da177e4SLinus Torvalds 
8481da177e4SLinus Torvalds /*
8495b93629bSTejun Heo  * blk_rq_pos()			: the current sector
8505b93629bSTejun Heo  * blk_rq_bytes()		: bytes left in the entire request
8515b93629bSTejun Heo  * blk_rq_cur_bytes()		: bytes left in the current segment
85280a761fdSTejun Heo  * blk_rq_err_bytes()		: bytes left till the next error boundary
8535b93629bSTejun Heo  * blk_rq_sectors()		: sectors left in the entire request
8545b93629bSTejun Heo  * blk_rq_cur_sectors()		: sectors left in the current segment
8555efccd17STejun Heo  */
8565b93629bSTejun Heo static inline sector_t blk_rq_pos(const struct request *rq)
8575b93629bSTejun Heo {
858a2dec7b3STejun Heo 	return rq->__sector;
8595b93629bSTejun Heo }
8605b93629bSTejun Heo 
8612e46e8b2STejun Heo static inline unsigned int blk_rq_bytes(const struct request *rq)
8622e46e8b2STejun Heo {
863a2dec7b3STejun Heo 	return rq->__data_len;
8642e46e8b2STejun Heo }
8652e46e8b2STejun Heo 
8662e46e8b2STejun Heo static inline int blk_rq_cur_bytes(const struct request *rq)
8672e46e8b2STejun Heo {
8682e46e8b2STejun Heo 	return rq->bio ? bio_cur_bytes(rq->bio) : 0;
8692e46e8b2STejun Heo }
8705efccd17STejun Heo 
87180a761fdSTejun Heo extern unsigned int blk_rq_err_bytes(const struct request *rq);
87280a761fdSTejun Heo 
8735b93629bSTejun Heo static inline unsigned int blk_rq_sectors(const struct request *rq)
8745b93629bSTejun Heo {
8752e46e8b2STejun Heo 	return blk_rq_bytes(rq) >> 9;
8765b93629bSTejun Heo }
8775b93629bSTejun Heo 
8785b93629bSTejun Heo static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
8795b93629bSTejun Heo {
8802e46e8b2STejun Heo 	return blk_rq_cur_bytes(rq) >> 9;
8815b93629bSTejun Heo }
8825b93629bSTejun Heo 
883f31dc1cdSMartin K. Petersen static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
8848fe0d473SMike Christie 						     int op)
885f31dc1cdSMartin K. Petersen {
8868fe0d473SMike Christie 	if (unlikely(op == REQ_OP_DISCARD))
887871dd928SJames Bottomley 		return min(q->limits.max_discard_sectors, UINT_MAX >> 9);
888f31dc1cdSMartin K. Petersen 
8898fe0d473SMike Christie 	if (unlikely(op == REQ_OP_WRITE_SAME))
8904363ac7cSMartin K. Petersen 		return q->limits.max_write_same_sectors;
8914363ac7cSMartin K. Petersen 
892f31dc1cdSMartin K. Petersen 	return q->limits.max_sectors;
893f31dc1cdSMartin K. Petersen }
894f31dc1cdSMartin K. Petersen 
895762380adSJens Axboe /*
896762380adSJens Axboe  * Return maximum size of a request at given offset. Only valid for
897762380adSJens Axboe  * file system requests.
898762380adSJens Axboe  */
899762380adSJens Axboe static inline unsigned int blk_max_size_offset(struct request_queue *q,
900762380adSJens Axboe 					       sector_t offset)
901762380adSJens Axboe {
902762380adSJens Axboe 	if (!q->limits.chunk_sectors)
903736ed4deSJens Axboe 		return q->limits.max_sectors;
904762380adSJens Axboe 
905762380adSJens Axboe 	return q->limits.chunk_sectors -
906762380adSJens Axboe 			(offset & (q->limits.chunk_sectors - 1));
907762380adSJens Axboe }
908762380adSJens Axboe 
909f31dc1cdSMartin K. Petersen static inline unsigned int blk_rq_get_max_sectors(struct request *rq)
910f31dc1cdSMartin K. Petersen {
911f31dc1cdSMartin K. Petersen 	struct request_queue *q = rq->q;
912f31dc1cdSMartin K. Petersen 
913f2101842SChristoph Hellwig 	if (unlikely(rq->cmd_type != REQ_TYPE_FS))
914f31dc1cdSMartin K. Petersen 		return q->limits.max_hw_sectors;
915f31dc1cdSMartin K. Petersen 
9168fe0d473SMike Christie 	if (!q->limits.chunk_sectors || (req_op(rq) == REQ_OP_DISCARD))
9178fe0d473SMike Christie 		return blk_queue_get_max_sectors(q, req_op(rq));
918762380adSJens Axboe 
919762380adSJens Axboe 	return min(blk_max_size_offset(q, blk_rq_pos(rq)),
9208fe0d473SMike Christie 			blk_queue_get_max_sectors(q, req_op(rq)));
921f31dc1cdSMartin K. Petersen }
922f31dc1cdSMartin K. Petersen 
92375afb352SJun'ichi Nomura static inline unsigned int blk_rq_count_bios(struct request *rq)
92475afb352SJun'ichi Nomura {
92575afb352SJun'ichi Nomura 	unsigned int nr_bios = 0;
92675afb352SJun'ichi Nomura 	struct bio *bio;
92775afb352SJun'ichi Nomura 
92875afb352SJun'ichi Nomura 	__rq_for_each_bio(bio, rq)
92975afb352SJun'ichi Nomura 		nr_bios++;
93075afb352SJun'ichi Nomura 
93175afb352SJun'ichi Nomura 	return nr_bios;
93275afb352SJun'ichi Nomura }
93375afb352SJun'ichi Nomura 
9345efccd17STejun Heo /*
9359934c8c0STejun Heo  * Request issue related functions.
9369934c8c0STejun Heo  */
9379934c8c0STejun Heo extern struct request *blk_peek_request(struct request_queue *q);
9389934c8c0STejun Heo extern void blk_start_request(struct request *rq);
9399934c8c0STejun Heo extern struct request *blk_fetch_request(struct request_queue *q);
9409934c8c0STejun Heo 
9419934c8c0STejun Heo /*
9422e60e022STejun Heo  * Request completion related functions.
9432e60e022STejun Heo  *
9442e60e022STejun Heo  * blk_update_request() completes given number of bytes and updates
9452e60e022STejun Heo  * the request without completing it.
9462e60e022STejun Heo  *
947f06d9a2bSTejun Heo  * blk_end_request() and friends.  __blk_end_request() must be called
948f06d9a2bSTejun Heo  * with the request queue spinlock acquired.
9491da177e4SLinus Torvalds  *
9501da177e4SLinus Torvalds  * Several drivers define their own end_request and call
9513bcddeacSKiyoshi Ueda  * blk_end_request() for parts of the original function.
9523bcddeacSKiyoshi Ueda  * This prevents code duplication in drivers.
9531da177e4SLinus Torvalds  */
9542e60e022STejun Heo extern bool blk_update_request(struct request *rq, int error,
95522b13210SJens Axboe 			       unsigned int nr_bytes);
95612120077SChristoph Hellwig extern void blk_finish_request(struct request *rq, int error);
957b1f74493SFUJITA Tomonori extern bool blk_end_request(struct request *rq, int error,
958b1f74493SFUJITA Tomonori 			    unsigned int nr_bytes);
959b1f74493SFUJITA Tomonori extern void blk_end_request_all(struct request *rq, int error);
960b1f74493SFUJITA Tomonori extern bool blk_end_request_cur(struct request *rq, int error);
96180a761fdSTejun Heo extern bool blk_end_request_err(struct request *rq, int error);
962b1f74493SFUJITA Tomonori extern bool __blk_end_request(struct request *rq, int error,
963b1f74493SFUJITA Tomonori 			      unsigned int nr_bytes);
964b1f74493SFUJITA Tomonori extern void __blk_end_request_all(struct request *rq, int error);
965b1f74493SFUJITA Tomonori extern bool __blk_end_request_cur(struct request *rq, int error);
96680a761fdSTejun Heo extern bool __blk_end_request_err(struct request *rq, int error);
9672e60e022STejun Heo 
968ff856badSJens Axboe extern void blk_complete_request(struct request *);
969242f9dcbSJens Axboe extern void __blk_complete_request(struct request *);
970242f9dcbSJens Axboe extern void blk_abort_request(struct request *);
97128018c24SJames Bottomley extern void blk_unprep_request(struct request *);
972ff856badSJens Axboe 
9731da177e4SLinus Torvalds /*
9741da177e4SLinus Torvalds  * Access functions for manipulating queue properties
9751da177e4SLinus Torvalds  */
976165125e1SJens Axboe extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
9771946089aSChristoph Lameter 					spinlock_t *lock, int node_id);
978165125e1SJens Axboe extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
97901effb0dSMike Snitzer extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
98001effb0dSMike Snitzer 						      request_fn_proc *, spinlock_t *);
981165125e1SJens Axboe extern void blk_cleanup_queue(struct request_queue *);
982165125e1SJens Axboe extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
983165125e1SJens Axboe extern void blk_queue_bounce_limit(struct request_queue *, u64);
984086fa5ffSMartin K. Petersen extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
985762380adSJens Axboe extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
9868a78362cSMartin K. Petersen extern void blk_queue_max_segments(struct request_queue *, unsigned short);
987165125e1SJens Axboe extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
98867efc925SChristoph Hellwig extern void blk_queue_max_discard_sectors(struct request_queue *q,
98967efc925SChristoph Hellwig 		unsigned int max_discard_sectors);
9904363ac7cSMartin K. Petersen extern void blk_queue_max_write_same_sectors(struct request_queue *q,
9914363ac7cSMartin K. Petersen 		unsigned int max_write_same_sectors);
992e1defc4fSMartin K. Petersen extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
993892b6f90SMartin K. Petersen extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
994c72758f3SMartin K. Petersen extern void blk_queue_alignment_offset(struct request_queue *q,
995c72758f3SMartin K. Petersen 				       unsigned int alignment);
9967c958e32SMartin K. Petersen extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
997c72758f3SMartin K. Petersen extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
9983c5820c7SMartin K. Petersen extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
999c72758f3SMartin K. Petersen extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
1000e475bba2SMartin K. Petersen extern void blk_set_default_limits(struct queue_limits *lim);
1001b1bd055dSMartin K. Petersen extern void blk_set_stacking_limits(struct queue_limits *lim);
1002c72758f3SMartin K. Petersen extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
1003c72758f3SMartin K. Petersen 			    sector_t offset);
100417be8c24SMartin K. Petersen extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
100517be8c24SMartin K. Petersen 			    sector_t offset);
1006c72758f3SMartin K. Petersen extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
1007c72758f3SMartin K. Petersen 			      sector_t offset);
1008165125e1SJens Axboe extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
1009e3790c7dSTejun Heo extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
101027f8221aSFUJITA Tomonori extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
10112fb98e84STejun Heo extern int blk_queue_dma_drain(struct request_queue *q,
10122fb98e84STejun Heo 			       dma_drain_needed_fn *dma_drain_needed,
10132fb98e84STejun Heo 			       void *buf, unsigned int size);
1014ef9e3facSKiyoshi Ueda extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
1015165125e1SJens Axboe extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
101603100aadSKeith Busch extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
1017165125e1SJens Axboe extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
101828018c24SJames Bottomley extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
1019165125e1SJens Axboe extern void blk_queue_dma_alignment(struct request_queue *, int);
102011c3e689SJames Bottomley extern void blk_queue_update_dma_alignment(struct request_queue *, int);
1021165125e1SJens Axboe extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
1022242f9dcbSJens Axboe extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
1023242f9dcbSJens Axboe extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
1024f3876930S[email protected] extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
102593e9d8e8SJens Axboe extern void blk_queue_write_cache(struct request_queue *q, bool enabled, bool fua);
10261da177e4SLinus Torvalds extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
10271da177e4SLinus Torvalds 
1028165125e1SJens Axboe extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
10291da177e4SLinus Torvalds extern void blk_dump_rq_flags(struct request *, char *);
10301da177e4SLinus Torvalds extern long nr_blockdev_pages(void);
10311da177e4SLinus Torvalds 
103209ac46c4STejun Heo bool __must_check blk_get_queue(struct request_queue *);
1033165125e1SJens Axboe struct request_queue *blk_alloc_queue(gfp_t);
1034165125e1SJens Axboe struct request_queue *blk_alloc_queue_node(gfp_t, int);
1035165125e1SJens Axboe extern void blk_put_queue(struct request_queue *);
10363f21c265SJens Axboe extern void blk_set_queue_dying(struct request_queue *);
10371da177e4SLinus Torvalds 
1038316cc67dSShaohua Li /*
10396c954667SLin Ming  * block layer runtime pm functions
10406c954667SLin Ming  */
104147fafbc7SRafael J. Wysocki #ifdef CONFIG_PM
10426c954667SLin Ming extern void blk_pm_runtime_init(struct request_queue *q, struct device *dev);
10436c954667SLin Ming extern int blk_pre_runtime_suspend(struct request_queue *q);
10446c954667SLin Ming extern void blk_post_runtime_suspend(struct request_queue *q, int err);
10456c954667SLin Ming extern void blk_pre_runtime_resume(struct request_queue *q);
10466c954667SLin Ming extern void blk_post_runtime_resume(struct request_queue *q, int err);
1047d07ab6d1SMika Westerberg extern void blk_set_runtime_active(struct request_queue *q);
10486c954667SLin Ming #else
10496c954667SLin Ming static inline void blk_pm_runtime_init(struct request_queue *q,
10506c954667SLin Ming 	struct device *dev) {}
10516c954667SLin Ming static inline int blk_pre_runtime_suspend(struct request_queue *q)
10526c954667SLin Ming {
10536c954667SLin Ming 	return -ENOSYS;
10546c954667SLin Ming }
10556c954667SLin Ming static inline void blk_post_runtime_suspend(struct request_queue *q, int err) {}
10566c954667SLin Ming static inline void blk_pre_runtime_resume(struct request_queue *q) {}
10576c954667SLin Ming static inline void blk_post_runtime_resume(struct request_queue *q, int err) {}
1058d07ab6d1SMika Westerberg extern inline void blk_set_runtime_active(struct request_queue *q) {}
10596c954667SLin Ming #endif
10606c954667SLin Ming 
10616c954667SLin Ming /*
106275df7136SSuresh Jayaraman  * blk_plug permits building a queue of related requests by holding the I/O
106375df7136SSuresh Jayaraman  * fragments for a short period. This allows merging of sequential requests
106475df7136SSuresh Jayaraman  * into single larger request. As the requests are moved from a per-task list to
106575df7136SSuresh Jayaraman  * the device's request_queue in a batch, this results in improved scalability
106675df7136SSuresh Jayaraman  * as the lock contention for request_queue lock is reduced.
106775df7136SSuresh Jayaraman  *
106875df7136SSuresh Jayaraman  * It is ok not to disable preemption when adding the request to the plug list
106975df7136SSuresh Jayaraman  * or when attempting a merge, because blk_schedule_flush_list() will only flush
107075df7136SSuresh Jayaraman  * the plug list when the task sleeps by itself. For details, please see
107175df7136SSuresh Jayaraman  * schedule() where blk_schedule_flush_plug() is called.
1072316cc67dSShaohua Li  */
107373c10101SJens Axboe struct blk_plug {
107475df7136SSuresh Jayaraman 	struct list_head list; /* requests */
1075320ae51fSJens Axboe 	struct list_head mq_list; /* blk-mq requests */
107675df7136SSuresh Jayaraman 	struct list_head cb_list; /* md requires an unplug callback */
107773c10101SJens Axboe };
107855c022bbSShaohua Li #define BLK_MAX_REQUEST_COUNT 16
107955c022bbSShaohua Li 
10809cbb1750SNeilBrown struct blk_plug_cb;
108174018dc3SNeilBrown typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
1082048c9374SNeilBrown struct blk_plug_cb {
1083048c9374SNeilBrown 	struct list_head list;
10849cbb1750SNeilBrown 	blk_plug_cb_fn callback;
10859cbb1750SNeilBrown 	void *data;
1086048c9374SNeilBrown };
10879cbb1750SNeilBrown extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
10889cbb1750SNeilBrown 					     void *data, int size);
108973c10101SJens Axboe extern void blk_start_plug(struct blk_plug *);
109073c10101SJens Axboe extern void blk_finish_plug(struct blk_plug *);
1091f6603783SJens Axboe extern void blk_flush_plug_list(struct blk_plug *, bool);
109273c10101SJens Axboe 
109373c10101SJens Axboe static inline void blk_flush_plug(struct task_struct *tsk)
109473c10101SJens Axboe {
109573c10101SJens Axboe 	struct blk_plug *plug = tsk->plug;
109673c10101SJens Axboe 
109788b996cdSChristoph Hellwig 	if (plug)
1098a237c1c5SJens Axboe 		blk_flush_plug_list(plug, false);
1099a237c1c5SJens Axboe }
1100a237c1c5SJens Axboe 
1101a237c1c5SJens Axboe static inline void blk_schedule_flush_plug(struct task_struct *tsk)
1102a237c1c5SJens Axboe {
1103a237c1c5SJens Axboe 	struct blk_plug *plug = tsk->plug;
1104a237c1c5SJens Axboe 
1105a237c1c5SJens Axboe 	if (plug)
1106f6603783SJens Axboe 		blk_flush_plug_list(plug, true);
110773c10101SJens Axboe }
110873c10101SJens Axboe 
110973c10101SJens Axboe static inline bool blk_needs_flush_plug(struct task_struct *tsk)
111073c10101SJens Axboe {
111173c10101SJens Axboe 	struct blk_plug *plug = tsk->plug;
111273c10101SJens Axboe 
1113320ae51fSJens Axboe 	return plug &&
1114320ae51fSJens Axboe 		(!list_empty(&plug->list) ||
1115320ae51fSJens Axboe 		 !list_empty(&plug->mq_list) ||
1116320ae51fSJens Axboe 		 !list_empty(&plug->cb_list));
111773c10101SJens Axboe }
111873c10101SJens Axboe 
11191da177e4SLinus Torvalds /*
11201da177e4SLinus Torvalds  * tag stuff
11211da177e4SLinus Torvalds  */
1122165125e1SJens Axboe extern int blk_queue_start_tag(struct request_queue *, struct request *);
1123165125e1SJens Axboe extern struct request *blk_queue_find_tag(struct request_queue *, int);
1124165125e1SJens Axboe extern void blk_queue_end_tag(struct request_queue *, struct request *);
1125ee1b6f7aSShaohua Li extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *, int);
1126165125e1SJens Axboe extern void blk_queue_free_tags(struct request_queue *);
1127165125e1SJens Axboe extern int blk_queue_resize_tags(struct request_queue *, int);
1128165125e1SJens Axboe extern void blk_queue_invalidate_tags(struct request_queue *);
1129ee1b6f7aSShaohua Li extern struct blk_queue_tag *blk_init_tags(int, int);
1130492dfb48SJames Bottomley extern void blk_free_tags(struct blk_queue_tag *);
11311da177e4SLinus Torvalds 
1132f583f492SDavid C Somayajulu static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
1133f583f492SDavid C Somayajulu 						int tag)
1134f583f492SDavid C Somayajulu {
1135f583f492SDavid C Somayajulu 	if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
1136f583f492SDavid C Somayajulu 		return NULL;
1137f583f492SDavid C Somayajulu 	return bqt->tag_index[tag];
1138f583f492SDavid C Somayajulu }
1139dd3932edSChristoph Hellwig 
1140*e950fdf7SChristoph Hellwig 
1141*e950fdf7SChristoph Hellwig #define BLKDEV_DISCARD_SECURE	(1 << 0)	/* issue a secure erase */
1142*e950fdf7SChristoph Hellwig #define BLKDEV_DISCARD_ZERO	(1 << 1)	/* must reliably zero data */
1143dd3932edSChristoph Hellwig 
1144dd3932edSChristoph Hellwig extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
1145fbd9b09aSDmitry Monakhov extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1146fbd9b09aSDmitry Monakhov 		sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
114738f25255SChristoph Hellwig extern int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1148288dab8aSChristoph Hellwig 		sector_t nr_sects, gfp_t gfp_mask, int flags,
1149469e3216SMike Christie 		struct bio **biop);
11504363ac7cSMartin K. Petersen extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
11514363ac7cSMartin K. Petersen 		sector_t nr_sects, gfp_t gfp_mask, struct page *page);
11523f14d792SDmitry Monakhov extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1153d93ba7a5SMartin K. Petersen 		sector_t nr_sects, gfp_t gfp_mask, bool discard);
11542cf6d26aSChristoph Hellwig static inline int sb_issue_discard(struct super_block *sb, sector_t block,
11552cf6d26aSChristoph Hellwig 		sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
1156fb2dce86SDavid Woodhouse {
11572cf6d26aSChristoph Hellwig 	return blkdev_issue_discard(sb->s_bdev, block << (sb->s_blocksize_bits - 9),
11582cf6d26aSChristoph Hellwig 				    nr_blocks << (sb->s_blocksize_bits - 9),
11592cf6d26aSChristoph Hellwig 				    gfp_mask, flags);
1160fb2dce86SDavid Woodhouse }
1161e6fa0be6SLukas Czerner static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
1162a107e5a3STheodore Ts'o 		sector_t nr_blocks, gfp_t gfp_mask)
1163e6fa0be6SLukas Czerner {
1164e6fa0be6SLukas Czerner 	return blkdev_issue_zeroout(sb->s_bdev,
1165e6fa0be6SLukas Czerner 				    block << (sb->s_blocksize_bits - 9),
1166e6fa0be6SLukas Czerner 				    nr_blocks << (sb->s_blocksize_bits - 9),
1167d93ba7a5SMartin K. Petersen 				    gfp_mask, true);
1168e6fa0be6SLukas Czerner }
11691da177e4SLinus Torvalds 
1170018e0446SJens Axboe extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
11710b07de85SAdel Gadllah 
1172eb28d31bSMartin K. Petersen enum blk_default_limits {
1173eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENTS	= 128,
1174eb28d31bSMartin K. Petersen 	BLK_SAFE_MAX_SECTORS	= 255,
1175d2be537cSJeff Moyer 	BLK_DEF_MAX_SECTORS	= 2560,
1176eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENT_SIZE	= 65536,
1177eb28d31bSMartin K. Petersen 	BLK_SEG_BOUNDARY_MASK	= 0xFFFFFFFFUL,
1178eb28d31bSMartin K. Petersen };
11790e435ac2SMilan Broz 
11801da177e4SLinus Torvalds #define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
11811da177e4SLinus Torvalds 
1182ae03bf63SMartin K. Petersen static inline unsigned long queue_bounce_pfn(struct request_queue *q)
1183ae03bf63SMartin K. Petersen {
1184025146e1SMartin K. Petersen 	return q->limits.bounce_pfn;
1185ae03bf63SMartin K. Petersen }
1186ae03bf63SMartin K. Petersen 
1187ae03bf63SMartin K. Petersen static inline unsigned long queue_segment_boundary(struct request_queue *q)
1188ae03bf63SMartin K. Petersen {
1189025146e1SMartin K. Petersen 	return q->limits.seg_boundary_mask;
1190ae03bf63SMartin K. Petersen }
1191ae03bf63SMartin K. Petersen 
119203100aadSKeith Busch static inline unsigned long queue_virt_boundary(struct request_queue *q)
119303100aadSKeith Busch {
119403100aadSKeith Busch 	return q->limits.virt_boundary_mask;
119503100aadSKeith Busch }
119603100aadSKeith Busch 
1197ae03bf63SMartin K. Petersen static inline unsigned int queue_max_sectors(struct request_queue *q)
1198ae03bf63SMartin K. Petersen {
1199025146e1SMartin K. Petersen 	return q->limits.max_sectors;
1200ae03bf63SMartin K. Petersen }
1201ae03bf63SMartin K. Petersen 
1202ae03bf63SMartin K. Petersen static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1203ae03bf63SMartin K. Petersen {
1204025146e1SMartin K. Petersen 	return q->limits.max_hw_sectors;
1205ae03bf63SMartin K. Petersen }
1206ae03bf63SMartin K. Petersen 
12078a78362cSMartin K. Petersen static inline unsigned short queue_max_segments(struct request_queue *q)
1208ae03bf63SMartin K. Petersen {
12098a78362cSMartin K. Petersen 	return q->limits.max_segments;
1210ae03bf63SMartin K. Petersen }
1211ae03bf63SMartin K. Petersen 
1212ae03bf63SMartin K. Petersen static inline unsigned int queue_max_segment_size(struct request_queue *q)
1213ae03bf63SMartin K. Petersen {
1214025146e1SMartin K. Petersen 	return q->limits.max_segment_size;
1215ae03bf63SMartin K. Petersen }
1216ae03bf63SMartin K. Petersen 
1217e1defc4fSMartin K. Petersen static inline unsigned short queue_logical_block_size(struct request_queue *q)
12181da177e4SLinus Torvalds {
12191da177e4SLinus Torvalds 	int retval = 512;
12201da177e4SLinus Torvalds 
1221025146e1SMartin K. Petersen 	if (q && q->limits.logical_block_size)
1222025146e1SMartin K. Petersen 		retval = q->limits.logical_block_size;
12231da177e4SLinus Torvalds 
12241da177e4SLinus Torvalds 	return retval;
12251da177e4SLinus Torvalds }
12261da177e4SLinus Torvalds 
1227e1defc4fSMartin K. Petersen static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
12281da177e4SLinus Torvalds {
1229e1defc4fSMartin K. Petersen 	return queue_logical_block_size(bdev_get_queue(bdev));
12301da177e4SLinus Torvalds }
12311da177e4SLinus Torvalds 
1232c72758f3SMartin K. Petersen static inline unsigned int queue_physical_block_size(struct request_queue *q)
1233c72758f3SMartin K. Petersen {
1234c72758f3SMartin K. Petersen 	return q->limits.physical_block_size;
1235c72758f3SMartin K. Petersen }
1236c72758f3SMartin K. Petersen 
1237892b6f90SMartin K. Petersen static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
1238ac481c20SMartin K. Petersen {
1239ac481c20SMartin K. Petersen 	return queue_physical_block_size(bdev_get_queue(bdev));
1240ac481c20SMartin K. Petersen }
1241ac481c20SMartin K. Petersen 
1242c72758f3SMartin K. Petersen static inline unsigned int queue_io_min(struct request_queue *q)
1243c72758f3SMartin K. Petersen {
1244c72758f3SMartin K. Petersen 	return q->limits.io_min;
1245c72758f3SMartin K. Petersen }
1246c72758f3SMartin K. Petersen 
1247ac481c20SMartin K. Petersen static inline int bdev_io_min(struct block_device *bdev)
1248ac481c20SMartin K. Petersen {
1249ac481c20SMartin K. Petersen 	return queue_io_min(bdev_get_queue(bdev));
1250ac481c20SMartin K. Petersen }
1251ac481c20SMartin K. Petersen 
1252c72758f3SMartin K. Petersen static inline unsigned int queue_io_opt(struct request_queue *q)
1253c72758f3SMartin K. Petersen {
1254c72758f3SMartin K. Petersen 	return q->limits.io_opt;
1255c72758f3SMartin K. Petersen }
1256c72758f3SMartin K. Petersen 
1257ac481c20SMartin K. Petersen static inline int bdev_io_opt(struct block_device *bdev)
1258ac481c20SMartin K. Petersen {
1259ac481c20SMartin K. Petersen 	return queue_io_opt(bdev_get_queue(bdev));
1260ac481c20SMartin K. Petersen }
1261ac481c20SMartin K. Petersen 
1262c72758f3SMartin K. Petersen static inline int queue_alignment_offset(struct request_queue *q)
1263c72758f3SMartin K. Petersen {
1264ac481c20SMartin K. Petersen 	if (q->limits.misaligned)
1265c72758f3SMartin K. Petersen 		return -1;
1266c72758f3SMartin K. Petersen 
1267c72758f3SMartin K. Petersen 	return q->limits.alignment_offset;
1268c72758f3SMartin K. Petersen }
1269c72758f3SMartin K. Petersen 
1270e03a72e1SMartin K. Petersen static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
127181744ee4SMartin K. Petersen {
127281744ee4SMartin K. Petersen 	unsigned int granularity = max(lim->physical_block_size, lim->io_min);
1273b8839b8cSMike Snitzer 	unsigned int alignment = sector_div(sector, granularity >> 9) << 9;
127481744ee4SMartin K. Petersen 
1275b8839b8cSMike Snitzer 	return (granularity + lim->alignment_offset - alignment) % granularity;
1276c72758f3SMartin K. Petersen }
1277c72758f3SMartin K. Petersen 
1278ac481c20SMartin K. Petersen static inline int bdev_alignment_offset(struct block_device *bdev)
1279ac481c20SMartin K. Petersen {
1280ac481c20SMartin K. Petersen 	struct request_queue *q = bdev_get_queue(bdev);
1281ac481c20SMartin K. Petersen 
1282ac481c20SMartin K. Petersen 	if (q->limits.misaligned)
1283ac481c20SMartin K. Petersen 		return -1;
1284ac481c20SMartin K. Petersen 
1285ac481c20SMartin K. Petersen 	if (bdev != bdev->bd_contains)
1286ac481c20SMartin K. Petersen 		return bdev->bd_part->alignment_offset;
1287ac481c20SMartin K. Petersen 
1288ac481c20SMartin K. Petersen 	return q->limits.alignment_offset;
1289ac481c20SMartin K. Petersen }
1290ac481c20SMartin K. Petersen 
129186b37281SMartin K. Petersen static inline int queue_discard_alignment(struct request_queue *q)
129286b37281SMartin K. Petersen {
129386b37281SMartin K. Petersen 	if (q->limits.discard_misaligned)
129486b37281SMartin K. Petersen 		return -1;
129586b37281SMartin K. Petersen 
129686b37281SMartin K. Petersen 	return q->limits.discard_alignment;
129786b37281SMartin K. Petersen }
129886b37281SMartin K. Petersen 
1299e03a72e1SMartin K. Petersen static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
130086b37281SMartin K. Petersen {
130159771079SLinus Torvalds 	unsigned int alignment, granularity, offset;
1302dd3d145dSMartin K. Petersen 
1303a934a00aSMartin K. Petersen 	if (!lim->max_discard_sectors)
1304a934a00aSMartin K. Petersen 		return 0;
1305a934a00aSMartin K. Petersen 
130659771079SLinus Torvalds 	/* Why are these in bytes, not sectors? */
130759771079SLinus Torvalds 	alignment = lim->discard_alignment >> 9;
130859771079SLinus Torvalds 	granularity = lim->discard_granularity >> 9;
130959771079SLinus Torvalds 	if (!granularity)
131059771079SLinus Torvalds 		return 0;
131159771079SLinus Torvalds 
131259771079SLinus Torvalds 	/* Offset of the partition start in 'granularity' sectors */
131359771079SLinus Torvalds 	offset = sector_div(sector, granularity);
131459771079SLinus Torvalds 
131559771079SLinus Torvalds 	/* And why do we do this modulus *again* in blkdev_issue_discard()? */
131659771079SLinus Torvalds 	offset = (granularity + alignment - offset) % granularity;
131759771079SLinus Torvalds 
131859771079SLinus Torvalds 	/* Turn it back into bytes, gaah */
131959771079SLinus Torvalds 	return offset << 9;
132086b37281SMartin K. Petersen }
132186b37281SMartin K. Petersen 
1322c6e66634SPaolo Bonzini static inline int bdev_discard_alignment(struct block_device *bdev)
1323c6e66634SPaolo Bonzini {
1324c6e66634SPaolo Bonzini 	struct request_queue *q = bdev_get_queue(bdev);
1325c6e66634SPaolo Bonzini 
1326c6e66634SPaolo Bonzini 	if (bdev != bdev->bd_contains)
1327c6e66634SPaolo Bonzini 		return bdev->bd_part->discard_alignment;
1328c6e66634SPaolo Bonzini 
1329c6e66634SPaolo Bonzini 	return q->limits.discard_alignment;
1330c6e66634SPaolo Bonzini }
1331c6e66634SPaolo Bonzini 
133298262f27SMartin K. Petersen static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
133398262f27SMartin K. Petersen {
1334a934a00aSMartin K. Petersen 	if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
133598262f27SMartin K. Petersen 		return 1;
133698262f27SMartin K. Petersen 
133798262f27SMartin K. Petersen 	return 0;
133898262f27SMartin K. Petersen }
133998262f27SMartin K. Petersen 
134098262f27SMartin K. Petersen static inline unsigned int bdev_discard_zeroes_data(struct block_device *bdev)
134198262f27SMartin K. Petersen {
134298262f27SMartin K. Petersen 	return queue_discard_zeroes_data(bdev_get_queue(bdev));
134398262f27SMartin K. Petersen }
134498262f27SMartin K. Petersen 
13454363ac7cSMartin K. Petersen static inline unsigned int bdev_write_same(struct block_device *bdev)
13464363ac7cSMartin K. Petersen {
13474363ac7cSMartin K. Petersen 	struct request_queue *q = bdev_get_queue(bdev);
13484363ac7cSMartin K. Petersen 
13494363ac7cSMartin K. Petersen 	if (q)
13504363ac7cSMartin K. Petersen 		return q->limits.max_write_same_sectors;
13514363ac7cSMartin K. Petersen 
13524363ac7cSMartin K. Petersen 	return 0;
13534363ac7cSMartin K. Petersen }
13544363ac7cSMartin K. Petersen 
1355165125e1SJens Axboe static inline int queue_dma_alignment(struct request_queue *q)
13561da177e4SLinus Torvalds {
1357482eb689SPete Wyckoff 	return q ? q->dma_alignment : 511;
13581da177e4SLinus Torvalds }
13591da177e4SLinus Torvalds 
136014417799SNamhyung Kim static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
136187904074SFUJITA Tomonori 				 unsigned int len)
136287904074SFUJITA Tomonori {
136387904074SFUJITA Tomonori 	unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
136414417799SNamhyung Kim 	return !(addr & alignment) && !(len & alignment);
136587904074SFUJITA Tomonori }
136687904074SFUJITA Tomonori 
13671da177e4SLinus Torvalds /* assumes size > 256 */
13681da177e4SLinus Torvalds static inline unsigned int blksize_bits(unsigned int size)
13691da177e4SLinus Torvalds {
13701da177e4SLinus Torvalds 	unsigned int bits = 8;
13711da177e4SLinus Torvalds 	do {
13721da177e4SLinus Torvalds 		bits++;
13731da177e4SLinus Torvalds 		size >>= 1;
13741da177e4SLinus Torvalds 	} while (size > 256);
13751da177e4SLinus Torvalds 	return bits;
13761da177e4SLinus Torvalds }
13771da177e4SLinus Torvalds 
13782befb9e3SAdrian Bunk static inline unsigned int block_size(struct block_device *bdev)
13791da177e4SLinus Torvalds {
13801da177e4SLinus Torvalds 	return bdev->bd_block_size;
13811da177e4SLinus Torvalds }
13821da177e4SLinus Torvalds 
1383f3876930S[email protected] static inline bool queue_flush_queueable(struct request_queue *q)
1384f3876930S[email protected] {
1385c888a8f9SJens Axboe 	return !test_bit(QUEUE_FLAG_FLUSH_NQ, &q->queue_flags);
1386f3876930S[email protected] }
1387f3876930S[email protected] 
13881da177e4SLinus Torvalds typedef struct {struct page *v;} Sector;
13891da177e4SLinus Torvalds 
13901da177e4SLinus Torvalds unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
13911da177e4SLinus Torvalds 
13921da177e4SLinus Torvalds static inline void put_dev_sector(Sector p)
13931da177e4SLinus Torvalds {
139409cbfeafSKirill A. Shutemov 	put_page(p.v);
13951da177e4SLinus Torvalds }
13961da177e4SLinus Torvalds 
1397e0af2917SMing Lei static inline bool __bvec_gap_to_prev(struct request_queue *q,
1398e0af2917SMing Lei 				struct bio_vec *bprv, unsigned int offset)
1399e0af2917SMing Lei {
1400e0af2917SMing Lei 	return offset ||
1401e0af2917SMing Lei 		((bprv->bv_offset + bprv->bv_len) & queue_virt_boundary(q));
1402e0af2917SMing Lei }
1403e0af2917SMing Lei 
140403100aadSKeith Busch /*
140503100aadSKeith Busch  * Check if adding a bio_vec after bprv with offset would create a gap in
140603100aadSKeith Busch  * the SG list. Most drivers don't care about this, but some do.
140703100aadSKeith Busch  */
140803100aadSKeith Busch static inline bool bvec_gap_to_prev(struct request_queue *q,
140903100aadSKeith Busch 				struct bio_vec *bprv, unsigned int offset)
141003100aadSKeith Busch {
141103100aadSKeith Busch 	if (!queue_virt_boundary(q))
141203100aadSKeith Busch 		return false;
1413e0af2917SMing Lei 	return __bvec_gap_to_prev(q, bprv, offset);
141403100aadSKeith Busch }
141503100aadSKeith Busch 
14165e7c4274SJens Axboe static inline bool bio_will_gap(struct request_queue *q, struct bio *prev,
14175e7c4274SJens Axboe 			 struct bio *next)
14185e7c4274SJens Axboe {
141925e71a99SMing Lei 	if (bio_has_data(prev) && queue_virt_boundary(q)) {
142025e71a99SMing Lei 		struct bio_vec pb, nb;
14215e7c4274SJens Axboe 
142225e71a99SMing Lei 		bio_get_last_bvec(prev, &pb);
142325e71a99SMing Lei 		bio_get_first_bvec(next, &nb);
142425e71a99SMing Lei 
142525e71a99SMing Lei 		return __bvec_gap_to_prev(q, &pb, nb.bv_offset);
142625e71a99SMing Lei 	}
142725e71a99SMing Lei 
142825e71a99SMing Lei 	return false;
14295e7c4274SJens Axboe }
14305e7c4274SJens Axboe 
14315e7c4274SJens Axboe static inline bool req_gap_back_merge(struct request *req, struct bio *bio)
14325e7c4274SJens Axboe {
14335e7c4274SJens Axboe 	return bio_will_gap(req->q, req->biotail, bio);
14345e7c4274SJens Axboe }
14355e7c4274SJens Axboe 
14365e7c4274SJens Axboe static inline bool req_gap_front_merge(struct request *req, struct bio *bio)
14375e7c4274SJens Axboe {
14385e7c4274SJens Axboe 	return bio_will_gap(req->q, bio, req->bio);
14395e7c4274SJens Axboe }
14405e7c4274SJens Axboe 
14411da177e4SLinus Torvalds struct work_struct;
144259c3d45eSJens Axboe int kblockd_schedule_work(struct work_struct *work);
144359c3d45eSJens Axboe int kblockd_schedule_delayed_work(struct delayed_work *dwork, unsigned long delay);
14448ab14595SJens Axboe int kblockd_schedule_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
14451da177e4SLinus Torvalds 
14469195291eSDivyesh Shah #ifdef CONFIG_BLK_CGROUP
144728f4197eSJens Axboe /*
144828f4197eSJens Axboe  * This should not be using sched_clock(). A real patch is in progress
144928f4197eSJens Axboe  * to fix this up, until that is in place we need to disable preemption
145028f4197eSJens Axboe  * around sched_clock() in this function and set_io_start_time_ns().
145128f4197eSJens Axboe  */
14529195291eSDivyesh Shah static inline void set_start_time_ns(struct request *req)
14539195291eSDivyesh Shah {
145428f4197eSJens Axboe 	preempt_disable();
14559195291eSDivyesh Shah 	req->start_time_ns = sched_clock();
145628f4197eSJens Axboe 	preempt_enable();
14579195291eSDivyesh Shah }
14589195291eSDivyesh Shah 
14599195291eSDivyesh Shah static inline void set_io_start_time_ns(struct request *req)
14609195291eSDivyesh Shah {
146128f4197eSJens Axboe 	preempt_disable();
14629195291eSDivyesh Shah 	req->io_start_time_ns = sched_clock();
146328f4197eSJens Axboe 	preempt_enable();
14649195291eSDivyesh Shah }
146584c124daSDivyesh Shah 
146684c124daSDivyesh Shah static inline uint64_t rq_start_time_ns(struct request *req)
146784c124daSDivyesh Shah {
146884c124daSDivyesh Shah         return req->start_time_ns;
146984c124daSDivyesh Shah }
147084c124daSDivyesh Shah 
147184c124daSDivyesh Shah static inline uint64_t rq_io_start_time_ns(struct request *req)
147284c124daSDivyesh Shah {
147384c124daSDivyesh Shah         return req->io_start_time_ns;
147484c124daSDivyesh Shah }
14759195291eSDivyesh Shah #else
14769195291eSDivyesh Shah static inline void set_start_time_ns(struct request *req) {}
14779195291eSDivyesh Shah static inline void set_io_start_time_ns(struct request *req) {}
147884c124daSDivyesh Shah static inline uint64_t rq_start_time_ns(struct request *req)
147984c124daSDivyesh Shah {
148084c124daSDivyesh Shah 	return 0;
148184c124daSDivyesh Shah }
148284c124daSDivyesh Shah static inline uint64_t rq_io_start_time_ns(struct request *req)
148384c124daSDivyesh Shah {
148484c124daSDivyesh Shah 	return 0;
148584c124daSDivyesh Shah }
14869195291eSDivyesh Shah #endif
14879195291eSDivyesh Shah 
14881da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV(major,minor) \
14891da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
14901da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
14911da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-*")
14921da177e4SLinus Torvalds 
14937ba1ba12SMartin K. Petersen #if defined(CONFIG_BLK_DEV_INTEGRITY)
14947ba1ba12SMartin K. Petersen 
14958288f496SMartin K. Petersen enum blk_integrity_flags {
14968288f496SMartin K. Petersen 	BLK_INTEGRITY_VERIFY		= 1 << 0,
14978288f496SMartin K. Petersen 	BLK_INTEGRITY_GENERATE		= 1 << 1,
14983aec2f41SMartin K. Petersen 	BLK_INTEGRITY_DEVICE_CAPABLE	= 1 << 2,
1499aae7df50SMartin K. Petersen 	BLK_INTEGRITY_IP_CHECKSUM	= 1 << 3,
15008288f496SMartin K. Petersen };
15017ba1ba12SMartin K. Petersen 
150218593088SMartin K. Petersen struct blk_integrity_iter {
15037ba1ba12SMartin K. Petersen 	void			*prot_buf;
15047ba1ba12SMartin K. Petersen 	void			*data_buf;
15053be91c4aSMartin K. Petersen 	sector_t		seed;
15067ba1ba12SMartin K. Petersen 	unsigned int		data_size;
15073be91c4aSMartin K. Petersen 	unsigned short		interval;
15087ba1ba12SMartin K. Petersen 	const char		*disk_name;
15097ba1ba12SMartin K. Petersen };
15107ba1ba12SMartin K. Petersen 
151118593088SMartin K. Petersen typedef int (integrity_processing_fn) (struct blk_integrity_iter *);
15127ba1ba12SMartin K. Petersen 
15130f8087ecSMartin K. Petersen struct blk_integrity_profile {
151418593088SMartin K. Petersen 	integrity_processing_fn		*generate_fn;
151518593088SMartin K. Petersen 	integrity_processing_fn		*verify_fn;
15160f8087ecSMartin K. Petersen 	const char			*name;
15170f8087ecSMartin K. Petersen };
15187ba1ba12SMartin K. Petersen 
151925520d55SMartin K. Petersen extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
15207ba1ba12SMartin K. Petersen extern void blk_integrity_unregister(struct gendisk *);
1521ad7fce93SMartin K. Petersen extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
152213f05c8dSMartin K. Petersen extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
152313f05c8dSMartin K. Petersen 				   struct scatterlist *);
152413f05c8dSMartin K. Petersen extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
15254eaf99beSMartin K. Petersen extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
152613f05c8dSMartin K. Petersen 				   struct request *);
15274eaf99beSMartin K. Petersen extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
152813f05c8dSMartin K. Petersen 				    struct bio *);
15297ba1ba12SMartin K. Petersen 
153025520d55SMartin K. Petersen static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
153125520d55SMartin K. Petersen {
1532ac6fc48cSDan Williams 	struct blk_integrity *bi = &disk->queue->integrity;
153325520d55SMartin K. Petersen 
153425520d55SMartin K. Petersen 	if (!bi->profile)
153525520d55SMartin K. Petersen 		return NULL;
153625520d55SMartin K. Petersen 
153725520d55SMartin K. Petersen 	return bi;
153825520d55SMartin K. Petersen }
153925520d55SMartin K. Petersen 
1540b04accc4SJens Axboe static inline
1541b04accc4SJens Axboe struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1542b04accc4SJens Axboe {
154325520d55SMartin K. Petersen 	return blk_get_integrity(bdev->bd_disk);
1544b02739b0SMartin K. Petersen }
1545b02739b0SMartin K. Petersen 
1546180b2f95SMartin K. Petersen static inline bool blk_integrity_rq(struct request *rq)
15477ba1ba12SMartin K. Petersen {
1548180b2f95SMartin K. Petersen 	return rq->cmd_flags & REQ_INTEGRITY;
15497ba1ba12SMartin K. Petersen }
15507ba1ba12SMartin K. Petersen 
155113f05c8dSMartin K. Petersen static inline void blk_queue_max_integrity_segments(struct request_queue *q,
155213f05c8dSMartin K. Petersen 						    unsigned int segs)
155313f05c8dSMartin K. Petersen {
155413f05c8dSMartin K. Petersen 	q->limits.max_integrity_segments = segs;
155513f05c8dSMartin K. Petersen }
155613f05c8dSMartin K. Petersen 
155713f05c8dSMartin K. Petersen static inline unsigned short
155813f05c8dSMartin K. Petersen queue_max_integrity_segments(struct request_queue *q)
155913f05c8dSMartin K. Petersen {
156013f05c8dSMartin K. Petersen 	return q->limits.max_integrity_segments;
156113f05c8dSMartin K. Petersen }
156213f05c8dSMartin K. Petersen 
15637f39add3SSagi Grimberg static inline bool integrity_req_gap_back_merge(struct request *req,
15647f39add3SSagi Grimberg 						struct bio *next)
15657f39add3SSagi Grimberg {
15667f39add3SSagi Grimberg 	struct bio_integrity_payload *bip = bio_integrity(req->bio);
15677f39add3SSagi Grimberg 	struct bio_integrity_payload *bip_next = bio_integrity(next);
15687f39add3SSagi Grimberg 
15697f39add3SSagi Grimberg 	return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
15707f39add3SSagi Grimberg 				bip_next->bip_vec[0].bv_offset);
15717f39add3SSagi Grimberg }
15727f39add3SSagi Grimberg 
15737f39add3SSagi Grimberg static inline bool integrity_req_gap_front_merge(struct request *req,
15747f39add3SSagi Grimberg 						 struct bio *bio)
15757f39add3SSagi Grimberg {
15767f39add3SSagi Grimberg 	struct bio_integrity_payload *bip = bio_integrity(bio);
15777f39add3SSagi Grimberg 	struct bio_integrity_payload *bip_next = bio_integrity(req->bio);
15787f39add3SSagi Grimberg 
15797f39add3SSagi Grimberg 	return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
15807f39add3SSagi Grimberg 				bip_next->bip_vec[0].bv_offset);
15817f39add3SSagi Grimberg }
15827f39add3SSagi Grimberg 
15837ba1ba12SMartin K. Petersen #else /* CONFIG_BLK_DEV_INTEGRITY */
15847ba1ba12SMartin K. Petersen 
1585fd83240aSStephen Rothwell struct bio;
1586fd83240aSStephen Rothwell struct block_device;
1587fd83240aSStephen Rothwell struct gendisk;
1588fd83240aSStephen Rothwell struct blk_integrity;
1589fd83240aSStephen Rothwell 
1590fd83240aSStephen Rothwell static inline int blk_integrity_rq(struct request *rq)
1591fd83240aSStephen Rothwell {
1592fd83240aSStephen Rothwell 	return 0;
1593fd83240aSStephen Rothwell }
1594fd83240aSStephen Rothwell static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1595fd83240aSStephen Rothwell 					    struct bio *b)
1596fd83240aSStephen Rothwell {
1597fd83240aSStephen Rothwell 	return 0;
1598fd83240aSStephen Rothwell }
1599fd83240aSStephen Rothwell static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1600fd83240aSStephen Rothwell 					  struct bio *b,
1601fd83240aSStephen Rothwell 					  struct scatterlist *s)
1602fd83240aSStephen Rothwell {
1603fd83240aSStephen Rothwell 	return 0;
1604fd83240aSStephen Rothwell }
1605fd83240aSStephen Rothwell static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1606fd83240aSStephen Rothwell {
160761a04e5bSMichele Curti 	return NULL;
1608fd83240aSStephen Rothwell }
1609fd83240aSStephen Rothwell static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1610fd83240aSStephen Rothwell {
1611fd83240aSStephen Rothwell 	return NULL;
1612fd83240aSStephen Rothwell }
1613fd83240aSStephen Rothwell static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1614fd83240aSStephen Rothwell {
1615fd83240aSStephen Rothwell 	return 0;
1616fd83240aSStephen Rothwell }
161725520d55SMartin K. Petersen static inline void blk_integrity_register(struct gendisk *d,
1618fd83240aSStephen Rothwell 					 struct blk_integrity *b)
1619fd83240aSStephen Rothwell {
1620fd83240aSStephen Rothwell }
1621fd83240aSStephen Rothwell static inline void blk_integrity_unregister(struct gendisk *d)
1622fd83240aSStephen Rothwell {
1623fd83240aSStephen Rothwell }
1624fd83240aSStephen Rothwell static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1625fd83240aSStephen Rothwell 						    unsigned int segs)
1626fd83240aSStephen Rothwell {
1627fd83240aSStephen Rothwell }
1628fd83240aSStephen Rothwell static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1629fd83240aSStephen Rothwell {
1630fd83240aSStephen Rothwell 	return 0;
1631fd83240aSStephen Rothwell }
16324eaf99beSMartin K. Petersen static inline bool blk_integrity_merge_rq(struct request_queue *rq,
1633fd83240aSStephen Rothwell 					  struct request *r1,
1634fd83240aSStephen Rothwell 					  struct request *r2)
1635fd83240aSStephen Rothwell {
1636cb1a5ab6SMartin K. Petersen 	return true;
1637fd83240aSStephen Rothwell }
16384eaf99beSMartin K. Petersen static inline bool blk_integrity_merge_bio(struct request_queue *rq,
1639fd83240aSStephen Rothwell 					   struct request *r,
1640fd83240aSStephen Rothwell 					   struct bio *b)
1641fd83240aSStephen Rothwell {
1642cb1a5ab6SMartin K. Petersen 	return true;
1643fd83240aSStephen Rothwell }
164425520d55SMartin K. Petersen 
16457f39add3SSagi Grimberg static inline bool integrity_req_gap_back_merge(struct request *req,
16467f39add3SSagi Grimberg 						struct bio *next)
16477f39add3SSagi Grimberg {
16487f39add3SSagi Grimberg 	return false;
16497f39add3SSagi Grimberg }
16507f39add3SSagi Grimberg static inline bool integrity_req_gap_front_merge(struct request *req,
16517f39add3SSagi Grimberg 						 struct bio *bio)
16527f39add3SSagi Grimberg {
16537f39add3SSagi Grimberg 	return false;
16547f39add3SSagi Grimberg }
16557ba1ba12SMartin K. Petersen 
16567ba1ba12SMartin K. Petersen #endif /* CONFIG_BLK_DEV_INTEGRITY */
16577ba1ba12SMartin K. Petersen 
1658b2e0d162SDan Williams /**
1659b2e0d162SDan Williams  * struct blk_dax_ctl - control and output parameters for ->direct_access
1660b2e0d162SDan Williams  * @sector: (input) offset relative to a block_device
1661b2e0d162SDan Williams  * @addr: (output) kernel virtual address for @sector populated by driver
1662b2e0d162SDan Williams  * @pfn: (output) page frame number for @addr populated by driver
1663b2e0d162SDan Williams  * @size: (input) number of bytes requested
1664b2e0d162SDan Williams  */
1665b2e0d162SDan Williams struct blk_dax_ctl {
1666b2e0d162SDan Williams 	sector_t sector;
1667b2e0d162SDan Williams 	void __pmem *addr;
1668b2e0d162SDan Williams 	long size;
166934c0fd54SDan Williams 	pfn_t pfn;
1670b2e0d162SDan Williams };
1671b2e0d162SDan Williams 
167208f85851SAl Viro struct block_device_operations {
1673d4430d62SAl Viro 	int (*open) (struct block_device *, fmode_t);
1674db2a144bSAl Viro 	void (*release) (struct gendisk *, fmode_t);
167547a191fdSMatthew Wilcox 	int (*rw_page)(struct block_device *, sector_t, struct page *, int rw);
1676d4430d62SAl Viro 	int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1677d4430d62SAl Viro 	int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1678e2e05394SRoss Zwisler 	long (*direct_access)(struct block_device *, sector_t, void __pmem **,
16790a70bd43SDan Williams 			pfn_t *, long);
168077ea887eSTejun Heo 	unsigned int (*check_events) (struct gendisk *disk,
168177ea887eSTejun Heo 				      unsigned int clearing);
168277ea887eSTejun Heo 	/* ->media_changed() is DEPRECATED, use ->check_events() instead */
168308f85851SAl Viro 	int (*media_changed) (struct gendisk *);
1684c3e33e04STejun Heo 	void (*unlock_native_capacity) (struct gendisk *);
168508f85851SAl Viro 	int (*revalidate_disk) (struct gendisk *);
168608f85851SAl Viro 	int (*getgeo)(struct block_device *, struct hd_geometry *);
1687b3a27d05SNitin Gupta 	/* this callback is with swap_lock and sometimes page table lock held */
1688b3a27d05SNitin Gupta 	void (*swap_slot_free_notify) (struct block_device *, unsigned long);
168908f85851SAl Viro 	struct module *owner;
1690bbd3e064SChristoph Hellwig 	const struct pr_ops *pr_ops;
169108f85851SAl Viro };
169208f85851SAl Viro 
1693633a08b8SAl Viro extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1694633a08b8SAl Viro 				 unsigned long);
169547a191fdSMatthew Wilcox extern int bdev_read_page(struct block_device *, sector_t, struct page *);
169647a191fdSMatthew Wilcox extern int bdev_write_page(struct block_device *, sector_t, struct page *,
169747a191fdSMatthew Wilcox 						struct writeback_control *);
1698b2e0d162SDan Williams extern long bdev_direct_access(struct block_device *, struct blk_dax_ctl *);
16992d96afc8SToshi Kani extern int bdev_dax_supported(struct super_block *, int);
1700a8078b1fSToshi Kani extern bool bdev_dax_capable(struct block_device *);
17019361401eSDavid Howells #else /* CONFIG_BLOCK */
1702ac13a829SFabian Frederick 
1703ac13a829SFabian Frederick struct block_device;
1704ac13a829SFabian Frederick 
17059361401eSDavid Howells /*
17069361401eSDavid Howells  * stubs for when the block layer is configured out
17079361401eSDavid Howells  */
17089361401eSDavid Howells #define buffer_heads_over_limit 0
17099361401eSDavid Howells 
17109361401eSDavid Howells static inline long nr_blockdev_pages(void)
17119361401eSDavid Howells {
17129361401eSDavid Howells 	return 0;
17139361401eSDavid Howells }
17149361401eSDavid Howells 
17151f940bdfSJens Axboe struct blk_plug {
17161f940bdfSJens Axboe };
17171f940bdfSJens Axboe 
17181f940bdfSJens Axboe static inline void blk_start_plug(struct blk_plug *plug)
171973c10101SJens Axboe {
172073c10101SJens Axboe }
172173c10101SJens Axboe 
17221f940bdfSJens Axboe static inline void blk_finish_plug(struct blk_plug *plug)
172373c10101SJens Axboe {
172473c10101SJens Axboe }
172573c10101SJens Axboe 
17261f940bdfSJens Axboe static inline void blk_flush_plug(struct task_struct *task)
172773c10101SJens Axboe {
172873c10101SJens Axboe }
172973c10101SJens Axboe 
1730a237c1c5SJens Axboe static inline void blk_schedule_flush_plug(struct task_struct *task)
1731a237c1c5SJens Axboe {
1732a237c1c5SJens Axboe }
1733a237c1c5SJens Axboe 
1734a237c1c5SJens Axboe 
173573c10101SJens Axboe static inline bool blk_needs_flush_plug(struct task_struct *tsk)
173673c10101SJens Axboe {
173773c10101SJens Axboe 	return false;
173873c10101SJens Axboe }
173973c10101SJens Axboe 
1740ac13a829SFabian Frederick static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
1741ac13a829SFabian Frederick 				     sector_t *error_sector)
1742ac13a829SFabian Frederick {
1743ac13a829SFabian Frederick 	return 0;
1744ac13a829SFabian Frederick }
1745ac13a829SFabian Frederick 
17469361401eSDavid Howells #endif /* CONFIG_BLOCK */
17479361401eSDavid Howells 
17481da177e4SLinus Torvalds #endif
1749