Linux Audio

Check our new training course

Loading...
v4.6
 
  1/*
  2 * Functions related to generic helpers functions
  3 */
  4#include <linux/kernel.h>
  5#include <linux/module.h>
  6#include <linux/bio.h>
  7#include <linux/blkdev.h>
  8#include <linux/scatterlist.h>
  9
 10#include "blk.h"
 11
 12struct bio_batch {
 13	atomic_t		done;
 14	int			error;
 15	struct completion	*wait;
 16};
 17
 18static void bio_batch_end_io(struct bio *bio)
 19{
 20	struct bio_batch *bb = bio->bi_private;
 
 
 
 
 
 21
 22	if (bio->bi_error && bio->bi_error != -EOPNOTSUPP)
 23		bb->error = bio->bi_error;
 24	if (atomic_dec_and_test(&bb->done))
 25		complete(bb->wait);
 26	bio_put(bio);
 27}
 28
 29/**
 30 * blkdev_issue_discard - queue a discard
 31 * @bdev:	blockdev to issue discard for
 32 * @sector:	start sector
 33 * @nr_sects:	number of sectors to discard
 34 * @gfp_mask:	memory allocation flags (for bio_alloc)
 35 * @flags:	BLKDEV_IFL_* flags to control behaviour
 36 *
 37 * Description:
 38 *    Issue a discard request for the sectors in question.
 39 */
 40int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
 41		sector_t nr_sects, gfp_t gfp_mask, unsigned long flags)
 42{
 43	DECLARE_COMPLETION_ONSTACK(wait);
 44	struct request_queue *q = bdev_get_queue(bdev);
 45	int type = REQ_WRITE | REQ_DISCARD;
 46	unsigned int granularity;
 47	int alignment;
 48	struct bio_batch bb;
 49	struct bio *bio;
 50	int ret = 0;
 51	struct blk_plug plug;
 52
 53	if (!q)
 54		return -ENXIO;
 55
 56	if (!blk_queue_discard(q))
 57		return -EOPNOTSUPP;
 58
 59	/* Zero-sector (unknown) and one-sector granularities are the same.  */
 60	granularity = max(q->limits.discard_granularity >> 9, 1U);
 61	alignment = (bdev_discard_alignment(bdev) >> 9) % granularity;
 62
 63	if (flags & BLKDEV_DISCARD_SECURE) {
 64		if (!blk_queue_secdiscard(q))
 
 
 
 
 65			return -EOPNOTSUPP;
 66		type |= REQ_SECURE;
 67	}
 68
 69	atomic_set(&bb.done, 1);
 70	bb.error = 0;
 71	bb.wait = &wait;
 72
 73	blk_start_plug(&plug);
 74	while (nr_sects) {
 75		unsigned int req_sects;
 76		sector_t end_sect, tmp;
 77
 78		bio = bio_alloc(gfp_mask, 1);
 79		if (!bio) {
 80			ret = -ENOMEM;
 81			break;
 82		}
 
 
 
 
 
 83
 84		/* Make sure bi_size doesn't overflow */
 85		req_sects = min_t(sector_t, nr_sects, UINT_MAX >> 9);
 
 
 
 
 86
 87		/*
 88		 * If splitting a request, and the next starting sector would be
 89		 * misaligned, stop the discard at the previous aligned sector.
 
 
 
 
 
 
 
 90		 */
 91		end_sect = sector + req_sects;
 92		tmp = end_sect;
 93		if (req_sects < nr_sects &&
 94		    sector_div(tmp, granularity) != alignment) {
 95			end_sect = end_sect - alignment;
 96			sector_div(end_sect, granularity);
 97			end_sect = end_sect * granularity + alignment;
 98			req_sects = end_sect - sector;
 99		}
100
 
 
 
101		bio->bi_iter.bi_sector = sector;
102		bio->bi_end_io = bio_batch_end_io;
103		bio->bi_bdev = bdev;
104		bio->bi_private = &bb;
105
106		bio->bi_iter.bi_size = req_sects << 9;
 
107		nr_sects -= req_sects;
108		sector = end_sect;
109
110		atomic_inc(&bb.done);
111		submit_bio(type, bio);
112
113		/*
114		 * We can loop for a long time in here, if someone does
115		 * full device discards (like mkfs). Be nice and allow
116		 * us to schedule out to avoid softlocking if preempt
117		 * is disabled.
118		 */
119		cond_resched();
120	}
121	blk_finish_plug(&plug);
122
123	/* Wait for bios in-flight */
124	if (!atomic_dec_and_test(&bb.done))
125		wait_for_completion_io(&wait);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
126
127	if (bb.error)
128		return bb.error;
129	return ret;
130}
131EXPORT_SYMBOL(blkdev_issue_discard);
132
133/**
134 * blkdev_issue_write_same - queue a write same operation
135 * @bdev:	target blockdev
136 * @sector:	start sector
137 * @nr_sects:	number of sectors to write
138 * @gfp_mask:	memory allocation flags (for bio_alloc)
139 * @page:	page containing data to write
 
140 *
141 * Description:
142 *    Issue a write same request for the sectors in question.
143 */
144int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
145			    sector_t nr_sects, gfp_t gfp_mask,
146			    struct page *page)
147{
148	DECLARE_COMPLETION_ONSTACK(wait);
149	struct request_queue *q = bdev_get_queue(bdev);
150	unsigned int max_write_same_sectors;
151	struct bio_batch bb;
152	struct bio *bio;
153	int ret = 0;
154
155	if (!q)
156		return -ENXIO;
157
158	/* Ensure that max_write_same_sectors doesn't overflow bi_size */
159	max_write_same_sectors = UINT_MAX >> 9;
160
161	atomic_set(&bb.done, 1);
162	bb.error = 0;
163	bb.wait = &wait;
164
165	while (nr_sects) {
166		bio = bio_alloc(gfp_mask, 1);
167		if (!bio) {
168			ret = -ENOMEM;
169			break;
170		}
171
 
 
 
 
 
172		bio->bi_iter.bi_sector = sector;
173		bio->bi_end_io = bio_batch_end_io;
174		bio->bi_bdev = bdev;
175		bio->bi_private = &bb;
176		bio->bi_vcnt = 1;
177		bio->bi_io_vec->bv_page = page;
178		bio->bi_io_vec->bv_offset = 0;
179		bio->bi_io_vec->bv_len = bdev_logical_block_size(bdev);
 
180
181		if (nr_sects > max_write_same_sectors) {
182			bio->bi_iter.bi_size = max_write_same_sectors << 9;
183			nr_sects -= max_write_same_sectors;
184			sector += max_write_same_sectors;
185		} else {
186			bio->bi_iter.bi_size = nr_sects << 9;
187			nr_sects = 0;
188		}
189
190		atomic_inc(&bb.done);
191		submit_bio(REQ_WRITE | REQ_WRITE_SAME, bio);
192	}
193
194	/* Wait for bios in-flight */
195	if (!atomic_dec_and_test(&bb.done))
196		wait_for_completion_io(&wait);
197
198	if (bb.error)
199		return bb.error;
200	return ret;
201}
202EXPORT_SYMBOL(blkdev_issue_write_same);
203
204/**
205 * blkdev_issue_zeroout - generate number of zero filed write bios
206 * @bdev:	blockdev to issue
207 * @sector:	start sector
208 * @nr_sects:	number of sectors to write
209 * @gfp_mask:	memory allocation flags (for bio_alloc)
 
210 *
211 * Description:
212 *  Generate and issue number of bios with zerofiled pages.
213 */
214
215static int __blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
216				  sector_t nr_sects, gfp_t gfp_mask)
217{
 
 
218	int ret;
219	struct bio *bio;
220	struct bio_batch bb;
221	unsigned int sz;
222	DECLARE_COMPLETION_ONSTACK(wait);
223
224	atomic_set(&bb.done, 1);
225	bb.error = 0;
226	bb.wait = &wait;
 
 
 
 
 
 
 
 
227
228	ret = 0;
229	while (nr_sects != 0) {
230		bio = bio_alloc(gfp_mask,
231				min(nr_sects, (sector_t)BIO_MAX_PAGES));
232		if (!bio) {
233			ret = -ENOMEM;
234			break;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
235		}
 
 
 
 
 
 
236
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
237		bio->bi_iter.bi_sector = sector;
238		bio->bi_bdev   = bdev;
239		bio->bi_end_io = bio_batch_end_io;
240		bio->bi_private = &bb;
241
242		while (nr_sects != 0) {
243			sz = min((sector_t) PAGE_SIZE >> 9 , nr_sects);
244			ret = bio_add_page(bio, ZERO_PAGE(0), sz << 9, 0);
245			nr_sects -= ret >> 9;
246			sector += ret >> 9;
247			if (ret < (sz << 9))
248				break;
249		}
250		ret = 0;
251		atomic_inc(&bb.done);
252		submit_bio(WRITE, bio);
253	}
254
255	/* Wait for bios in-flight */
256	if (!atomic_dec_and_test(&bb.done))
257		wait_for_completion_io(&wait);
258
259	if (bb.error)
260		return bb.error;
261	return ret;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
262}
 
263
264/**
265 * blkdev_issue_zeroout - zero-fill a block range
266 * @bdev:	blockdev to write
267 * @sector:	start sector
268 * @nr_sects:	number of sectors to write
269 * @gfp_mask:	memory allocation flags (for bio_alloc)
270 * @discard:	whether to discard the block range
271 *
272 * Description:
273 *  Zero-fill a block range.  If the discard flag is set and the block
274 *  device guarantees that subsequent READ operations to the block range
275 *  in question will return zeroes, the blocks will be discarded. Should
276 *  the discard request fail, if the discard flag is not set, or if
277 *  discard_zeroes_data is not supported, this function will resort to
278 *  zeroing the blocks manually, thus provisioning (allocating,
279 *  anchoring) them. If the block device supports the WRITE SAME command
280 *  blkdev_issue_zeroout() will use it to optimize the process of
281 *  clearing the block range. Otherwise the zeroing will be performed
282 *  using regular WRITE calls.
283 */
284
285int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
286			 sector_t nr_sects, gfp_t gfp_mask, bool discard)
287{
288	struct request_queue *q = bdev_get_queue(bdev);
 
 
 
 
289
290	if (discard && blk_queue_discard(q) && q->limits.discard_zeroes_data &&
291	    blkdev_issue_discard(bdev, sector, nr_sects, gfp_mask, 0) == 0)
292		return 0;
293
294	if (bdev_write_same(bdev) &&
295	    blkdev_issue_write_same(bdev, sector, nr_sects, gfp_mask,
296				    ZERO_PAGE(0)) == 0)
297		return 0;
298
299	return __blkdev_issue_zeroout(bdev, sector, nr_sects, gfp_mask);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
300}
301EXPORT_SYMBOL(blkdev_issue_zeroout);
v5.9
  1// SPDX-License-Identifier: GPL-2.0
  2/*
  3 * Functions related to generic helpers functions
  4 */
  5#include <linux/kernel.h>
  6#include <linux/module.h>
  7#include <linux/bio.h>
  8#include <linux/blkdev.h>
  9#include <linux/scatterlist.h>
 10
 11#include "blk.h"
 12
 13struct bio *blk_next_bio(struct bio *bio, unsigned int nr_pages, gfp_t gfp)
 
 
 
 
 
 
 14{
 15	struct bio *new = bio_alloc(gfp, nr_pages);
 16
 17	if (bio) {
 18		bio_chain(bio, new);
 19		submit_bio(bio);
 20	}
 21
 22	return new;
 
 
 
 
 23}
 24
 25int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
 26		sector_t nr_sects, gfp_t gfp_mask, int flags,
 27		struct bio **biop)
 
 
 
 
 
 
 
 
 
 
 28{
 
 29	struct request_queue *q = bdev_get_queue(bdev);
 30	struct bio *bio = *biop;
 31	unsigned int op;
 32	sector_t bs_mask, part_offset = 0;
 
 
 
 
 33
 34	if (!q)
 35		return -ENXIO;
 36
 37	if (bdev_read_only(bdev))
 38		return -EPERM;
 
 
 
 
 39
 40	if (flags & BLKDEV_DISCARD_SECURE) {
 41		if (!blk_queue_secure_erase(q))
 42			return -EOPNOTSUPP;
 43		op = REQ_OP_SECURE_ERASE;
 44	} else {
 45		if (!blk_queue_discard(q))
 46			return -EOPNOTSUPP;
 47		op = REQ_OP_DISCARD;
 48	}
 49
 50	/* In case the discard granularity isn't set by buggy device driver */
 51	if (WARN_ON_ONCE(!q->limits.discard_granularity)) {
 52		char dev_name[BDEVNAME_SIZE];
 53
 54		bdevname(bdev, dev_name);
 55		pr_err_ratelimited("%s: Error: discard_granularity is 0.\n", dev_name);
 56		return -EOPNOTSUPP;
 57	}
 58
 59	bs_mask = (bdev_logical_block_size(bdev) >> 9) - 1;
 60	if ((sector | nr_sects) & bs_mask)
 61		return -EINVAL;
 62
 63	if (!nr_sects)
 64		return -EINVAL;
 65
 66	/* In case the discard request is in a partition */
 67	if (bdev->bd_partno)
 68		part_offset = bdev->bd_part->start_sect;
 69
 70	while (nr_sects) {
 71		sector_t granularity_aligned_lba, req_sects;
 72		sector_t sector_mapped = sector + part_offset;
 73
 74		granularity_aligned_lba = round_up(sector_mapped,
 75				q->limits.discard_granularity >> SECTOR_SHIFT);
 76
 77		/*
 78		 * Check whether the discard bio starts at a discard_granularity
 79		 * aligned LBA,
 80		 * - If no: set (granularity_aligned_lba - sector_mapped) to
 81		 *   bi_size of the first split bio, then the second bio will
 82		 *   start at a discard_granularity aligned LBA on the device.
 83		 * - If yes: use bio_aligned_discard_max_sectors() as the max
 84		 *   possible bi_size of the first split bio. Then when this bio
 85		 *   is split in device drive, the split ones are very probably
 86		 *   to be aligned to discard_granularity of the device's queue.
 87		 */
 88		if (granularity_aligned_lba == sector_mapped)
 89			req_sects = min_t(sector_t, nr_sects,
 90					  bio_aligned_discard_max_sectors(q));
 91		else
 92			req_sects = min_t(sector_t, nr_sects,
 93					  granularity_aligned_lba - sector_mapped);
 
 
 
 94
 95		WARN_ON_ONCE((req_sects << 9) > UINT_MAX);
 96
 97		bio = blk_next_bio(bio, 0, gfp_mask);
 98		bio->bi_iter.bi_sector = sector;
 99		bio_set_dev(bio, bdev);
100		bio_set_op_attrs(bio, op, 0);
 
101
102		bio->bi_iter.bi_size = req_sects << 9;
103		sector += req_sects;
104		nr_sects -= req_sects;
 
 
 
 
105
106		/*
107		 * We can loop for a long time in here, if someone does
108		 * full device discards (like mkfs). Be nice and allow
109		 * us to schedule out to avoid softlocking if preempt
110		 * is disabled.
111		 */
112		cond_resched();
113	}
 
114
115	*biop = bio;
116	return 0;
117}
118EXPORT_SYMBOL(__blkdev_issue_discard);
119
120/**
121 * blkdev_issue_discard - queue a discard
122 * @bdev:	blockdev to issue discard for
123 * @sector:	start sector
124 * @nr_sects:	number of sectors to discard
125 * @gfp_mask:	memory allocation flags (for bio_alloc)
126 * @flags:	BLKDEV_DISCARD_* flags to control behaviour
127 *
128 * Description:
129 *    Issue a discard request for the sectors in question.
130 */
131int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
132		sector_t nr_sects, gfp_t gfp_mask, unsigned long flags)
133{
134	struct bio *bio = NULL;
135	struct blk_plug plug;
136	int ret;
137
138	blk_start_plug(&plug);
139	ret = __blkdev_issue_discard(bdev, sector, nr_sects, gfp_mask, flags,
140			&bio);
141	if (!ret && bio) {
142		ret = submit_bio_wait(bio);
143		if (ret == -EOPNOTSUPP)
144			ret = 0;
145		bio_put(bio);
146	}
147	blk_finish_plug(&plug);
148
 
 
149	return ret;
150}
151EXPORT_SYMBOL(blkdev_issue_discard);
152
153/**
154 * __blkdev_issue_write_same - generate number of bios with same page
155 * @bdev:	target blockdev
156 * @sector:	start sector
157 * @nr_sects:	number of sectors to write
158 * @gfp_mask:	memory allocation flags (for bio_alloc)
159 * @page:	page containing data to write
160 * @biop:	pointer to anchor bio
161 *
162 * Description:
163 *  Generate and issue number of bios(REQ_OP_WRITE_SAME) with same page.
164 */
165static int __blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
166		sector_t nr_sects, gfp_t gfp_mask, struct page *page,
167		struct bio **biop)
168{
 
169	struct request_queue *q = bdev_get_queue(bdev);
170	unsigned int max_write_same_sectors;
171	struct bio *bio = *biop;
172	sector_t bs_mask;
 
173
174	if (!q)
175		return -ENXIO;
176
177	if (bdev_read_only(bdev))
178		return -EPERM;
179
180	bs_mask = (bdev_logical_block_size(bdev) >> 9) - 1;
181	if ((sector | nr_sects) & bs_mask)
182		return -EINVAL;
183
184	if (!bdev_write_same(bdev))
185		return -EOPNOTSUPP;
 
 
 
 
186
187	/* Ensure that max_write_same_sectors doesn't overflow bi_size */
188	max_write_same_sectors = bio_allowed_max_sectors(q);
189
190	while (nr_sects) {
191		bio = blk_next_bio(bio, 1, gfp_mask);
192		bio->bi_iter.bi_sector = sector;
193		bio_set_dev(bio, bdev);
 
 
194		bio->bi_vcnt = 1;
195		bio->bi_io_vec->bv_page = page;
196		bio->bi_io_vec->bv_offset = 0;
197		bio->bi_io_vec->bv_len = bdev_logical_block_size(bdev);
198		bio_set_op_attrs(bio, REQ_OP_WRITE_SAME, 0);
199
200		if (nr_sects > max_write_same_sectors) {
201			bio->bi_iter.bi_size = max_write_same_sectors << 9;
202			nr_sects -= max_write_same_sectors;
203			sector += max_write_same_sectors;
204		} else {
205			bio->bi_iter.bi_size = nr_sects << 9;
206			nr_sects = 0;
207		}
208		cond_resched();
 
 
209	}
210
211	*biop = bio;
212	return 0;
 
 
 
 
 
213}
 
214
215/**
216 * blkdev_issue_write_same - queue a write same operation
217 * @bdev:	target blockdev
218 * @sector:	start sector
219 * @nr_sects:	number of sectors to write
220 * @gfp_mask:	memory allocation flags (for bio_alloc)
221 * @page:	page containing data
222 *
223 * Description:
224 *    Issue a write same request for the sectors in question.
225 */
226int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
227				sector_t nr_sects, gfp_t gfp_mask,
228				struct page *page)
229{
230	struct bio *bio = NULL;
231	struct blk_plug plug;
232	int ret;
 
 
 
 
233
234	blk_start_plug(&plug);
235	ret = __blkdev_issue_write_same(bdev, sector, nr_sects, gfp_mask, page,
236			&bio);
237	if (ret == 0 && bio) {
238		ret = submit_bio_wait(bio);
239		bio_put(bio);
240	}
241	blk_finish_plug(&plug);
242	return ret;
243}
244EXPORT_SYMBOL(blkdev_issue_write_same);
245
246static int __blkdev_issue_write_zeroes(struct block_device *bdev,
247		sector_t sector, sector_t nr_sects, gfp_t gfp_mask,
248		struct bio **biop, unsigned flags)
249{
250	struct bio *bio = *biop;
251	unsigned int max_write_zeroes_sectors;
252	struct request_queue *q = bdev_get_queue(bdev);
253
254	if (!q)
255		return -ENXIO;
256
257	if (bdev_read_only(bdev))
258		return -EPERM;
259
260	/* Ensure that max_write_zeroes_sectors doesn't overflow bi_size */
261	max_write_zeroes_sectors = bdev_write_zeroes_sectors(bdev);
262
263	if (max_write_zeroes_sectors == 0)
264		return -EOPNOTSUPP;
265
266	while (nr_sects) {
267		bio = blk_next_bio(bio, 0, gfp_mask);
268		bio->bi_iter.bi_sector = sector;
269		bio_set_dev(bio, bdev);
270		bio->bi_opf = REQ_OP_WRITE_ZEROES;
271		if (flags & BLKDEV_ZERO_NOUNMAP)
272			bio->bi_opf |= REQ_NOUNMAP;
273
274		if (nr_sects > max_write_zeroes_sectors) {
275			bio->bi_iter.bi_size = max_write_zeroes_sectors << 9;
276			nr_sects -= max_write_zeroes_sectors;
277			sector += max_write_zeroes_sectors;
278		} else {
279			bio->bi_iter.bi_size = nr_sects << 9;
280			nr_sects = 0;
281		}
282		cond_resched();
283	}
284
285	*biop = bio;
286	return 0;
287}
288
289/*
290 * Convert a number of 512B sectors to a number of pages.
291 * The result is limited to a number of pages that can fit into a BIO.
292 * Also make sure that the result is always at least 1 (page) for the cases
293 * where nr_sects is lower than the number of sectors in a page.
294 */
295static unsigned int __blkdev_sectors_to_bio_pages(sector_t nr_sects)
296{
297	sector_t pages = DIV_ROUND_UP_SECTOR_T(nr_sects, PAGE_SIZE / 512);
298
299	return min(pages, (sector_t)BIO_MAX_PAGES);
300}
301
302static int __blkdev_issue_zero_pages(struct block_device *bdev,
303		sector_t sector, sector_t nr_sects, gfp_t gfp_mask,
304		struct bio **biop)
305{
306	struct request_queue *q = bdev_get_queue(bdev);
307	struct bio *bio = *biop;
308	int bi_size = 0;
309	unsigned int sz;
310
311	if (!q)
312		return -ENXIO;
313
314	if (bdev_read_only(bdev))
315		return -EPERM;
316
317	while (nr_sects != 0) {
318		bio = blk_next_bio(bio, __blkdev_sectors_to_bio_pages(nr_sects),
319				   gfp_mask);
320		bio->bi_iter.bi_sector = sector;
321		bio_set_dev(bio, bdev);
322		bio_set_op_attrs(bio, REQ_OP_WRITE, 0);
 
323
324		while (nr_sects != 0) {
325			sz = min((sector_t) PAGE_SIZE, nr_sects << 9);
326			bi_size = bio_add_page(bio, ZERO_PAGE(0), sz, 0);
327			nr_sects -= bi_size >> 9;
328			sector += bi_size >> 9;
329			if (bi_size < sz)
330				break;
331		}
332		cond_resched();
 
 
333	}
334
335	*biop = bio;
336	return 0;
337}
338
339/**
340 * __blkdev_issue_zeroout - generate number of zero filed write bios
341 * @bdev:	blockdev to issue
342 * @sector:	start sector
343 * @nr_sects:	number of sectors to write
344 * @gfp_mask:	memory allocation flags (for bio_alloc)
345 * @biop:	pointer to anchor bio
346 * @flags:	controls detailed behavior
347 *
348 * Description:
349 *  Zero-fill a block range, either using hardware offload or by explicitly
350 *  writing zeroes to the device.
351 *
352 *  If a device is using logical block provisioning, the underlying space will
353 *  not be released if %flags contains BLKDEV_ZERO_NOUNMAP.
354 *
355 *  If %flags contains BLKDEV_ZERO_NOFALLBACK, the function will return
356 *  -EOPNOTSUPP if no explicit hardware offload for zeroing is provided.
357 */
358int __blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
359		sector_t nr_sects, gfp_t gfp_mask, struct bio **biop,
360		unsigned flags)
361{
362	int ret;
363	sector_t bs_mask;
364
365	bs_mask = (bdev_logical_block_size(bdev) >> 9) - 1;
366	if ((sector | nr_sects) & bs_mask)
367		return -EINVAL;
368
369	ret = __blkdev_issue_write_zeroes(bdev, sector, nr_sects, gfp_mask,
370			biop, flags);
371	if (ret != -EOPNOTSUPP || (flags & BLKDEV_ZERO_NOFALLBACK))
372		return ret;
373
374	return __blkdev_issue_zero_pages(bdev, sector, nr_sects, gfp_mask,
375					 biop);
376}
377EXPORT_SYMBOL(__blkdev_issue_zeroout);
378
379/**
380 * blkdev_issue_zeroout - zero-fill a block range
381 * @bdev:	blockdev to write
382 * @sector:	start sector
383 * @nr_sects:	number of sectors to write
384 * @gfp_mask:	memory allocation flags (for bio_alloc)
385 * @flags:	controls detailed behavior
386 *
387 * Description:
388 *  Zero-fill a block range, either using hardware offload or by explicitly
389 *  writing zeroes to the device.  See __blkdev_issue_zeroout() for the
390 *  valid values for %flags.
 
 
 
 
 
 
 
391 */
 
392int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
393		sector_t nr_sects, gfp_t gfp_mask, unsigned flags)
394{
395	int ret = 0;
396	sector_t bs_mask;
397	struct bio *bio;
398	struct blk_plug plug;
399	bool try_write_zeroes = !!bdev_write_zeroes_sectors(bdev);
400
401	bs_mask = (bdev_logical_block_size(bdev) >> 9) - 1;
402	if ((sector | nr_sects) & bs_mask)
403		return -EINVAL;
 
 
 
 
 
404
405retry:
406	bio = NULL;
407	blk_start_plug(&plug);
408	if (try_write_zeroes) {
409		ret = __blkdev_issue_write_zeroes(bdev, sector, nr_sects,
410						  gfp_mask, &bio, flags);
411	} else if (!(flags & BLKDEV_ZERO_NOFALLBACK)) {
412		ret = __blkdev_issue_zero_pages(bdev, sector, nr_sects,
413						gfp_mask, &bio);
414	} else {
415		/* No zeroing offload support */
416		ret = -EOPNOTSUPP;
417	}
418	if (ret == 0 && bio) {
419		ret = submit_bio_wait(bio);
420		bio_put(bio);
421	}
422	blk_finish_plug(&plug);
423	if (ret && try_write_zeroes) {
424		if (!(flags & BLKDEV_ZERO_NOFALLBACK)) {
425			try_write_zeroes = false;
426			goto retry;
427		}
428		if (!bdev_write_zeroes_sectors(bdev)) {
429			/*
430			 * Zeroing offload support was indicated, but the
431			 * device reported ILLEGAL REQUEST (for some devices
432			 * there is no non-destructive way to verify whether
433			 * WRITE ZEROES is actually supported).
434			 */
435			ret = -EOPNOTSUPP;
436		}
437	}
438
439	return ret;
440}
441EXPORT_SYMBOL(blkdev_issue_zeroout);