xref: /linux-6.15/include/linux/blkdev.h (revision b623e347)
1b2441318SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0 */
2322cbb50SChristoph Hellwig /*
3322cbb50SChristoph Hellwig  * Portions Copyright (C) 1992 Drew Eckhardt
4322cbb50SChristoph Hellwig  */
51da177e4SLinus Torvalds #ifndef _LINUX_BLKDEV_H
61da177e4SLinus Torvalds #define _LINUX_BLKDEV_H
71da177e4SLinus Torvalds 
8322cbb50SChristoph Hellwig #include <linux/types.h>
9322cbb50SChristoph Hellwig #include <linux/blk_types.h>
10322cbb50SChristoph Hellwig #include <linux/device.h>
111da177e4SLinus Torvalds #include <linux/list.h>
12320ae51fSJens Axboe #include <linux/llist.h>
13b296a6d5SAndy Shevchenko #include <linux/minmax.h>
141da177e4SLinus Torvalds #include <linux/timer.h>
151da177e4SLinus Torvalds #include <linux/workqueue.h>
161da177e4SLinus Torvalds #include <linux/wait.h>
171da177e4SLinus Torvalds #include <linux/bio.h>
183e6053d7SHugh Dickins #include <linux/gfp.h>
19322cbb50SChristoph Hellwig #include <linux/kdev_t.h>
20548bc8e1STejun Heo #include <linux/rcupdate.h>
21add703fdSTejun Heo #include <linux/percpu-refcount.h>
226a0cb1bcSHannes Reinecke #include <linux/blkzoned.h>
23322cbb50SChristoph Hellwig #include <linux/sched.h>
24d97e594cSJohn Garry #include <linux/sbitmap.h>
25704b914fSMing Lei #include <linux/srcu.h>
26322cbb50SChristoph Hellwig #include <linux/uuid.h>
27322cbb50SChristoph Hellwig #include <linux/xarray.h>
281da177e4SLinus Torvalds 
29de477254SPaul Gortmaker struct module;
301da177e4SLinus Torvalds struct request_queue;
311da177e4SLinus Torvalds struct elevator_queue;
322056a782SJens Axboe struct blk_trace;
333d6392cfSJens Axboe struct request;
343d6392cfSJens Axboe struct sg_io_hdr;
353c798398STejun Heo struct blkcg_gq;
367c94e1c1SMing Lei struct blk_flush_queue;
373e08773cSChristoph Hellwig struct kiocb;
38bbd3e064SChristoph Hellwig struct pr_ops;
39a7905043SJosef Bacik struct rq_qos;
4034dbad5dSOmar Sandoval struct blk_queue_stats;
4134dbad5dSOmar Sandoval struct blk_stat_callback;
42cb77cb5aSEric Biggers struct blk_crypto_profile;
431da177e4SLinus Torvalds 
44322cbb50SChristoph Hellwig extern const struct device_type disk_type;
45322cbb50SChristoph Hellwig extern struct device_type part_type;
46322cbb50SChristoph Hellwig extern struct class block_class;
47322cbb50SChristoph Hellwig 
48096392e0SMinwoo Im /* Must be consistent with blk_mq_poll_stats_bkt() */
490206319fSStephen Bates #define BLK_MQ_POLL_STATS_BKTS 16
500206319fSStephen Bates 
5129ece8b4SYufen Yu /* Doing classic polling */
5229ece8b4SYufen Yu #define BLK_MQ_POLL_CLASSIC -1
5329ece8b4SYufen Yu 
548bd435b3STejun Heo /*
558bd435b3STejun Heo  * Maximum number of blkcg policies allowed to be registered concurrently.
568bd435b3STejun Heo  * Defined here to simplify include dependency.
578bd435b3STejun Heo  */
58ec645dc9SOleksandr Natalenko #define BLKCG_MAX_POLS		6
598bd435b3STejun Heo 
60322cbb50SChristoph Hellwig #define DISK_MAX_PARTS			256
61322cbb50SChristoph Hellwig #define DISK_NAME_LEN			32
62322cbb50SChristoph Hellwig 
63322cbb50SChristoph Hellwig #define PARTITION_META_INFO_VOLNAMELTH	64
64322cbb50SChristoph Hellwig /*
65322cbb50SChristoph Hellwig  * Enough for the string representation of any kind of UUID plus NULL.
66322cbb50SChristoph Hellwig  * EFI UUID is 36 characters. MSDOS UUID is 11 characters.
67322cbb50SChristoph Hellwig  */
68322cbb50SChristoph Hellwig #define PARTITION_META_INFO_UUIDLTH	(UUID_STRING_LEN + 1)
69322cbb50SChristoph Hellwig 
70322cbb50SChristoph Hellwig struct partition_meta_info {
71322cbb50SChristoph Hellwig 	char uuid[PARTITION_META_INFO_UUIDLTH];
72322cbb50SChristoph Hellwig 	u8 volname[PARTITION_META_INFO_VOLNAMELTH];
73322cbb50SChristoph Hellwig };
74322cbb50SChristoph Hellwig 
75322cbb50SChristoph Hellwig /**
76322cbb50SChristoph Hellwig  * DOC: genhd capability flags
77322cbb50SChristoph Hellwig  *
78322cbb50SChristoph Hellwig  * ``GENHD_FL_REMOVABLE``: indicates that the block device gives access to
79322cbb50SChristoph Hellwig  * removable media.  When set, the device remains present even when media is not
80322cbb50SChristoph Hellwig  * inserted.  Shall not be set for devices which are removed entirely when the
81322cbb50SChristoph Hellwig  * media is removed.
82322cbb50SChristoph Hellwig  *
83322cbb50SChristoph Hellwig  * ``GENHD_FL_HIDDEN``: the block device is hidden; it doesn't produce events,
84322cbb50SChristoph Hellwig  * doesn't appear in sysfs, and can't be opened from userspace or using
85322cbb50SChristoph Hellwig  * blkdev_get*. Used for the underlying components of multipath devices.
86322cbb50SChristoph Hellwig  *
87322cbb50SChristoph Hellwig  * ``GENHD_FL_NO_PART``: partition support is disabled.  The kernel will not
88322cbb50SChristoph Hellwig  * scan for partitions from add_disk, and users can't add partitions manually.
89322cbb50SChristoph Hellwig  *
90322cbb50SChristoph Hellwig  */
91322cbb50SChristoph Hellwig enum {
92322cbb50SChristoph Hellwig 	GENHD_FL_REMOVABLE			= 1 << 0,
93322cbb50SChristoph Hellwig 	GENHD_FL_HIDDEN				= 1 << 1,
94322cbb50SChristoph Hellwig 	GENHD_FL_NO_PART			= 1 << 2,
95322cbb50SChristoph Hellwig };
96322cbb50SChristoph Hellwig 
97322cbb50SChristoph Hellwig enum {
98322cbb50SChristoph Hellwig 	DISK_EVENT_MEDIA_CHANGE			= 1 << 0, /* media changed */
99322cbb50SChristoph Hellwig 	DISK_EVENT_EJECT_REQUEST		= 1 << 1, /* eject requested */
100322cbb50SChristoph Hellwig };
101322cbb50SChristoph Hellwig 
102322cbb50SChristoph Hellwig enum {
103322cbb50SChristoph Hellwig 	/* Poll even if events_poll_msecs is unset */
104322cbb50SChristoph Hellwig 	DISK_EVENT_FLAG_POLL			= 1 << 0,
105322cbb50SChristoph Hellwig 	/* Forward events to udev */
106322cbb50SChristoph Hellwig 	DISK_EVENT_FLAG_UEVENT			= 1 << 1,
107322cbb50SChristoph Hellwig 	/* Block event polling when open for exclusive write */
108322cbb50SChristoph Hellwig 	DISK_EVENT_FLAG_BLOCK_ON_EXCL_WRITE	= 1 << 2,
109322cbb50SChristoph Hellwig };
110322cbb50SChristoph Hellwig 
111322cbb50SChristoph Hellwig struct disk_events;
112322cbb50SChristoph Hellwig struct badblocks;
113322cbb50SChristoph Hellwig 
114322cbb50SChristoph Hellwig struct blk_integrity {
115322cbb50SChristoph Hellwig 	const struct blk_integrity_profile	*profile;
116322cbb50SChristoph Hellwig 	unsigned char				flags;
117322cbb50SChristoph Hellwig 	unsigned char				tuple_size;
118322cbb50SChristoph Hellwig 	unsigned char				interval_exp;
119322cbb50SChristoph Hellwig 	unsigned char				tag_size;
120322cbb50SChristoph Hellwig };
121322cbb50SChristoph Hellwig 
122322cbb50SChristoph Hellwig struct gendisk {
123322cbb50SChristoph Hellwig 	/*
124322cbb50SChristoph Hellwig 	 * major/first_minor/minors should not be set by any new driver, the
125322cbb50SChristoph Hellwig 	 * block core will take care of allocating them automatically.
126322cbb50SChristoph Hellwig 	 */
127322cbb50SChristoph Hellwig 	int major;
128322cbb50SChristoph Hellwig 	int first_minor;
129322cbb50SChristoph Hellwig 	int minors;
130322cbb50SChristoph Hellwig 
131322cbb50SChristoph Hellwig 	char disk_name[DISK_NAME_LEN];	/* name of major driver */
132322cbb50SChristoph Hellwig 
133322cbb50SChristoph Hellwig 	unsigned short events;		/* supported events */
134322cbb50SChristoph Hellwig 	unsigned short event_flags;	/* flags related to event processing */
135322cbb50SChristoph Hellwig 
136322cbb50SChristoph Hellwig 	struct xarray part_tbl;
137322cbb50SChristoph Hellwig 	struct block_device *part0;
138322cbb50SChristoph Hellwig 
139322cbb50SChristoph Hellwig 	const struct block_device_operations *fops;
140322cbb50SChristoph Hellwig 	struct request_queue *queue;
141322cbb50SChristoph Hellwig 	void *private_data;
142322cbb50SChristoph Hellwig 
143322cbb50SChristoph Hellwig 	int flags;
144322cbb50SChristoph Hellwig 	unsigned long state;
145322cbb50SChristoph Hellwig #define GD_NEED_PART_SCAN		0
146322cbb50SChristoph Hellwig #define GD_READ_ONLY			1
147322cbb50SChristoph Hellwig #define GD_DEAD				2
148322cbb50SChristoph Hellwig #define GD_NATIVE_CAPACITY		3
14976792055SChristoph Hellwig #define GD_ADDED			4
150b9684a71SChristoph Hellwig #define GD_SUPPRESS_PART_SCAN		5
1516f8191fdSChristoph Hellwig #define GD_OWNS_QUEUE			6
152322cbb50SChristoph Hellwig 
153322cbb50SChristoph Hellwig 	struct mutex open_mutex;	/* open/close mutex */
154322cbb50SChristoph Hellwig 	unsigned open_partitions;	/* number of open partitions */
155322cbb50SChristoph Hellwig 
156322cbb50SChristoph Hellwig 	struct backing_dev_info	*bdi;
157322cbb50SChristoph Hellwig 	struct kobject *slave_dir;
158322cbb50SChristoph Hellwig #ifdef CONFIG_BLOCK_HOLDER_DEPRECATED
159322cbb50SChristoph Hellwig 	struct list_head slave_bdevs;
160322cbb50SChristoph Hellwig #endif
161322cbb50SChristoph Hellwig 	struct timer_rand_state *random;
162322cbb50SChristoph Hellwig 	atomic_t sync_io;		/* RAID */
163322cbb50SChristoph Hellwig 	struct disk_events *ev;
164322cbb50SChristoph Hellwig #ifdef  CONFIG_BLK_DEV_INTEGRITY
165322cbb50SChristoph Hellwig 	struct kobject integrity_kobj;
166322cbb50SChristoph Hellwig #endif	/* CONFIG_BLK_DEV_INTEGRITY */
167322cbb50SChristoph Hellwig #if IS_ENABLED(CONFIG_CDROM)
168322cbb50SChristoph Hellwig 	struct cdrom_device_info *cdi;
169322cbb50SChristoph Hellwig #endif
170322cbb50SChristoph Hellwig 	int node_id;
171322cbb50SChristoph Hellwig 	struct badblocks *bb;
172322cbb50SChristoph Hellwig 	struct lockdep_map lockdep_map;
173322cbb50SChristoph Hellwig 	u64 diskseq;
1746a27d28cSChristoph Hellwig 
1756a27d28cSChristoph Hellwig 	/*
1766a27d28cSChristoph Hellwig 	 * Independent sector access ranges. This is always NULL for
1776a27d28cSChristoph Hellwig 	 * devices that do not have multiple independent access ranges.
1786a27d28cSChristoph Hellwig 	 */
1796a27d28cSChristoph Hellwig 	struct blk_independent_access_ranges *ia_ranges;
180322cbb50SChristoph Hellwig };
181322cbb50SChristoph Hellwig 
182322cbb50SChristoph Hellwig static inline bool disk_live(struct gendisk *disk)
183322cbb50SChristoph Hellwig {
184322cbb50SChristoph Hellwig 	return !inode_unhashed(disk->part0->bd_inode);
185322cbb50SChristoph Hellwig }
186322cbb50SChristoph Hellwig 
187dbdc1be3SChristoph Hellwig /**
188dbdc1be3SChristoph Hellwig  * disk_openers - returns how many openers are there for a disk
189dbdc1be3SChristoph Hellwig  * @disk: disk to check
190dbdc1be3SChristoph Hellwig  *
191dbdc1be3SChristoph Hellwig  * This returns the number of openers for a disk.  Note that this value is only
192dbdc1be3SChristoph Hellwig  * stable if disk->open_mutex is held.
193dbdc1be3SChristoph Hellwig  *
194dbdc1be3SChristoph Hellwig  * Note: Due to a quirk in the block layer open code, each open partition is
195dbdc1be3SChristoph Hellwig  * only counted once even if there are multiple openers.
196dbdc1be3SChristoph Hellwig  */
197dbdc1be3SChristoph Hellwig static inline unsigned int disk_openers(struct gendisk *disk)
198dbdc1be3SChristoph Hellwig {
1999acf381fSChristoph Hellwig 	return atomic_read(&disk->part0->bd_openers);
200dbdc1be3SChristoph Hellwig }
201dbdc1be3SChristoph Hellwig 
202322cbb50SChristoph Hellwig /*
203322cbb50SChristoph Hellwig  * The gendisk is refcounted by the part0 block_device, and the bd_device
204322cbb50SChristoph Hellwig  * therein is also used for device model presentation in sysfs.
205322cbb50SChristoph Hellwig  */
206322cbb50SChristoph Hellwig #define dev_to_disk(device) \
207322cbb50SChristoph Hellwig 	(dev_to_bdev(device)->bd_disk)
208322cbb50SChristoph Hellwig #define disk_to_dev(disk) \
209322cbb50SChristoph Hellwig 	(&((disk)->part0->bd_device))
210322cbb50SChristoph Hellwig 
211322cbb50SChristoph Hellwig #if IS_REACHABLE(CONFIG_CDROM)
212322cbb50SChristoph Hellwig #define disk_to_cdi(disk)	((disk)->cdi)
213322cbb50SChristoph Hellwig #else
214322cbb50SChristoph Hellwig #define disk_to_cdi(disk)	NULL
215322cbb50SChristoph Hellwig #endif
216322cbb50SChristoph Hellwig 
217322cbb50SChristoph Hellwig static inline dev_t disk_devt(struct gendisk *disk)
218322cbb50SChristoph Hellwig {
219322cbb50SChristoph Hellwig 	return MKDEV(disk->major, disk->first_minor);
220322cbb50SChristoph Hellwig }
221322cbb50SChristoph Hellwig 
22237ae5a0fSTetsuo Handa static inline int blk_validate_block_size(unsigned long bsize)
223570b1cacSXie Yongji {
224570b1cacSXie Yongji 	if (bsize < 512 || bsize > PAGE_SIZE || !is_power_of_2(bsize))
225570b1cacSXie Yongji 		return -EINVAL;
226570b1cacSXie Yongji 
227570b1cacSXie Yongji 	return 0;
228570b1cacSXie Yongji }
229570b1cacSXie Yongji 
230da6269daSChristoph Hellwig static inline bool blk_op_is_passthrough(unsigned int op)
23114cb0dc6SMing Lei {
232da6269daSChristoph Hellwig 	op &= REQ_OP_MASK;
23314cb0dc6SMing Lei 	return op == REQ_OP_DRV_IN || op == REQ_OP_DRV_OUT;
23414cb0dc6SMing Lei }
23514cb0dc6SMing Lei 
236797476b8SDamien Le Moal /*
237797476b8SDamien Le Moal  * Zoned block device models (zoned limit).
2383093a479SChristoph Hellwig  *
2393093a479SChristoph Hellwig  * Note: This needs to be ordered from the least to the most severe
2403093a479SChristoph Hellwig  * restrictions for the inheritance in blk_stack_limits() to work.
241797476b8SDamien Le Moal  */
242797476b8SDamien Le Moal enum blk_zoned_model {
2433093a479SChristoph Hellwig 	BLK_ZONED_NONE = 0,	/* Regular block device */
244797476b8SDamien Le Moal 	BLK_ZONED_HA,		/* Host-aware zoned block device */
245797476b8SDamien Le Moal 	BLK_ZONED_HM,		/* Host-managed zoned block device */
246797476b8SDamien Le Moal };
247797476b8SDamien Le Moal 
2489bb33f24SChristoph Hellwig /*
2499bb33f24SChristoph Hellwig  * BLK_BOUNCE_NONE:	never bounce (default)
2509bb33f24SChristoph Hellwig  * BLK_BOUNCE_HIGH:	bounce all highmem pages
2519bb33f24SChristoph Hellwig  */
2529bb33f24SChristoph Hellwig enum blk_bounce {
2539bb33f24SChristoph Hellwig 	BLK_BOUNCE_NONE,
2549bb33f24SChristoph Hellwig 	BLK_BOUNCE_HIGH,
2559bb33f24SChristoph Hellwig };
2569bb33f24SChristoph Hellwig 
257025146e1SMartin K. Petersen struct queue_limits {
2589bb33f24SChristoph Hellwig 	enum blk_bounce		bounce;
259025146e1SMartin K. Petersen 	unsigned long		seg_boundary_mask;
26003100aadSKeith Busch 	unsigned long		virt_boundary_mask;
261025146e1SMartin K. Petersen 
262025146e1SMartin K. Petersen 	unsigned int		max_hw_sectors;
263ca369d51SMartin K. Petersen 	unsigned int		max_dev_sectors;
264762380adSJens Axboe 	unsigned int		chunk_sectors;
265025146e1SMartin K. Petersen 	unsigned int		max_sectors;
266025146e1SMartin K. Petersen 	unsigned int		max_segment_size;
267c72758f3SMartin K. Petersen 	unsigned int		physical_block_size;
268ad6bf88aSMikulas Patocka 	unsigned int		logical_block_size;
269c72758f3SMartin K. Petersen 	unsigned int		alignment_offset;
270c72758f3SMartin K. Petersen 	unsigned int		io_min;
271c72758f3SMartin K. Petersen 	unsigned int		io_opt;
27267efc925SChristoph Hellwig 	unsigned int		max_discard_sectors;
2730034af03SJens Axboe 	unsigned int		max_hw_discard_sectors;
27444abff2cSChristoph Hellwig 	unsigned int		max_secure_erase_sectors;
275a6f0788eSChaitanya Kulkarni 	unsigned int		max_write_zeroes_sectors;
2760512a75bSKeith Busch 	unsigned int		max_zone_append_sectors;
27786b37281SMartin K. Petersen 	unsigned int		discard_granularity;
27886b37281SMartin K. Petersen 	unsigned int		discard_alignment;
279a805a4faSDamien Le Moal 	unsigned int		zone_write_granularity;
280025146e1SMartin K. Petersen 
2818a78362cSMartin K. Petersen 	unsigned short		max_segments;
28213f05c8dSMartin K. Petersen 	unsigned short		max_integrity_segments;
2831e739730SChristoph Hellwig 	unsigned short		max_discard_segments;
284025146e1SMartin K. Petersen 
285c72758f3SMartin K. Petersen 	unsigned char		misaligned;
28686b37281SMartin K. Petersen 	unsigned char		discard_misaligned;
287c78afc62SKent Overstreet 	unsigned char		raid_partial_stripes_expensive;
288797476b8SDamien Le Moal 	enum blk_zoned_model	zoned;
289025146e1SMartin K. Petersen };
290025146e1SMartin K. Petersen 
291d4100351SChristoph Hellwig typedef int (*report_zones_cb)(struct blk_zone *zone, unsigned int idx,
292d4100351SChristoph Hellwig 			       void *data);
293d4100351SChristoph Hellwig 
2946b2bd274SChristoph Hellwig void disk_set_zoned(struct gendisk *disk, enum blk_zoned_model model);
29527ba3e8fSDamien Le Moal 
2966a0cb1bcSHannes Reinecke #ifdef CONFIG_BLK_DEV_ZONED
2976a0cb1bcSHannes Reinecke 
298d4100351SChristoph Hellwig #define BLK_ALL_ZONES  ((unsigned int)-1)
299d4100351SChristoph Hellwig int blkdev_report_zones(struct block_device *bdev, sector_t sector,
300d4100351SChristoph Hellwig 			unsigned int nr_zones, report_zones_cb cb, void *data);
301*b623e347SChristoph Hellwig unsigned int bdev_nr_zones(struct block_device *bdev);
3026c1b1da5SAjay Joshi extern int blkdev_zone_mgmt(struct block_device *bdev, enum req_opf op,
3036c1b1da5SAjay Joshi 			    sector_t sectors, sector_t nr_sectors,
3046c1b1da5SAjay Joshi 			    gfp_t gfp_mask);
305e732671aSDamien Le Moal int blk_revalidate_disk_zones(struct gendisk *disk,
306e732671aSDamien Le Moal 			      void (*update_driver_data)(struct gendisk *disk));
3076a0cb1bcSHannes Reinecke 
3083ed05a98SShaun Tancheff extern int blkdev_report_zones_ioctl(struct block_device *bdev, fmode_t mode,
3093ed05a98SShaun Tancheff 				     unsigned int cmd, unsigned long arg);
310e876df1fSAjay Joshi extern int blkdev_zone_mgmt_ioctl(struct block_device *bdev, fmode_t mode,
3113ed05a98SShaun Tancheff 				  unsigned int cmd, unsigned long arg);
3123ed05a98SShaun Tancheff 
3133ed05a98SShaun Tancheff #else /* CONFIG_BLK_DEV_ZONED */
3143ed05a98SShaun Tancheff 
315*b623e347SChristoph Hellwig static inline unsigned int bdev_nr_zones(struct block_device *bdev)
316a91e1380SDamien Le Moal {
317a91e1380SDamien Le Moal 	return 0;
318a91e1380SDamien Le Moal }
319bf505456SDamien Le Moal 
3203ed05a98SShaun Tancheff static inline int blkdev_report_zones_ioctl(struct block_device *bdev,
3213ed05a98SShaun Tancheff 					    fmode_t mode, unsigned int cmd,
3223ed05a98SShaun Tancheff 					    unsigned long arg)
3233ed05a98SShaun Tancheff {
3243ed05a98SShaun Tancheff 	return -ENOTTY;
3253ed05a98SShaun Tancheff }
3263ed05a98SShaun Tancheff 
327e876df1fSAjay Joshi static inline int blkdev_zone_mgmt_ioctl(struct block_device *bdev,
3283ed05a98SShaun Tancheff 					 fmode_t mode, unsigned int cmd,
3293ed05a98SShaun Tancheff 					 unsigned long arg)
3303ed05a98SShaun Tancheff {
3313ed05a98SShaun Tancheff 	return -ENOTTY;
3323ed05a98SShaun Tancheff }
3333ed05a98SShaun Tancheff 
3346a0cb1bcSHannes Reinecke #endif /* CONFIG_BLK_DEV_ZONED */
3356a0cb1bcSHannes Reinecke 
336a2247f19SDamien Le Moal /*
337a2247f19SDamien Le Moal  * Independent access ranges: struct blk_independent_access_range describes
338a2247f19SDamien Le Moal  * a range of contiguous sectors that can be accessed using device command
339a2247f19SDamien Le Moal  * execution resources that are independent from the resources used for
340a2247f19SDamien Le Moal  * other access ranges. This is typically found with single-LUN multi-actuator
341a2247f19SDamien Le Moal  * HDDs where each access range is served by a different set of heads.
342a2247f19SDamien Le Moal  * The set of independent ranges supported by the device is defined using
343a2247f19SDamien Le Moal  * struct blk_independent_access_ranges. The independent ranges must not overlap
344a2247f19SDamien Le Moal  * and must include all sectors within the disk capacity (no sector holes
345a2247f19SDamien Le Moal  * allowed).
346a2247f19SDamien Le Moal  * For a device with multiple ranges, requests targeting sectors in different
347a2247f19SDamien Le Moal  * ranges can be executed in parallel. A request can straddle an access range
348a2247f19SDamien Le Moal  * boundary.
349a2247f19SDamien Le Moal  */
350a2247f19SDamien Le Moal struct blk_independent_access_range {
351a2247f19SDamien Le Moal 	struct kobject		kobj;
352a2247f19SDamien Le Moal 	sector_t		sector;
353a2247f19SDamien Le Moal 	sector_t		nr_sectors;
354a2247f19SDamien Le Moal };
355a2247f19SDamien Le Moal 
356a2247f19SDamien Le Moal struct blk_independent_access_ranges {
357a2247f19SDamien Le Moal 	struct kobject				kobj;
358a2247f19SDamien Le Moal 	bool					sysfs_registered;
359a2247f19SDamien Le Moal 	unsigned int				nr_ia_ranges;
360a2247f19SDamien Le Moal 	struct blk_independent_access_range	ia_range[];
361a2247f19SDamien Le Moal };
362a2247f19SDamien Le Moal 
363d7b76301SRichard Kennedy struct request_queue {
3641da177e4SLinus Torvalds 	struct request		*last_merge;
365b374d18aSJens Axboe 	struct elevator_queue	*elevator;
3661da177e4SLinus Torvalds 
3670549e87cSMing Lei 	struct percpu_ref	q_usage_counter;
3680549e87cSMing Lei 
36934dbad5dSOmar Sandoval 	struct blk_queue_stats	*stats;
370a7905043SJosef Bacik 	struct rq_qos		*rq_qos;
37187760e5eSJens Axboe 
372f8a5b122SJens Axboe 	const struct blk_mq_ops	*mq_ops;
373320ae51fSJens Axboe 
374320ae51fSJens Axboe 	/* sw queues */
375e6cdb092SMing Lei 	struct blk_mq_ctx __percpu	*queue_ctx;
376320ae51fSJens Axboe 
377d278d4a8SJens Axboe 	unsigned int		queue_depth;
378d278d4a8SJens Axboe 
379320ae51fSJens Axboe 	/* hw dispatch queues */
3804e5cc99eSMing Lei 	struct xarray		hctx_table;
381320ae51fSJens Axboe 	unsigned int		nr_hw_queues;
382320ae51fSJens Axboe 
3831da177e4SLinus Torvalds 	/*
3841da177e4SLinus Torvalds 	 * The queue owner gets to use this for whatever they like.
3851da177e4SLinus Torvalds 	 * ll_rw_blk doesn't touch it.
3861da177e4SLinus Torvalds 	 */
3871da177e4SLinus Torvalds 	void			*queuedata;
3881da177e4SLinus Torvalds 
3891da177e4SLinus Torvalds 	/*
3901da177e4SLinus Torvalds 	 * various queue flags, see QUEUE_* below
3911da177e4SLinus Torvalds 	 */
3921da177e4SLinus Torvalds 	unsigned long		queue_flags;
393cd84a62eSBart Van Assche 	/*
394cd84a62eSBart Van Assche 	 * Number of contexts that have called blk_set_pm_only(). If this
395a4d34da7SBart Van Assche 	 * counter is above zero then only RQF_PM requests are processed.
396cd84a62eSBart Van Assche 	 */
397cd84a62eSBart Van Assche 	atomic_t		pm_only;
3981da177e4SLinus Torvalds 
3991da177e4SLinus Torvalds 	/*
400a73f730dSTejun Heo 	 * ida allocated id for this queue.  Used to index queues from
401a73f730dSTejun Heo 	 * ioctx.
402a73f730dSTejun Heo 	 */
403a73f730dSTejun Heo 	int			id;
404a73f730dSTejun Heo 
4050d945c1fSChristoph Hellwig 	spinlock_t		queue_lock;
4061da177e4SLinus Torvalds 
407d152c682SChristoph Hellwig 	struct gendisk		*disk;
408d152c682SChristoph Hellwig 
4091da177e4SLinus Torvalds 	/*
4101da177e4SLinus Torvalds 	 * queue kobject
4111da177e4SLinus Torvalds 	 */
4121da177e4SLinus Torvalds 	struct kobject kobj;
4131da177e4SLinus Torvalds 
414320ae51fSJens Axboe 	/*
415320ae51fSJens Axboe 	 * mq queue kobject
416320ae51fSJens Axboe 	 */
4171db4909eSMing Lei 	struct kobject *mq_kobj;
418320ae51fSJens Axboe 
419ac6fc48cSDan Williams #ifdef  CONFIG_BLK_DEV_INTEGRITY
420ac6fc48cSDan Williams 	struct blk_integrity integrity;
421ac6fc48cSDan Williams #endif	/* CONFIG_BLK_DEV_INTEGRITY */
422ac6fc48cSDan Williams 
42347fafbc7SRafael J. Wysocki #ifdef CONFIG_PM
4246c954667SLin Ming 	struct device		*dev;
425db04e18dSGeert Uytterhoeven 	enum rpm_status		rpm_status;
4266c954667SLin Ming #endif
4276c954667SLin Ming 
4281da177e4SLinus Torvalds 	/*
4291da177e4SLinus Torvalds 	 * queue settings
4301da177e4SLinus Torvalds 	 */
4311da177e4SLinus Torvalds 	unsigned long		nr_requests;	/* Max # of requests */
4321da177e4SLinus Torvalds 
433e3790c7dSTejun Heo 	unsigned int		dma_pad_mask;
434b1a000d3SKeith Busch 	/*
435b1a000d3SKeith Busch 	 * Drivers that set dma_alignment to less than 511 must be prepared to
436b1a000d3SKeith Busch 	 * handle individual bvec's that are not a multiple of a SECTOR_SIZE
437b1a000d3SKeith Busch 	 * due to possible offsets.
438b1a000d3SKeith Busch 	 */
4391da177e4SLinus Torvalds 	unsigned int		dma_alignment;
4401da177e4SLinus Torvalds 
4411b262839SSatya Tangirala #ifdef CONFIG_BLK_INLINE_ENCRYPTION
442cb77cb5aSEric Biggers 	struct blk_crypto_profile *crypto_profile;
44320f01f16SEric Biggers 	struct kobject *crypto_kobject;
4441b262839SSatya Tangirala #endif
4451b262839SSatya Tangirala 
446242f9dcbSJens Axboe 	unsigned int		rq_timeout;
44764f1c21eSJens Axboe 	int			poll_nsec;
44834dbad5dSOmar Sandoval 
44934dbad5dSOmar Sandoval 	struct blk_stat_callback	*poll_cb;
45048b5c1fbSJens Axboe 	struct blk_rq_stat	*poll_stat;
45134dbad5dSOmar Sandoval 
452242f9dcbSJens Axboe 	struct timer_list	timeout;
453287922ebSChristoph Hellwig 	struct work_struct	timeout_work;
454242f9dcbSJens Axboe 
455079a2e3eSJohn Garry 	atomic_t		nr_active_requests_shared_tags;
456bccf5e26SJohn Garry 
457079a2e3eSJohn Garry 	struct blk_mq_tags	*sched_shared_tags;
458d97e594cSJohn Garry 
459a612fddfSTejun Heo 	struct list_head	icq_list;
4604eef3049STejun Heo #ifdef CONFIG_BLK_CGROUP
461a2b1693bSTejun Heo 	DECLARE_BITMAP		(blkcg_pols, BLKCG_MAX_POLS);
4623c798398STejun Heo 	struct blkcg_gq		*root_blkg;
46303aa264aSTejun Heo 	struct list_head	blkg_list;
4644eef3049STejun Heo #endif
465a612fddfSTejun Heo 
466025146e1SMartin K. Petersen 	struct queue_limits	limits;
467025146e1SMartin K. Petersen 
46868c43f13SDamien Le Moal 	unsigned int		required_elevator_features;
46968c43f13SDamien Le Moal 
4706a5ac984SBart Van Assche #ifdef CONFIG_BLK_DEV_ZONED
4711da177e4SLinus Torvalds 	/*
4726cc77e9cSChristoph Hellwig 	 * Zoned block device information for request dispatch control.
4736cc77e9cSChristoph Hellwig 	 * nr_zones is the total number of zones of the device. This is always
474f216fdd7SChristoph Hellwig 	 * 0 for regular block devices. conv_zones_bitmap is a bitmap of nr_zones
475f216fdd7SChristoph Hellwig 	 * bits which indicates if a zone is conventional (bit set) or
476f216fdd7SChristoph Hellwig 	 * sequential (bit clear). seq_zones_wlock is a bitmap of nr_zones
4776cc77e9cSChristoph Hellwig 	 * bits which indicates if a zone is write locked, that is, if a write
4786cc77e9cSChristoph Hellwig 	 * request targeting the zone was dispatched. All three fields are
4796cc77e9cSChristoph Hellwig 	 * initialized by the low level device driver (e.g. scsi/sd.c).
4806cc77e9cSChristoph Hellwig 	 * Stacking drivers (device mappers) may or may not initialize
4816cc77e9cSChristoph Hellwig 	 * these fields.
482ccce20fcSBart Van Assche 	 *
483ccce20fcSBart Van Assche 	 * Reads of this information must be protected with blk_queue_enter() /
484ccce20fcSBart Van Assche 	 * blk_queue_exit(). Modifying this information is only allowed while
485ccce20fcSBart Van Assche 	 * no requests are being processed. See also blk_mq_freeze_queue() and
486ccce20fcSBart Van Assche 	 * blk_mq_unfreeze_queue().
4876cc77e9cSChristoph Hellwig 	 */
4886cc77e9cSChristoph Hellwig 	unsigned int		nr_zones;
489f216fdd7SChristoph Hellwig 	unsigned long		*conv_zones_bitmap;
4906cc77e9cSChristoph Hellwig 	unsigned long		*seq_zones_wlock;
491e15864f8SNiklas Cassel 	unsigned int		max_open_zones;
492659bf827SNiklas Cassel 	unsigned int		max_active_zones;
4936a5ac984SBart Van Assche #endif /* CONFIG_BLK_DEV_ZONED */
4946cc77e9cSChristoph Hellwig 
4951946089aSChristoph Lameter 	int			node;
4966c5c9341SAlexey Dobriyan #ifdef CONFIG_BLK_DEV_IO_TRACE
497c780e86dSJan Kara 	struct blk_trace __rcu	*blk_trace;
4986c5c9341SAlexey Dobriyan #endif
4991da177e4SLinus Torvalds 	/*
5004913efe4STejun Heo 	 * for flush operations
5011da177e4SLinus Torvalds 	 */
5027c94e1c1SMing Lei 	struct blk_flush_queue	*fq;
503483f4afcSAl Viro 
5046fca6a61SChristoph Hellwig 	struct list_head	requeue_list;
5056fca6a61SChristoph Hellwig 	spinlock_t		requeue_lock;
5062849450aSMike Snitzer 	struct delayed_work	requeue_work;
5076fca6a61SChristoph Hellwig 
508483f4afcSAl Viro 	struct mutex		sysfs_lock;
509cecf5d87SMing Lei 	struct mutex		sysfs_dir_lock;
510d351af01SFUJITA Tomonori 
5112f8f1336SMing Lei 	/*
5122f8f1336SMing Lei 	 * for reusing dead hctx instance in case of updating
5132f8f1336SMing Lei 	 * nr_hw_queues
5142f8f1336SMing Lei 	 */
5152f8f1336SMing Lei 	struct list_head	unused_hctx_list;
5162f8f1336SMing Lei 	spinlock_t		unused_hctx_lock;
5172f8f1336SMing Lei 
5187996a8b5SBob Liu 	int			mq_freeze_depth;
519d732580bSTejun Heo 
520e43473b7SVivek Goyal #ifdef CONFIG_BLK_DEV_THROTTLING
521e43473b7SVivek Goyal 	/* Throttle data */
522e43473b7SVivek Goyal 	struct throtl_data *td;
523e43473b7SVivek Goyal #endif
524548bc8e1STejun Heo 	struct rcu_head		rcu_head;
525320ae51fSJens Axboe 	wait_queue_head_t	mq_freeze_wq;
5267996a8b5SBob Liu 	/*
5277996a8b5SBob Liu 	 * Protect concurrent access to q_usage_counter by
5287996a8b5SBob Liu 	 * percpu_ref_kill() and percpu_ref_reinit().
5297996a8b5SBob Liu 	 */
5307996a8b5SBob Liu 	struct mutex		mq_freeze_lock;
5310d2602caSJens Axboe 
532e70feb8bSMing Lei 	int			quiesce_depth;
533e70feb8bSMing Lei 
5340d2602caSJens Axboe 	struct blk_mq_tag_set	*tag_set;
5350d2602caSJens Axboe 	struct list_head	tag_set_list;
536338aa96dSKent Overstreet 	struct bio_set		bio_split;
5374593fdbeSAkinobu Mita 
53807e4feadSOmar Sandoval 	struct dentry		*debugfs_dir;
539d332ce09SOmar Sandoval 	struct dentry		*sched_debugfs_dir;
540cc56694fSMing Lei 	struct dentry		*rqos_debugfs_dir;
5415cf9c91bSChristoph Hellwig 	/*
5425cf9c91bSChristoph Hellwig 	 * Serializes all debugfs metadata operations using the above dentries.
5435cf9c91bSChristoph Hellwig 	 */
5445cf9c91bSChristoph Hellwig 	struct mutex		debugfs_mutex;
54507e4feadSOmar Sandoval 
5464593fdbeSAkinobu Mita 	bool			mq_sysfs_init_done;
5476d247d7fSChristoph Hellwig 
548704b914fSMing Lei 	/**
549704b914fSMing Lei 	 * @srcu: Sleepable RCU. Use as lock when type of the request queue
550704b914fSMing Lei 	 * is blocking (BLK_MQ_F_BLOCKING). Must be the last member
551704b914fSMing Lei 	 */
552704b914fSMing Lei 	struct srcu_struct	srcu[];
5531da177e4SLinus Torvalds };
5541da177e4SLinus Torvalds 
555bfe373f6SHou Tao /* Keep blk_queue_flag_name[] in sync with the definitions below */
556eca7abf3SJens Axboe #define QUEUE_FLAG_STOPPED	0	/* queue is stopped */
557eca7abf3SJens Axboe #define QUEUE_FLAG_DYING	1	/* queue being torn down */
558704b914fSMing Lei #define QUEUE_FLAG_HAS_SRCU	2	/* SRCU is allocated */
559eca7abf3SJens Axboe #define QUEUE_FLAG_NOMERGES     3	/* disable merge attempts */
560eca7abf3SJens Axboe #define QUEUE_FLAG_SAME_COMP	4	/* complete on same CPU-group */
561eca7abf3SJens Axboe #define QUEUE_FLAG_FAIL_IO	5	/* fake timeout */
562eca7abf3SJens Axboe #define QUEUE_FLAG_NONROT	6	/* non-rotational device (SSD) */
56388e740f1SFernando Luis Vázquez Cao #define QUEUE_FLAG_VIRT		QUEUE_FLAG_NONROT /* paravirt device */
564eca7abf3SJens Axboe #define QUEUE_FLAG_IO_STAT	7	/* do disk/partitions IO accounting */
565eca7abf3SJens Axboe #define QUEUE_FLAG_NOXMERGES	9	/* No extended merges */
566eca7abf3SJens Axboe #define QUEUE_FLAG_ADD_RANDOM	10	/* Contributes to random pool */
567eca7abf3SJens Axboe #define QUEUE_FLAG_SAME_FORCE	12	/* force complete on same CPU */
568eca7abf3SJens Axboe #define QUEUE_FLAG_INIT_DONE	14	/* queue is initialized */
5691cb039f3SChristoph Hellwig #define QUEUE_FLAG_STABLE_WRITES 15	/* don't modify blks until WB is done */
570eca7abf3SJens Axboe #define QUEUE_FLAG_POLL		16	/* IO polling enabled if set */
571eca7abf3SJens Axboe #define QUEUE_FLAG_WC		17	/* Write back caching */
572eca7abf3SJens Axboe #define QUEUE_FLAG_FUA		18	/* device supports FUA writes */
573eca7abf3SJens Axboe #define QUEUE_FLAG_DAX		19	/* device supports DAX */
574eca7abf3SJens Axboe #define QUEUE_FLAG_STATS	20	/* track IO start and completion times */
575eca7abf3SJens Axboe #define QUEUE_FLAG_REGISTERED	22	/* queue has been registered to a disk */
576eca7abf3SJens Axboe #define QUEUE_FLAG_QUIESCED	24	/* queue has been quiesced */
577eca7abf3SJens Axboe #define QUEUE_FLAG_PCI_P2PDMA	25	/* device supports PCI p2p requests */
578e84e8f06SChaitanya Kulkarni #define QUEUE_FLAG_ZONE_RESETALL 26	/* supports Zone Reset All */
5796f816b4bSTejun Heo #define QUEUE_FLAG_RQ_ALLOC_TIME 27	/* record rq->alloc_time_ns */
580f1b49fdcSJohn Garry #define QUEUE_FLAG_HCTX_ACTIVE	28	/* at least one blk-mq hctx is active */
581021a2446SMike Snitzer #define QUEUE_FLAG_NOWAIT       29	/* device supports NOWAIT */
5824d337cebSMing Lei #define QUEUE_FLAG_SQ_SCHED     30	/* single queue style io dispatch */
583797e7dbbSTejun Heo 
58494eddfbeSJens Axboe #define QUEUE_FLAG_MQ_DEFAULT	((1 << QUEUE_FLAG_IO_STAT) |		\
585021a2446SMike Snitzer 				 (1 << QUEUE_FLAG_SAME_COMP) |		\
586021a2446SMike Snitzer 				 (1 << QUEUE_FLAG_NOWAIT))
58794eddfbeSJens Axboe 
5888814ce8aSBart Van Assche void blk_queue_flag_set(unsigned int flag, struct request_queue *q);
5898814ce8aSBart Van Assche void blk_queue_flag_clear(unsigned int flag, struct request_queue *q);
5908814ce8aSBart Van Assche bool blk_queue_flag_test_and_set(unsigned int flag, struct request_queue *q);
5918814ce8aSBart Van Assche 
5921da177e4SLinus Torvalds #define blk_queue_stopped(q)	test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
5933f3299d5SBart Van Assche #define blk_queue_dying(q)	test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
594704b914fSMing Lei #define blk_queue_has_srcu(q)	test_bit(QUEUE_FLAG_HAS_SRCU, &(q)->queue_flags)
595320ae51fSJens Axboe #define blk_queue_init_done(q)	test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
596ac9fafa1SAlan D. Brunelle #define blk_queue_nomerges(q)	test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
597488991e2SAlan D. Brunelle #define blk_queue_noxmerges(q)	\
598488991e2SAlan D. Brunelle 	test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
599a68bbddbSJens Axboe #define blk_queue_nonrot(q)	test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
6001cb039f3SChristoph Hellwig #define blk_queue_stable_writes(q) \
6011cb039f3SChristoph Hellwig 	test_bit(QUEUE_FLAG_STABLE_WRITES, &(q)->queue_flags)
602bc58ba94SJens Axboe #define blk_queue_io_stat(q)	test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
603e2e1a148SJens Axboe #define blk_queue_add_random(q)	test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
604e84e8f06SChaitanya Kulkarni #define blk_queue_zone_resetall(q)	\
605e84e8f06SChaitanya Kulkarni 	test_bit(QUEUE_FLAG_ZONE_RESETALL, &(q)->queue_flags)
606163d4baaSToshi Kani #define blk_queue_dax(q)	test_bit(QUEUE_FLAG_DAX, &(q)->queue_flags)
60749d92c0dSLogan Gunthorpe #define blk_queue_pci_p2pdma(q)	\
60849d92c0dSLogan Gunthorpe 	test_bit(QUEUE_FLAG_PCI_P2PDMA, &(q)->queue_flags)
6096f816b4bSTejun Heo #ifdef CONFIG_BLK_RQ_ALLOC_TIME
6106f816b4bSTejun Heo #define blk_queue_rq_alloc_time(q)	\
6116f816b4bSTejun Heo 	test_bit(QUEUE_FLAG_RQ_ALLOC_TIME, &(q)->queue_flags)
6126f816b4bSTejun Heo #else
6136f816b4bSTejun Heo #define blk_queue_rq_alloc_time(q)	false
6146f816b4bSTejun Heo #endif
6151da177e4SLinus Torvalds 
61633659ebbSChristoph Hellwig #define blk_noretry_request(rq) \
61733659ebbSChristoph Hellwig 	((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
61833659ebbSChristoph Hellwig 			     REQ_FAILFAST_DRIVER))
619f4560ffeSMing Lei #define blk_queue_quiesced(q)	test_bit(QUEUE_FLAG_QUIESCED, &(q)->queue_flags)
620cd84a62eSBart Van Assche #define blk_queue_pm_only(q)	atomic_read(&(q)->pm_only)
62158c898baSMing Lei #define blk_queue_registered(q)	test_bit(QUEUE_FLAG_REGISTERED, &(q)->queue_flags)
622021a2446SMike Snitzer #define blk_queue_nowait(q)	test_bit(QUEUE_FLAG_NOWAIT, &(q)->queue_flags)
6234d337cebSMing Lei #define blk_queue_sq_sched(q)	test_bit(QUEUE_FLAG_SQ_SCHED, &(q)->queue_flags)
624c9254f2dSBart Van Assche 
625cd84a62eSBart Van Assche extern void blk_set_pm_only(struct request_queue *q);
626cd84a62eSBart Van Assche extern void blk_clear_pm_only(struct request_queue *q);
6274aff5e23SJens Axboe 
6281da177e4SLinus Torvalds #define list_entry_rq(ptr)	list_entry((ptr), struct request, queuelist)
6291da177e4SLinus Torvalds 
6303ab3a031SChristoph Hellwig #define dma_map_bvec(dev, bv, dir, attrs) \
6313ab3a031SChristoph Hellwig 	dma_map_page_attrs(dev, (bv)->bv_page, (bv)->bv_offset, (bv)->bv_len, \
6323ab3a031SChristoph Hellwig 	(dir), (attrs))
6333ab3a031SChristoph Hellwig 
634344e9ffcSJens Axboe static inline bool queue_is_mq(struct request_queue *q)
63549fd524fSJens Axboe {
636a1ce35faSJens Axboe 	return q->mq_ops;
63749fd524fSJens Axboe }
63849fd524fSJens Axboe 
63952abca64SAlan Stern #ifdef CONFIG_PM
64052abca64SAlan Stern static inline enum rpm_status queue_rpm_status(struct request_queue *q)
64152abca64SAlan Stern {
64252abca64SAlan Stern 	return q->rpm_status;
64352abca64SAlan Stern }
64452abca64SAlan Stern #else
64552abca64SAlan Stern static inline enum rpm_status queue_rpm_status(struct request_queue *q)
64652abca64SAlan Stern {
64752abca64SAlan Stern 	return RPM_ACTIVE;
64852abca64SAlan Stern }
64952abca64SAlan Stern #endif
65052abca64SAlan Stern 
651797476b8SDamien Le Moal static inline enum blk_zoned_model
652797476b8SDamien Le Moal blk_queue_zoned_model(struct request_queue *q)
653797476b8SDamien Le Moal {
6546fcd6695SChristoph Hellwig 	if (IS_ENABLED(CONFIG_BLK_DEV_ZONED))
655797476b8SDamien Le Moal 		return q->limits.zoned;
6566fcd6695SChristoph Hellwig 	return BLK_ZONED_NONE;
657797476b8SDamien Le Moal }
658797476b8SDamien Le Moal 
659797476b8SDamien Le Moal static inline bool blk_queue_is_zoned(struct request_queue *q)
660797476b8SDamien Le Moal {
661797476b8SDamien Le Moal 	switch (blk_queue_zoned_model(q)) {
662797476b8SDamien Le Moal 	case BLK_ZONED_HA:
663797476b8SDamien Le Moal 	case BLK_ZONED_HM:
664797476b8SDamien Le Moal 		return true;
665797476b8SDamien Le Moal 	default:
666797476b8SDamien Le Moal 		return false;
667797476b8SDamien Le Moal 	}
668797476b8SDamien Le Moal }
669797476b8SDamien Le Moal 
670113ab72eSDamien Le Moal static inline sector_t blk_queue_zone_sectors(struct request_queue *q)
6716a0cb1bcSHannes Reinecke {
6726a0cb1bcSHannes Reinecke 	return blk_queue_is_zoned(q) ? q->limits.chunk_sectors : 0;
6736a0cb1bcSHannes Reinecke }
6746a0cb1bcSHannes Reinecke 
6756a5ac984SBart Van Assche #ifdef CONFIG_BLK_DEV_ZONED
676965b652eSDamien Le Moal static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
677965b652eSDamien Le Moal {
678965b652eSDamien Le Moal 	return blk_queue_is_zoned(q) ? q->nr_zones : 0;
679965b652eSDamien Le Moal }
680965b652eSDamien Le Moal 
6816cc77e9cSChristoph Hellwig static inline unsigned int blk_queue_zone_no(struct request_queue *q,
6826cc77e9cSChristoph Hellwig 					     sector_t sector)
6836cc77e9cSChristoph Hellwig {
6846cc77e9cSChristoph Hellwig 	if (!blk_queue_is_zoned(q))
6856cc77e9cSChristoph Hellwig 		return 0;
6866cc77e9cSChristoph Hellwig 	return sector >> ilog2(q->limits.chunk_sectors);
6876cc77e9cSChristoph Hellwig }
6886cc77e9cSChristoph Hellwig 
6896cc77e9cSChristoph Hellwig static inline bool blk_queue_zone_is_seq(struct request_queue *q,
6906cc77e9cSChristoph Hellwig 					 sector_t sector)
6916cc77e9cSChristoph Hellwig {
692f216fdd7SChristoph Hellwig 	if (!blk_queue_is_zoned(q))
6936cc77e9cSChristoph Hellwig 		return false;
694f216fdd7SChristoph Hellwig 	if (!q->conv_zones_bitmap)
695f216fdd7SChristoph Hellwig 		return true;
696f216fdd7SChristoph Hellwig 	return !test_bit(blk_queue_zone_no(q, sector), q->conv_zones_bitmap);
6976cc77e9cSChristoph Hellwig }
698e15864f8SNiklas Cassel 
699982977dfSChristoph Hellwig static inline void disk_set_max_open_zones(struct gendisk *disk,
700e15864f8SNiklas Cassel 		unsigned int max_open_zones)
701e15864f8SNiklas Cassel {
702982977dfSChristoph Hellwig 	disk->queue->max_open_zones = max_open_zones;
703e15864f8SNiklas Cassel }
704e15864f8SNiklas Cassel 
705982977dfSChristoph Hellwig static inline void disk_set_max_active_zones(struct gendisk *disk,
706659bf827SNiklas Cassel 		unsigned int max_active_zones)
707659bf827SNiklas Cassel {
708982977dfSChristoph Hellwig 	disk->queue->max_active_zones = max_active_zones;
709659bf827SNiklas Cassel }
710659bf827SNiklas Cassel 
7111dc01720SChristoph Hellwig static inline unsigned int bdev_max_open_zones(struct block_device *bdev)
712659bf827SNiklas Cassel {
7131dc01720SChristoph Hellwig 	return bdev->bd_disk->queue->max_open_zones;
714659bf827SNiklas Cassel }
7151dc01720SChristoph Hellwig 
7161dc01720SChristoph Hellwig static inline unsigned int bdev_max_active_zones(struct block_device *bdev)
7171dc01720SChristoph Hellwig {
7181dc01720SChristoph Hellwig 	return bdev->bd_disk->queue->max_active_zones;
7191dc01720SChristoph Hellwig }
7201dc01720SChristoph Hellwig 
721965b652eSDamien Le Moal #else /* CONFIG_BLK_DEV_ZONED */
722965b652eSDamien Le Moal static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
723965b652eSDamien Le Moal {
724965b652eSDamien Le Moal 	return 0;
725965b652eSDamien Le Moal }
72602992df8SJohannes Thumshirn static inline bool blk_queue_zone_is_seq(struct request_queue *q,
72702992df8SJohannes Thumshirn 					 sector_t sector)
72802992df8SJohannes Thumshirn {
72902992df8SJohannes Thumshirn 	return false;
73002992df8SJohannes Thumshirn }
73102992df8SJohannes Thumshirn static inline unsigned int blk_queue_zone_no(struct request_queue *q,
73202992df8SJohannes Thumshirn 					     sector_t sector)
73302992df8SJohannes Thumshirn {
73402992df8SJohannes Thumshirn 	return 0;
73502992df8SJohannes Thumshirn }
7361dc01720SChristoph Hellwig static inline unsigned int bdev_max_open_zones(struct block_device *bdev)
737e15864f8SNiklas Cassel {
738e15864f8SNiklas Cassel 	return 0;
739e15864f8SNiklas Cassel }
7401dc01720SChristoph Hellwig static inline unsigned int bdev_max_active_zones(struct block_device *bdev)
741659bf827SNiklas Cassel {
742659bf827SNiklas Cassel 	return 0;
743659bf827SNiklas Cassel }
7446a5ac984SBart Van Assche #endif /* CONFIG_BLK_DEV_ZONED */
7456cc77e9cSChristoph Hellwig 
746d278d4a8SJens Axboe static inline unsigned int blk_queue_depth(struct request_queue *q)
747d278d4a8SJens Axboe {
748d278d4a8SJens Axboe 	if (q->queue_depth)
749d278d4a8SJens Axboe 		return q->queue_depth;
750d278d4a8SJens Axboe 
751d278d4a8SJens Axboe 	return q->nr_requests;
752d278d4a8SJens Axboe }
753d278d4a8SJens Axboe 
7543d6392cfSJens Axboe /*
7553d6392cfSJens Axboe  * default timeout for SG_IO if none specified
7563d6392cfSJens Axboe  */
7573d6392cfSJens Axboe #define BLK_DEFAULT_SG_TIMEOUT	(60 * HZ)
758f2f1fa78SLinus Torvalds #define BLK_MIN_SG_TIMEOUT	(7 * HZ)
7593d6392cfSJens Axboe 
7605705f702SNeilBrown /* This should not be used directly - use rq_for_each_segment */
7611e428079SJens Axboe #define for_each_bio(_bio)		\
7621e428079SJens Axboe 	for (; _bio; _bio = _bio->bi_next)
7631da177e4SLinus Torvalds 
764322cbb50SChristoph Hellwig int __must_check device_add_disk(struct device *parent, struct gendisk *disk,
765322cbb50SChristoph Hellwig 				 const struct attribute_group **groups);
766322cbb50SChristoph Hellwig static inline int __must_check add_disk(struct gendisk *disk)
767322cbb50SChristoph Hellwig {
768322cbb50SChristoph Hellwig 	return device_add_disk(NULL, disk, NULL);
769322cbb50SChristoph Hellwig }
770322cbb50SChristoph Hellwig void del_gendisk(struct gendisk *gp);
771322cbb50SChristoph Hellwig void invalidate_disk(struct gendisk *disk);
772322cbb50SChristoph Hellwig void set_disk_ro(struct gendisk *disk, bool read_only);
773322cbb50SChristoph Hellwig void disk_uevent(struct gendisk *disk, enum kobject_action action);
774322cbb50SChristoph Hellwig 
775322cbb50SChristoph Hellwig static inline int get_disk_ro(struct gendisk *disk)
776322cbb50SChristoph Hellwig {
777322cbb50SChristoph Hellwig 	return disk->part0->bd_read_only ||
778322cbb50SChristoph Hellwig 		test_bit(GD_READ_ONLY, &disk->state);
779322cbb50SChristoph Hellwig }
780322cbb50SChristoph Hellwig 
781322cbb50SChristoph Hellwig static inline int bdev_read_only(struct block_device *bdev)
782322cbb50SChristoph Hellwig {
783322cbb50SChristoph Hellwig 	return bdev->bd_read_only || get_disk_ro(bdev->bd_disk);
784322cbb50SChristoph Hellwig }
785322cbb50SChristoph Hellwig 
786322cbb50SChristoph Hellwig bool set_capacity_and_notify(struct gendisk *disk, sector_t size);
787322cbb50SChristoph Hellwig bool disk_force_media_change(struct gendisk *disk, unsigned int events);
788322cbb50SChristoph Hellwig 
789322cbb50SChristoph Hellwig void add_disk_randomness(struct gendisk *disk) __latent_entropy;
790322cbb50SChristoph Hellwig void rand_initialize_disk(struct gendisk *disk);
791322cbb50SChristoph Hellwig 
792322cbb50SChristoph Hellwig static inline sector_t get_start_sect(struct block_device *bdev)
793322cbb50SChristoph Hellwig {
794322cbb50SChristoph Hellwig 	return bdev->bd_start_sect;
795322cbb50SChristoph Hellwig }
796322cbb50SChristoph Hellwig 
797322cbb50SChristoph Hellwig static inline sector_t bdev_nr_sectors(struct block_device *bdev)
798322cbb50SChristoph Hellwig {
799322cbb50SChristoph Hellwig 	return bdev->bd_nr_sectors;
800322cbb50SChristoph Hellwig }
801322cbb50SChristoph Hellwig 
802322cbb50SChristoph Hellwig static inline loff_t bdev_nr_bytes(struct block_device *bdev)
803322cbb50SChristoph Hellwig {
804322cbb50SChristoph Hellwig 	return (loff_t)bdev_nr_sectors(bdev) << SECTOR_SHIFT;
805322cbb50SChristoph Hellwig }
806322cbb50SChristoph Hellwig 
807322cbb50SChristoph Hellwig static inline sector_t get_capacity(struct gendisk *disk)
808322cbb50SChristoph Hellwig {
809322cbb50SChristoph Hellwig 	return bdev_nr_sectors(disk->part0);
810322cbb50SChristoph Hellwig }
811322cbb50SChristoph Hellwig 
812322cbb50SChristoph Hellwig static inline u64 sb_bdev_nr_blocks(struct super_block *sb)
813322cbb50SChristoph Hellwig {
814322cbb50SChristoph Hellwig 	return bdev_nr_sectors(sb->s_bdev) >>
815322cbb50SChristoph Hellwig 		(sb->s_blocksize_bits - SECTOR_SHIFT);
816322cbb50SChristoph Hellwig }
817322cbb50SChristoph Hellwig 
818322cbb50SChristoph Hellwig int bdev_disk_changed(struct gendisk *disk, bool invalidate);
819322cbb50SChristoph Hellwig 
820322cbb50SChristoph Hellwig void put_disk(struct gendisk *disk);
821322cbb50SChristoph Hellwig struct gendisk *__blk_alloc_disk(int node, struct lock_class_key *lkclass);
822322cbb50SChristoph Hellwig 
823322cbb50SChristoph Hellwig /**
824322cbb50SChristoph Hellwig  * blk_alloc_disk - allocate a gendisk structure
825322cbb50SChristoph Hellwig  * @node_id: numa node to allocate on
826322cbb50SChristoph Hellwig  *
827322cbb50SChristoph Hellwig  * Allocate and pre-initialize a gendisk structure for use with BIO based
828322cbb50SChristoph Hellwig  * drivers.
829322cbb50SChristoph Hellwig  *
830322cbb50SChristoph Hellwig  * Context: can sleep
831322cbb50SChristoph Hellwig  */
832322cbb50SChristoph Hellwig #define blk_alloc_disk(node_id)						\
833322cbb50SChristoph Hellwig ({									\
834322cbb50SChristoph Hellwig 	static struct lock_class_key __key;				\
835322cbb50SChristoph Hellwig 									\
836322cbb50SChristoph Hellwig 	__blk_alloc_disk(node_id, &__key);				\
837322cbb50SChristoph Hellwig })
838322cbb50SChristoph Hellwig 
839322cbb50SChristoph Hellwig int __register_blkdev(unsigned int major, const char *name,
840322cbb50SChristoph Hellwig 		void (*probe)(dev_t devt));
841322cbb50SChristoph Hellwig #define register_blkdev(major, name) \
842322cbb50SChristoph Hellwig 	__register_blkdev(major, name, NULL)
843322cbb50SChristoph Hellwig void unregister_blkdev(unsigned int major, const char *name);
844322cbb50SChristoph Hellwig 
845322cbb50SChristoph Hellwig bool bdev_check_media_change(struct block_device *bdev);
846322cbb50SChristoph Hellwig int __invalidate_device(struct block_device *bdev, bool kill_dirty);
847322cbb50SChristoph Hellwig void set_capacity(struct gendisk *disk, sector_t size);
848322cbb50SChristoph Hellwig 
849322cbb50SChristoph Hellwig #ifdef CONFIG_BLOCK_HOLDER_DEPRECATED
850322cbb50SChristoph Hellwig int bd_link_disk_holder(struct block_device *bdev, struct gendisk *disk);
851322cbb50SChristoph Hellwig void bd_unlink_disk_holder(struct block_device *bdev, struct gendisk *disk);
852322cbb50SChristoph Hellwig int bd_register_pending_holders(struct gendisk *disk);
853322cbb50SChristoph Hellwig #else
854322cbb50SChristoph Hellwig static inline int bd_link_disk_holder(struct block_device *bdev,
855322cbb50SChristoph Hellwig 				      struct gendisk *disk)
856322cbb50SChristoph Hellwig {
857322cbb50SChristoph Hellwig 	return 0;
858322cbb50SChristoph Hellwig }
859322cbb50SChristoph Hellwig static inline void bd_unlink_disk_holder(struct block_device *bdev,
860322cbb50SChristoph Hellwig 					 struct gendisk *disk)
861322cbb50SChristoph Hellwig {
862322cbb50SChristoph Hellwig }
863322cbb50SChristoph Hellwig static inline int bd_register_pending_holders(struct gendisk *disk)
864322cbb50SChristoph Hellwig {
865322cbb50SChristoph Hellwig 	return 0;
866322cbb50SChristoph Hellwig }
867322cbb50SChristoph Hellwig #endif /* CONFIG_BLOCK_HOLDER_DEPRECATED */
868322cbb50SChristoph Hellwig 
869322cbb50SChristoph Hellwig dev_t part_devt(struct gendisk *disk, u8 partno);
870322cbb50SChristoph Hellwig void inc_diskseq(struct gendisk *disk);
871322cbb50SChristoph Hellwig dev_t blk_lookup_devt(const char *name, int partno);
872322cbb50SChristoph Hellwig void blk_request_module(dev_t devt);
8732d4dc890SIlya Loginov 
8741da177e4SLinus Torvalds extern int blk_register_queue(struct gendisk *disk);
8751da177e4SLinus Torvalds extern void blk_unregister_queue(struct gendisk *disk);
8763e08773cSChristoph Hellwig void submit_bio_noacct(struct bio *bio);
87724b83debSChristoph Hellwig 
878ef9e3facSKiyoshi Ueda extern int blk_lld_busy(struct request_queue *q);
879f695ca38SChristoph Hellwig extern void blk_queue_split(struct bio **);
8809a95e4efSBart Van Assche extern int blk_queue_enter(struct request_queue *q, blk_mq_req_flags_t flags);
8812e6edc95SDan Williams extern void blk_queue_exit(struct request_queue *q);
8821da177e4SLinus Torvalds extern void blk_sync_queue(struct request_queue *q);
883fb9b16e1SKeith Busch 
884e47bc4edSChaitanya Kulkarni /* Helper to convert REQ_OP_XXX to its string format XXX */
885e47bc4edSChaitanya Kulkarni extern const char *blk_op_str(unsigned int op);
886e47bc4edSChaitanya Kulkarni 
8872a842acaSChristoph Hellwig int blk_status_to_errno(blk_status_t status);
8882a842acaSChristoph Hellwig blk_status_t errno_to_blk_status(int errno);
8892a842acaSChristoph Hellwig 
890ef99b2d3SChristoph Hellwig /* only poll the hardware once, don't continue until a completion was found */
891ef99b2d3SChristoph Hellwig #define BLK_POLL_ONESHOT		(1 << 0)
892d729cf9aSChristoph Hellwig /* do not sleep to wait for the expected completion time */
893d729cf9aSChristoph Hellwig #define BLK_POLL_NOSLEEP		(1 << 1)
8945a72e899SJens Axboe int bio_poll(struct bio *bio, struct io_comp_batch *iob, unsigned int flags);
8955a72e899SJens Axboe int iocb_bio_iopoll(struct kiocb *kiocb, struct io_comp_batch *iob,
8965a72e899SJens Axboe 			unsigned int flags);
89705229beeSJens Axboe 
898165125e1SJens Axboe static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
8991da177e4SLinus Torvalds {
90017220ca5SPavel Begunkov 	return bdev->bd_queue;	/* this is never NULL */
9011da177e4SLinus Torvalds }
9021da177e4SLinus Torvalds 
90302694e86SChaitanya Kulkarni /* Helper to convert BLK_ZONE_ZONE_XXX to its string format XXX */
90402694e86SChaitanya Kulkarni const char *blk_zone_cond_str(enum blk_zone_cond zone_cond);
90502694e86SChaitanya Kulkarni 
906d0ea6bdeSDamien Le Moal static inline unsigned int bio_zone_no(struct bio *bio)
907d0ea6bdeSDamien Le Moal {
908d0ea6bdeSDamien Le Moal 	return blk_queue_zone_no(bdev_get_queue(bio->bi_bdev),
909d0ea6bdeSDamien Le Moal 				 bio->bi_iter.bi_sector);
910d0ea6bdeSDamien Le Moal }
911d0ea6bdeSDamien Le Moal 
912d0ea6bdeSDamien Le Moal static inline unsigned int bio_zone_is_seq(struct bio *bio)
913d0ea6bdeSDamien Le Moal {
914d0ea6bdeSDamien Le Moal 	return blk_queue_zone_is_seq(bdev_get_queue(bio->bi_bdev),
915d0ea6bdeSDamien Le Moal 				     bio->bi_iter.bi_sector);
916d0ea6bdeSDamien Le Moal }
9176cc77e9cSChristoph Hellwig 
918762380adSJens Axboe /*
9198689461bSChristoph Hellwig  * Return how much of the chunk is left to be used for I/O at a given offset.
9208689461bSChristoph Hellwig  */
9218689461bSChristoph Hellwig static inline unsigned int blk_chunk_sectors_left(sector_t offset,
9228689461bSChristoph Hellwig 		unsigned int chunk_sectors)
9238689461bSChristoph Hellwig {
9248689461bSChristoph Hellwig 	if (unlikely(!is_power_of_2(chunk_sectors)))
9258689461bSChristoph Hellwig 		return chunk_sectors - sector_div(offset, chunk_sectors);
9268689461bSChristoph Hellwig 	return chunk_sectors - (offset & (chunk_sectors - 1));
9278689461bSChristoph Hellwig }
9288689461bSChristoph Hellwig 
9298689461bSChristoph Hellwig /*
9301da177e4SLinus Torvalds  * Access functions for manipulating queue properties
9311da177e4SLinus Torvalds  */
9329bb33f24SChristoph Hellwig void blk_queue_bounce_limit(struct request_queue *q, enum blk_bounce limit);
933086fa5ffSMartin K. Petersen extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
934762380adSJens Axboe extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
9358a78362cSMartin K. Petersen extern void blk_queue_max_segments(struct request_queue *, unsigned short);
9361e739730SChristoph Hellwig extern void blk_queue_max_discard_segments(struct request_queue *,
9371e739730SChristoph Hellwig 		unsigned short);
93844abff2cSChristoph Hellwig void blk_queue_max_secure_erase_sectors(struct request_queue *q,
93944abff2cSChristoph Hellwig 		unsigned int max_sectors);
940165125e1SJens Axboe extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
94167efc925SChristoph Hellwig extern void blk_queue_max_discard_sectors(struct request_queue *q,
94267efc925SChristoph Hellwig 		unsigned int max_discard_sectors);
943a6f0788eSChaitanya Kulkarni extern void blk_queue_max_write_zeroes_sectors(struct request_queue *q,
944a6f0788eSChaitanya Kulkarni 		unsigned int max_write_same_sectors);
945ad6bf88aSMikulas Patocka extern void blk_queue_logical_block_size(struct request_queue *, unsigned int);
9460512a75bSKeith Busch extern void blk_queue_max_zone_append_sectors(struct request_queue *q,
9470512a75bSKeith Busch 		unsigned int max_zone_append_sectors);
948892b6f90SMartin K. Petersen extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
949a805a4faSDamien Le Moal void blk_queue_zone_write_granularity(struct request_queue *q,
950a805a4faSDamien Le Moal 				      unsigned int size);
951c72758f3SMartin K. Petersen extern void blk_queue_alignment_offset(struct request_queue *q,
952c72758f3SMartin K. Petersen 				       unsigned int alignment);
953471aa704SChristoph Hellwig void disk_update_readahead(struct gendisk *disk);
9547c958e32SMartin K. Petersen extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
955c72758f3SMartin K. Petersen extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
9563c5820c7SMartin K. Petersen extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
957c72758f3SMartin K. Petersen extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
958d278d4a8SJens Axboe extern void blk_set_queue_depth(struct request_queue *q, unsigned int depth);
959e475bba2SMartin K. Petersen extern void blk_set_default_limits(struct queue_limits *lim);
960b1bd055dSMartin K. Petersen extern void blk_set_stacking_limits(struct queue_limits *lim);
961c72758f3SMartin K. Petersen extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
962c72758f3SMartin K. Petersen 			    sector_t offset);
963c72758f3SMartin K. Petersen extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
964c72758f3SMartin K. Petersen 			      sector_t offset);
96527f8221aSFUJITA Tomonori extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
966165125e1SJens Axboe extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
96703100aadSKeith Busch extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
968165125e1SJens Axboe extern void blk_queue_dma_alignment(struct request_queue *, int);
96911c3e689SJames Bottomley extern void blk_queue_update_dma_alignment(struct request_queue *, int);
970242f9dcbSJens Axboe extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
97193e9d8e8SJens Axboe extern void blk_queue_write_cache(struct request_queue *q, bool enabled, bool fua);
9722e9bc346SChristoph Hellwig 
973a2247f19SDamien Le Moal struct blk_independent_access_ranges *
974a2247f19SDamien Le Moal disk_alloc_independent_access_ranges(struct gendisk *disk, int nr_ia_ranges);
975a2247f19SDamien Le Moal void disk_set_independent_access_ranges(struct gendisk *disk,
976a2247f19SDamien Le Moal 				struct blk_independent_access_ranges *iars);
977a2247f19SDamien Le Moal 
9782e9bc346SChristoph Hellwig /*
9792e9bc346SChristoph Hellwig  * Elevator features for blk_queue_required_elevator_features:
9802e9bc346SChristoph Hellwig  */
9812e9bc346SChristoph Hellwig /* Supports zoned block devices sequential write constraint */
9822e9bc346SChristoph Hellwig #define ELEVATOR_F_ZBD_SEQ_WRITE	(1U << 0)
9832e9bc346SChristoph Hellwig 
98468c43f13SDamien Le Moal extern void blk_queue_required_elevator_features(struct request_queue *q,
98568c43f13SDamien Le Moal 						 unsigned int features);
98645147fb5SYoshihiro Shimoda extern bool blk_queue_can_use_dma_map_merging(struct request_queue *q,
98745147fb5SYoshihiro Shimoda 					      struct device *dev);
9881da177e4SLinus Torvalds 
98909ac46c4STejun Heo bool __must_check blk_get_queue(struct request_queue *);
990165125e1SJens Axboe extern void blk_put_queue(struct request_queue *);
9917a5428dcSChristoph Hellwig 
9927a5428dcSChristoph Hellwig void blk_mark_disk_dead(struct gendisk *disk);
9931da177e4SLinus Torvalds 
9941a4dcfa8SChristoph Hellwig #ifdef CONFIG_BLOCK
995316cc67dSShaohua Li /*
99675df7136SSuresh Jayaraman  * blk_plug permits building a queue of related requests by holding the I/O
99775df7136SSuresh Jayaraman  * fragments for a short period. This allows merging of sequential requests
99875df7136SSuresh Jayaraman  * into single larger request. As the requests are moved from a per-task list to
99975df7136SSuresh Jayaraman  * the device's request_queue in a batch, this results in improved scalability
100075df7136SSuresh Jayaraman  * as the lock contention for request_queue lock is reduced.
100175df7136SSuresh Jayaraman  *
100275df7136SSuresh Jayaraman  * It is ok not to disable preemption when adding the request to the plug list
1003008f75a2SChristoph Hellwig  * or when attempting a merge. For details, please see schedule() where
1004008f75a2SChristoph Hellwig  * blk_flush_plug() is called.
1005316cc67dSShaohua Li  */
100673c10101SJens Axboe struct blk_plug {
1007bc490f81SJens Axboe 	struct request *mq_list; /* blk-mq requests */
100847c122e3SJens Axboe 
100947c122e3SJens Axboe 	/* if ios_left is > 1, we can batch tag/rq allocations */
101047c122e3SJens Axboe 	struct request *cached_rq;
101147c122e3SJens Axboe 	unsigned short nr_ios;
101247c122e3SJens Axboe 
10135f0ed774SJens Axboe 	unsigned short rq_count;
101447c122e3SJens Axboe 
1015ce5b009cSJens Axboe 	bool multiple_queues;
1016dc5fc361SJens Axboe 	bool has_elevator;
10175a473e83SJens Axboe 	bool nowait;
101847c122e3SJens Axboe 
101947c122e3SJens Axboe 	struct list_head cb_list; /* md requires an unplug callback */
102073c10101SJens Axboe };
102155c022bbSShaohua Li 
10229cbb1750SNeilBrown struct blk_plug_cb;
102374018dc3SNeilBrown typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
1024048c9374SNeilBrown struct blk_plug_cb {
1025048c9374SNeilBrown 	struct list_head list;
10269cbb1750SNeilBrown 	blk_plug_cb_fn callback;
10279cbb1750SNeilBrown 	void *data;
1028048c9374SNeilBrown };
10299cbb1750SNeilBrown extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
10309cbb1750SNeilBrown 					     void *data, int size);
103173c10101SJens Axboe extern void blk_start_plug(struct blk_plug *);
103247c122e3SJens Axboe extern void blk_start_plug_nr_ios(struct blk_plug *, unsigned short);
103373c10101SJens Axboe extern void blk_finish_plug(struct blk_plug *);
103473c10101SJens Axboe 
1035aa8dcccaSChristoph Hellwig void __blk_flush_plug(struct blk_plug *plug, bool from_schedule);
1036aa8dcccaSChristoph Hellwig static inline void blk_flush_plug(struct blk_plug *plug, bool async)
103773c10101SJens Axboe {
1038aa8dcccaSChristoph Hellwig 	if (plug)
1039aa8dcccaSChristoph Hellwig 		__blk_flush_plug(plug, async);
104073c10101SJens Axboe }
104173c10101SJens Axboe 
1042c6bf3f0eSChristoph Hellwig int blkdev_issue_flush(struct block_device *bdev);
10431a4dcfa8SChristoph Hellwig long nr_blockdev_pages(void);
10441a4dcfa8SChristoph Hellwig #else /* CONFIG_BLOCK */
10451a4dcfa8SChristoph Hellwig struct blk_plug {
10461a4dcfa8SChristoph Hellwig };
10471a4dcfa8SChristoph Hellwig 
104847c122e3SJens Axboe static inline void blk_start_plug_nr_ios(struct blk_plug *plug,
104947c122e3SJens Axboe 					 unsigned short nr_ios)
105047c122e3SJens Axboe {
105147c122e3SJens Axboe }
105247c122e3SJens Axboe 
10531a4dcfa8SChristoph Hellwig static inline void blk_start_plug(struct blk_plug *plug)
10541a4dcfa8SChristoph Hellwig {
10551a4dcfa8SChristoph Hellwig }
10561a4dcfa8SChristoph Hellwig 
10571a4dcfa8SChristoph Hellwig static inline void blk_finish_plug(struct blk_plug *plug)
10581a4dcfa8SChristoph Hellwig {
10591a4dcfa8SChristoph Hellwig }
10601a4dcfa8SChristoph Hellwig 
1061008f75a2SChristoph Hellwig static inline void blk_flush_plug(struct blk_plug *plug, bool async)
10621a4dcfa8SChristoph Hellwig {
10631a4dcfa8SChristoph Hellwig }
10641a4dcfa8SChristoph Hellwig 
1065c6bf3f0eSChristoph Hellwig static inline int blkdev_issue_flush(struct block_device *bdev)
10661a4dcfa8SChristoph Hellwig {
10671a4dcfa8SChristoph Hellwig 	return 0;
10681a4dcfa8SChristoph Hellwig }
10691a4dcfa8SChristoph Hellwig 
10701a4dcfa8SChristoph Hellwig static inline long nr_blockdev_pages(void)
10711a4dcfa8SChristoph Hellwig {
10721a4dcfa8SChristoph Hellwig 	return 0;
10731a4dcfa8SChristoph Hellwig }
10741a4dcfa8SChristoph Hellwig #endif /* CONFIG_BLOCK */
10751a4dcfa8SChristoph Hellwig 
107671ac860aSMing Lei extern void blk_io_schedule(void);
107771ac860aSMing Lei 
107844abff2cSChristoph Hellwig int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
107944abff2cSChristoph Hellwig 		sector_t nr_sects, gfp_t gfp_mask);
108044abff2cSChristoph Hellwig int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
108144abff2cSChristoph Hellwig 		sector_t nr_sects, gfp_t gfp_mask, struct bio **biop);
108244abff2cSChristoph Hellwig int blkdev_issue_secure_erase(struct block_device *bdev, sector_t sector,
108344abff2cSChristoph Hellwig 		sector_t nr_sects, gfp_t gfp);
1084ee472d83SChristoph Hellwig 
1085ee472d83SChristoph Hellwig #define BLKDEV_ZERO_NOUNMAP	(1 << 0)  /* do not free blocks */
1086cb365b96SChristoph Hellwig #define BLKDEV_ZERO_NOFALLBACK	(1 << 1)  /* don't write explicit zeroes */
1087ee472d83SChristoph Hellwig 
1088e73c23ffSChaitanya Kulkarni extern int __blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1089e73c23ffSChaitanya Kulkarni 		sector_t nr_sects, gfp_t gfp_mask, struct bio **biop,
1090ee472d83SChristoph Hellwig 		unsigned flags);
10913f14d792SDmitry Monakhov extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1092ee472d83SChristoph Hellwig 		sector_t nr_sects, gfp_t gfp_mask, unsigned flags);
1093ee472d83SChristoph Hellwig 
10942cf6d26aSChristoph Hellwig static inline int sb_issue_discard(struct super_block *sb, sector_t block,
10952cf6d26aSChristoph Hellwig 		sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
1096fb2dce86SDavid Woodhouse {
1097233bde21SBart Van Assche 	return blkdev_issue_discard(sb->s_bdev,
1098233bde21SBart Van Assche 				    block << (sb->s_blocksize_bits -
1099233bde21SBart Van Assche 					      SECTOR_SHIFT),
1100233bde21SBart Van Assche 				    nr_blocks << (sb->s_blocksize_bits -
1101233bde21SBart Van Assche 						  SECTOR_SHIFT),
110244abff2cSChristoph Hellwig 				    gfp_mask);
1103fb2dce86SDavid Woodhouse }
1104e6fa0be6SLukas Czerner static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
1105a107e5a3STheodore Ts'o 		sector_t nr_blocks, gfp_t gfp_mask)
1106e6fa0be6SLukas Czerner {
1107e6fa0be6SLukas Czerner 	return blkdev_issue_zeroout(sb->s_bdev,
1108233bde21SBart Van Assche 				    block << (sb->s_blocksize_bits -
1109233bde21SBart Van Assche 					      SECTOR_SHIFT),
1110233bde21SBart Van Assche 				    nr_blocks << (sb->s_blocksize_bits -
1111233bde21SBart Van Assche 						  SECTOR_SHIFT),
1112ee472d83SChristoph Hellwig 				    gfp_mask, 0);
1113e6fa0be6SLukas Czerner }
11141da177e4SLinus Torvalds 
1115fa01b1e9SChristoph Hellwig static inline bool bdev_is_partition(struct block_device *bdev)
1116fa01b1e9SChristoph Hellwig {
1117fa01b1e9SChristoph Hellwig 	return bdev->bd_partno;
1118fa01b1e9SChristoph Hellwig }
1119fa01b1e9SChristoph Hellwig 
1120eb28d31bSMartin K. Petersen enum blk_default_limits {
1121eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENTS	= 128,
1122eb28d31bSMartin K. Petersen 	BLK_SAFE_MAX_SECTORS	= 255,
1123d2be537cSJeff Moyer 	BLK_DEF_MAX_SECTORS	= 2560,
1124eb28d31bSMartin K. Petersen 	BLK_MAX_SEGMENT_SIZE	= 65536,
1125eb28d31bSMartin K. Petersen 	BLK_SEG_BOUNDARY_MASK	= 0xFFFFFFFFUL,
1126eb28d31bSMartin K. Petersen };
11270e435ac2SMilan Broz 
1128af2c68feSBart Van Assche static inline unsigned long queue_segment_boundary(const struct request_queue *q)
1129ae03bf63SMartin K. Petersen {
1130025146e1SMartin K. Petersen 	return q->limits.seg_boundary_mask;
1131ae03bf63SMartin K. Petersen }
1132ae03bf63SMartin K. Petersen 
1133af2c68feSBart Van Assche static inline unsigned long queue_virt_boundary(const struct request_queue *q)
113403100aadSKeith Busch {
113503100aadSKeith Busch 	return q->limits.virt_boundary_mask;
113603100aadSKeith Busch }
113703100aadSKeith Busch 
1138af2c68feSBart Van Assche static inline unsigned int queue_max_sectors(const struct request_queue *q)
1139ae03bf63SMartin K. Petersen {
1140025146e1SMartin K. Petersen 	return q->limits.max_sectors;
1141ae03bf63SMartin K. Petersen }
1142ae03bf63SMartin K. Petersen 
1143547e2f70SChristoph Hellwig static inline unsigned int queue_max_bytes(struct request_queue *q)
1144547e2f70SChristoph Hellwig {
1145547e2f70SChristoph Hellwig 	return min_t(unsigned int, queue_max_sectors(q), INT_MAX >> 9) << 9;
1146547e2f70SChristoph Hellwig }
1147547e2f70SChristoph Hellwig 
1148af2c68feSBart Van Assche static inline unsigned int queue_max_hw_sectors(const struct request_queue *q)
1149ae03bf63SMartin K. Petersen {
1150025146e1SMartin K. Petersen 	return q->limits.max_hw_sectors;
1151ae03bf63SMartin K. Petersen }
1152ae03bf63SMartin K. Petersen 
1153af2c68feSBart Van Assche static inline unsigned short queue_max_segments(const struct request_queue *q)
1154ae03bf63SMartin K. Petersen {
11558a78362cSMartin K. Petersen 	return q->limits.max_segments;
1156ae03bf63SMartin K. Petersen }
1157ae03bf63SMartin K. Petersen 
1158af2c68feSBart Van Assche static inline unsigned short queue_max_discard_segments(const struct request_queue *q)
11591e739730SChristoph Hellwig {
11601e739730SChristoph Hellwig 	return q->limits.max_discard_segments;
11611e739730SChristoph Hellwig }
11621e739730SChristoph Hellwig 
1163af2c68feSBart Van Assche static inline unsigned int queue_max_segment_size(const struct request_queue *q)
1164ae03bf63SMartin K. Petersen {
1165025146e1SMartin K. Petersen 	return q->limits.max_segment_size;
1166ae03bf63SMartin K. Petersen }
1167ae03bf63SMartin K. Petersen 
11680512a75bSKeith Busch static inline unsigned int queue_max_zone_append_sectors(const struct request_queue *q)
11690512a75bSKeith Busch {
1170fe6f0cdcSJohannes Thumshirn 
1171fe6f0cdcSJohannes Thumshirn 	const struct queue_limits *l = &q->limits;
1172fe6f0cdcSJohannes Thumshirn 
1173fe6f0cdcSJohannes Thumshirn 	return min(l->max_zone_append_sectors, l->max_sectors);
11740512a75bSKeith Busch }
11750512a75bSKeith Busch 
11762aba0d19SChristoph Hellwig static inline unsigned int
11772aba0d19SChristoph Hellwig bdev_max_zone_append_sectors(struct block_device *bdev)
11782aba0d19SChristoph Hellwig {
11792aba0d19SChristoph Hellwig 	return queue_max_zone_append_sectors(bdev_get_queue(bdev));
11802aba0d19SChristoph Hellwig }
11812aba0d19SChristoph Hellwig 
1182ad6bf88aSMikulas Patocka static inline unsigned queue_logical_block_size(const struct request_queue *q)
11831da177e4SLinus Torvalds {
11841da177e4SLinus Torvalds 	int retval = 512;
11851da177e4SLinus Torvalds 
1186025146e1SMartin K. Petersen 	if (q && q->limits.logical_block_size)
1187025146e1SMartin K. Petersen 		retval = q->limits.logical_block_size;
11881da177e4SLinus Torvalds 
11891da177e4SLinus Torvalds 	return retval;
11901da177e4SLinus Torvalds }
11911da177e4SLinus Torvalds 
1192ad6bf88aSMikulas Patocka static inline unsigned int bdev_logical_block_size(struct block_device *bdev)
11931da177e4SLinus Torvalds {
1194e1defc4fSMartin K. Petersen 	return queue_logical_block_size(bdev_get_queue(bdev));
11951da177e4SLinus Torvalds }
11961da177e4SLinus Torvalds 
1197af2c68feSBart Van Assche static inline unsigned int queue_physical_block_size(const struct request_queue *q)
1198c72758f3SMartin K. Petersen {
1199c72758f3SMartin K. Petersen 	return q->limits.physical_block_size;
1200c72758f3SMartin K. Petersen }
1201c72758f3SMartin K. Petersen 
1202892b6f90SMartin K. Petersen static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
1203ac481c20SMartin K. Petersen {
1204ac481c20SMartin K. Petersen 	return queue_physical_block_size(bdev_get_queue(bdev));
1205ac481c20SMartin K. Petersen }
1206ac481c20SMartin K. Petersen 
1207af2c68feSBart Van Assche static inline unsigned int queue_io_min(const struct request_queue *q)
1208c72758f3SMartin K. Petersen {
1209c72758f3SMartin K. Petersen 	return q->limits.io_min;
1210c72758f3SMartin K. Petersen }
1211c72758f3SMartin K. Petersen 
1212ac481c20SMartin K. Petersen static inline int bdev_io_min(struct block_device *bdev)
1213ac481c20SMartin K. Petersen {
1214ac481c20SMartin K. Petersen 	return queue_io_min(bdev_get_queue(bdev));
1215ac481c20SMartin K. Petersen }
1216ac481c20SMartin K. Petersen 
1217af2c68feSBart Van Assche static inline unsigned int queue_io_opt(const struct request_queue *q)
1218c72758f3SMartin K. Petersen {
1219c72758f3SMartin K. Petersen 	return q->limits.io_opt;
1220c72758f3SMartin K. Petersen }
1221c72758f3SMartin K. Petersen 
1222ac481c20SMartin K. Petersen static inline int bdev_io_opt(struct block_device *bdev)
1223ac481c20SMartin K. Petersen {
1224ac481c20SMartin K. Petersen 	return queue_io_opt(bdev_get_queue(bdev));
1225ac481c20SMartin K. Petersen }
1226ac481c20SMartin K. Petersen 
1227a805a4faSDamien Le Moal static inline unsigned int
1228a805a4faSDamien Le Moal queue_zone_write_granularity(const struct request_queue *q)
1229a805a4faSDamien Le Moal {
1230a805a4faSDamien Le Moal 	return q->limits.zone_write_granularity;
1231a805a4faSDamien Le Moal }
1232a805a4faSDamien Le Moal 
1233a805a4faSDamien Le Moal static inline unsigned int
1234a805a4faSDamien Le Moal bdev_zone_write_granularity(struct block_device *bdev)
1235a805a4faSDamien Le Moal {
1236a805a4faSDamien Le Moal 	return queue_zone_write_granularity(bdev_get_queue(bdev));
1237a805a4faSDamien Le Moal }
1238a805a4faSDamien Le Moal 
123989098b07SChristoph Hellwig int bdev_alignment_offset(struct block_device *bdev);
12405c4b4a5cSChristoph Hellwig unsigned int bdev_discard_alignment(struct block_device *bdev);
1241c6e66634SPaolo Bonzini 
1242cf0fbf89SChristoph Hellwig static inline unsigned int bdev_max_discard_sectors(struct block_device *bdev)
1243cf0fbf89SChristoph Hellwig {
1244cf0fbf89SChristoph Hellwig 	return bdev_get_queue(bdev)->limits.max_discard_sectors;
1245cf0fbf89SChristoph Hellwig }
1246cf0fbf89SChristoph Hellwig 
12477b47ef52SChristoph Hellwig static inline unsigned int bdev_discard_granularity(struct block_device *bdev)
12487b47ef52SChristoph Hellwig {
12497b47ef52SChristoph Hellwig 	return bdev_get_queue(bdev)->limits.discard_granularity;
12507b47ef52SChristoph Hellwig }
12517b47ef52SChristoph Hellwig 
125244abff2cSChristoph Hellwig static inline unsigned int
125344abff2cSChristoph Hellwig bdev_max_secure_erase_sectors(struct block_device *bdev)
125444abff2cSChristoph Hellwig {
125544abff2cSChristoph Hellwig 	return bdev_get_queue(bdev)->limits.max_secure_erase_sectors;
125644abff2cSChristoph Hellwig }
125744abff2cSChristoph Hellwig 
1258a6f0788eSChaitanya Kulkarni static inline unsigned int bdev_write_zeroes_sectors(struct block_device *bdev)
1259a6f0788eSChaitanya Kulkarni {
1260a6f0788eSChaitanya Kulkarni 	struct request_queue *q = bdev_get_queue(bdev);
1261a6f0788eSChaitanya Kulkarni 
1262a6f0788eSChaitanya Kulkarni 	if (q)
1263a6f0788eSChaitanya Kulkarni 		return q->limits.max_write_zeroes_sectors;
1264a6f0788eSChaitanya Kulkarni 
1265a6f0788eSChaitanya Kulkarni 	return 0;
1266a6f0788eSChaitanya Kulkarni }
1267a6f0788eSChaitanya Kulkarni 
126810f0d2a5SChristoph Hellwig static inline bool bdev_nonrot(struct block_device *bdev)
126910f0d2a5SChristoph Hellwig {
127010f0d2a5SChristoph Hellwig 	return blk_queue_nonrot(bdev_get_queue(bdev));
127110f0d2a5SChristoph Hellwig }
127210f0d2a5SChristoph Hellwig 
127336d25489SChristoph Hellwig static inline bool bdev_stable_writes(struct block_device *bdev)
127436d25489SChristoph Hellwig {
127536d25489SChristoph Hellwig 	return test_bit(QUEUE_FLAG_STABLE_WRITES,
127636d25489SChristoph Hellwig 			&bdev_get_queue(bdev)->queue_flags);
127736d25489SChristoph Hellwig }
127836d25489SChristoph Hellwig 
127908e688fdSChristoph Hellwig static inline bool bdev_write_cache(struct block_device *bdev)
128008e688fdSChristoph Hellwig {
128108e688fdSChristoph Hellwig 	return test_bit(QUEUE_FLAG_WC, &bdev_get_queue(bdev)->queue_flags);
128208e688fdSChristoph Hellwig }
128308e688fdSChristoph Hellwig 
1284a557e82eSChristoph Hellwig static inline bool bdev_fua(struct block_device *bdev)
1285a557e82eSChristoph Hellwig {
1286a557e82eSChristoph Hellwig 	return test_bit(QUEUE_FLAG_FUA, &bdev_get_queue(bdev)->queue_flags);
1287a557e82eSChristoph Hellwig }
1288a557e82eSChristoph Hellwig 
1289797476b8SDamien Le Moal static inline enum blk_zoned_model bdev_zoned_model(struct block_device *bdev)
1290797476b8SDamien Le Moal {
1291797476b8SDamien Le Moal 	struct request_queue *q = bdev_get_queue(bdev);
1292797476b8SDamien Le Moal 
1293797476b8SDamien Le Moal 	if (q)
1294797476b8SDamien Le Moal 		return blk_queue_zoned_model(q);
1295797476b8SDamien Le Moal 
1296797476b8SDamien Le Moal 	return BLK_ZONED_NONE;
1297797476b8SDamien Le Moal }
1298797476b8SDamien Le Moal 
1299797476b8SDamien Le Moal static inline bool bdev_is_zoned(struct block_device *bdev)
1300797476b8SDamien Le Moal {
1301797476b8SDamien Le Moal 	struct request_queue *q = bdev_get_queue(bdev);
1302797476b8SDamien Le Moal 
1303797476b8SDamien Le Moal 	if (q)
1304797476b8SDamien Le Moal 		return blk_queue_is_zoned(q);
1305797476b8SDamien Le Moal 
1306797476b8SDamien Le Moal 	return false;
1307797476b8SDamien Le Moal }
1308797476b8SDamien Le Moal 
1309113ab72eSDamien Le Moal static inline sector_t bdev_zone_sectors(struct block_device *bdev)
13106a0cb1bcSHannes Reinecke {
13116a0cb1bcSHannes Reinecke 	struct request_queue *q = bdev_get_queue(bdev);
13126a0cb1bcSHannes Reinecke 
13136a0cb1bcSHannes Reinecke 	if (q)
1314f99e8648SDamien Le Moal 		return blk_queue_zone_sectors(q);
13156cc77e9cSChristoph Hellwig 	return 0;
13166cc77e9cSChristoph Hellwig }
13176a0cb1bcSHannes Reinecke 
1318af2c68feSBart Van Assche static inline int queue_dma_alignment(const struct request_queue *q)
13191da177e4SLinus Torvalds {
1320482eb689SPete Wyckoff 	return q ? q->dma_alignment : 511;
13211da177e4SLinus Torvalds }
13221da177e4SLinus Torvalds 
13234a2dcc35SKeith Busch static inline unsigned int bdev_dma_alignment(struct block_device *bdev)
13244a2dcc35SKeith Busch {
13254a2dcc35SKeith Busch 	return queue_dma_alignment(bdev_get_queue(bdev));
13264a2dcc35SKeith Busch }
13274a2dcc35SKeith Busch 
13285debd969SKeith Busch static inline bool bdev_iter_is_aligned(struct block_device *bdev,
13295debd969SKeith Busch 					struct iov_iter *iter)
13305debd969SKeith Busch {
13315debd969SKeith Busch 	return iov_iter_is_aligned(iter, bdev_dma_alignment(bdev),
13325debd969SKeith Busch 				   bdev_logical_block_size(bdev) - 1);
13335debd969SKeith Busch }
13345debd969SKeith Busch 
133514417799SNamhyung Kim static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
133687904074SFUJITA Tomonori 				 unsigned int len)
133787904074SFUJITA Tomonori {
133887904074SFUJITA Tomonori 	unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
133914417799SNamhyung Kim 	return !(addr & alignment) && !(len & alignment);
134087904074SFUJITA Tomonori }
134187904074SFUJITA Tomonori 
13421da177e4SLinus Torvalds /* assumes size > 256 */
13431da177e4SLinus Torvalds static inline unsigned int blksize_bits(unsigned int size)
13441da177e4SLinus Torvalds {
13451da177e4SLinus Torvalds 	unsigned int bits = 8;
13461da177e4SLinus Torvalds 	do {
13471da177e4SLinus Torvalds 		bits++;
13481da177e4SLinus Torvalds 		size >>= 1;
13491da177e4SLinus Torvalds 	} while (size > 256);
13501da177e4SLinus Torvalds 	return bits;
13511da177e4SLinus Torvalds }
13521da177e4SLinus Torvalds 
13532befb9e3SAdrian Bunk static inline unsigned int block_size(struct block_device *bdev)
13541da177e4SLinus Torvalds {
13556b7b181bSChristoph Hellwig 	return 1 << bdev->bd_inode->i_blkbits;
13561da177e4SLinus Torvalds }
13571da177e4SLinus Torvalds 
135859c3d45eSJens Axboe int kblockd_schedule_work(struct work_struct *work);
1359818cd1cbSJens Axboe int kblockd_mod_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
13601da177e4SLinus Torvalds 
13611da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV(major,minor) \
13621da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
13631da177e4SLinus Torvalds #define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
13641da177e4SLinus Torvalds 	MODULE_ALIAS("block-major-" __stringify(major) "-*")
13651da177e4SLinus Torvalds 
1366d145dc23SSatya Tangirala #ifdef CONFIG_BLK_INLINE_ENCRYPTION
1367d145dc23SSatya Tangirala 
1368cb77cb5aSEric Biggers bool blk_crypto_register(struct blk_crypto_profile *profile,
1369cb77cb5aSEric Biggers 			 struct request_queue *q);
1370d145dc23SSatya Tangirala 
1371d145dc23SSatya Tangirala #else /* CONFIG_BLK_INLINE_ENCRYPTION */
1372d145dc23SSatya Tangirala 
1373cb77cb5aSEric Biggers static inline bool blk_crypto_register(struct blk_crypto_profile *profile,
1374d145dc23SSatya Tangirala 				       struct request_queue *q)
1375d145dc23SSatya Tangirala {
1376d145dc23SSatya Tangirala 	return true;
1377d145dc23SSatya Tangirala }
1378d145dc23SSatya Tangirala 
1379d145dc23SSatya Tangirala #endif /* CONFIG_BLK_INLINE_ENCRYPTION */
1380d145dc23SSatya Tangirala 
13819208d414SChristoph Hellwig enum blk_unique_id {
13829208d414SChristoph Hellwig 	/* these match the Designator Types specified in SPC */
13839208d414SChristoph Hellwig 	BLK_UID_T10	= 1,
13849208d414SChristoph Hellwig 	BLK_UID_EUI64	= 2,
13859208d414SChristoph Hellwig 	BLK_UID_NAA	= 3,
13869208d414SChristoph Hellwig };
13879208d414SChristoph Hellwig 
13889208d414SChristoph Hellwig #define NFL4_UFLG_MASK			0x0000003F
1389d145dc23SSatya Tangirala 
139008f85851SAl Viro struct block_device_operations {
13913e08773cSChristoph Hellwig 	void (*submit_bio)(struct bio *bio);
139269fe0f29SMing Lei 	int (*poll_bio)(struct bio *bio, struct io_comp_batch *iob,
139369fe0f29SMing Lei 			unsigned int flags);
1394d4430d62SAl Viro 	int (*open) (struct block_device *, fmode_t);
1395db2a144bSAl Viro 	void (*release) (struct gendisk *, fmode_t);
13963f289dcbSTejun Heo 	int (*rw_page)(struct block_device *, sector_t, struct page *, unsigned int);
1397d4430d62SAl Viro 	int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1398d4430d62SAl Viro 	int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
139977ea887eSTejun Heo 	unsigned int (*check_events) (struct gendisk *disk,
140077ea887eSTejun Heo 				      unsigned int clearing);
1401c3e33e04STejun Heo 	void (*unlock_native_capacity) (struct gendisk *);
140208f85851SAl Viro 	int (*getgeo)(struct block_device *, struct hd_geometry *);
1403e00adcadSChristoph Hellwig 	int (*set_read_only)(struct block_device *bdev, bool ro);
140476792055SChristoph Hellwig 	void (*free_disk)(struct gendisk *disk);
1405b3a27d05SNitin Gupta 	/* this callback is with swap_lock and sometimes page table lock held */
1406b3a27d05SNitin Gupta 	void (*swap_slot_free_notify) (struct block_device *, unsigned long);
1407e76239a3SChristoph Hellwig 	int (*report_zones)(struct gendisk *, sector_t sector,
1408d4100351SChristoph Hellwig 			unsigned int nr_zones, report_zones_cb cb, void *data);
1409348e114bSChristoph Hellwig 	char *(*devnode)(struct gendisk *disk, umode_t *mode);
14109208d414SChristoph Hellwig 	/* returns the length of the identifier or a negative errno: */
14119208d414SChristoph Hellwig 	int (*get_unique_id)(struct gendisk *disk, u8 id[16],
14129208d414SChristoph Hellwig 			enum blk_unique_id id_type);
141308f85851SAl Viro 	struct module *owner;
1414bbd3e064SChristoph Hellwig 	const struct pr_ops *pr_ops;
14150bdfbca8SDmitry Osipenko 
14160bdfbca8SDmitry Osipenko 	/*
14170bdfbca8SDmitry Osipenko 	 * Special callback for probing GPT entry at a given sector.
14180bdfbca8SDmitry Osipenko 	 * Needed by Android devices, used by GPT scanner and MMC blk
14190bdfbca8SDmitry Osipenko 	 * driver.
14200bdfbca8SDmitry Osipenko 	 */
14210bdfbca8SDmitry Osipenko 	int (*alternative_gpt_sector)(struct gendisk *disk, sector_t *sector);
142208f85851SAl Viro };
142308f85851SAl Viro 
1424ee6a129dSArnd Bergmann #ifdef CONFIG_COMPAT
1425ee6a129dSArnd Bergmann extern int blkdev_compat_ptr_ioctl(struct block_device *, fmode_t,
1426ee6a129dSArnd Bergmann 				      unsigned int, unsigned long);
1427ee6a129dSArnd Bergmann #else
1428ee6a129dSArnd Bergmann #define blkdev_compat_ptr_ioctl NULL
1429ee6a129dSArnd Bergmann #endif
1430ee6a129dSArnd Bergmann 
143147a191fdSMatthew Wilcox extern int bdev_read_page(struct block_device *, sector_t, struct page *);
143247a191fdSMatthew Wilcox extern int bdev_write_page(struct block_device *, sector_t, struct page *,
143347a191fdSMatthew Wilcox 						struct writeback_control *);
14346cc77e9cSChristoph Hellwig 
14350619317fSJens Axboe static inline void blk_wake_io_task(struct task_struct *waiter)
14360619317fSJens Axboe {
14370619317fSJens Axboe 	/*
14380619317fSJens Axboe 	 * If we're polling, the task itself is doing the completions. For
14390619317fSJens Axboe 	 * that case, we don't need to signal a wakeup, it's enough to just
14400619317fSJens Axboe 	 * mark us as RUNNING.
14410619317fSJens Axboe 	 */
14420619317fSJens Axboe 	if (waiter == current)
14430619317fSJens Axboe 		__set_current_state(TASK_RUNNING);
14440619317fSJens Axboe 	else
14450619317fSJens Axboe 		wake_up_process(waiter);
14460619317fSJens Axboe }
14470619317fSJens Axboe 
14485f0614a5SMing Lei unsigned long bdev_start_io_acct(struct block_device *bdev,
14495f0614a5SMing Lei 				 unsigned int sectors, unsigned int op,
14505f0614a5SMing Lei 				 unsigned long start_time);
14515f0614a5SMing Lei void bdev_end_io_acct(struct block_device *bdev, unsigned int op,
1452956d510eSChristoph Hellwig 		unsigned long start_time);
1453956d510eSChristoph Hellwig 
1454e45c47d1SMike Snitzer void bio_start_io_acct_time(struct bio *bio, unsigned long start_time);
145599dfc43eSChristoph Hellwig unsigned long bio_start_io_acct(struct bio *bio);
145699dfc43eSChristoph Hellwig void bio_end_io_acct_remapped(struct bio *bio, unsigned long start_time,
145799dfc43eSChristoph Hellwig 		struct block_device *orig_bdev);
1458956d510eSChristoph Hellwig 
1459956d510eSChristoph Hellwig /**
1460956d510eSChristoph Hellwig  * bio_end_io_acct - end I/O accounting for bio based drivers
1461956d510eSChristoph Hellwig  * @bio:	bio to end account for
1462b42c1fc3SChristoph Hellwig  * @start_time:	start time returned by bio_start_io_acct()
1463956d510eSChristoph Hellwig  */
1464956d510eSChristoph Hellwig static inline void bio_end_io_acct(struct bio *bio, unsigned long start_time)
1465956d510eSChristoph Hellwig {
146699dfc43eSChristoph Hellwig 	return bio_end_io_acct_remapped(bio, start_time, bio->bi_bdev);
1467956d510eSChristoph Hellwig }
1468956d510eSChristoph Hellwig 
14693f1266f1SChristoph Hellwig int bdev_read_only(struct block_device *bdev);
14703f1266f1SChristoph Hellwig int set_blocksize(struct block_device *bdev, int size);
14713f1266f1SChristoph Hellwig 
14723f1266f1SChristoph Hellwig const char *bdevname(struct block_device *bdev, char *buffer);
14734e7b5671SChristoph Hellwig int lookup_bdev(const char *pathname, dev_t *dev);
14743f1266f1SChristoph Hellwig 
14753f1266f1SChristoph Hellwig void blkdev_show(struct seq_file *seqf, off_t offset);
14763f1266f1SChristoph Hellwig 
14773f1266f1SChristoph Hellwig #define BDEVNAME_SIZE	32	/* Largest string for a blockdev identifier */
14783f1266f1SChristoph Hellwig #define BDEVT_SIZE	10	/* Largest string for MAJ:MIN for blkdev */
14793f1266f1SChristoph Hellwig #ifdef CONFIG_BLOCK
14803f1266f1SChristoph Hellwig #define BLKDEV_MAJOR_MAX	512
14813f1266f1SChristoph Hellwig #else
14823f1266f1SChristoph Hellwig #define BLKDEV_MAJOR_MAX	0
14831da177e4SLinus Torvalds #endif
14843f1266f1SChristoph Hellwig 
14853f1266f1SChristoph Hellwig struct block_device *blkdev_get_by_path(const char *path, fmode_t mode,
14863f1266f1SChristoph Hellwig 		void *holder);
14873f1266f1SChristoph Hellwig struct block_device *blkdev_get_by_dev(dev_t dev, fmode_t mode, void *holder);
148837c3fc9aSChristoph Hellwig int bd_prepare_to_claim(struct block_device *bdev, void *holder);
148937c3fc9aSChristoph Hellwig void bd_abort_claiming(struct block_device *bdev, void *holder);
14903f1266f1SChristoph Hellwig void blkdev_put(struct block_device *bdev, fmode_t mode);
14913f1266f1SChristoph Hellwig 
149222ae8ce8SChristoph Hellwig /* just for blk-cgroup, don't use elsewhere */
149322ae8ce8SChristoph Hellwig struct block_device *blkdev_get_no_open(dev_t dev);
149422ae8ce8SChristoph Hellwig void blkdev_put_no_open(struct block_device *bdev);
149522ae8ce8SChristoph Hellwig 
149622ae8ce8SChristoph Hellwig struct block_device *bdev_alloc(struct gendisk *disk, u8 partno);
149722ae8ce8SChristoph Hellwig void bdev_add(struct block_device *bdev, dev_t dev);
1498621c1f42SChristoph Hellwig struct block_device *I_BDEV(struct inode *inode);
14992c2b9fd6SChristoph Hellwig int truncate_bdev_range(struct block_device *bdev, fmode_t mode, loff_t lstart,
15002c2b9fd6SChristoph Hellwig 		loff_t lend);
15013f1266f1SChristoph Hellwig 
15023f1266f1SChristoph Hellwig #ifdef CONFIG_BLOCK
15033f1266f1SChristoph Hellwig void invalidate_bdev(struct block_device *bdev);
15043f1266f1SChristoph Hellwig int sync_blockdev(struct block_device *bdev);
150597d6fb1bSYuezhang Mo int sync_blockdev_range(struct block_device *bdev, loff_t lstart, loff_t lend);
150670164eb6SChristoph Hellwig int sync_blockdev_nowait(struct block_device *bdev);
15071e03a36bSChristoph Hellwig void sync_bdevs(bool wait);
1508322cbb50SChristoph Hellwig void printk_all_partitions(void);
15093f1266f1SChristoph Hellwig #else
15103f1266f1SChristoph Hellwig static inline void invalidate_bdev(struct block_device *bdev)
15113f1266f1SChristoph Hellwig {
15123f1266f1SChristoph Hellwig }
15133f1266f1SChristoph Hellwig static inline int sync_blockdev(struct block_device *bdev)
15143f1266f1SChristoph Hellwig {
15153f1266f1SChristoph Hellwig 	return 0;
15163f1266f1SChristoph Hellwig }
151770164eb6SChristoph Hellwig static inline int sync_blockdev_nowait(struct block_device *bdev)
151870164eb6SChristoph Hellwig {
151970164eb6SChristoph Hellwig 	return 0;
152070164eb6SChristoph Hellwig }
15211e03a36bSChristoph Hellwig static inline void sync_bdevs(bool wait)
15221e03a36bSChristoph Hellwig {
15231e03a36bSChristoph Hellwig }
1524322cbb50SChristoph Hellwig static inline void printk_all_partitions(void)
1525322cbb50SChristoph Hellwig {
1526322cbb50SChristoph Hellwig }
1527322cbb50SChristoph Hellwig #endif /* CONFIG_BLOCK */
1528322cbb50SChristoph Hellwig 
15293f1266f1SChristoph Hellwig int fsync_bdev(struct block_device *bdev);
15303f1266f1SChristoph Hellwig 
1531040f04bdSChristoph Hellwig int freeze_bdev(struct block_device *bdev);
1532040f04bdSChristoph Hellwig int thaw_bdev(struct block_device *bdev);
15333f1266f1SChristoph Hellwig 
15345a72e899SJens Axboe struct io_comp_batch {
15355a72e899SJens Axboe 	struct request *req_list;
15365a72e899SJens Axboe 	bool need_ts;
15375a72e899SJens Axboe 	void (*complete)(struct io_comp_batch *);
15385a72e899SJens Axboe };
15395a72e899SJens Axboe 
15405a72e899SJens Axboe #define DEFINE_IO_COMP_BATCH(name)	struct io_comp_batch name = { }
15415a72e899SJens Axboe 
15423f1266f1SChristoph Hellwig #endif /* _LINUX_BLKDEV_H */
1543