1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) 2010 Red Hat, Inc.
4 * Copyright (C) 2016-2019 Christoph Hellwig.
6 #include <linux/module.h>
7 #include <linux/compiler.h>
9 #include <linux/iomap.h>
10 #include <linux/pagemap.h>
11 #include <linux/uio.h>
12 #include <linux/buffer_head.h>
13 #include <linux/dax.h>
14 #include <linux/writeback.h>
15 #include <linux/list_sort.h>
16 #include <linux/swap.h>
17 #include <linux/bio.h>
18 #include <linux/sched/signal.h>
19 #include <linux/migrate.h>
22 #include "../internal.h"
24 #define IOEND_BATCH_SIZE 4096
27 * Structure allocated for each folio when block size < folio size
28 * to track sub-folio uptodate status and I/O completions.
31 atomic_t read_bytes_pending;
32 atomic_t write_bytes_pending;
33 spinlock_t uptodate_lock;
34 unsigned long uptodate[];
37 static inline struct iomap_page *to_iomap_page(struct folio *folio)
39 if (folio_test_private(folio))
40 return folio_get_private(folio);
44 static struct bio_set iomap_ioend_bioset;
46 static struct iomap_page *
47 iomap_page_create(struct inode *inode, struct folio *folio)
49 struct iomap_page *iop = to_iomap_page(folio);
50 unsigned int nr_blocks = i_blocks_per_folio(inode, folio);
52 if (iop || nr_blocks <= 1)
55 iop = kzalloc(struct_size(iop, uptodate, BITS_TO_LONGS(nr_blocks)),
56 GFP_NOFS | __GFP_NOFAIL);
57 spin_lock_init(&iop->uptodate_lock);
58 if (folio_test_uptodate(folio))
59 bitmap_fill(iop->uptodate, nr_blocks);
60 folio_attach_private(folio, iop);
64 static void iomap_page_release(struct folio *folio)
66 struct iomap_page *iop = folio_detach_private(folio);
67 struct inode *inode = folio->mapping->host;
68 unsigned int nr_blocks = i_blocks_per_folio(inode, folio);
72 WARN_ON_ONCE(atomic_read(&iop->read_bytes_pending));
73 WARN_ON_ONCE(atomic_read(&iop->write_bytes_pending));
74 WARN_ON_ONCE(bitmap_full(iop->uptodate, nr_blocks) !=
75 folio_test_uptodate(folio));
80 * Calculate the range inside the folio that we actually need to read.
82 static void iomap_adjust_read_range(struct inode *inode, struct folio *folio,
83 loff_t *pos, loff_t length, size_t *offp, size_t *lenp)
85 struct iomap_page *iop = to_iomap_page(folio);
86 loff_t orig_pos = *pos;
87 loff_t isize = i_size_read(inode);
88 unsigned block_bits = inode->i_blkbits;
89 unsigned block_size = (1 << block_bits);
90 size_t poff = offset_in_folio(folio, *pos);
91 size_t plen = min_t(loff_t, folio_size(folio) - poff, length);
92 unsigned first = poff >> block_bits;
93 unsigned last = (poff + plen - 1) >> block_bits;
96 * If the block size is smaller than the page size, we need to check the
97 * per-block uptodate status and adjust the offset and length if needed
98 * to avoid reading in already uptodate ranges.
103 /* move forward for each leading block marked uptodate */
104 for (i = first; i <= last; i++) {
105 if (!test_bit(i, iop->uptodate))
113 /* truncate len if we find any trailing uptodate block(s) */
114 for ( ; i <= last; i++) {
115 if (test_bit(i, iop->uptodate)) {
116 plen -= (last - i + 1) * block_size;
124 * If the extent spans the block that contains the i_size, we need to
125 * handle both halves separately so that we properly zero data in the
126 * page cache for blocks that are entirely outside of i_size.
128 if (orig_pos <= isize && orig_pos + length > isize) {
129 unsigned end = offset_in_folio(folio, isize - 1) >> block_bits;
131 if (first <= end && last > end)
132 plen -= (last - end) * block_size;
139 static void iomap_iop_set_range_uptodate(struct folio *folio,
140 struct iomap_page *iop, size_t off, size_t len)
142 struct inode *inode = folio->mapping->host;
143 unsigned first = off >> inode->i_blkbits;
144 unsigned last = (off + len - 1) >> inode->i_blkbits;
147 spin_lock_irqsave(&iop->uptodate_lock, flags);
148 bitmap_set(iop->uptodate, first, last - first + 1);
149 if (bitmap_full(iop->uptodate, i_blocks_per_folio(inode, folio)))
150 folio_mark_uptodate(folio);
151 spin_unlock_irqrestore(&iop->uptodate_lock, flags);
154 static void iomap_set_range_uptodate(struct folio *folio,
155 struct iomap_page *iop, size_t off, size_t len)
157 if (folio_test_error(folio))
161 iomap_iop_set_range_uptodate(folio, iop, off, len);
163 folio_mark_uptodate(folio);
166 static void iomap_finish_folio_read(struct folio *folio, size_t offset,
167 size_t len, int error)
169 struct iomap_page *iop = to_iomap_page(folio);
171 if (unlikely(error)) {
172 folio_clear_uptodate(folio);
173 folio_set_error(folio);
175 iomap_set_range_uptodate(folio, iop, offset, len);
178 if (!iop || atomic_sub_and_test(len, &iop->read_bytes_pending))
182 static void iomap_read_end_io(struct bio *bio)
184 int error = blk_status_to_errno(bio->bi_status);
185 struct folio_iter fi;
187 bio_for_each_folio_all(fi, bio)
188 iomap_finish_folio_read(fi.folio, fi.offset, fi.length, error);
192 struct iomap_readpage_ctx {
193 struct folio *cur_folio;
194 bool cur_folio_in_bio;
196 struct readahead_control *rac;
200 * iomap_read_inline_data - copy inline data into the page cache
201 * @iter: iteration structure
202 * @folio: folio to copy to
204 * Copy the inline data in @iter into @folio and zero out the rest of the folio.
205 * Only a single IOMAP_INLINE extent is allowed at the end of each file.
206 * Returns zero for success to complete the read, or the usual negative errno.
208 static int iomap_read_inline_data(const struct iomap_iter *iter,
211 struct iomap_page *iop;
212 const struct iomap *iomap = iomap_iter_srcmap(iter);
213 size_t size = i_size_read(iter->inode) - iomap->offset;
214 size_t poff = offset_in_page(iomap->offset);
215 size_t offset = offset_in_folio(folio, iomap->offset);
218 if (folio_test_uptodate(folio))
221 if (WARN_ON_ONCE(size > PAGE_SIZE - poff))
223 if (WARN_ON_ONCE(size > PAGE_SIZE -
224 offset_in_page(iomap->inline_data)))
226 if (WARN_ON_ONCE(size > iomap->length))
229 iop = iomap_page_create(iter->inode, folio);
231 iop = to_iomap_page(folio);
233 addr = kmap_local_folio(folio, offset);
234 memcpy(addr, iomap->inline_data, size);
235 memset(addr + size, 0, PAGE_SIZE - poff - size);
237 iomap_set_range_uptodate(folio, iop, offset, PAGE_SIZE - poff);
241 static inline bool iomap_block_needs_zeroing(const struct iomap_iter *iter,
244 const struct iomap *srcmap = iomap_iter_srcmap(iter);
246 return srcmap->type != IOMAP_MAPPED ||
247 (srcmap->flags & IOMAP_F_NEW) ||
248 pos >= i_size_read(iter->inode);
251 static loff_t iomap_readpage_iter(const struct iomap_iter *iter,
252 struct iomap_readpage_ctx *ctx, loff_t offset)
254 const struct iomap *iomap = &iter->iomap;
255 loff_t pos = iter->pos + offset;
256 loff_t length = iomap_length(iter) - offset;
257 struct folio *folio = ctx->cur_folio;
258 struct iomap_page *iop;
259 loff_t orig_pos = pos;
263 if (iomap->type == IOMAP_INLINE)
264 return iomap_read_inline_data(iter, folio);
266 /* zero post-eof blocks as the page may be mapped */
267 iop = iomap_page_create(iter->inode, folio);
268 iomap_adjust_read_range(iter->inode, folio, &pos, length, &poff, &plen);
272 if (iomap_block_needs_zeroing(iter, pos)) {
273 folio_zero_range(folio, poff, plen);
274 iomap_set_range_uptodate(folio, iop, poff, plen);
278 ctx->cur_folio_in_bio = true;
280 atomic_add(plen, &iop->read_bytes_pending);
282 sector = iomap_sector(iomap, pos);
284 bio_end_sector(ctx->bio) != sector ||
285 !bio_add_folio(ctx->bio, folio, plen, poff)) {
286 gfp_t gfp = mapping_gfp_constraint(folio->mapping, GFP_KERNEL);
287 gfp_t orig_gfp = gfp;
288 unsigned int nr_vecs = DIV_ROUND_UP(length, PAGE_SIZE);
291 submit_bio(ctx->bio);
293 if (ctx->rac) /* same as readahead_gfp_mask */
294 gfp |= __GFP_NORETRY | __GFP_NOWARN;
295 ctx->bio = bio_alloc(gfp, bio_max_segs(nr_vecs));
297 * If the bio_alloc fails, try it again for a single page to
298 * avoid having to deal with partial page reads. This emulates
299 * what do_mpage_readpage does.
302 ctx->bio = bio_alloc(orig_gfp, 1);
303 ctx->bio->bi_opf = REQ_OP_READ;
305 ctx->bio->bi_opf |= REQ_RAHEAD;
306 ctx->bio->bi_iter.bi_sector = sector;
307 bio_set_dev(ctx->bio, iomap->bdev);
308 ctx->bio->bi_end_io = iomap_read_end_io;
309 bio_add_folio(ctx->bio, folio, plen, poff);
314 * Move the caller beyond our range so that it keeps making progress.
315 * For that, we have to include any leading non-uptodate ranges, but
316 * we can skip trailing ones as they will be handled in the next
319 return pos - orig_pos + plen;
323 iomap_readpage(struct page *page, const struct iomap_ops *ops)
325 struct folio *folio = page_folio(page);
326 struct iomap_iter iter = {
327 .inode = folio->mapping->host,
328 .pos = folio_pos(folio),
329 .len = folio_size(folio),
331 struct iomap_readpage_ctx ctx = {
336 trace_iomap_readpage(iter.inode, 1);
338 while ((ret = iomap_iter(&iter, ops)) > 0)
339 iter.processed = iomap_readpage_iter(&iter, &ctx, 0);
342 folio_set_error(folio);
346 WARN_ON_ONCE(!ctx.cur_folio_in_bio);
348 WARN_ON_ONCE(ctx.cur_folio_in_bio);
353 * Just like mpage_readahead and block_read_full_page, we always
354 * return 0 and just mark the page as PageError on errors. This
355 * should be cleaned up throughout the stack eventually.
359 EXPORT_SYMBOL_GPL(iomap_readpage);
361 static loff_t iomap_readahead_iter(const struct iomap_iter *iter,
362 struct iomap_readpage_ctx *ctx)
364 loff_t length = iomap_length(iter);
367 for (done = 0; done < length; done += ret) {
368 if (ctx->cur_folio &&
369 offset_in_folio(ctx->cur_folio, iter->pos + done) == 0) {
370 if (!ctx->cur_folio_in_bio)
371 folio_unlock(ctx->cur_folio);
372 ctx->cur_folio = NULL;
374 if (!ctx->cur_folio) {
375 ctx->cur_folio = readahead_folio(ctx->rac);
376 ctx->cur_folio_in_bio = false;
378 ret = iomap_readpage_iter(iter, ctx, done);
387 * iomap_readahead - Attempt to read pages from a file.
388 * @rac: Describes the pages to be read.
389 * @ops: The operations vector for the filesystem.
391 * This function is for filesystems to call to implement their readahead
392 * address_space operation.
394 * Context: The @ops callbacks may submit I/O (eg to read the addresses of
395 * blocks from disc), and may wait for it. The caller may be trying to
396 * access a different page, and so sleeping excessively should be avoided.
397 * It may allocate memory, but should avoid costly allocations. This
398 * function is called with memalloc_nofs set, so allocations will not cause
399 * the filesystem to be reentered.
401 void iomap_readahead(struct readahead_control *rac, const struct iomap_ops *ops)
403 struct iomap_iter iter = {
404 .inode = rac->mapping->host,
405 .pos = readahead_pos(rac),
406 .len = readahead_length(rac),
408 struct iomap_readpage_ctx ctx = {
412 trace_iomap_readahead(rac->mapping->host, readahead_count(rac));
414 while (iomap_iter(&iter, ops) > 0)
415 iter.processed = iomap_readahead_iter(&iter, &ctx);
420 if (!ctx.cur_folio_in_bio)
421 folio_unlock(ctx.cur_folio);
424 EXPORT_SYMBOL_GPL(iomap_readahead);
427 * iomap_is_partially_uptodate checks whether blocks within a page are
430 * Returns true if all blocks which correspond to a file portion
431 * we want to read within the page are uptodate.
434 iomap_is_partially_uptodate(struct page *page, unsigned long from,
437 struct folio *folio = page_folio(page);
438 struct iomap_page *iop = to_iomap_page(folio);
439 struct inode *inode = page->mapping->host;
440 unsigned len, first, last;
443 /* Limit range to one page */
444 len = min_t(unsigned, PAGE_SIZE - from, count);
446 /* First and last blocks in range within page */
447 first = from >> inode->i_blkbits;
448 last = (from + len - 1) >> inode->i_blkbits;
451 for (i = first; i <= last; i++)
452 if (!test_bit(i, iop->uptodate))
459 EXPORT_SYMBOL_GPL(iomap_is_partially_uptodate);
462 iomap_releasepage(struct page *page, gfp_t gfp_mask)
464 struct folio *folio = page_folio(page);
466 trace_iomap_releasepage(folio->mapping->host, folio_pos(folio),
470 * mm accommodates an old ext3 case where clean pages might not have had
471 * the dirty bit cleared. Thus, it can send actual dirty pages to
472 * ->releasepage() via shrink_active_list(); skip those here.
474 if (folio_test_dirty(folio) || folio_test_writeback(folio))
476 iomap_page_release(folio);
479 EXPORT_SYMBOL_GPL(iomap_releasepage);
481 void iomap_invalidate_folio(struct folio *folio, size_t offset, size_t len)
483 trace_iomap_invalidatepage(folio->mapping->host, offset, len);
486 * If we're invalidating the entire folio, clear the dirty state
487 * from it and release it to avoid unnecessary buildup of the LRU.
489 if (offset == 0 && len == folio_size(folio)) {
490 WARN_ON_ONCE(folio_test_writeback(folio));
491 folio_cancel_dirty(folio);
492 iomap_page_release(folio);
493 } else if (folio_test_large(folio)) {
494 /* Must release the iop so the page can be split */
495 WARN_ON_ONCE(!folio_test_uptodate(folio) &&
496 folio_test_dirty(folio));
497 iomap_page_release(folio);
500 EXPORT_SYMBOL_GPL(iomap_invalidate_folio);
502 void iomap_invalidatepage(struct page *page, unsigned int offset,
505 iomap_invalidate_folio(page_folio(page), offset, len);
507 EXPORT_SYMBOL_GPL(iomap_invalidatepage);
509 #ifdef CONFIG_MIGRATION
511 iomap_migrate_page(struct address_space *mapping, struct page *newpage,
512 struct page *page, enum migrate_mode mode)
514 struct folio *folio = page_folio(page);
515 struct folio *newfolio = page_folio(newpage);
518 ret = folio_migrate_mapping(mapping, newfolio, folio, 0);
519 if (ret != MIGRATEPAGE_SUCCESS)
522 if (folio_test_private(folio))
523 folio_attach_private(newfolio, folio_detach_private(folio));
525 if (mode != MIGRATE_SYNC_NO_COPY)
526 folio_migrate_copy(newfolio, folio);
528 folio_migrate_flags(newfolio, folio);
529 return MIGRATEPAGE_SUCCESS;
531 EXPORT_SYMBOL_GPL(iomap_migrate_page);
532 #endif /* CONFIG_MIGRATION */
535 iomap_write_failed(struct inode *inode, loff_t pos, unsigned len)
537 loff_t i_size = i_size_read(inode);
540 * Only truncate newly allocated pages beyoned EOF, even if the
541 * write started inside the existing inode size.
543 if (pos + len > i_size)
544 truncate_pagecache_range(inode, max(pos, i_size), pos + len);
547 static int iomap_read_folio_sync(loff_t block_start, struct folio *folio,
548 size_t poff, size_t plen, const struct iomap *iomap)
553 bio_init(&bio, &bvec, 1);
554 bio.bi_opf = REQ_OP_READ;
555 bio.bi_iter.bi_sector = iomap_sector(iomap, block_start);
556 bio_set_dev(&bio, iomap->bdev);
557 bio_add_folio(&bio, folio, plen, poff);
558 return submit_bio_wait(&bio);
561 static int __iomap_write_begin(const struct iomap_iter *iter, loff_t pos,
562 size_t len, struct folio *folio)
564 const struct iomap *srcmap = iomap_iter_srcmap(iter);
565 struct iomap_page *iop = iomap_page_create(iter->inode, folio);
566 loff_t block_size = i_blocksize(iter->inode);
567 loff_t block_start = round_down(pos, block_size);
568 loff_t block_end = round_up(pos + len, block_size);
569 size_t from = offset_in_folio(folio, pos), to = from + len;
572 if (folio_test_uptodate(folio))
574 folio_clear_error(folio);
577 iomap_adjust_read_range(iter->inode, folio, &block_start,
578 block_end - block_start, &poff, &plen);
582 if (!(iter->flags & IOMAP_UNSHARE) &&
583 (from <= poff || from >= poff + plen) &&
584 (to <= poff || to >= poff + plen))
587 if (iomap_block_needs_zeroing(iter, block_start)) {
588 if (WARN_ON_ONCE(iter->flags & IOMAP_UNSHARE))
590 folio_zero_segments(folio, poff, from, to, poff + plen);
592 int status = iomap_read_folio_sync(block_start, folio,
597 iomap_set_range_uptodate(folio, iop, poff, plen);
598 } while ((block_start += plen) < block_end);
603 static int iomap_write_begin_inline(const struct iomap_iter *iter,
606 /* needs more work for the tailpacking case; disable for now */
607 if (WARN_ON_ONCE(iomap_iter_srcmap(iter)->offset != 0))
609 return iomap_read_inline_data(iter, folio);
612 static int iomap_write_begin(const struct iomap_iter *iter, loff_t pos,
613 size_t len, struct folio **foliop)
615 const struct iomap_page_ops *page_ops = iter->iomap.page_ops;
616 const struct iomap *srcmap = iomap_iter_srcmap(iter);
618 unsigned fgp = FGP_LOCK | FGP_WRITE | FGP_CREAT | FGP_STABLE | FGP_NOFS;
621 BUG_ON(pos + len > iter->iomap.offset + iter->iomap.length);
622 if (srcmap != &iter->iomap)
623 BUG_ON(pos + len > srcmap->offset + srcmap->length);
625 if (fatal_signal_pending(current))
628 if (!mapping_large_folio_support(iter->inode->i_mapping))
629 len = min_t(size_t, len, PAGE_SIZE - offset_in_page(pos));
631 if (page_ops && page_ops->page_prepare) {
632 status = page_ops->page_prepare(iter->inode, pos, len);
637 folio = __filemap_get_folio(iter->inode->i_mapping, pos >> PAGE_SHIFT,
638 fgp, mapping_gfp_mask(iter->inode->i_mapping));
643 if (pos + len > folio_pos(folio) + folio_size(folio))
644 len = folio_pos(folio) + folio_size(folio) - pos;
646 if (srcmap->type == IOMAP_INLINE)
647 status = iomap_write_begin_inline(iter, folio);
648 else if (srcmap->flags & IOMAP_F_BUFFER_HEAD)
649 status = __block_write_begin_int(folio, pos, len, NULL, srcmap);
651 status = __iomap_write_begin(iter, pos, len, folio);
653 if (unlikely(status))
662 iomap_write_failed(iter->inode, pos, len);
665 if (page_ops && page_ops->page_done)
666 page_ops->page_done(iter->inode, pos, 0, NULL);
670 static size_t __iomap_write_end(struct inode *inode, loff_t pos, size_t len,
671 size_t copied, struct folio *folio)
673 struct iomap_page *iop = to_iomap_page(folio);
674 flush_dcache_folio(folio);
677 * The blocks that were entirely written will now be uptodate, so we
678 * don't have to worry about a readpage reading them and overwriting a
679 * partial write. However, if we've encountered a short write and only
680 * partially written into a block, it will not be marked uptodate, so a
681 * readpage might come in and destroy our partial write.
683 * Do the simplest thing and just treat any short write to a
684 * non-uptodate page as a zero-length write, and force the caller to
685 * redo the whole thing.
687 if (unlikely(copied < len && !folio_test_uptodate(folio)))
689 iomap_set_range_uptodate(folio, iop, offset_in_folio(folio, pos), len);
690 filemap_dirty_folio(inode->i_mapping, folio);
694 static size_t iomap_write_end_inline(const struct iomap_iter *iter,
695 struct folio *folio, loff_t pos, size_t copied)
697 const struct iomap *iomap = &iter->iomap;
700 WARN_ON_ONCE(!folio_test_uptodate(folio));
701 BUG_ON(!iomap_inline_data_valid(iomap));
703 flush_dcache_folio(folio);
704 addr = kmap_local_folio(folio, pos);
705 memcpy(iomap_inline_data(iomap, pos), addr, copied);
708 mark_inode_dirty(iter->inode);
712 /* Returns the number of bytes copied. May be 0. Cannot be an errno. */
713 static size_t iomap_write_end(struct iomap_iter *iter, loff_t pos, size_t len,
714 size_t copied, struct folio *folio)
716 const struct iomap_page_ops *page_ops = iter->iomap.page_ops;
717 const struct iomap *srcmap = iomap_iter_srcmap(iter);
718 loff_t old_size = iter->inode->i_size;
721 if (srcmap->type == IOMAP_INLINE) {
722 ret = iomap_write_end_inline(iter, folio, pos, copied);
723 } else if (srcmap->flags & IOMAP_F_BUFFER_HEAD) {
724 ret = block_write_end(NULL, iter->inode->i_mapping, pos, len,
725 copied, &folio->page, NULL);
727 ret = __iomap_write_end(iter->inode, pos, len, copied, folio);
731 * Update the in-memory inode size after copying the data into the page
732 * cache. It's up to the file system to write the updated size to disk,
733 * preferably after I/O completion so that no stale data is exposed.
735 if (pos + ret > old_size) {
736 i_size_write(iter->inode, pos + ret);
737 iter->iomap.flags |= IOMAP_F_SIZE_CHANGED;
742 pagecache_isize_extended(iter->inode, old_size, pos);
743 if (page_ops && page_ops->page_done)
744 page_ops->page_done(iter->inode, pos, ret, &folio->page);
748 iomap_write_failed(iter->inode, pos, len);
752 static loff_t iomap_write_iter(struct iomap_iter *iter, struct iov_iter *i)
754 loff_t length = iomap_length(iter);
755 loff_t pos = iter->pos;
762 unsigned long offset; /* Offset into pagecache page */
763 unsigned long bytes; /* Bytes to write to page */
764 size_t copied; /* Bytes copied from user */
766 offset = offset_in_page(pos);
767 bytes = min_t(unsigned long, PAGE_SIZE - offset,
774 * Bring in the user page that we'll copy from _first_.
775 * Otherwise there's a nasty deadlock on copying from the
776 * same page as we're writing to, without it being marked
779 if (unlikely(fault_in_iov_iter_readable(i, bytes))) {
784 status = iomap_write_begin(iter, pos, bytes, &folio);
785 if (unlikely(status))
788 page = folio_file_page(folio, pos >> PAGE_SHIFT);
789 if (mapping_writably_mapped(iter->inode->i_mapping))
790 flush_dcache_page(page);
792 copied = copy_page_from_iter_atomic(page, offset, bytes, i);
794 status = iomap_write_end(iter, pos, bytes, copied, folio);
796 if (unlikely(copied != status))
797 iov_iter_revert(i, copied - status);
800 if (unlikely(status == 0)) {
802 * A short copy made iomap_write_end() reject the
803 * thing entirely. Might be memory poisoning
804 * halfway through, might be a race with munmap,
805 * might be severe memory pressure.
815 balance_dirty_pages_ratelimited(iter->inode->i_mapping);
816 } while (iov_iter_count(i) && length);
818 return written ? written : status;
822 iomap_file_buffered_write(struct kiocb *iocb, struct iov_iter *i,
823 const struct iomap_ops *ops)
825 struct iomap_iter iter = {
826 .inode = iocb->ki_filp->f_mapping->host,
828 .len = iov_iter_count(i),
829 .flags = IOMAP_WRITE,
833 while ((ret = iomap_iter(&iter, ops)) > 0)
834 iter.processed = iomap_write_iter(&iter, i);
835 if (iter.pos == iocb->ki_pos)
837 return iter.pos - iocb->ki_pos;
839 EXPORT_SYMBOL_GPL(iomap_file_buffered_write);
841 static loff_t iomap_unshare_iter(struct iomap_iter *iter)
843 struct iomap *iomap = &iter->iomap;
844 const struct iomap *srcmap = iomap_iter_srcmap(iter);
845 loff_t pos = iter->pos;
846 loff_t length = iomap_length(iter);
850 /* don't bother with blocks that are not shared to start with */
851 if (!(iomap->flags & IOMAP_F_SHARED))
853 /* don't bother with holes or unwritten extents */
854 if (srcmap->type == IOMAP_HOLE || srcmap->type == IOMAP_UNWRITTEN)
858 unsigned long offset = offset_in_page(pos);
859 unsigned long bytes = min_t(loff_t, PAGE_SIZE - offset, length);
862 status = iomap_write_begin(iter, pos, bytes, &folio);
863 if (unlikely(status))
866 status = iomap_write_end(iter, pos, bytes, bytes, folio);
867 if (WARN_ON_ONCE(status == 0))
876 balance_dirty_pages_ratelimited(iter->inode->i_mapping);
883 iomap_file_unshare(struct inode *inode, loff_t pos, loff_t len,
884 const struct iomap_ops *ops)
886 struct iomap_iter iter = {
890 .flags = IOMAP_WRITE | IOMAP_UNSHARE,
894 while ((ret = iomap_iter(&iter, ops)) > 0)
895 iter.processed = iomap_unshare_iter(&iter);
898 EXPORT_SYMBOL_GPL(iomap_file_unshare);
900 static loff_t iomap_zero_iter(struct iomap_iter *iter, bool *did_zero)
902 const struct iomap *srcmap = iomap_iter_srcmap(iter);
903 loff_t pos = iter->pos;
904 loff_t length = iomap_length(iter);
907 /* already zeroed? we're done. */
908 if (srcmap->type == IOMAP_HOLE || srcmap->type == IOMAP_UNWRITTEN)
915 size_t bytes = min_t(u64, SIZE_MAX, length);
917 status = iomap_write_begin(iter, pos, bytes, &folio);
921 offset = offset_in_folio(folio, pos);
922 if (bytes > folio_size(folio) - offset)
923 bytes = folio_size(folio) - offset;
925 folio_zero_range(folio, offset, bytes);
926 folio_mark_accessed(folio);
928 bytes = iomap_write_end(iter, pos, bytes, bytes, folio);
929 if (WARN_ON_ONCE(bytes == 0))
937 } while (length > 0);
943 iomap_zero_range(struct inode *inode, loff_t pos, loff_t len, bool *did_zero,
944 const struct iomap_ops *ops)
946 struct iomap_iter iter = {
954 while ((ret = iomap_iter(&iter, ops)) > 0)
955 iter.processed = iomap_zero_iter(&iter, did_zero);
958 EXPORT_SYMBOL_GPL(iomap_zero_range);
961 iomap_truncate_page(struct inode *inode, loff_t pos, bool *did_zero,
962 const struct iomap_ops *ops)
964 unsigned int blocksize = i_blocksize(inode);
965 unsigned int off = pos & (blocksize - 1);
967 /* Block boundary? Nothing to do */
970 return iomap_zero_range(inode, pos, blocksize - off, did_zero, ops);
972 EXPORT_SYMBOL_GPL(iomap_truncate_page);
974 static loff_t iomap_folio_mkwrite_iter(struct iomap_iter *iter,
977 loff_t length = iomap_length(iter);
980 if (iter->iomap.flags & IOMAP_F_BUFFER_HEAD) {
981 ret = __block_write_begin_int(folio, iter->pos, length, NULL,
985 block_commit_write(&folio->page, 0, length);
987 WARN_ON_ONCE(!folio_test_uptodate(folio));
988 folio_mark_dirty(folio);
994 vm_fault_t iomap_page_mkwrite(struct vm_fault *vmf, const struct iomap_ops *ops)
996 struct iomap_iter iter = {
997 .inode = file_inode(vmf->vma->vm_file),
998 .flags = IOMAP_WRITE | IOMAP_FAULT,
1000 struct folio *folio = page_folio(vmf->page);
1004 ret = folio_mkwrite_check_truncate(folio, iter.inode);
1007 iter.pos = folio_pos(folio);
1009 while ((ret = iomap_iter(&iter, ops)) > 0)
1010 iter.processed = iomap_folio_mkwrite_iter(&iter, folio);
1014 folio_wait_stable(folio);
1015 return VM_FAULT_LOCKED;
1017 folio_unlock(folio);
1018 return block_page_mkwrite_return(ret);
1020 EXPORT_SYMBOL_GPL(iomap_page_mkwrite);
1022 static void iomap_finish_folio_write(struct inode *inode, struct folio *folio,
1023 size_t len, int error)
1025 struct iomap_page *iop = to_iomap_page(folio);
1028 folio_set_error(folio);
1029 mapping_set_error(inode->i_mapping, error);
1032 WARN_ON_ONCE(i_blocks_per_folio(inode, folio) > 1 && !iop);
1033 WARN_ON_ONCE(iop && atomic_read(&iop->write_bytes_pending) <= 0);
1035 if (!iop || atomic_sub_and_test(len, &iop->write_bytes_pending))
1036 folio_end_writeback(folio);
1040 * We're now finished for good with this ioend structure. Update the page
1041 * state, release holds on bios, and finally free up memory. Do not use the
1045 iomap_finish_ioend(struct iomap_ioend *ioend, int error)
1047 struct inode *inode = ioend->io_inode;
1048 struct bio *bio = &ioend->io_inline_bio;
1049 struct bio *last = ioend->io_bio, *next;
1050 u64 start = bio->bi_iter.bi_sector;
1051 loff_t offset = ioend->io_offset;
1052 bool quiet = bio_flagged(bio, BIO_QUIET);
1053 u32 folio_count = 0;
1055 for (bio = &ioend->io_inline_bio; bio; bio = next) {
1056 struct folio_iter fi;
1059 * For the last bio, bi_private points to the ioend, so we
1060 * need to explicitly end the iteration here.
1065 next = bio->bi_private;
1067 /* walk all folios in bio, ending page IO on them */
1068 bio_for_each_folio_all(fi, bio) {
1069 iomap_finish_folio_write(inode, fi.folio, fi.length,
1075 /* The ioend has been freed by bio_put() */
1077 if (unlikely(error && !quiet)) {
1078 printk_ratelimited(KERN_ERR
1079 "%s: writeback error on inode %lu, offset %lld, sector %llu",
1080 inode->i_sb->s_id, inode->i_ino, offset, start);
1086 * Ioend completion routine for merged bios. This can only be called from task
1087 * contexts as merged ioends can be of unbound length. Hence we have to break up
1088 * the writeback completions into manageable chunks to avoid long scheduler
1089 * holdoffs. We aim to keep scheduler holdoffs down below 10ms so that we get
1090 * good batch processing throughput without creating adverse scheduler latency
1094 iomap_finish_ioends(struct iomap_ioend *ioend, int error)
1096 struct list_head tmp;
1101 list_replace_init(&ioend->io_list, &tmp);
1102 completions = iomap_finish_ioend(ioend, error);
1104 while (!list_empty(&tmp)) {
1105 if (completions > IOEND_BATCH_SIZE * 8) {
1109 ioend = list_first_entry(&tmp, struct iomap_ioend, io_list);
1110 list_del_init(&ioend->io_list);
1111 completions += iomap_finish_ioend(ioend, error);
1114 EXPORT_SYMBOL_GPL(iomap_finish_ioends);
1117 * We can merge two adjacent ioends if they have the same set of work to do.
1120 iomap_ioend_can_merge(struct iomap_ioend *ioend, struct iomap_ioend *next)
1122 if (ioend->io_bio->bi_status != next->io_bio->bi_status)
1124 if ((ioend->io_flags & IOMAP_F_SHARED) ^
1125 (next->io_flags & IOMAP_F_SHARED))
1127 if ((ioend->io_type == IOMAP_UNWRITTEN) ^
1128 (next->io_type == IOMAP_UNWRITTEN))
1130 if (ioend->io_offset + ioend->io_size != next->io_offset)
1133 * Do not merge physically discontiguous ioends. The filesystem
1134 * completion functions will have to iterate the physical
1135 * discontiguities even if we merge the ioends at a logical level, so
1136 * we don't gain anything by merging physical discontiguities here.
1138 * We cannot use bio->bi_iter.bi_sector here as it is modified during
1139 * submission so does not point to the start sector of the bio at
1142 if (ioend->io_sector + (ioend->io_size >> 9) != next->io_sector)
1148 iomap_ioend_try_merge(struct iomap_ioend *ioend, struct list_head *more_ioends)
1150 struct iomap_ioend *next;
1152 INIT_LIST_HEAD(&ioend->io_list);
1154 while ((next = list_first_entry_or_null(more_ioends, struct iomap_ioend,
1156 if (!iomap_ioend_can_merge(ioend, next))
1158 list_move_tail(&next->io_list, &ioend->io_list);
1159 ioend->io_size += next->io_size;
1162 EXPORT_SYMBOL_GPL(iomap_ioend_try_merge);
1165 iomap_ioend_compare(void *priv, const struct list_head *a,
1166 const struct list_head *b)
1168 struct iomap_ioend *ia = container_of(a, struct iomap_ioend, io_list);
1169 struct iomap_ioend *ib = container_of(b, struct iomap_ioend, io_list);
1171 if (ia->io_offset < ib->io_offset)
1173 if (ia->io_offset > ib->io_offset)
1179 iomap_sort_ioends(struct list_head *ioend_list)
1181 list_sort(NULL, ioend_list, iomap_ioend_compare);
1183 EXPORT_SYMBOL_GPL(iomap_sort_ioends);
1185 static void iomap_writepage_end_bio(struct bio *bio)
1187 struct iomap_ioend *ioend = bio->bi_private;
1189 iomap_finish_ioend(ioend, blk_status_to_errno(bio->bi_status));
1193 * Submit the final bio for an ioend.
1195 * If @error is non-zero, it means that we have a situation where some part of
1196 * the submission process has failed after we've marked pages for writeback
1197 * and unlocked them. In this situation, we need to fail the bio instead of
1198 * submitting it. This typically only happens on a filesystem shutdown.
1201 iomap_submit_ioend(struct iomap_writepage_ctx *wpc, struct iomap_ioend *ioend,
1204 ioend->io_bio->bi_private = ioend;
1205 ioend->io_bio->bi_end_io = iomap_writepage_end_bio;
1207 if (wpc->ops->prepare_ioend)
1208 error = wpc->ops->prepare_ioend(ioend, error);
1211 * If we're failing the IO now, just mark the ioend with an
1212 * error and finish it. This will run IO completion immediately
1213 * as there is only one reference to the ioend at this point in
1216 ioend->io_bio->bi_status = errno_to_blk_status(error);
1217 bio_endio(ioend->io_bio);
1221 submit_bio(ioend->io_bio);
1225 static struct iomap_ioend *
1226 iomap_alloc_ioend(struct inode *inode, struct iomap_writepage_ctx *wpc,
1227 loff_t offset, sector_t sector, struct writeback_control *wbc)
1229 struct iomap_ioend *ioend;
1232 bio = bio_alloc_bioset(GFP_NOFS, BIO_MAX_VECS, &iomap_ioend_bioset);
1233 bio_set_dev(bio, wpc->iomap.bdev);
1234 bio->bi_iter.bi_sector = sector;
1235 bio->bi_opf = REQ_OP_WRITE | wbc_to_write_flags(wbc);
1236 bio->bi_write_hint = inode->i_write_hint;
1237 wbc_init_bio(wbc, bio);
1239 ioend = container_of(bio, struct iomap_ioend, io_inline_bio);
1240 INIT_LIST_HEAD(&ioend->io_list);
1241 ioend->io_type = wpc->iomap.type;
1242 ioend->io_flags = wpc->iomap.flags;
1243 ioend->io_inode = inode;
1245 ioend->io_folios = 0;
1246 ioend->io_offset = offset;
1247 ioend->io_bio = bio;
1248 ioend->io_sector = sector;
1253 * Allocate a new bio, and chain the old bio to the new one.
1255 * Note that we have to perform the chaining in this unintuitive order
1256 * so that the bi_private linkage is set up in the right direction for the
1257 * traversal in iomap_finish_ioend().
1260 iomap_chain_bio(struct bio *prev)
1264 new = bio_alloc(GFP_NOFS, BIO_MAX_VECS);
1265 bio_copy_dev(new, prev);/* also copies over blkcg information */
1266 new->bi_iter.bi_sector = bio_end_sector(prev);
1267 new->bi_opf = prev->bi_opf;
1268 new->bi_write_hint = prev->bi_write_hint;
1270 bio_chain(prev, new);
1271 bio_get(prev); /* for iomap_finish_ioend */
1277 iomap_can_add_to_ioend(struct iomap_writepage_ctx *wpc, loff_t offset,
1280 if ((wpc->iomap.flags & IOMAP_F_SHARED) !=
1281 (wpc->ioend->io_flags & IOMAP_F_SHARED))
1283 if (wpc->iomap.type != wpc->ioend->io_type)
1285 if (offset != wpc->ioend->io_offset + wpc->ioend->io_size)
1287 if (sector != bio_end_sector(wpc->ioend->io_bio))
1290 * Limit ioend bio chain lengths to minimise IO completion latency. This
1291 * also prevents long tight loops ending page writeback on all the
1292 * folios in the ioend.
1294 if (wpc->ioend->io_folios >= IOEND_BATCH_SIZE)
1300 * Test to see if we have an existing ioend structure that we could append to
1301 * first; otherwise finish off the current ioend and start another.
1304 iomap_add_to_ioend(struct inode *inode, loff_t pos, struct folio *folio,
1305 struct iomap_page *iop, struct iomap_writepage_ctx *wpc,
1306 struct writeback_control *wbc, struct list_head *iolist)
1308 sector_t sector = iomap_sector(&wpc->iomap, pos);
1309 unsigned len = i_blocksize(inode);
1310 size_t poff = offset_in_folio(folio, pos);
1312 if (!wpc->ioend || !iomap_can_add_to_ioend(wpc, pos, sector)) {
1314 list_add(&wpc->ioend->io_list, iolist);
1315 wpc->ioend = iomap_alloc_ioend(inode, wpc, pos, sector, wbc);
1318 if (!bio_add_folio(wpc->ioend->io_bio, folio, len, poff)) {
1319 wpc->ioend->io_bio = iomap_chain_bio(wpc->ioend->io_bio);
1320 bio_add_folio(wpc->ioend->io_bio, folio, len, poff);
1324 atomic_add(len, &iop->write_bytes_pending);
1325 wpc->ioend->io_size += len;
1326 wbc_account_cgroup_owner(wbc, &folio->page, len);
1330 * We implement an immediate ioend submission policy here to avoid needing to
1331 * chain multiple ioends and hence nest mempool allocations which can violate
1332 * the forward progress guarantees we need to provide. The current ioend we're
1333 * adding blocks to is cached in the writepage context, and if the new block
1334 * doesn't append to the cached ioend, it will create a new ioend and cache that
1337 * If a new ioend is created and cached, the old ioend is returned and queued
1338 * locally for submission once the entire page is processed or an error has been
1339 * detected. While ioends are submitted immediately after they are completed,
1340 * batching optimisations are provided by higher level block plugging.
1342 * At the end of a writeback pass, there will be a cached ioend remaining on the
1343 * writepage context that the caller will need to submit.
1346 iomap_writepage_map(struct iomap_writepage_ctx *wpc,
1347 struct writeback_control *wbc, struct inode *inode,
1348 struct folio *folio, u64 end_pos)
1350 struct iomap_page *iop = iomap_page_create(inode, folio);
1351 struct iomap_ioend *ioend, *next;
1352 unsigned len = i_blocksize(inode);
1353 unsigned nblocks = i_blocks_per_folio(inode, folio);
1354 u64 pos = folio_pos(folio);
1355 int error = 0, count = 0, i;
1356 LIST_HEAD(submit_list);
1358 WARN_ON_ONCE(iop && atomic_read(&iop->write_bytes_pending) != 0);
1361 * Walk through the folio to find areas to write back. If we
1362 * run off the end of the current map or find the current map
1363 * invalid, grab a new one.
1365 for (i = 0; i < nblocks && pos < end_pos; i++, pos += len) {
1366 if (iop && !test_bit(i, iop->uptodate))
1369 error = wpc->ops->map_blocks(wpc, inode, pos);
1372 if (WARN_ON_ONCE(wpc->iomap.type == IOMAP_INLINE))
1374 if (wpc->iomap.type == IOMAP_HOLE)
1376 iomap_add_to_ioend(inode, pos, folio, iop, wpc, wbc,
1381 wpc->ioend->io_folios++;
1383 WARN_ON_ONCE(!wpc->ioend && !list_empty(&submit_list));
1384 WARN_ON_ONCE(!folio_test_locked(folio));
1385 WARN_ON_ONCE(folio_test_writeback(folio));
1386 WARN_ON_ONCE(folio_test_dirty(folio));
1389 * We cannot cancel the ioend directly here on error. We may have
1390 * already set other pages under writeback and hence we have to run I/O
1391 * completion to mark the error state of the pages under writeback
1394 if (unlikely(error)) {
1396 * Let the filesystem know what portion of the current page
1397 * failed to map. If the page hasn't been added to ioend, it
1398 * won't be affected by I/O completion and we must unlock it
1401 if (wpc->ops->discard_folio)
1402 wpc->ops->discard_folio(folio, pos);
1404 folio_clear_uptodate(folio);
1405 folio_unlock(folio);
1410 folio_start_writeback(folio);
1411 folio_unlock(folio);
1414 * Preserve the original error if there was one; catch
1415 * submission errors here and propagate into subsequent ioend
1418 list_for_each_entry_safe(ioend, next, &submit_list, io_list) {
1421 list_del_init(&ioend->io_list);
1422 error2 = iomap_submit_ioend(wpc, ioend, error);
1423 if (error2 && !error)
1428 * We can end up here with no error and nothing to write only if we race
1429 * with a partial page truncate on a sub-page block sized filesystem.
1432 folio_end_writeback(folio);
1434 mapping_set_error(folio->mapping, error);
1439 * Write out a dirty page.
1441 * For delalloc space on the page, we need to allocate space and flush it.
1442 * For unwritten space on the page, we need to start the conversion to
1443 * regular allocated space.
1446 iomap_do_writepage(struct page *page, struct writeback_control *wbc, void *data)
1448 struct folio *folio = page_folio(page);
1449 struct iomap_writepage_ctx *wpc = data;
1450 struct inode *inode = folio->mapping->host;
1453 trace_iomap_writepage(inode, folio_pos(folio), folio_size(folio));
1456 * Refuse to write the folio out if we're called from reclaim context.
1458 * This avoids stack overflows when called from deeply used stacks in
1459 * random callers for direct reclaim or memcg reclaim. We explicitly
1460 * allow reclaim from kswapd as the stack usage there is relatively low.
1462 * This should never happen except in the case of a VM regression so
1465 if (WARN_ON_ONCE((current->flags & (PF_MEMALLOC|PF_KSWAPD)) ==
1470 * Is this folio beyond the end of the file?
1472 * The folio index is less than the end_index, adjust the end_pos
1473 * to the highest offset that this folio should represent.
1474 * -----------------------------------------------------
1475 * | file mapping | <EOF> |
1476 * -----------------------------------------------------
1477 * | Page ... | Page N-2 | Page N-1 | Page N | |
1478 * ^--------------------------------^----------|--------
1479 * | desired writeback range | see else |
1480 * ---------------------------------^------------------|
1482 isize = i_size_read(inode);
1483 end_pos = folio_pos(folio) + folio_size(folio);
1484 if (end_pos > isize) {
1486 * Check whether the page to write out is beyond or straddles
1488 * -------------------------------------------------------
1489 * | file mapping | <EOF> |
1490 * -------------------------------------------------------
1491 * | Page ... | Page N-2 | Page N-1 | Page N | Beyond |
1492 * ^--------------------------------^-----------|---------
1494 * ---------------------------------^-----------|--------|
1496 size_t poff = offset_in_folio(folio, isize);
1497 pgoff_t end_index = isize >> PAGE_SHIFT;
1500 * Skip the page if it's fully outside i_size, e.g. due to a
1501 * truncate operation that's in progress. We must redirty the
1502 * page so that reclaim stops reclaiming it. Otherwise
1503 * iomap_vm_releasepage() is called on it and gets confused.
1505 * Note that the end_index is unsigned long. If the given
1506 * offset is greater than 16TB on a 32-bit system then if we
1507 * checked if the page is fully outside i_size with
1508 * "if (page->index >= end_index + 1)", "end_index + 1" would
1509 * overflow and evaluate to 0. Hence this page would be
1510 * redirtied and written out repeatedly, which would result in
1511 * an infinite loop; the user program performing this operation
1512 * would hang. Instead, we can detect this situation by
1513 * checking if the page is totally beyond i_size or if its
1514 * offset is just equal to the EOF.
1516 if (folio->index > end_index ||
1517 (folio->index == end_index && poff == 0))
1521 * The page straddles i_size. It must be zeroed out on each
1522 * and every writepage invocation because it may be mmapped.
1523 * "A file is mapped in multiples of the page size. For a file
1524 * that is not a multiple of the page size, the remaining
1525 * memory is zeroed when mapped, and writes to that region are
1526 * not written out to the file."
1528 folio_zero_segment(folio, poff, folio_size(folio));
1532 return iomap_writepage_map(wpc, wbc, inode, folio, end_pos);
1535 folio_redirty_for_writepage(wbc, folio);
1536 folio_unlock(folio);
1541 iomap_writepage(struct page *page, struct writeback_control *wbc,
1542 struct iomap_writepage_ctx *wpc,
1543 const struct iomap_writeback_ops *ops)
1548 ret = iomap_do_writepage(page, wbc, wpc);
1551 return iomap_submit_ioend(wpc, wpc->ioend, ret);
1553 EXPORT_SYMBOL_GPL(iomap_writepage);
1556 iomap_writepages(struct address_space *mapping, struct writeback_control *wbc,
1557 struct iomap_writepage_ctx *wpc,
1558 const struct iomap_writeback_ops *ops)
1563 ret = write_cache_pages(mapping, wbc, iomap_do_writepage, wpc);
1566 return iomap_submit_ioend(wpc, wpc->ioend, ret);
1568 EXPORT_SYMBOL_GPL(iomap_writepages);
1570 static int __init iomap_init(void)
1572 return bioset_init(&iomap_ioend_bioset, 4 * (PAGE_SIZE / SECTOR_SIZE),
1573 offsetof(struct iomap_ioend, io_inline_bio),
1576 fs_initcall(iomap_init);