]>
Commit | Line | Data |
---|---|---|
8c16567d | 1 | // SPDX-License-Identifier: GPL-2.0 |
1da177e4 | 2 | /* |
0fe23479 | 3 | * Copyright (C) 2001 Jens Axboe <[email protected]> |
1da177e4 LT |
4 | */ |
5 | #include <linux/mm.h> | |
6 | #include <linux/swap.h> | |
da042a36 | 7 | #include <linux/bio-integrity.h> |
1da177e4 | 8 | #include <linux/blkdev.h> |
a27bb332 | 9 | #include <linux/uio.h> |
852c788f | 10 | #include <linux/iocontext.h> |
1da177e4 LT |
11 | #include <linux/slab.h> |
12 | #include <linux/init.h> | |
13 | #include <linux/kernel.h> | |
630d9c47 | 14 | #include <linux/export.h> |
1da177e4 LT |
15 | #include <linux/mempool.h> |
16 | #include <linux/workqueue.h> | |
852c788f | 17 | #include <linux/cgroup.h> |
b4c5875d | 18 | #include <linux/highmem.h> |
a892c8d5 | 19 | #include <linux/blk-crypto.h> |
49d1ec85 | 20 | #include <linux/xarray.h> |
1da177e4 | 21 | |
55782138 | 22 | #include <trace/events/block.h> |
9e234eea | 23 | #include "blk.h" |
67b42d0b | 24 | #include "blk-rq-qos.h" |
672fdcf0 | 25 | #include "blk-cgroup.h" |
0bfc2455 | 26 | |
b99182c5 | 27 | #define ALLOC_CACHE_THRESHOLD 16 |
42b2b2fb | 28 | #define ALLOC_CACHE_MAX 256 |
b99182c5 | 29 | |
be4d234d | 30 | struct bio_alloc_cache { |
fcade2ce | 31 | struct bio *free_list; |
b99182c5 | 32 | struct bio *free_list_irq; |
be4d234d | 33 | unsigned int nr; |
b99182c5 | 34 | unsigned int nr_irq; |
be4d234d JA |
35 | }; |
36 | ||
de76fd89 | 37 | static struct biovec_slab { |
6ac0b715 CH |
38 | int nr_vecs; |
39 | char *name; | |
40 | struct kmem_cache *slab; | |
de76fd89 CH |
41 | } bvec_slabs[] __read_mostly = { |
42 | { .nr_vecs = 16, .name = "biovec-16" }, | |
43 | { .nr_vecs = 64, .name = "biovec-64" }, | |
44 | { .nr_vecs = 128, .name = "biovec-128" }, | |
a8affc03 | 45 | { .nr_vecs = BIO_MAX_VECS, .name = "biovec-max" }, |
1da177e4 | 46 | }; |
6ac0b715 | 47 | |
7a800a20 CH |
48 | static struct biovec_slab *biovec_slab(unsigned short nr_vecs) |
49 | { | |
50 | switch (nr_vecs) { | |
51 | /* smaller bios use inline vecs */ | |
52 | case 5 ... 16: | |
53 | return &bvec_slabs[0]; | |
54 | case 17 ... 64: | |
55 | return &bvec_slabs[1]; | |
56 | case 65 ... 128: | |
57 | return &bvec_slabs[2]; | |
a8affc03 | 58 | case 129 ... BIO_MAX_VECS: |
7a800a20 CH |
59 | return &bvec_slabs[3]; |
60 | default: | |
61 | BUG(); | |
62 | return NULL; | |
63 | } | |
64 | } | |
1da177e4 | 65 | |
1da177e4 LT |
66 | /* |
67 | * fs_bio_set is the bio_set containing bio and iovec memory pools used by | |
68 | * IO code that does not need private memory pools. | |
69 | */ | |
f4f8154a | 70 | struct bio_set fs_bio_set; |
3f86a82a | 71 | EXPORT_SYMBOL(fs_bio_set); |
1da177e4 | 72 | |
bb799ca0 JA |
73 | /* |
74 | * Our slab pool management | |
75 | */ | |
76 | struct bio_slab { | |
77 | struct kmem_cache *slab; | |
78 | unsigned int slab_ref; | |
79 | unsigned int slab_size; | |
80 | char name[8]; | |
81 | }; | |
82 | static DEFINE_MUTEX(bio_slab_lock); | |
49d1ec85 | 83 | static DEFINE_XARRAY(bio_slabs); |
bb799ca0 | 84 | |
49d1ec85 | 85 | static struct bio_slab *create_bio_slab(unsigned int size) |
bb799ca0 | 86 | { |
49d1ec85 | 87 | struct bio_slab *bslab = kzalloc(sizeof(*bslab), GFP_KERNEL); |
bb799ca0 | 88 | |
49d1ec85 ML |
89 | if (!bslab) |
90 | return NULL; | |
bb799ca0 | 91 | |
49d1ec85 ML |
92 | snprintf(bslab->name, sizeof(bslab->name), "bio-%d", size); |
93 | bslab->slab = kmem_cache_create(bslab->name, size, | |
1a7e76e4 CH |
94 | ARCH_KMALLOC_MINALIGN, |
95 | SLAB_HWCACHE_ALIGN | SLAB_TYPESAFE_BY_RCU, NULL); | |
49d1ec85 ML |
96 | if (!bslab->slab) |
97 | goto fail_alloc_slab; | |
bb799ca0 | 98 | |
49d1ec85 ML |
99 | bslab->slab_ref = 1; |
100 | bslab->slab_size = size; | |
bb799ca0 | 101 | |
49d1ec85 ML |
102 | if (!xa_err(xa_store(&bio_slabs, size, bslab, GFP_KERNEL))) |
103 | return bslab; | |
bb799ca0 | 104 | |
49d1ec85 | 105 | kmem_cache_destroy(bslab->slab); |
bb799ca0 | 106 | |
49d1ec85 ML |
107 | fail_alloc_slab: |
108 | kfree(bslab); | |
109 | return NULL; | |
110 | } | |
bb799ca0 | 111 | |
49d1ec85 ML |
112 | static inline unsigned int bs_bio_slab_size(struct bio_set *bs) |
113 | { | |
9f180e31 | 114 | return bs->front_pad + sizeof(struct bio) + bs->back_pad; |
49d1ec85 | 115 | } |
bb799ca0 | 116 | |
49d1ec85 ML |
117 | static struct kmem_cache *bio_find_or_create_slab(struct bio_set *bs) |
118 | { | |
119 | unsigned int size = bs_bio_slab_size(bs); | |
120 | struct bio_slab *bslab; | |
bb799ca0 | 121 | |
49d1ec85 ML |
122 | mutex_lock(&bio_slab_lock); |
123 | bslab = xa_load(&bio_slabs, size); | |
124 | if (bslab) | |
125 | bslab->slab_ref++; | |
126 | else | |
127 | bslab = create_bio_slab(size); | |
bb799ca0 | 128 | mutex_unlock(&bio_slab_lock); |
49d1ec85 ML |
129 | |
130 | if (bslab) | |
131 | return bslab->slab; | |
132 | return NULL; | |
bb799ca0 JA |
133 | } |
134 | ||
135 | static void bio_put_slab(struct bio_set *bs) | |
136 | { | |
137 | struct bio_slab *bslab = NULL; | |
49d1ec85 | 138 | unsigned int slab_size = bs_bio_slab_size(bs); |
bb799ca0 JA |
139 | |
140 | mutex_lock(&bio_slab_lock); | |
141 | ||
49d1ec85 | 142 | bslab = xa_load(&bio_slabs, slab_size); |
bb799ca0 JA |
143 | if (WARN(!bslab, KERN_ERR "bio: unable to find slab!\n")) |
144 | goto out; | |
145 | ||
49d1ec85 ML |
146 | WARN_ON_ONCE(bslab->slab != bs->bio_slab); |
147 | ||
bb799ca0 JA |
148 | WARN_ON(!bslab->slab_ref); |
149 | ||
150 | if (--bslab->slab_ref) | |
151 | goto out; | |
152 | ||
49d1ec85 ML |
153 | xa_erase(&bio_slabs, slab_size); |
154 | ||
bb799ca0 | 155 | kmem_cache_destroy(bslab->slab); |
49d1ec85 | 156 | kfree(bslab); |
bb799ca0 JA |
157 | |
158 | out: | |
159 | mutex_unlock(&bio_slab_lock); | |
160 | } | |
161 | ||
7a800a20 | 162 | void bvec_free(mempool_t *pool, struct bio_vec *bv, unsigned short nr_vecs) |
7ba1ba12 | 163 | { |
9e8c0d0d | 164 | BUG_ON(nr_vecs > BIO_MAX_VECS); |
ed996a52 | 165 | |
a8affc03 | 166 | if (nr_vecs == BIO_MAX_VECS) |
9f060e22 | 167 | mempool_free(bv, pool); |
7a800a20 CH |
168 | else if (nr_vecs > BIO_INLINE_VECS) |
169 | kmem_cache_free(biovec_slab(nr_vecs)->slab, bv); | |
bb799ca0 | 170 | } |
bb799ca0 | 171 | |
f2c3eb9b CH |
172 | /* |
173 | * Make the first allocation restricted and don't dump info on allocation | |
174 | * failures, since we'll fall back to the mempool in case of failure. | |
175 | */ | |
176 | static inline gfp_t bvec_alloc_gfp(gfp_t gfp) | |
177 | { | |
178 | return (gfp & ~(__GFP_DIRECT_RECLAIM | __GFP_IO)) | | |
179 | __GFP_NOMEMALLOC | __GFP_NORETRY | __GFP_NOWARN; | |
bb799ca0 JA |
180 | } |
181 | ||
7a800a20 CH |
182 | struct bio_vec *bvec_alloc(mempool_t *pool, unsigned short *nr_vecs, |
183 | gfp_t gfp_mask) | |
1da177e4 | 184 | { |
7a800a20 | 185 | struct biovec_slab *bvs = biovec_slab(*nr_vecs); |
1da177e4 | 186 | |
7a800a20 | 187 | if (WARN_ON_ONCE(!bvs)) |
7ff9345f | 188 | return NULL; |
7ff9345f JA |
189 | |
190 | /* | |
7a800a20 CH |
191 | * Upgrade the nr_vecs request to take full advantage of the allocation. |
192 | * We also rely on this in the bvec_free path. | |
7ff9345f | 193 | */ |
7a800a20 | 194 | *nr_vecs = bvs->nr_vecs; |
7ff9345f | 195 | |
7ff9345f | 196 | /* |
f007a3d6 CH |
197 | * Try a slab allocation first for all smaller allocations. If that |
198 | * fails and __GFP_DIRECT_RECLAIM is set retry with the mempool. | |
a8affc03 | 199 | * The mempool is sized to handle up to BIO_MAX_VECS entries. |
7ff9345f | 200 | */ |
a8affc03 | 201 | if (*nr_vecs < BIO_MAX_VECS) { |
f007a3d6 | 202 | struct bio_vec *bvl; |
1da177e4 | 203 | |
f2c3eb9b | 204 | bvl = kmem_cache_alloc(bvs->slab, bvec_alloc_gfp(gfp_mask)); |
7a800a20 | 205 | if (likely(bvl) || !(gfp_mask & __GFP_DIRECT_RECLAIM)) |
f007a3d6 | 206 | return bvl; |
a8affc03 | 207 | *nr_vecs = BIO_MAX_VECS; |
7ff9345f JA |
208 | } |
209 | ||
f007a3d6 | 210 | return mempool_alloc(pool, gfp_mask); |
1da177e4 LT |
211 | } |
212 | ||
9ae3b3f5 | 213 | void bio_uninit(struct bio *bio) |
1da177e4 | 214 | { |
db9819c7 CH |
215 | #ifdef CONFIG_BLK_CGROUP |
216 | if (bio->bi_blkg) { | |
217 | blkg_put(bio->bi_blkg); | |
218 | bio->bi_blkg = NULL; | |
219 | } | |
220 | #endif | |
ece841ab JT |
221 | if (bio_integrity(bio)) |
222 | bio_integrity_free(bio); | |
a892c8d5 ST |
223 | |
224 | bio_crypt_free_ctx(bio); | |
4254bba1 | 225 | } |
9ae3b3f5 | 226 | EXPORT_SYMBOL(bio_uninit); |
7ba1ba12 | 227 | |
4254bba1 KO |
228 | static void bio_free(struct bio *bio) |
229 | { | |
230 | struct bio_set *bs = bio->bi_pool; | |
066ff571 | 231 | void *p = bio; |
4254bba1 | 232 | |
066ff571 | 233 | WARN_ON_ONCE(!bs); |
4254bba1 | 234 | |
066ff571 CH |
235 | bio_uninit(bio); |
236 | bvec_free(&bs->bvec_pool, bio->bi_io_vec, bio->bi_max_vecs); | |
237 | mempool_free(p - bs->front_pad, &bs->bio_pool); | |
3676347a PO |
238 | } |
239 | ||
9ae3b3f5 JA |
240 | /* |
241 | * Users of this function have their own bio allocation. Subsequently, | |
242 | * they must remember to pair any call to bio_init() with bio_uninit() | |
243 | * when IO has completed, or when the bio is released. | |
244 | */ | |
49add496 | 245 | void bio_init(struct bio *bio, struct block_device *bdev, struct bio_vec *table, |
16458cf3 | 246 | unsigned short max_vecs, blk_opf_t opf) |
1da177e4 | 247 | { |
da521626 | 248 | bio->bi_next = NULL; |
49add496 CH |
249 | bio->bi_bdev = bdev; |
250 | bio->bi_opf = opf; | |
da521626 JA |
251 | bio->bi_flags = 0; |
252 | bio->bi_ioprio = 0; | |
44981351 | 253 | bio->bi_write_hint = 0; |
da521626 JA |
254 | bio->bi_status = 0; |
255 | bio->bi_iter.bi_sector = 0; | |
256 | bio->bi_iter.bi_size = 0; | |
257 | bio->bi_iter.bi_idx = 0; | |
258 | bio->bi_iter.bi_bvec_done = 0; | |
259 | bio->bi_end_io = NULL; | |
260 | bio->bi_private = NULL; | |
261 | #ifdef CONFIG_BLK_CGROUP | |
262 | bio->bi_blkg = NULL; | |
263 | bio->bi_issue.value = 0; | |
49add496 CH |
264 | if (bdev) |
265 | bio_associate_blkg(bio); | |
da521626 JA |
266 | #ifdef CONFIG_BLK_CGROUP_IOCOST |
267 | bio->bi_iocost_cost = 0; | |
268 | #endif | |
269 | #endif | |
270 | #ifdef CONFIG_BLK_INLINE_ENCRYPTION | |
271 | bio->bi_crypt_context = NULL; | |
272 | #endif | |
273 | #ifdef CONFIG_BLK_DEV_INTEGRITY | |
274 | bio->bi_integrity = NULL; | |
275 | #endif | |
276 | bio->bi_vcnt = 0; | |
277 | ||
c4cf5261 | 278 | atomic_set(&bio->__bi_remaining, 1); |
dac56212 | 279 | atomic_set(&bio->__bi_cnt, 1); |
3e08773c | 280 | bio->bi_cookie = BLK_QC_T_NONE; |
3a83f467 | 281 | |
3a83f467 | 282 | bio->bi_max_vecs = max_vecs; |
da521626 JA |
283 | bio->bi_io_vec = table; |
284 | bio->bi_pool = NULL; | |
1da177e4 | 285 | } |
a112a71d | 286 | EXPORT_SYMBOL(bio_init); |
1da177e4 | 287 | |
f44b48c7 KO |
288 | /** |
289 | * bio_reset - reinitialize a bio | |
290 | * @bio: bio to reset | |
a7c50c94 CH |
291 | * @bdev: block device to use the bio for |
292 | * @opf: operation and flags for bio | |
f44b48c7 KO |
293 | * |
294 | * Description: | |
295 | * After calling bio_reset(), @bio will be in the same state as a freshly | |
296 | * allocated bio returned bio bio_alloc_bioset() - the only fields that are | |
297 | * preserved are the ones that are initialized by bio_alloc_bioset(). See | |
298 | * comment in struct bio. | |
299 | */ | |
16458cf3 | 300 | void bio_reset(struct bio *bio, struct block_device *bdev, blk_opf_t opf) |
f44b48c7 | 301 | { |
9ae3b3f5 | 302 | bio_uninit(bio); |
f44b48c7 | 303 | memset(bio, 0, BIO_RESET_BYTES); |
c4cf5261 | 304 | atomic_set(&bio->__bi_remaining, 1); |
a7c50c94 | 305 | bio->bi_bdev = bdev; |
78e34374 CH |
306 | if (bio->bi_bdev) |
307 | bio_associate_blkg(bio); | |
a7c50c94 | 308 | bio->bi_opf = opf; |
f44b48c7 KO |
309 | } |
310 | EXPORT_SYMBOL(bio_reset); | |
311 | ||
38f8baae | 312 | static struct bio *__bio_chain_endio(struct bio *bio) |
196d38bc | 313 | { |
4246a0b6 CH |
314 | struct bio *parent = bio->bi_private; |
315 | ||
3edf5346 | 316 | if (bio->bi_status && !parent->bi_status) |
4e4cbee9 | 317 | parent->bi_status = bio->bi_status; |
196d38bc | 318 | bio_put(bio); |
38f8baae CH |
319 | return parent; |
320 | } | |
321 | ||
322 | static void bio_chain_endio(struct bio *bio) | |
323 | { | |
324 | bio_endio(__bio_chain_endio(bio)); | |
196d38bc KO |
325 | } |
326 | ||
327 | /** | |
328 | * bio_chain - chain bio completions | |
1051a902 | 329 | * @bio: the target bio |
5b874af6 | 330 | * @parent: the parent bio of @bio |
196d38bc KO |
331 | * |
332 | * The caller won't have a bi_end_io called when @bio completes - instead, | |
333 | * @parent's bi_end_io won't be called until both @parent and @bio have | |
334 | * completed; the chained bio will also be freed when it completes. | |
335 | * | |
336 | * The caller must not set bi_private or bi_end_io in @bio. | |
337 | */ | |
338 | void bio_chain(struct bio *bio, struct bio *parent) | |
339 | { | |
340 | BUG_ON(bio->bi_private || bio->bi_end_io); | |
341 | ||
342 | bio->bi_private = parent; | |
343 | bio->bi_end_io = bio_chain_endio; | |
c4cf5261 | 344 | bio_inc_remaining(parent); |
196d38bc KO |
345 | } |
346 | EXPORT_SYMBOL(bio_chain); | |
347 | ||
81c2168c CH |
348 | /** |
349 | * bio_chain_and_submit - submit a bio after chaining it to another one | |
350 | * @prev: bio to chain and submit | |
351 | * @new: bio to chain to | |
352 | * | |
353 | * If @prev is non-NULL, chain it to @new and submit it. | |
354 | * | |
355 | * Return: @new. | |
356 | */ | |
357 | struct bio *bio_chain_and_submit(struct bio *prev, struct bio *new) | |
3b005bf6 | 358 | { |
81c2168c CH |
359 | if (prev) { |
360 | bio_chain(prev, new); | |
361 | submit_bio(prev); | |
3b005bf6 | 362 | } |
3b005bf6 CH |
363 | return new; |
364 | } | |
81c2168c CH |
365 | |
366 | struct bio *blk_next_bio(struct bio *bio, struct block_device *bdev, | |
367 | unsigned int nr_pages, blk_opf_t opf, gfp_t gfp) | |
368 | { | |
369 | return bio_chain_and_submit(bio, bio_alloc(bdev, nr_pages, opf, gfp)); | |
370 | } | |
3b005bf6 CH |
371 | EXPORT_SYMBOL_GPL(blk_next_bio); |
372 | ||
df2cb6da KO |
373 | static void bio_alloc_rescue(struct work_struct *work) |
374 | { | |
375 | struct bio_set *bs = container_of(work, struct bio_set, rescue_work); | |
376 | struct bio *bio; | |
377 | ||
378 | while (1) { | |
379 | spin_lock(&bs->rescue_lock); | |
380 | bio = bio_list_pop(&bs->rescue_list); | |
381 | spin_unlock(&bs->rescue_lock); | |
382 | ||
383 | if (!bio) | |
384 | break; | |
385 | ||
ed00aabd | 386 | submit_bio_noacct(bio); |
df2cb6da KO |
387 | } |
388 | } | |
389 | ||
390 | static void punt_bios_to_rescuer(struct bio_set *bs) | |
391 | { | |
392 | struct bio_list punt, nopunt; | |
393 | struct bio *bio; | |
394 | ||
47e0fb46 N |
395 | if (WARN_ON_ONCE(!bs->rescue_workqueue)) |
396 | return; | |
df2cb6da KO |
397 | /* |
398 | * In order to guarantee forward progress we must punt only bios that | |
399 | * were allocated from this bio_set; otherwise, if there was a bio on | |
400 | * there for a stacking driver higher up in the stack, processing it | |
401 | * could require allocating bios from this bio_set, and doing that from | |
402 | * our own rescuer would be bad. | |
403 | * | |
404 | * Since bio lists are singly linked, pop them all instead of trying to | |
405 | * remove from the middle of the list: | |
406 | */ | |
407 | ||
408 | bio_list_init(&punt); | |
409 | bio_list_init(&nopunt); | |
410 | ||
f5fe1b51 | 411 | while ((bio = bio_list_pop(¤t->bio_list[0]))) |
df2cb6da | 412 | bio_list_add(bio->bi_pool == bs ? &punt : &nopunt, bio); |
f5fe1b51 | 413 | current->bio_list[0] = nopunt; |
df2cb6da | 414 | |
f5fe1b51 N |
415 | bio_list_init(&nopunt); |
416 | while ((bio = bio_list_pop(¤t->bio_list[1]))) | |
417 | bio_list_add(bio->bi_pool == bs ? &punt : &nopunt, bio); | |
418 | current->bio_list[1] = nopunt; | |
df2cb6da KO |
419 | |
420 | spin_lock(&bs->rescue_lock); | |
421 | bio_list_merge(&bs->rescue_list, &punt); | |
422 | spin_unlock(&bs->rescue_lock); | |
423 | ||
424 | queue_work(bs->rescue_workqueue, &bs->rescue_work); | |
425 | } | |
426 | ||
b99182c5 PB |
427 | static void bio_alloc_irq_cache_splice(struct bio_alloc_cache *cache) |
428 | { | |
429 | unsigned long flags; | |
430 | ||
431 | /* cache->free_list must be empty */ | |
432 | if (WARN_ON_ONCE(cache->free_list)) | |
433 | return; | |
434 | ||
435 | local_irq_save(flags); | |
436 | cache->free_list = cache->free_list_irq; | |
437 | cache->free_list_irq = NULL; | |
438 | cache->nr += cache->nr_irq; | |
439 | cache->nr_irq = 0; | |
440 | local_irq_restore(flags); | |
441 | } | |
442 | ||
0df71650 | 443 | static struct bio *bio_alloc_percpu_cache(struct block_device *bdev, |
16458cf3 | 444 | unsigned short nr_vecs, blk_opf_t opf, gfp_t gfp, |
0df71650 MS |
445 | struct bio_set *bs) |
446 | { | |
447 | struct bio_alloc_cache *cache; | |
448 | struct bio *bio; | |
449 | ||
450 | cache = per_cpu_ptr(bs->cache, get_cpu()); | |
451 | if (!cache->free_list) { | |
b99182c5 PB |
452 | if (READ_ONCE(cache->nr_irq) >= ALLOC_CACHE_THRESHOLD) |
453 | bio_alloc_irq_cache_splice(cache); | |
454 | if (!cache->free_list) { | |
455 | put_cpu(); | |
456 | return NULL; | |
457 | } | |
0df71650 MS |
458 | } |
459 | bio = cache->free_list; | |
460 | cache->free_list = bio->bi_next; | |
461 | cache->nr--; | |
462 | put_cpu(); | |
463 | ||
464 | bio_init(bio, bdev, nr_vecs ? bio->bi_inline_vecs : NULL, nr_vecs, opf); | |
465 | bio->bi_pool = bs; | |
466 | return bio; | |
467 | } | |
468 | ||
1da177e4 LT |
469 | /** |
470 | * bio_alloc_bioset - allocate a bio for I/O | |
609be106 CH |
471 | * @bdev: block device to allocate the bio for (can be %NULL) |
472 | * @nr_vecs: number of bvecs to pre-allocate | |
473 | * @opf: operation and flags for bio | |
519c8e9f | 474 | * @gfp_mask: the GFP_* mask given to the slab allocator |
db18efac | 475 | * @bs: the bio_set to allocate from. |
1da177e4 | 476 | * |
3175199a | 477 | * Allocate a bio from the mempools in @bs. |
3f86a82a | 478 | * |
3175199a CH |
479 | * If %__GFP_DIRECT_RECLAIM is set then bio_alloc will always be able to |
480 | * allocate a bio. This is due to the mempool guarantees. To make this work, | |
481 | * callers must never allocate more than 1 bio at a time from the general pool. | |
482 | * Callers that need to allocate more than 1 bio must always submit the | |
483 | * previously allocated bio for IO before attempting to allocate a new one. | |
484 | * Failure to do so can cause deadlocks under memory pressure. | |
3f86a82a | 485 | * |
3175199a CH |
486 | * Note that when running under submit_bio_noacct() (i.e. any block driver), |
487 | * bios are not submitted until after you return - see the code in | |
488 | * submit_bio_noacct() that converts recursion into iteration, to prevent | |
489 | * stack overflows. | |
df2cb6da | 490 | * |
3175199a CH |
491 | * This would normally mean allocating multiple bios under submit_bio_noacct() |
492 | * would be susceptible to deadlocks, but we have | |
493 | * deadlock avoidance code that resubmits any blocked bios from a rescuer | |
494 | * thread. | |
df2cb6da | 495 | * |
3175199a CH |
496 | * However, we do not guarantee forward progress for allocations from other |
497 | * mempools. Doing multiple allocations from the same mempool under | |
498 | * submit_bio_noacct() should be avoided - instead, use bio_set's front_pad | |
499 | * for per bio allocations. | |
df2cb6da | 500 | * |
3175199a | 501 | * Returns: Pointer to new bio on success, NULL on failure. |
3f86a82a | 502 | */ |
609be106 | 503 | struct bio *bio_alloc_bioset(struct block_device *bdev, unsigned short nr_vecs, |
16458cf3 | 504 | blk_opf_t opf, gfp_t gfp_mask, |
7a88fa19 | 505 | struct bio_set *bs) |
1da177e4 | 506 | { |
df2cb6da | 507 | gfp_t saved_gfp = gfp_mask; |
451a9ebf TH |
508 | struct bio *bio; |
509 | void *p; | |
510 | ||
609be106 CH |
511 | /* should not use nobvec bioset for nr_vecs > 0 */ |
512 | if (WARN_ON_ONCE(!mempool_initialized(&bs->bvec_pool) && nr_vecs > 0)) | |
3175199a | 513 | return NULL; |
df2cb6da | 514 | |
0df71650 MS |
515 | if (opf & REQ_ALLOC_CACHE) { |
516 | if (bs->cache && nr_vecs <= BIO_INLINE_VECS) { | |
517 | bio = bio_alloc_percpu_cache(bdev, nr_vecs, opf, | |
518 | gfp_mask, bs); | |
519 | if (bio) | |
520 | return bio; | |
521 | /* | |
522 | * No cached bio available, bio returned below marked with | |
523 | * REQ_ALLOC_CACHE to particpate in per-cpu alloc cache. | |
524 | */ | |
525 | } else { | |
526 | opf &= ~REQ_ALLOC_CACHE; | |
527 | } | |
528 | } | |
529 | ||
3175199a CH |
530 | /* |
531 | * submit_bio_noacct() converts recursion to iteration; this means if | |
532 | * we're running beneath it, any bios we allocate and submit will not be | |
533 | * submitted (and thus freed) until after we return. | |
534 | * | |
535 | * This exposes us to a potential deadlock if we allocate multiple bios | |
536 | * from the same bio_set() while running underneath submit_bio_noacct(). | |
537 | * If we were to allocate multiple bios (say a stacking block driver | |
538 | * that was splitting bios), we would deadlock if we exhausted the | |
539 | * mempool's reserve. | |
540 | * | |
541 | * We solve this, and guarantee forward progress, with a rescuer | |
542 | * workqueue per bio_set. If we go to allocate and there are bios on | |
543 | * current->bio_list, we first try the allocation without | |
544 | * __GFP_DIRECT_RECLAIM; if that fails, we punt those bios we would be | |
545 | * blocking to the rescuer workqueue before we retry with the original | |
546 | * gfp_flags. | |
547 | */ | |
548 | if (current->bio_list && | |
549 | (!bio_list_empty(¤t->bio_list[0]) || | |
550 | !bio_list_empty(¤t->bio_list[1])) && | |
551 | bs->rescue_workqueue) | |
552 | gfp_mask &= ~__GFP_DIRECT_RECLAIM; | |
553 | ||
554 | p = mempool_alloc(&bs->bio_pool, gfp_mask); | |
555 | if (!p && gfp_mask != saved_gfp) { | |
556 | punt_bios_to_rescuer(bs); | |
557 | gfp_mask = saved_gfp; | |
8aa6ba2f | 558 | p = mempool_alloc(&bs->bio_pool, gfp_mask); |
3f86a82a | 559 | } |
451a9ebf TH |
560 | if (unlikely(!p)) |
561 | return NULL; | |
759aa12f PB |
562 | if (!mempool_is_saturated(&bs->bio_pool)) |
563 | opf &= ~REQ_ALLOC_CACHE; | |
1da177e4 | 564 | |
3175199a | 565 | bio = p + bs->front_pad; |
609be106 | 566 | if (nr_vecs > BIO_INLINE_VECS) { |
3175199a | 567 | struct bio_vec *bvl = NULL; |
34053979 | 568 | |
609be106 | 569 | bvl = bvec_alloc(&bs->bvec_pool, &nr_vecs, gfp_mask); |
df2cb6da KO |
570 | if (!bvl && gfp_mask != saved_gfp) { |
571 | punt_bios_to_rescuer(bs); | |
572 | gfp_mask = saved_gfp; | |
609be106 | 573 | bvl = bvec_alloc(&bs->bvec_pool, &nr_vecs, gfp_mask); |
df2cb6da | 574 | } |
34053979 IM |
575 | if (unlikely(!bvl)) |
576 | goto err_free; | |
a38352e0 | 577 | |
49add496 | 578 | bio_init(bio, bdev, bvl, nr_vecs, opf); |
609be106 | 579 | } else if (nr_vecs) { |
49add496 | 580 | bio_init(bio, bdev, bio->bi_inline_vecs, BIO_INLINE_VECS, opf); |
3175199a | 581 | } else { |
49add496 | 582 | bio_init(bio, bdev, NULL, 0, opf); |
1da177e4 | 583 | } |
3f86a82a KO |
584 | |
585 | bio->bi_pool = bs; | |
1da177e4 | 586 | return bio; |
34053979 IM |
587 | |
588 | err_free: | |
8aa6ba2f | 589 | mempool_free(p, &bs->bio_pool); |
34053979 | 590 | return NULL; |
1da177e4 | 591 | } |
a112a71d | 592 | EXPORT_SYMBOL(bio_alloc_bioset); |
1da177e4 | 593 | |
3175199a | 594 | /** |
066ff571 CH |
595 | * bio_kmalloc - kmalloc a bio |
596 | * @nr_vecs: number of bio_vecs to allocate | |
3175199a | 597 | * @gfp_mask: the GFP_* mask given to the slab allocator |
3175199a | 598 | * |
066ff571 CH |
599 | * Use kmalloc to allocate a bio (including bvecs). The bio must be initialized |
600 | * using bio_init() before use. To free a bio returned from this function use | |
601 | * kfree() after calling bio_uninit(). A bio returned from this function can | |
602 | * be reused by calling bio_uninit() before calling bio_init() again. | |
603 | * | |
604 | * Note that unlike bio_alloc() or bio_alloc_bioset() allocations from this | |
340e1347 | 605 | * function are not backed by a mempool can fail. Do not use this function |
066ff571 | 606 | * for allocations in the file system I/O path. |
3175199a CH |
607 | * |
608 | * Returns: Pointer to new bio on success, NULL on failure. | |
609 | */ | |
066ff571 | 610 | struct bio *bio_kmalloc(unsigned short nr_vecs, gfp_t gfp_mask) |
3175199a CH |
611 | { |
612 | struct bio *bio; | |
613 | ||
066ff571 | 614 | if (nr_vecs > UIO_MAXIOV) |
3175199a | 615 | return NULL; |
066ff571 | 616 | return kmalloc(struct_size(bio, bi_inline_vecs, nr_vecs), gfp_mask); |
3175199a CH |
617 | } |
618 | EXPORT_SYMBOL(bio_kmalloc); | |
619 | ||
649f070e | 620 | void zero_fill_bio_iter(struct bio *bio, struct bvec_iter start) |
1da177e4 | 621 | { |
7988613b KO |
622 | struct bio_vec bv; |
623 | struct bvec_iter iter; | |
1da177e4 | 624 | |
649f070e | 625 | __bio_for_each_segment(bv, bio, iter, start) |
ab6c340e | 626 | memzero_bvec(&bv); |
1da177e4 | 627 | } |
649f070e | 628 | EXPORT_SYMBOL(zero_fill_bio_iter); |
1da177e4 | 629 | |
83c9c547 ML |
630 | /** |
631 | * bio_truncate - truncate the bio to small size of @new_size | |
632 | * @bio: the bio to be truncated | |
633 | * @new_size: new size for truncating the bio | |
634 | * | |
635 | * Description: | |
636 | * Truncate the bio to new size of @new_size. If bio_op(bio) is | |
637 | * REQ_OP_READ, zero the truncated part. This function should only | |
638 | * be used for handling corner cases, such as bio eod. | |
639 | */ | |
4f7ab09a | 640 | static void bio_truncate(struct bio *bio, unsigned new_size) |
85a8ce62 ML |
641 | { |
642 | struct bio_vec bv; | |
643 | struct bvec_iter iter; | |
644 | unsigned int done = 0; | |
645 | bool truncated = false; | |
646 | ||
647 | if (new_size >= bio->bi_iter.bi_size) | |
648 | return; | |
649 | ||
83c9c547 | 650 | if (bio_op(bio) != REQ_OP_READ) |
85a8ce62 ML |
651 | goto exit; |
652 | ||
653 | bio_for_each_segment(bv, bio, iter) { | |
654 | if (done + bv.bv_len > new_size) { | |
655 | unsigned offset; | |
656 | ||
657 | if (!truncated) | |
658 | offset = new_size - done; | |
659 | else | |
660 | offset = 0; | |
3ee859e3 OH |
661 | zero_user(bv.bv_page, bv.bv_offset + offset, |
662 | bv.bv_len - offset); | |
85a8ce62 ML |
663 | truncated = true; |
664 | } | |
665 | done += bv.bv_len; | |
666 | } | |
667 | ||
668 | exit: | |
669 | /* | |
670 | * Don't touch bvec table here and make it really immutable, since | |
671 | * fs bio user has to retrieve all pages via bio_for_each_segment_all | |
672 | * in its .end_bio() callback. | |
673 | * | |
674 | * It is enough to truncate bio by updating .bi_size since we can make | |
675 | * correct bvec with the updated .bi_size for drivers. | |
676 | */ | |
677 | bio->bi_iter.bi_size = new_size; | |
678 | } | |
679 | ||
29125ed6 CH |
680 | /** |
681 | * guard_bio_eod - truncate a BIO to fit the block device | |
682 | * @bio: bio to truncate | |
683 | * | |
684 | * This allows us to do IO even on the odd last sectors of a device, even if the | |
685 | * block size is some multiple of the physical sector size. | |
686 | * | |
687 | * We'll just truncate the bio to the size of the device, and clear the end of | |
688 | * the buffer head manually. Truly out-of-range accesses will turn into actual | |
689 | * I/O errors, this only handles the "we need to be able to do I/O at the final | |
690 | * sector" case. | |
691 | */ | |
692 | void guard_bio_eod(struct bio *bio) | |
693 | { | |
309dca30 | 694 | sector_t maxsector = bdev_nr_sectors(bio->bi_bdev); |
29125ed6 CH |
695 | |
696 | if (!maxsector) | |
697 | return; | |
698 | ||
699 | /* | |
700 | * If the *whole* IO is past the end of the device, | |
701 | * let it through, and the IO layer will turn it into | |
702 | * an EIO. | |
703 | */ | |
704 | if (unlikely(bio->bi_iter.bi_sector >= maxsector)) | |
705 | return; | |
706 | ||
707 | maxsector -= bio->bi_iter.bi_sector; | |
708 | if (likely((bio->bi_iter.bi_size >> 9) <= maxsector)) | |
709 | return; | |
710 | ||
711 | bio_truncate(bio, maxsector << 9); | |
712 | } | |
713 | ||
b99182c5 PB |
714 | static int __bio_alloc_cache_prune(struct bio_alloc_cache *cache, |
715 | unsigned int nr) | |
be4d234d JA |
716 | { |
717 | unsigned int i = 0; | |
718 | struct bio *bio; | |
719 | ||
fcade2ce JA |
720 | while ((bio = cache->free_list) != NULL) { |
721 | cache->free_list = bio->bi_next; | |
be4d234d JA |
722 | cache->nr--; |
723 | bio_free(bio); | |
724 | if (++i == nr) | |
725 | break; | |
726 | } | |
b99182c5 PB |
727 | return i; |
728 | } | |
729 | ||
730 | static void bio_alloc_cache_prune(struct bio_alloc_cache *cache, | |
731 | unsigned int nr) | |
732 | { | |
733 | nr -= __bio_alloc_cache_prune(cache, nr); | |
734 | if (!READ_ONCE(cache->free_list)) { | |
735 | bio_alloc_irq_cache_splice(cache); | |
736 | __bio_alloc_cache_prune(cache, nr); | |
737 | } | |
be4d234d JA |
738 | } |
739 | ||
740 | static int bio_cpu_dead(unsigned int cpu, struct hlist_node *node) | |
741 | { | |
742 | struct bio_set *bs; | |
743 | ||
744 | bs = hlist_entry_safe(node, struct bio_set, cpuhp_dead); | |
745 | if (bs->cache) { | |
746 | struct bio_alloc_cache *cache = per_cpu_ptr(bs->cache, cpu); | |
747 | ||
748 | bio_alloc_cache_prune(cache, -1U); | |
749 | } | |
750 | return 0; | |
751 | } | |
752 | ||
753 | static void bio_alloc_cache_destroy(struct bio_set *bs) | |
754 | { | |
755 | int cpu; | |
756 | ||
757 | if (!bs->cache) | |
758 | return; | |
759 | ||
760 | cpuhp_state_remove_instance_nocalls(CPUHP_BIO_DEAD, &bs->cpuhp_dead); | |
761 | for_each_possible_cpu(cpu) { | |
762 | struct bio_alloc_cache *cache; | |
763 | ||
764 | cache = per_cpu_ptr(bs->cache, cpu); | |
765 | bio_alloc_cache_prune(cache, -1U); | |
766 | } | |
767 | free_percpu(bs->cache); | |
605f7415 | 768 | bs->cache = NULL; |
be4d234d JA |
769 | } |
770 | ||
f25cf75a PB |
771 | static inline void bio_put_percpu_cache(struct bio *bio) |
772 | { | |
773 | struct bio_alloc_cache *cache; | |
774 | ||
775 | cache = per_cpu_ptr(bio->bi_pool->cache, get_cpu()); | |
e516c3fc PB |
776 | if (READ_ONCE(cache->nr_irq) + cache->nr > ALLOC_CACHE_MAX) |
777 | goto out_free; | |
b99182c5 | 778 | |
c9f5f3aa | 779 | if (in_task()) { |
e516c3fc | 780 | bio_uninit(bio); |
f25cf75a | 781 | bio->bi_next = cache->free_list; |
c9f5f3aa | 782 | /* Not necessary but helps not to iopoll already freed bios */ |
11eb695f | 783 | bio->bi_bdev = NULL; |
f25cf75a PB |
784 | cache->free_list = bio; |
785 | cache->nr++; | |
e516c3fc PB |
786 | } else if (in_hardirq()) { |
787 | lockdep_assert_irqs_disabled(); | |
f25cf75a | 788 | |
e516c3fc | 789 | bio_uninit(bio); |
b99182c5 PB |
790 | bio->bi_next = cache->free_list_irq; |
791 | cache->free_list_irq = bio; | |
792 | cache->nr_irq++; | |
e516c3fc PB |
793 | } else { |
794 | goto out_free; | |
b99182c5 | 795 | } |
f25cf75a | 796 | put_cpu(); |
e516c3fc PB |
797 | return; |
798 | out_free: | |
799 | put_cpu(); | |
800 | bio_free(bio); | |
f25cf75a PB |
801 | } |
802 | ||
1da177e4 LT |
803 | /** |
804 | * bio_put - release a reference to a bio | |
805 | * @bio: bio to release reference to | |
806 | * | |
807 | * Description: | |
808 | * Put a reference to a &struct bio, either one you have gotten with | |
9b10f6a9 | 809 | * bio_alloc, bio_get or bio_clone_*. The last put of a bio will free it. |
1da177e4 LT |
810 | **/ |
811 | void bio_put(struct bio *bio) | |
812 | { | |
be4d234d | 813 | if (unlikely(bio_flagged(bio, BIO_REFFED))) { |
9e8c0d0d | 814 | BUG_ON(!atomic_read(&bio->__bi_cnt)); |
be4d234d JA |
815 | if (!atomic_dec_and_test(&bio->__bi_cnt)) |
816 | return; | |
817 | } | |
f25cf75a PB |
818 | if (bio->bi_opf & REQ_ALLOC_CACHE) |
819 | bio_put_percpu_cache(bio); | |
820 | else | |
be4d234d | 821 | bio_free(bio); |
1da177e4 | 822 | } |
a112a71d | 823 | EXPORT_SYMBOL(bio_put); |
1da177e4 | 824 | |
a0e8de79 | 825 | static int __bio_clone(struct bio *bio, struct bio *bio_src, gfp_t gfp) |
59d276fe | 826 | { |
b7c44ed9 | 827 | bio_set_flag(bio, BIO_CLONED); |
ca474b73 | 828 | bio->bi_ioprio = bio_src->bi_ioprio; |
44981351 | 829 | bio->bi_write_hint = bio_src->bi_write_hint; |
59d276fe | 830 | bio->bi_iter = bio_src->bi_iter; |
20bd723e | 831 | |
7ecc56c6 CH |
832 | if (bio->bi_bdev) { |
833 | if (bio->bi_bdev == bio_src->bi_bdev && | |
834 | bio_flagged(bio_src, BIO_REMAPPED)) | |
835 | bio_set_flag(bio, BIO_REMAPPED); | |
836 | bio_clone_blkg_association(bio, bio_src); | |
837 | } | |
56b4b5ab CH |
838 | |
839 | if (bio_crypt_clone(bio, bio_src, gfp) < 0) | |
840 | return -ENOMEM; | |
841 | if (bio_integrity(bio_src) && | |
842 | bio_integrity_clone(bio, bio_src, gfp) < 0) | |
843 | return -ENOMEM; | |
844 | return 0; | |
59d276fe | 845 | } |
59d276fe KO |
846 | |
847 | /** | |
abfc426d CH |
848 | * bio_alloc_clone - clone a bio that shares the original bio's biovec |
849 | * @bdev: block_device to clone onto | |
a0e8de79 CH |
850 | * @bio_src: bio to clone from |
851 | * @gfp: allocation priority | |
852 | * @bs: bio_set to allocate from | |
59d276fe | 853 | * |
a0e8de79 CH |
854 | * Allocate a new bio that is a clone of @bio_src. The caller owns the returned |
855 | * bio, but not the actual data it points to. | |
856 | * | |
857 | * The caller must ensure that the return bio is not freed before @bio_src. | |
59d276fe | 858 | */ |
abfc426d CH |
859 | struct bio *bio_alloc_clone(struct block_device *bdev, struct bio *bio_src, |
860 | gfp_t gfp, struct bio_set *bs) | |
59d276fe | 861 | { |
a0e8de79 | 862 | struct bio *bio; |
59d276fe | 863 | |
abfc426d | 864 | bio = bio_alloc_bioset(bdev, 0, bio_src->bi_opf, gfp, bs); |
a0e8de79 | 865 | if (!bio) |
59d276fe KO |
866 | return NULL; |
867 | ||
a0e8de79 CH |
868 | if (__bio_clone(bio, bio_src, gfp) < 0) { |
869 | bio_put(bio); | |
56b4b5ab CH |
870 | return NULL; |
871 | } | |
a0e8de79 | 872 | bio->bi_io_vec = bio_src->bi_io_vec; |
59d276fe | 873 | |
a0e8de79 | 874 | return bio; |
59d276fe | 875 | } |
abfc426d | 876 | EXPORT_SYMBOL(bio_alloc_clone); |
59d276fe | 877 | |
a0e8de79 | 878 | /** |
abfc426d CH |
879 | * bio_init_clone - clone a bio that shares the original bio's biovec |
880 | * @bdev: block_device to clone onto | |
a0e8de79 CH |
881 | * @bio: bio to clone into |
882 | * @bio_src: bio to clone from | |
883 | * @gfp: allocation priority | |
884 | * | |
885 | * Initialize a new bio in caller provided memory that is a clone of @bio_src. | |
886 | * The caller owns the returned bio, but not the actual data it points to. | |
887 | * | |
888 | * The caller must ensure that @bio_src is not freed before @bio. | |
889 | */ | |
abfc426d CH |
890 | int bio_init_clone(struct block_device *bdev, struct bio *bio, |
891 | struct bio *bio_src, gfp_t gfp) | |
a0e8de79 CH |
892 | { |
893 | int ret; | |
894 | ||
abfc426d | 895 | bio_init(bio, bdev, bio_src->bi_io_vec, 0, bio_src->bi_opf); |
a0e8de79 CH |
896 | ret = __bio_clone(bio, bio_src, gfp); |
897 | if (ret) | |
898 | bio_uninit(bio); | |
899 | return ret; | |
900 | } | |
abfc426d | 901 | EXPORT_SYMBOL(bio_init_clone); |
a0e8de79 | 902 | |
9a6083be CH |
903 | /** |
904 | * bio_full - check if the bio is full | |
905 | * @bio: bio to check | |
906 | * @len: length of one segment to be added | |
907 | * | |
908 | * Return true if @bio is full and one segment with @len bytes can't be | |
909 | * added to the bio, otherwise return false | |
910 | */ | |
911 | static inline bool bio_full(struct bio *bio, unsigned len) | |
912 | { | |
913 | if (bio->bi_vcnt >= bio->bi_max_vecs) | |
914 | return true; | |
915 | if (bio->bi_iter.bi_size > UINT_MAX - len) | |
916 | return true; | |
917 | return false; | |
918 | } | |
919 | ||
858c708d CH |
920 | static bool bvec_try_merge_page(struct bio_vec *bv, struct page *page, |
921 | unsigned int len, unsigned int off, bool *same_page) | |
5919482e | 922 | { |
d8166519 MWO |
923 | size_t bv_end = bv->bv_offset + bv->bv_len; |
924 | phys_addr_t vec_end_addr = page_to_phys(bv->bv_page) + bv_end - 1; | |
5919482e ML |
925 | phys_addr_t page_addr = page_to_phys(page); |
926 | ||
927 | if (vec_end_addr + 1 != page_addr + off) | |
928 | return false; | |
929 | if (xen_domain() && !xen_biovec_phys_mergeable(bv, page)) | |
930 | return false; | |
49580e69 LG |
931 | if (!zone_device_pages_have_same_pgmap(bv->bv_page, page)) |
932 | return false; | |
52d52d1c | 933 | |
ff896738 | 934 | *same_page = ((vec_end_addr & PAGE_MASK) == page_addr); |
858c708d CH |
935 | if (!*same_page) { |
936 | if (IS_ENABLED(CONFIG_KMSAN)) | |
937 | return false; | |
938 | if (bv->bv_page + bv_end / PAGE_SIZE != page + off / PAGE_SIZE) | |
939 | return false; | |
940 | } | |
0eca8b6f | 941 | |
0eca8b6f | 942 | bv->bv_len += len; |
0eca8b6f | 943 | return true; |
9774b391 CH |
944 | } |
945 | ||
e4581105 CH |
946 | /* |
947 | * Try to merge a page into a segment, while obeying the hardware segment | |
948 | * size limit. This is not for normal read/write bios, but for passthrough | |
949 | * or Zone Append operations that we can't split. | |
950 | */ | |
7c8998f7 | 951 | bool bvec_try_merge_hw_page(struct request_queue *q, struct bio_vec *bv, |
ae42f0b3 CH |
952 | struct page *page, unsigned len, unsigned offset, |
953 | bool *same_page) | |
489fbbcb ML |
954 | { |
955 | unsigned long mask = queue_segment_boundary(q); | |
25f76c3d | 956 | phys_addr_t addr1 = bvec_phys(bv); |
489fbbcb ML |
957 | phys_addr_t addr2 = page_to_phys(page) + offset + len - 1; |
958 | ||
959 | if ((addr1 | mask) != (addr2 | mask)) | |
960 | return false; | |
3f034c37 | 961 | if (len > queue_max_segment_size(q) - bv->bv_len) |
489fbbcb | 962 | return false; |
858c708d | 963 | return bvec_try_merge_page(bv, page, len, offset, same_page); |
489fbbcb ML |
964 | } |
965 | ||
1da177e4 | 966 | /** |
e4581105 CH |
967 | * bio_add_hw_page - attempt to add a page to a bio with hw constraints |
968 | * @q: the target queue | |
969 | * @bio: destination bio | |
970 | * @page: page to add | |
971 | * @len: vec entry length | |
972 | * @offset: vec entry offset | |
973 | * @max_sectors: maximum number of sectors that can be added | |
974 | * @same_page: return if the segment has been merged inside the same page | |
c66a14d0 | 975 | * |
e4581105 CH |
976 | * Add a page to a bio while respecting the hardware max_sectors, max_segment |
977 | * and gap limitations. | |
1da177e4 | 978 | */ |
e4581105 | 979 | int bio_add_hw_page(struct request_queue *q, struct bio *bio, |
19047087 | 980 | struct page *page, unsigned int len, unsigned int offset, |
e4581105 | 981 | unsigned int max_sectors, bool *same_page) |
1da177e4 | 982 | { |
6ef02df1 CH |
983 | unsigned int max_size = max_sectors << SECTOR_SHIFT; |
984 | ||
e4581105 | 985 | if (WARN_ON_ONCE(bio_flagged(bio, BIO_CLONED))) |
1da177e4 LT |
986 | return 0; |
987 | ||
6ef02df1 CH |
988 | len = min3(len, max_size, queue_max_segment_size(q)); |
989 | if (len > max_size - bio->bi_iter.bi_size) | |
1da177e4 LT |
990 | return 0; |
991 | ||
80cfd548 | 992 | if (bio->bi_vcnt > 0) { |
ae42f0b3 CH |
993 | struct bio_vec *bv = &bio->bi_io_vec[bio->bi_vcnt - 1]; |
994 | ||
995 | if (bvec_try_merge_hw_page(q, bv, page, len, offset, | |
858c708d CH |
996 | same_page)) { |
997 | bio->bi_iter.bi_size += len; | |
384209cd | 998 | return len; |
858c708d | 999 | } |
320ea869 | 1000 | |
cd1d83e2 CH |
1001 | if (bio->bi_vcnt >= |
1002 | min(bio->bi_max_vecs, queue_max_segments(q))) | |
1003 | return 0; | |
1004 | ||
320ea869 CH |
1005 | /* |
1006 | * If the queue doesn't support SG gaps and adding this segment | |
1007 | * would create a gap, disallow it. | |
1008 | */ | |
ae42f0b3 | 1009 | if (bvec_gap_to_prev(&q->limits, bv, offset)) |
320ea869 | 1010 | return 0; |
80cfd548 JA |
1011 | } |
1012 | ||
d58cdfae | 1013 | bvec_set_page(&bio->bi_io_vec[bio->bi_vcnt], page, len, offset); |
fcbf6a08 | 1014 | bio->bi_vcnt++; |
dcdca753 | 1015 | bio->bi_iter.bi_size += len; |
1da177e4 LT |
1016 | return len; |
1017 | } | |
19047087 | 1018 | |
e4581105 CH |
1019 | /** |
1020 | * bio_add_pc_page - attempt to add page to passthrough bio | |
1021 | * @q: the target queue | |
1022 | * @bio: destination bio | |
1023 | * @page: page to add | |
1024 | * @len: vec entry length | |
1025 | * @offset: vec entry offset | |
1026 | * | |
1027 | * Attempt to add a page to the bio_vec maplist. This can fail for a | |
1028 | * number of reasons, such as the bio being full or target block device | |
1029 | * limitations. The target block device must allow bio's up to PAGE_SIZE, | |
1030 | * so it is always possible to add a single page to an empty bio. | |
1031 | * | |
1032 | * This should only be used by passthrough bios. | |
1033 | */ | |
19047087 ML |
1034 | int bio_add_pc_page(struct request_queue *q, struct bio *bio, |
1035 | struct page *page, unsigned int len, unsigned int offset) | |
1036 | { | |
d1916c86 | 1037 | bool same_page = false; |
e4581105 CH |
1038 | return bio_add_hw_page(q, bio, page, len, offset, |
1039 | queue_max_hw_sectors(q), &same_page); | |
19047087 | 1040 | } |
a112a71d | 1041 | EXPORT_SYMBOL(bio_add_pc_page); |
6e68af66 | 1042 | |
ae29333f JT |
1043 | /** |
1044 | * bio_add_zone_append_page - attempt to add page to zone-append bio | |
1045 | * @bio: destination bio | |
1046 | * @page: page to add | |
1047 | * @len: vec entry length | |
1048 | * @offset: vec entry offset | |
1049 | * | |
1050 | * Attempt to add a page to the bio_vec maplist of a bio that will be submitted | |
1051 | * for a zone-append request. This can fail for a number of reasons, such as the | |
1052 | * bio being full or the target block device is not a zoned block device or | |
1053 | * other limitations of the target block device. The target block device must | |
1054 | * allow bio's up to PAGE_SIZE, so it is always possible to add a single page | |
1055 | * to an empty bio. | |
1056 | * | |
1057 | * Returns: number of bytes added to the bio, or 0 in case of a failure. | |
1058 | */ | |
1059 | int bio_add_zone_append_page(struct bio *bio, struct page *page, | |
1060 | unsigned int len, unsigned int offset) | |
1061 | { | |
3caee463 | 1062 | struct request_queue *q = bdev_get_queue(bio->bi_bdev); |
ae29333f JT |
1063 | bool same_page = false; |
1064 | ||
1065 | if (WARN_ON_ONCE(bio_op(bio) != REQ_OP_ZONE_APPEND)) | |
1066 | return 0; | |
1067 | ||
edd1dbc8 | 1068 | if (WARN_ON_ONCE(!bdev_is_zoned(bio->bi_bdev))) |
ae29333f JT |
1069 | return 0; |
1070 | ||
1071 | return bio_add_hw_page(q, bio, page, len, offset, | |
1072 | queue_max_zone_append_sectors(q), &same_page); | |
1073 | } | |
1074 | EXPORT_SYMBOL_GPL(bio_add_zone_append_page); | |
1075 | ||
0aa69fd3 | 1076 | /** |
551879a4 | 1077 | * __bio_add_page - add page(s) to a bio in a new segment |
0aa69fd3 | 1078 | * @bio: destination bio |
551879a4 ML |
1079 | * @page: start page to add |
1080 | * @len: length of the data to add, may cross pages | |
1081 | * @off: offset of the data relative to @page, may cross pages | |
0aa69fd3 CH |
1082 | * |
1083 | * Add the data at @page + @off to @bio as a new bvec. The caller must ensure | |
1084 | * that @bio has space for another bvec. | |
1085 | */ | |
1086 | void __bio_add_page(struct bio *bio, struct page *page, | |
1087 | unsigned int len, unsigned int off) | |
1088 | { | |
0aa69fd3 | 1089 | WARN_ON_ONCE(bio_flagged(bio, BIO_CLONED)); |
79d08f89 | 1090 | WARN_ON_ONCE(bio_full(bio, len)); |
0aa69fd3 | 1091 | |
d58cdfae | 1092 | bvec_set_page(&bio->bi_io_vec[bio->bi_vcnt], page, len, off); |
c66a14d0 | 1093 | bio->bi_iter.bi_size += len; |
0aa69fd3 CH |
1094 | bio->bi_vcnt++; |
1095 | } | |
1096 | EXPORT_SYMBOL_GPL(__bio_add_page); | |
1097 | ||
1098 | /** | |
551879a4 | 1099 | * bio_add_page - attempt to add page(s) to bio |
0aa69fd3 | 1100 | * @bio: destination bio |
551879a4 ML |
1101 | * @page: start page to add |
1102 | * @len: vec entry length, may cross pages | |
1103 | * @offset: vec entry offset relative to @page, may cross pages | |
0aa69fd3 | 1104 | * |
551879a4 | 1105 | * Attempt to add page(s) to the bio_vec maplist. This will only fail |
0aa69fd3 CH |
1106 | * if either bio->bi_vcnt == bio->bi_max_vecs or it's a cloned bio. |
1107 | */ | |
1108 | int bio_add_page(struct bio *bio, struct page *page, | |
1109 | unsigned int len, unsigned int offset) | |
1110 | { | |
ff896738 CH |
1111 | bool same_page = false; |
1112 | ||
939e1a37 CH |
1113 | if (WARN_ON_ONCE(bio_flagged(bio, BIO_CLONED))) |
1114 | return 0; | |
61369905 CH |
1115 | if (bio->bi_iter.bi_size > UINT_MAX - len) |
1116 | return 0; | |
939e1a37 | 1117 | |
0eca8b6f | 1118 | if (bio->bi_vcnt > 0 && |
858c708d CH |
1119 | bvec_try_merge_page(&bio->bi_io_vec[bio->bi_vcnt - 1], |
1120 | page, len, offset, &same_page)) { | |
1121 | bio->bi_iter.bi_size += len; | |
0eca8b6f | 1122 | return len; |
858c708d | 1123 | } |
0eca8b6f | 1124 | |
80232b52 | 1125 | if (bio->bi_vcnt >= bio->bi_max_vecs) |
0eca8b6f CH |
1126 | return 0; |
1127 | __bio_add_page(bio, page, len, offset); | |
c66a14d0 | 1128 | return len; |
1da177e4 | 1129 | } |
a112a71d | 1130 | EXPORT_SYMBOL(bio_add_page); |
1da177e4 | 1131 | |
7a150f1e JT |
1132 | void bio_add_folio_nofail(struct bio *bio, struct folio *folio, size_t len, |
1133 | size_t off) | |
1134 | { | |
1135 | WARN_ON_ONCE(len > UINT_MAX); | |
1136 | WARN_ON_ONCE(off > UINT_MAX); | |
1137 | __bio_add_page(bio, &folio->page, len, off); | |
1138 | } | |
8fde439b | 1139 | EXPORT_SYMBOL_GPL(bio_add_folio_nofail); |
7a150f1e | 1140 | |
85f5a74c MWO |
1141 | /** |
1142 | * bio_add_folio - Attempt to add part of a folio to a bio. | |
1143 | * @bio: BIO to add to. | |
1144 | * @folio: Folio to add. | |
1145 | * @len: How many bytes from the folio to add. | |
1146 | * @off: First byte in this folio to add. | |
1147 | * | |
1148 | * Filesystems that use folios can call this function instead of calling | |
1149 | * bio_add_page() for each page in the folio. If @off is bigger than | |
1150 | * PAGE_SIZE, this function can create a bio_vec that starts in a page | |
1151 | * after the bv_page. BIOs do not support folios that are 4GiB or larger. | |
1152 | * | |
1153 | * Return: Whether the addition was successful. | |
1154 | */ | |
1155 | bool bio_add_folio(struct bio *bio, struct folio *folio, size_t len, | |
1156 | size_t off) | |
1157 | { | |
1158 | if (len > UINT_MAX || off > UINT_MAX) | |
455a844d | 1159 | return false; |
85f5a74c MWO |
1160 | return bio_add_page(bio, &folio->page, len, off) > 0; |
1161 | } | |
cd57b771 | 1162 | EXPORT_SYMBOL(bio_add_folio); |
85f5a74c | 1163 | |
c809084a | 1164 | void __bio_release_pages(struct bio *bio, bool mark_dirty) |
7321ecbf | 1165 | { |
1b151e24 MWO |
1166 | struct folio_iter fi; |
1167 | ||
1168 | bio_for_each_folio_all(fi, bio) { | |
1169 | struct page *page; | |
38b43539 | 1170 | size_t nr_pages; |
7321ecbf | 1171 | |
1b151e24 MWO |
1172 | if (mark_dirty) { |
1173 | folio_lock(fi.folio); | |
1174 | folio_mark_dirty(fi.folio); | |
1175 | folio_unlock(fi.folio); | |
1176 | } | |
1177 | page = folio_page(fi.folio, fi.offset / PAGE_SIZE); | |
38b43539 TB |
1178 | nr_pages = (fi.offset + fi.length - 1) / PAGE_SIZE - |
1179 | fi.offset / PAGE_SIZE + 1; | |
1b151e24 MWO |
1180 | do { |
1181 | bio_release_page(bio, page++); | |
38b43539 | 1182 | } while (--nr_pages != 0); |
d241a95f | 1183 | } |
7321ecbf | 1184 | } |
c809084a | 1185 | EXPORT_SYMBOL_GPL(__bio_release_pages); |
7321ecbf | 1186 | |
1bb6b810 | 1187 | void bio_iov_bvec_set(struct bio *bio, struct iov_iter *iter) |
6d0c48ae | 1188 | { |
fa5fa8ec PB |
1189 | size_t size = iov_iter_count(iter); |
1190 | ||
7a800a20 | 1191 | WARN_ON_ONCE(bio->bi_max_vecs); |
c42bca92 | 1192 | |
fa5fa8ec PB |
1193 | if (bio_op(bio) == REQ_OP_ZONE_APPEND) { |
1194 | struct request_queue *q = bdev_get_queue(bio->bi_bdev); | |
1195 | size_t max_sectors = queue_max_zone_append_sectors(q); | |
1196 | ||
1197 | size = min(size, max_sectors << SECTOR_SHIFT); | |
1198 | } | |
1199 | ||
c42bca92 | 1200 | bio->bi_vcnt = iter->nr_segs; |
c42bca92 PB |
1201 | bio->bi_io_vec = (struct bio_vec *)iter->bvec; |
1202 | bio->bi_iter.bi_bvec_done = iter->iov_offset; | |
fa5fa8ec | 1203 | bio->bi_iter.bi_size = size; |
977be012 | 1204 | bio_set_flag(bio, BIO_CLONED); |
7de55b7d | 1205 | } |
c42bca92 | 1206 | |
c58c0074 KB |
1207 | static int bio_iov_add_page(struct bio *bio, struct page *page, |
1208 | unsigned int len, unsigned int offset) | |
1209 | { | |
1210 | bool same_page = false; | |
1211 | ||
61369905 CH |
1212 | if (WARN_ON_ONCE(bio->bi_iter.bi_size > UINT_MAX - len)) |
1213 | return -EIO; | |
1214 | ||
0eca8b6f | 1215 | if (bio->bi_vcnt > 0 && |
858c708d CH |
1216 | bvec_try_merge_page(&bio->bi_io_vec[bio->bi_vcnt - 1], |
1217 | page, len, offset, &same_page)) { | |
1218 | bio->bi_iter.bi_size += len; | |
0eca8b6f CH |
1219 | if (same_page) |
1220 | bio_release_page(bio, page); | |
c58c0074 KB |
1221 | return 0; |
1222 | } | |
0eca8b6f | 1223 | __bio_add_page(bio, page, len, offset); |
c58c0074 KB |
1224 | return 0; |
1225 | } | |
1226 | ||
1227 | static int bio_iov_add_zone_append_page(struct bio *bio, struct page *page, | |
1228 | unsigned int len, unsigned int offset) | |
1229 | { | |
1230 | struct request_queue *q = bdev_get_queue(bio->bi_bdev); | |
1231 | bool same_page = false; | |
1232 | ||
1233 | if (bio_add_hw_page(q, bio, page, len, offset, | |
1234 | queue_max_zone_append_sectors(q), &same_page) != len) | |
1235 | return -EINVAL; | |
1236 | if (same_page) | |
a7e689dd | 1237 | bio_release_page(bio, page); |
c58c0074 KB |
1238 | return 0; |
1239 | } | |
1240 | ||
576ed913 CH |
1241 | #define PAGE_PTRS_PER_BVEC (sizeof(struct bio_vec) / sizeof(struct page *)) |
1242 | ||
2cefe4db | 1243 | /** |
17d51b10 | 1244 | * __bio_iov_iter_get_pages - pin user or kernel pages and add them to a bio |
2cefe4db KO |
1245 | * @bio: bio to add pages to |
1246 | * @iter: iov iterator describing the region to be mapped | |
1247 | * | |
a7e689dd DH |
1248 | * Extracts pages from *iter and appends them to @bio's bvec array. The pages |
1249 | * will have to be cleaned up in the way indicated by the BIO_PAGE_PINNED flag. | |
1250 | * For a multi-segment *iter, this function only adds pages from the next | |
1251 | * non-empty segment of the iov iterator. | |
2cefe4db | 1252 | */ |
17d51b10 | 1253 | static int __bio_iov_iter_get_pages(struct bio *bio, struct iov_iter *iter) |
2cefe4db | 1254 | { |
f62e52d1 | 1255 | iov_iter_extraction_t extraction_flags = 0; |
576ed913 CH |
1256 | unsigned short nr_pages = bio->bi_max_vecs - bio->bi_vcnt; |
1257 | unsigned short entries_left = bio->bi_max_vecs - bio->bi_vcnt; | |
2cefe4db KO |
1258 | struct bio_vec *bv = bio->bi_io_vec + bio->bi_vcnt; |
1259 | struct page **pages = (struct page **)bv; | |
576ed913 | 1260 | ssize_t size, left; |
e97424fd | 1261 | unsigned len, i = 0; |
168145f6 | 1262 | size_t offset; |
325347d9 | 1263 | int ret = 0; |
576ed913 CH |
1264 | |
1265 | /* | |
1266 | * Move page array up in the allocated memory for the bio vecs as far as | |
1267 | * possible so that we can start filling biovecs from the beginning | |
1268 | * without overwriting the temporary page array. | |
c58c0074 | 1269 | */ |
576ed913 CH |
1270 | BUILD_BUG_ON(PAGE_PTRS_PER_BVEC < 2); |
1271 | pages += entries_left * (PAGE_PTRS_PER_BVEC - 1); | |
2cefe4db | 1272 | |
5e3e3f2e | 1273 | if (bio->bi_bdev && blk_queue_pci_p2pdma(bio->bi_bdev->bd_disk->queue)) |
f62e52d1 | 1274 | extraction_flags |= ITER_ALLOW_P2PDMA; |
5e3e3f2e | 1275 | |
b1a000d3 KB |
1276 | /* |
1277 | * Each segment in the iov is required to be a block size multiple. | |
1278 | * However, we may not be able to get the entire segment if it spans | |
1279 | * more pages than bi_max_vecs allows, so we have to ALIGN_DOWN the | |
1280 | * result to ensure the bio's total size is correct. The remainder of | |
1281 | * the iov data will be picked up in the next bio iteration. | |
1282 | */ | |
a7e689dd DH |
1283 | size = iov_iter_extract_pages(iter, &pages, |
1284 | UINT_MAX - bio->bi_iter.bi_size, | |
1285 | nr_pages, extraction_flags, &offset); | |
480cb846 AV |
1286 | if (unlikely(size <= 0)) |
1287 | return size ? size : -EFAULT; | |
1288 | ||
1289 | nr_pages = DIV_ROUND_UP(offset + size, PAGE_SIZE); | |
1290 | ||
168145f6 KO |
1291 | if (bio->bi_bdev) { |
1292 | size_t trim = size & (bdev_logical_block_size(bio->bi_bdev) - 1); | |
1293 | iov_iter_revert(iter, trim); | |
1294 | size -= trim; | |
1295 | } | |
480cb846 | 1296 | |
480cb846 AV |
1297 | if (unlikely(!size)) { |
1298 | ret = -EFAULT; | |
e97424fd KB |
1299 | goto out; |
1300 | } | |
2cefe4db | 1301 | |
576ed913 CH |
1302 | for (left = size, i = 0; left > 0; left -= len, i++) { |
1303 | struct page *page = pages[i]; | |
2cefe4db | 1304 | |
576ed913 | 1305 | len = min_t(size_t, PAGE_SIZE - offset, left); |
34cdb8c8 | 1306 | if (bio_op(bio) == REQ_OP_ZONE_APPEND) { |
c58c0074 KB |
1307 | ret = bio_iov_add_zone_append_page(bio, page, len, |
1308 | offset); | |
e97424fd | 1309 | if (ret) |
34cdb8c8 | 1310 | break; |
34cdb8c8 KB |
1311 | } else |
1312 | bio_iov_add_page(bio, page, len, offset); | |
45691804 | 1313 | |
576ed913 | 1314 | offset = 0; |
2cefe4db KO |
1315 | } |
1316 | ||
480cb846 | 1317 | iov_iter_revert(iter, left); |
e97424fd KB |
1318 | out: |
1319 | while (i < nr_pages) | |
a7e689dd | 1320 | bio_release_page(bio, pages[i++]); |
e97424fd | 1321 | |
325347d9 | 1322 | return ret; |
2cefe4db | 1323 | } |
17d51b10 MW |
1324 | |
1325 | /** | |
6d0c48ae | 1326 | * bio_iov_iter_get_pages - add user or kernel pages to a bio |
17d51b10 | 1327 | * @bio: bio to add pages to |
6d0c48ae JA |
1328 | * @iter: iov iterator describing the region to be added |
1329 | * | |
1330 | * This takes either an iterator pointing to user memory, or one pointing to | |
1331 | * kernel pages (BVEC iterator). If we're adding user pages, we pin them and | |
1332 | * map them into the kernel. On IO completion, the caller should put those | |
c42bca92 PB |
1333 | * pages. For bvec based iterators bio_iov_iter_get_pages() uses the provided |
1334 | * bvecs rather than copying them. Hence anyone issuing kiocb based IO needs | |
1335 | * to ensure the bvecs and pages stay referenced until the submitted I/O is | |
1336 | * completed by a call to ->ki_complete() or returns with an error other than | |
1337 | * -EIOCBQUEUED. The caller needs to check if the bio is flagged BIO_NO_PAGE_REF | |
1338 | * on IO completion. If it isn't, then pages should be released. | |
17d51b10 | 1339 | * |
17d51b10 | 1340 | * The function tries, but does not guarantee, to pin as many pages as |
5cd3ddc1 | 1341 | * fit into the bio, or are requested in @iter, whatever is smaller. If |
6d0c48ae JA |
1342 | * MM encounters an error pinning the requested pages, it stops. Error |
1343 | * is returned only if 0 pages could be pinned. | |
17d51b10 MW |
1344 | */ |
1345 | int bio_iov_iter_get_pages(struct bio *bio, struct iov_iter *iter) | |
1346 | { | |
c42bca92 | 1347 | int ret = 0; |
14eacf12 | 1348 | |
939e1a37 CH |
1349 | if (WARN_ON_ONCE(bio_flagged(bio, BIO_CLONED))) |
1350 | return -EIO; | |
1351 | ||
c42bca92 | 1352 | if (iov_iter_is_bvec(iter)) { |
fa5fa8ec PB |
1353 | bio_iov_bvec_set(bio, iter); |
1354 | iov_iter_advance(iter, bio->bi_iter.bi_size); | |
1355 | return 0; | |
c42bca92 | 1356 | } |
17d51b10 | 1357 | |
a7e689dd DH |
1358 | if (iov_iter_extract_will_pin(iter)) |
1359 | bio_set_flag(bio, BIO_PAGE_PINNED); | |
17d51b10 | 1360 | do { |
c58c0074 | 1361 | ret = __bio_iov_iter_get_pages(bio, iter); |
79d08f89 | 1362 | } while (!ret && iov_iter_count(iter) && !bio_full(bio, 0)); |
17d51b10 | 1363 | |
14eacf12 | 1364 | return bio->bi_vcnt ? 0 : ret; |
17d51b10 | 1365 | } |
29b2a3aa | 1366 | EXPORT_SYMBOL_GPL(bio_iov_iter_get_pages); |
2cefe4db | 1367 | |
4246a0b6 | 1368 | static void submit_bio_wait_endio(struct bio *bio) |
9e882242 | 1369 | { |
65e53aab | 1370 | complete(bio->bi_private); |
9e882242 KO |
1371 | } |
1372 | ||
1373 | /** | |
1374 | * submit_bio_wait - submit a bio, and wait until it completes | |
9e882242 KO |
1375 | * @bio: The &struct bio which describes the I/O |
1376 | * | |
1377 | * Simple wrapper around submit_bio(). Returns 0 on success, or the error from | |
1378 | * bio_endio() on failure. | |
3d289d68 JK |
1379 | * |
1380 | * WARNING: Unlike to how submit_bio() is usually used, this function does not | |
1381 | * result in bio reference to be consumed. The caller must drop the reference | |
1382 | * on his own. | |
9e882242 | 1383 | */ |
4e49ea4a | 1384 | int submit_bio_wait(struct bio *bio) |
9e882242 | 1385 | { |
309dca30 CH |
1386 | DECLARE_COMPLETION_ONSTACK_MAP(done, |
1387 | bio->bi_bdev->bd_disk->lockdep_map); | |
9e882242 | 1388 | |
65e53aab | 1389 | bio->bi_private = &done; |
9e882242 | 1390 | bio->bi_end_io = submit_bio_wait_endio; |
1eff9d32 | 1391 | bio->bi_opf |= REQ_SYNC; |
4e49ea4a | 1392 | submit_bio(bio); |
0eb4db47 | 1393 | blk_wait_io(&done); |
9e882242 | 1394 | |
65e53aab | 1395 | return blk_status_to_errno(bio->bi_status); |
9e882242 KO |
1396 | } |
1397 | EXPORT_SYMBOL(submit_bio_wait); | |
1398 | ||
0f8e9ecc KB |
1399 | static void bio_wait_end_io(struct bio *bio) |
1400 | { | |
1401 | complete(bio->bi_private); | |
1402 | bio_put(bio); | |
1403 | } | |
1404 | ||
1405 | /* | |
1406 | * bio_await_chain - ends @bio and waits for every chained bio to complete | |
1407 | */ | |
1408 | void bio_await_chain(struct bio *bio) | |
1409 | { | |
1410 | DECLARE_COMPLETION_ONSTACK_MAP(done, | |
1411 | bio->bi_bdev->bd_disk->lockdep_map); | |
1412 | ||
1413 | bio->bi_private = &done; | |
1414 | bio->bi_end_io = bio_wait_end_io; | |
1415 | bio_endio(bio); | |
1416 | blk_wait_io(&done); | |
1417 | } | |
1418 | ||
d4aa57a1 | 1419 | void __bio_advance(struct bio *bio, unsigned bytes) |
054bdf64 KO |
1420 | { |
1421 | if (bio_integrity(bio)) | |
1422 | bio_integrity_advance(bio, bytes); | |
1423 | ||
a892c8d5 | 1424 | bio_crypt_advance(bio, bytes); |
4550dd6c | 1425 | bio_advance_iter(bio, &bio->bi_iter, bytes); |
054bdf64 | 1426 | } |
d4aa57a1 | 1427 | EXPORT_SYMBOL(__bio_advance); |
054bdf64 | 1428 | |
ee4b4e22 JA |
1429 | void bio_copy_data_iter(struct bio *dst, struct bvec_iter *dst_iter, |
1430 | struct bio *src, struct bvec_iter *src_iter) | |
1431 | { | |
1432 | while (src_iter->bi_size && dst_iter->bi_size) { | |
1433 | struct bio_vec src_bv = bio_iter_iovec(src, *src_iter); | |
1434 | struct bio_vec dst_bv = bio_iter_iovec(dst, *dst_iter); | |
1435 | unsigned int bytes = min(src_bv.bv_len, dst_bv.bv_len); | |
1436 | void *src_buf = bvec_kmap_local(&src_bv); | |
1437 | void *dst_buf = bvec_kmap_local(&dst_bv); | |
1438 | ||
1439 | memcpy(dst_buf, src_buf, bytes); | |
1440 | ||
1441 | kunmap_local(dst_buf); | |
1442 | kunmap_local(src_buf); | |
1443 | ||
1444 | bio_advance_iter_single(src, src_iter, bytes); | |
1445 | bio_advance_iter_single(dst, dst_iter, bytes); | |
1446 | } | |
1447 | } | |
1448 | EXPORT_SYMBOL(bio_copy_data_iter); | |
1449 | ||
38a72dac | 1450 | /** |
45db54d5 KO |
1451 | * bio_copy_data - copy contents of data buffers from one bio to another |
1452 | * @src: source bio | |
1453 | * @dst: destination bio | |
38a72dac KO |
1454 | * |
1455 | * Stops when it reaches the end of either @src or @dst - that is, copies | |
1456 | * min(src->bi_size, dst->bi_size) bytes (or the equivalent for lists of bios). | |
1457 | */ | |
1458 | void bio_copy_data(struct bio *dst, struct bio *src) | |
1459 | { | |
45db54d5 KO |
1460 | struct bvec_iter src_iter = src->bi_iter; |
1461 | struct bvec_iter dst_iter = dst->bi_iter; | |
1462 | ||
ee4b4e22 | 1463 | bio_copy_data_iter(dst, &dst_iter, src, &src_iter); |
38a72dac | 1464 | } |
16ac3d63 KO |
1465 | EXPORT_SYMBOL(bio_copy_data); |
1466 | ||
491221f8 | 1467 | void bio_free_pages(struct bio *bio) |
1dfa0f68 CH |
1468 | { |
1469 | struct bio_vec *bvec; | |
6dc4f100 | 1470 | struct bvec_iter_all iter_all; |
1dfa0f68 | 1471 | |
2b070cfe | 1472 | bio_for_each_segment_all(bvec, bio, iter_all) |
1dfa0f68 CH |
1473 | __free_page(bvec->bv_page); |
1474 | } | |
491221f8 | 1475 | EXPORT_SYMBOL(bio_free_pages); |
1dfa0f68 | 1476 | |
1da177e4 LT |
1477 | /* |
1478 | * bio_set_pages_dirty() and bio_check_pages_dirty() are support functions | |
1479 | * for performing direct-IO in BIOs. | |
1480 | * | |
1b151e24 | 1481 | * The problem is that we cannot run folio_mark_dirty() from interrupt context |
1da177e4 LT |
1482 | * because the required locks are not interrupt-safe. So what we can do is to |
1483 | * mark the pages dirty _before_ performing IO. And in interrupt context, | |
1484 | * check that the pages are still dirty. If so, fine. If not, redirty them | |
1485 | * in process context. | |
1486 | * | |
1da177e4 LT |
1487 | * Note that this code is very hard to test under normal circumstances because |
1488 | * direct-io pins the pages with get_user_pages(). This makes | |
1489 | * is_page_cache_freeable return false, and the VM will not clean the pages. | |
0d5c3eba | 1490 | * But other code (eg, flusher threads) could clean the pages if they are mapped |
1da177e4 LT |
1491 | * pagecache. |
1492 | * | |
1493 | * Simply disabling the call to bio_set_pages_dirty() is a good way to test the | |
1494 | * deferred bio dirtying paths. | |
1495 | */ | |
1496 | ||
1497 | /* | |
1498 | * bio_set_pages_dirty() will mark all the bio's pages as dirty. | |
1499 | */ | |
1500 | void bio_set_pages_dirty(struct bio *bio) | |
1501 | { | |
1b151e24 | 1502 | struct folio_iter fi; |
1da177e4 | 1503 | |
1b151e24 MWO |
1504 | bio_for_each_folio_all(fi, bio) { |
1505 | folio_lock(fi.folio); | |
1506 | folio_mark_dirty(fi.folio); | |
1507 | folio_unlock(fi.folio); | |
1da177e4 LT |
1508 | } |
1509 | } | |
7ba37927 | 1510 | EXPORT_SYMBOL_GPL(bio_set_pages_dirty); |
1da177e4 | 1511 | |
1da177e4 LT |
1512 | /* |
1513 | * bio_check_pages_dirty() will check that all the BIO's pages are still dirty. | |
1514 | * If they are, then fine. If, however, some pages are clean then they must | |
1515 | * have been written out during the direct-IO read. So we take another ref on | |
24d5493f | 1516 | * the BIO and re-dirty the pages in process context. |
1da177e4 LT |
1517 | * |
1518 | * It is expected that bio_check_pages_dirty() will wholly own the BIO from | |
fd363244 DH |
1519 | * here on. It will unpin each page and will run one bio_put() against the |
1520 | * BIO. | |
1da177e4 LT |
1521 | */ |
1522 | ||
65f27f38 | 1523 | static void bio_dirty_fn(struct work_struct *work); |
1da177e4 | 1524 | |
65f27f38 | 1525 | static DECLARE_WORK(bio_dirty_work, bio_dirty_fn); |
1da177e4 LT |
1526 | static DEFINE_SPINLOCK(bio_dirty_lock); |
1527 | static struct bio *bio_dirty_list; | |
1528 | ||
1529 | /* | |
1530 | * This runs in process context | |
1531 | */ | |
65f27f38 | 1532 | static void bio_dirty_fn(struct work_struct *work) |
1da177e4 | 1533 | { |
24d5493f | 1534 | struct bio *bio, *next; |
1da177e4 | 1535 | |
24d5493f CH |
1536 | spin_lock_irq(&bio_dirty_lock); |
1537 | next = bio_dirty_list; | |
1da177e4 | 1538 | bio_dirty_list = NULL; |
24d5493f | 1539 | spin_unlock_irq(&bio_dirty_lock); |
1da177e4 | 1540 | |
24d5493f CH |
1541 | while ((bio = next) != NULL) { |
1542 | next = bio->bi_private; | |
1da177e4 | 1543 | |
d241a95f | 1544 | bio_release_pages(bio, true); |
1da177e4 | 1545 | bio_put(bio); |
1da177e4 LT |
1546 | } |
1547 | } | |
1548 | ||
1549 | void bio_check_pages_dirty(struct bio *bio) | |
1550 | { | |
1b151e24 | 1551 | struct folio_iter fi; |
24d5493f | 1552 | unsigned long flags; |
1da177e4 | 1553 | |
1b151e24 MWO |
1554 | bio_for_each_folio_all(fi, bio) { |
1555 | if (!folio_test_dirty(fi.folio)) | |
24d5493f | 1556 | goto defer; |
1da177e4 LT |
1557 | } |
1558 | ||
d241a95f | 1559 | bio_release_pages(bio, false); |
24d5493f CH |
1560 | bio_put(bio); |
1561 | return; | |
1562 | defer: | |
1563 | spin_lock_irqsave(&bio_dirty_lock, flags); | |
1564 | bio->bi_private = bio_dirty_list; | |
1565 | bio_dirty_list = bio; | |
1566 | spin_unlock_irqrestore(&bio_dirty_lock, flags); | |
1567 | schedule_work(&bio_dirty_work); | |
1da177e4 | 1568 | } |
7ba37927 | 1569 | EXPORT_SYMBOL_GPL(bio_check_pages_dirty); |
1da177e4 | 1570 | |
c4cf5261 JA |
1571 | static inline bool bio_remaining_done(struct bio *bio) |
1572 | { | |
1573 | /* | |
1574 | * If we're not chaining, then ->__bi_remaining is always 1 and | |
1575 | * we always end io on the first invocation. | |
1576 | */ | |
1577 | if (!bio_flagged(bio, BIO_CHAIN)) | |
1578 | return true; | |
1579 | ||
1580 | BUG_ON(atomic_read(&bio->__bi_remaining) <= 0); | |
1581 | ||
326e1dbb | 1582 | if (atomic_dec_and_test(&bio->__bi_remaining)) { |
b7c44ed9 | 1583 | bio_clear_flag(bio, BIO_CHAIN); |
c4cf5261 | 1584 | return true; |
326e1dbb | 1585 | } |
c4cf5261 JA |
1586 | |
1587 | return false; | |
1588 | } | |
1589 | ||
1da177e4 LT |
1590 | /** |
1591 | * bio_endio - end I/O on a bio | |
1592 | * @bio: bio | |
1da177e4 LT |
1593 | * |
1594 | * Description: | |
4246a0b6 CH |
1595 | * bio_endio() will end I/O on the whole bio. bio_endio() is the preferred |
1596 | * way to end I/O on a bio. No one should call bi_end_io() directly on a | |
1597 | * bio unless they own it and thus know that it has an end_io function. | |
fbbaf700 N |
1598 | * |
1599 | * bio_endio() can be called several times on a bio that has been chained | |
1600 | * using bio_chain(). The ->bi_end_io() function will only be called the | |
60b6a7e6 | 1601 | * last time. |
1da177e4 | 1602 | **/ |
4246a0b6 | 1603 | void bio_endio(struct bio *bio) |
1da177e4 | 1604 | { |
ba8c6967 | 1605 | again: |
2b885517 | 1606 | if (!bio_remaining_done(bio)) |
ba8c6967 | 1607 | return; |
7c20f116 CH |
1608 | if (!bio_integrity_endio(bio)) |
1609 | return; | |
1da177e4 | 1610 | |
dd291d77 DLM |
1611 | blk_zone_bio_endio(bio); |
1612 | ||
aa1b46dc | 1613 | rq_qos_done_bio(bio); |
67b42d0b | 1614 | |
60b6a7e6 | 1615 | if (bio->bi_bdev && bio_flagged(bio, BIO_TRACE_COMPLETION)) { |
3caee463 | 1616 | trace_block_bio_complete(bdev_get_queue(bio->bi_bdev), bio); |
60b6a7e6 EH |
1617 | bio_clear_flag(bio, BIO_TRACE_COMPLETION); |
1618 | } | |
1619 | ||
ba8c6967 CH |
1620 | /* |
1621 | * Need to have a real endio function for chained bios, otherwise | |
1622 | * various corner cases will break (like stacking block devices that | |
1623 | * save/restore bi_end_io) - however, we want to avoid unbounded | |
1624 | * recursion and blowing the stack. Tail call optimization would | |
1625 | * handle this, but compiling with frame pointers also disables | |
1626 | * gcc's sibling call optimization. | |
1627 | */ | |
1628 | if (bio->bi_end_io == bio_chain_endio) { | |
1629 | bio = __bio_chain_endio(bio); | |
1630 | goto again; | |
196d38bc | 1631 | } |
ba8c6967 | 1632 | |
bf4c89fc CH |
1633 | #ifdef CONFIG_BLK_CGROUP |
1634 | /* | |
1635 | * Release cgroup info. We shouldn't have to do this here, but quite | |
1636 | * a few callers of bio_init fail to call bio_uninit, so we cover up | |
1637 | * for that here at least for now. | |
1638 | */ | |
1639 | if (bio->bi_blkg) { | |
1640 | blkg_put(bio->bi_blkg); | |
1641 | bio->bi_blkg = NULL; | |
1642 | } | |
1643 | #endif | |
1644 | ||
ba8c6967 CH |
1645 | if (bio->bi_end_io) |
1646 | bio->bi_end_io(bio); | |
1da177e4 | 1647 | } |
a112a71d | 1648 | EXPORT_SYMBOL(bio_endio); |
1da177e4 | 1649 | |
20d0189b KO |
1650 | /** |
1651 | * bio_split - split a bio | |
1652 | * @bio: bio to split | |
1653 | * @sectors: number of sectors to split from the front of @bio | |
1654 | * @gfp: gfp mask | |
1655 | * @bs: bio set to allocate from | |
1656 | * | |
1657 | * Allocates and returns a new bio which represents @sectors from the start of | |
1658 | * @bio, and updates @bio to represent the remaining sectors. | |
1659 | * | |
f3f5da62 | 1660 | * Unless this is a discard request the newly allocated bio will point |
dad77584 BVA |
1661 | * to @bio's bi_io_vec. It is the caller's responsibility to ensure that |
1662 | * neither @bio nor @bs are freed before the split bio. | |
20d0189b KO |
1663 | */ |
1664 | struct bio *bio_split(struct bio *bio, int sectors, | |
1665 | gfp_t gfp, struct bio_set *bs) | |
1666 | { | |
f341a4d3 | 1667 | struct bio *split; |
20d0189b KO |
1668 | |
1669 | BUG_ON(sectors <= 0); | |
1670 | BUG_ON(sectors >= bio_sectors(bio)); | |
1671 | ||
0512a75b KB |
1672 | /* Zone append commands cannot be split */ |
1673 | if (WARN_ON_ONCE(bio_op(bio) == REQ_OP_ZONE_APPEND)) | |
1674 | return NULL; | |
1675 | ||
abfc426d | 1676 | split = bio_alloc_clone(bio->bi_bdev, bio, gfp, bs); |
20d0189b KO |
1677 | if (!split) |
1678 | return NULL; | |
1679 | ||
1680 | split->bi_iter.bi_size = sectors << 9; | |
1681 | ||
1682 | if (bio_integrity(split)) | |
fbd08e76 | 1683 | bio_integrity_trim(split); |
20d0189b KO |
1684 | |
1685 | bio_advance(bio, split->bi_iter.bi_size); | |
1686 | ||
fbbaf700 | 1687 | if (bio_flagged(bio, BIO_TRACE_COMPLETION)) |
20d59023 | 1688 | bio_set_flag(split, BIO_TRACE_COMPLETION); |
fbbaf700 | 1689 | |
20d0189b KO |
1690 | return split; |
1691 | } | |
1692 | EXPORT_SYMBOL(bio_split); | |
1693 | ||
6678d83f KO |
1694 | /** |
1695 | * bio_trim - trim a bio | |
1696 | * @bio: bio to trim | |
1697 | * @offset: number of sectors to trim from the front of @bio | |
1698 | * @size: size we want to trim @bio to, in sectors | |
e83502ca CK |
1699 | * |
1700 | * This function is typically used for bios that are cloned and submitted | |
1701 | * to the underlying device in parts. | |
6678d83f | 1702 | */ |
e83502ca | 1703 | void bio_trim(struct bio *bio, sector_t offset, sector_t size) |
6678d83f | 1704 | { |
e83502ca | 1705 | if (WARN_ON_ONCE(offset > BIO_MAX_SECTORS || size > BIO_MAX_SECTORS || |
8535c018 | 1706 | offset + size > bio_sectors(bio))) |
e83502ca | 1707 | return; |
6678d83f KO |
1708 | |
1709 | size <<= 9; | |
4f024f37 | 1710 | if (offset == 0 && size == bio->bi_iter.bi_size) |
6678d83f KO |
1711 | return; |
1712 | ||
6678d83f | 1713 | bio_advance(bio, offset << 9); |
4f024f37 | 1714 | bio->bi_iter.bi_size = size; |
376a78ab DM |
1715 | |
1716 | if (bio_integrity(bio)) | |
fbd08e76 | 1717 | bio_integrity_trim(bio); |
6678d83f KO |
1718 | } |
1719 | EXPORT_SYMBOL_GPL(bio_trim); | |
1720 | ||
1da177e4 LT |
1721 | /* |
1722 | * create memory pools for biovec's in a bio_set. | |
1723 | * use the global biovec slabs created for general use. | |
1724 | */ | |
8aa6ba2f | 1725 | int biovec_init_pool(mempool_t *pool, int pool_entries) |
1da177e4 | 1726 | { |
7a800a20 | 1727 | struct biovec_slab *bp = bvec_slabs + ARRAY_SIZE(bvec_slabs) - 1; |
1da177e4 | 1728 | |
8aa6ba2f | 1729 | return mempool_init_slab_pool(pool, pool_entries, bp->slab); |
1da177e4 LT |
1730 | } |
1731 | ||
917a38c7 KO |
1732 | /* |
1733 | * bioset_exit - exit a bioset initialized with bioset_init() | |
1734 | * | |
1735 | * May be called on a zeroed but uninitialized bioset (i.e. allocated with | |
1736 | * kzalloc()). | |
1737 | */ | |
1738 | void bioset_exit(struct bio_set *bs) | |
1da177e4 | 1739 | { |
be4d234d | 1740 | bio_alloc_cache_destroy(bs); |
df2cb6da KO |
1741 | if (bs->rescue_workqueue) |
1742 | destroy_workqueue(bs->rescue_workqueue); | |
917a38c7 | 1743 | bs->rescue_workqueue = NULL; |
df2cb6da | 1744 | |
8aa6ba2f KO |
1745 | mempool_exit(&bs->bio_pool); |
1746 | mempool_exit(&bs->bvec_pool); | |
9f060e22 | 1747 | |
7878cba9 | 1748 | bioset_integrity_free(bs); |
917a38c7 KO |
1749 | if (bs->bio_slab) |
1750 | bio_put_slab(bs); | |
1751 | bs->bio_slab = NULL; | |
1752 | } | |
1753 | EXPORT_SYMBOL(bioset_exit); | |
1da177e4 | 1754 | |
917a38c7 KO |
1755 | /** |
1756 | * bioset_init - Initialize a bio_set | |
dad08527 | 1757 | * @bs: pool to initialize |
917a38c7 KO |
1758 | * @pool_size: Number of bio and bio_vecs to cache in the mempool |
1759 | * @front_pad: Number of bytes to allocate in front of the returned bio | |
1760 | * @flags: Flags to modify behavior, currently %BIOSET_NEED_BVECS | |
1761 | * and %BIOSET_NEED_RESCUER | |
1762 | * | |
dad08527 KO |
1763 | * Description: |
1764 | * Set up a bio_set to be used with @bio_alloc_bioset. Allows the caller | |
1765 | * to ask for a number of bytes to be allocated in front of the bio. | |
1766 | * Front pad allocation is useful for embedding the bio inside | |
1767 | * another structure, to avoid allocating extra data to go with the bio. | |
1768 | * Note that the bio must be embedded at the END of that structure always, | |
1769 | * or things will break badly. | |
1770 | * If %BIOSET_NEED_BVECS is set in @flags, a separate pool will be allocated | |
abfc426d CH |
1771 | * for allocating iovecs. This pool is not needed e.g. for bio_init_clone(). |
1772 | * If %BIOSET_NEED_RESCUER is set, a workqueue is created which can be used | |
1773 | * to dispatch queued requests when the mempool runs out of space. | |
dad08527 | 1774 | * |
917a38c7 KO |
1775 | */ |
1776 | int bioset_init(struct bio_set *bs, | |
1777 | unsigned int pool_size, | |
1778 | unsigned int front_pad, | |
1779 | int flags) | |
1780 | { | |
917a38c7 | 1781 | bs->front_pad = front_pad; |
9f180e31 ML |
1782 | if (flags & BIOSET_NEED_BVECS) |
1783 | bs->back_pad = BIO_INLINE_VECS * sizeof(struct bio_vec); | |
1784 | else | |
1785 | bs->back_pad = 0; | |
917a38c7 KO |
1786 | |
1787 | spin_lock_init(&bs->rescue_lock); | |
1788 | bio_list_init(&bs->rescue_list); | |
1789 | INIT_WORK(&bs->rescue_work, bio_alloc_rescue); | |
1790 | ||
49d1ec85 | 1791 | bs->bio_slab = bio_find_or_create_slab(bs); |
917a38c7 KO |
1792 | if (!bs->bio_slab) |
1793 | return -ENOMEM; | |
1794 | ||
1795 | if (mempool_init_slab_pool(&bs->bio_pool, pool_size, bs->bio_slab)) | |
1796 | goto bad; | |
1797 | ||
1798 | if ((flags & BIOSET_NEED_BVECS) && | |
1799 | biovec_init_pool(&bs->bvec_pool, pool_size)) | |
1800 | goto bad; | |
1801 | ||
be4d234d JA |
1802 | if (flags & BIOSET_NEED_RESCUER) { |
1803 | bs->rescue_workqueue = alloc_workqueue("bioset", | |
1804 | WQ_MEM_RECLAIM, 0); | |
1805 | if (!bs->rescue_workqueue) | |
1806 | goto bad; | |
1807 | } | |
1808 | if (flags & BIOSET_PERCPU_CACHE) { | |
1809 | bs->cache = alloc_percpu(struct bio_alloc_cache); | |
1810 | if (!bs->cache) | |
1811 | goto bad; | |
1812 | cpuhp_state_add_instance_nocalls(CPUHP_BIO_DEAD, &bs->cpuhp_dead); | |
1813 | } | |
917a38c7 KO |
1814 | |
1815 | return 0; | |
1816 | bad: | |
1817 | bioset_exit(bs); | |
1818 | return -ENOMEM; | |
1819 | } | |
1820 | EXPORT_SYMBOL(bioset_init); | |
1821 | ||
de76fd89 | 1822 | static int __init init_bio(void) |
1da177e4 LT |
1823 | { |
1824 | int i; | |
1825 | ||
a3df2e45 JA |
1826 | BUILD_BUG_ON(BIO_FLAG_LAST > 8 * sizeof_field(struct bio, bi_flags)); |
1827 | ||
7878cba9 | 1828 | bio_integrity_init(); |
1da177e4 | 1829 | |
de76fd89 CH |
1830 | for (i = 0; i < ARRAY_SIZE(bvec_slabs); i++) { |
1831 | struct biovec_slab *bvs = bvec_slabs + i; | |
a7fcd37c | 1832 | |
de76fd89 CH |
1833 | bvs->slab = kmem_cache_create(bvs->name, |
1834 | bvs->nr_vecs * sizeof(struct bio_vec), 0, | |
1835 | SLAB_HWCACHE_ALIGN | SLAB_PANIC, NULL); | |
1da177e4 | 1836 | } |
1da177e4 | 1837 | |
be4d234d JA |
1838 | cpuhp_setup_state_multi(CPUHP_BIO_DEAD, "block/bio:dead", NULL, |
1839 | bio_cpu_dead); | |
1840 | ||
12c5b70c JA |
1841 | if (bioset_init(&fs_bio_set, BIO_POOL_SIZE, 0, |
1842 | BIOSET_NEED_BVECS | BIOSET_PERCPU_CACHE)) | |
1da177e4 LT |
1843 | panic("bio: can't allocate bios\n"); |
1844 | ||
f4f8154a | 1845 | if (bioset_integrity_create(&fs_bio_set, BIO_POOL_SIZE)) |
a91a2785 MP |
1846 | panic("bio: can't create integrity pool\n"); |
1847 | ||
1da177e4 LT |
1848 | return 0; |
1849 | } | |
1da177e4 | 1850 | subsys_initcall(init_bio); |