2 * Copyright (C) 2010 Red Hat, Inc.
3 * Copyright (c) 2016 Christoph Hellwig.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 #include <linux/module.h>
15 #include <linux/compiler.h>
17 #include <linux/iomap.h>
18 #include <linux/uaccess.h>
19 #include <linux/gfp.h>
21 #include <linux/swap.h>
22 #include <linux/pagemap.h>
23 #include <linux/file.h>
24 #include <linux/uio.h>
25 #include <linux/backing-dev.h>
26 #include <linux/buffer_head.h>
27 #include <linux/dax.h>
31 * Execute a iomap write on a segment of the mapping that spans a
32 * contiguous range of pages that have identical block mapping state.
34 * This avoids the need to map pages individually, do individual allocations
35 * for each page and most importantly avoid the need for filesystem specific
36 * locking per page. Instead, all the operations are amortised over the entire
37 * range of pages. It is assumed that the filesystems will lock whatever
38 * resources they require in the iomap_begin call, and release them in the
42 iomap_apply(struct inode
*inode
, loff_t pos
, loff_t length
, unsigned flags
,
43 struct iomap_ops
*ops
, void *data
, iomap_actor_t actor
)
45 struct iomap iomap
= { 0 };
46 loff_t written
= 0, ret
;
49 * Need to map a range from start position for length bytes. This can
50 * span multiple pages - it is only guaranteed to return a range of a
51 * single type of pages (e.g. all into a hole, all mapped or all
52 * unwritten). Failure at this point has nothing to undo.
54 * If allocation is required for this range, reserve the space now so
55 * that the allocation is guaranteed to succeed later on. Once we copy
56 * the data into the page cache pages, then we cannot fail otherwise we
57 * expose transient stale data. If the reserve fails, we can safely
58 * back out at this point as there is nothing to undo.
60 ret
= ops
->iomap_begin(inode
, pos
, length
, flags
, &iomap
);
63 if (WARN_ON(iomap
.offset
> pos
))
67 * Cut down the length to the one actually provided by the filesystem,
68 * as it might not be able to give us the whole size that we requested.
70 if (iomap
.offset
+ iomap
.length
< pos
+ length
)
71 length
= iomap
.offset
+ iomap
.length
- pos
;
74 * Now that we have guaranteed that the space allocation will succeed.
75 * we can do the copy-in page by page without having to worry about
76 * failures exposing transient data.
78 written
= actor(inode
, pos
, length
, data
, &iomap
);
81 * Now the data has been copied, commit the range we've copied. This
82 * should not fail unless the filesystem has had a fatal error.
85 ret
= ops
->iomap_end(inode
, pos
, length
,
86 written
> 0 ? written
: 0,
90 return written
? written
: ret
;
94 iomap_write_failed(struct inode
*inode
, loff_t pos
, unsigned len
)
96 loff_t i_size
= i_size_read(inode
);
99 * Only truncate newly allocated pages beyoned EOF, even if the
100 * write started inside the existing inode size.
102 if (pos
+ len
> i_size
)
103 truncate_pagecache_range(inode
, max(pos
, i_size
), pos
+ len
);
107 iomap_write_begin(struct inode
*inode
, loff_t pos
, unsigned len
, unsigned flags
,
108 struct page
**pagep
, struct iomap
*iomap
)
110 pgoff_t index
= pos
>> PAGE_SHIFT
;
114 BUG_ON(pos
+ len
> iomap
->offset
+ iomap
->length
);
116 page
= grab_cache_page_write_begin(inode
->i_mapping
, index
, flags
);
120 status
= __block_write_begin_int(page
, pos
, len
, NULL
, iomap
);
121 if (unlikely(status
)) {
126 iomap_write_failed(inode
, pos
, len
);
134 iomap_write_end(struct inode
*inode
, loff_t pos
, unsigned len
,
135 unsigned copied
, struct page
*page
)
139 ret
= generic_write_end(NULL
, inode
->i_mapping
, pos
, len
,
142 iomap_write_failed(inode
, pos
, len
);
147 iomap_write_actor(struct inode
*inode
, loff_t pos
, loff_t length
, void *data
,
150 struct iov_iter
*i
= data
;
153 unsigned int flags
= AOP_FLAG_NOFS
;
156 * Copies from kernel address space cannot fail (NFSD is a big user).
158 if (!iter_is_iovec(i
))
159 flags
|= AOP_FLAG_UNINTERRUPTIBLE
;
163 unsigned long offset
; /* Offset into pagecache page */
164 unsigned long bytes
; /* Bytes to write to page */
165 size_t copied
; /* Bytes copied from user */
167 offset
= (pos
& (PAGE_SIZE
- 1));
168 bytes
= min_t(unsigned long, PAGE_SIZE
- offset
,
175 * Bring in the user page that we will copy from _first_.
176 * Otherwise there's a nasty deadlock on copying from the
177 * same page as we're writing to, without it being marked
180 * Not only is this an optimisation, but it is also required
181 * to check that the address is actually valid, when atomic
182 * usercopies are used, below.
184 if (unlikely(iov_iter_fault_in_readable(i
, bytes
))) {
189 status
= iomap_write_begin(inode
, pos
, bytes
, flags
, &page
,
191 if (unlikely(status
))
194 if (mapping_writably_mapped(inode
->i_mapping
))
195 flush_dcache_page(page
);
197 copied
= iov_iter_copy_from_user_atomic(page
, i
, offset
, bytes
);
199 flush_dcache_page(page
);
201 status
= iomap_write_end(inode
, pos
, bytes
, copied
, page
);
202 if (unlikely(status
< 0))
208 iov_iter_advance(i
, copied
);
209 if (unlikely(copied
== 0)) {
211 * If we were unable to copy any data at all, we must
212 * fall back to a single segment length write.
214 * If we didn't fallback here, we could livelock
215 * because not all segments in the iov can be copied at
216 * once without a pagefault.
218 bytes
= min_t(unsigned long, PAGE_SIZE
- offset
,
219 iov_iter_single_seg_count(i
));
226 balance_dirty_pages_ratelimited(inode
->i_mapping
);
227 } while (iov_iter_count(i
) && length
);
229 return written
? written
: status
;
233 iomap_file_buffered_write(struct kiocb
*iocb
, struct iov_iter
*iter
,
234 struct iomap_ops
*ops
)
236 struct inode
*inode
= iocb
->ki_filp
->f_mapping
->host
;
237 loff_t pos
= iocb
->ki_pos
, ret
= 0, written
= 0;
239 while (iov_iter_count(iter
)) {
240 ret
= iomap_apply(inode
, pos
, iov_iter_count(iter
),
241 IOMAP_WRITE
, ops
, iter
, iomap_write_actor
);
248 return written
? written
: ret
;
250 EXPORT_SYMBOL_GPL(iomap_file_buffered_write
);
253 __iomap_read_page(struct inode
*inode
, loff_t offset
)
255 struct address_space
*mapping
= inode
->i_mapping
;
258 page
= read_mapping_page(mapping
, offset
>> PAGE_SHIFT
, NULL
);
261 if (!PageUptodate(page
)) {
263 return ERR_PTR(-EIO
);
269 iomap_dirty_actor(struct inode
*inode
, loff_t pos
, loff_t length
, void *data
,
276 struct page
*page
, *rpage
;
277 unsigned long offset
; /* Offset into pagecache page */
278 unsigned long bytes
; /* Bytes to write to page */
280 offset
= (pos
& (PAGE_SIZE
- 1));
281 bytes
= min_t(unsigned long, PAGE_SIZE
- offset
, length
);
283 rpage
= __iomap_read_page(inode
, pos
);
285 return PTR_ERR(rpage
);
287 status
= iomap_write_begin(inode
, pos
, bytes
,
288 AOP_FLAG_NOFS
| AOP_FLAG_UNINTERRUPTIBLE
,
291 if (unlikely(status
))
294 WARN_ON_ONCE(!PageUptodate(page
));
296 status
= iomap_write_end(inode
, pos
, bytes
, bytes
, page
);
297 if (unlikely(status
<= 0)) {
298 if (WARN_ON_ONCE(status
== 0))
309 balance_dirty_pages_ratelimited(inode
->i_mapping
);
316 iomap_file_dirty(struct inode
*inode
, loff_t pos
, loff_t len
,
317 struct iomap_ops
*ops
)
322 ret
= iomap_apply(inode
, pos
, len
, IOMAP_WRITE
, ops
, NULL
,
332 EXPORT_SYMBOL_GPL(iomap_file_dirty
);
334 static int iomap_zero(struct inode
*inode
, loff_t pos
, unsigned offset
,
335 unsigned bytes
, struct iomap
*iomap
)
340 status
= iomap_write_begin(inode
, pos
, bytes
,
341 AOP_FLAG_UNINTERRUPTIBLE
| AOP_FLAG_NOFS
, &page
, iomap
);
345 zero_user(page
, offset
, bytes
);
346 mark_page_accessed(page
);
348 return iomap_write_end(inode
, pos
, bytes
, bytes
, page
);
351 static int iomap_dax_zero(loff_t pos
, unsigned offset
, unsigned bytes
,
354 sector_t sector
= iomap
->blkno
+
355 (((pos
& ~(PAGE_SIZE
- 1)) - iomap
->offset
) >> 9);
357 return __dax_zero_page_range(iomap
->bdev
, sector
, offset
, bytes
);
361 iomap_zero_range_actor(struct inode
*inode
, loff_t pos
, loff_t count
,
362 void *data
, struct iomap
*iomap
)
364 bool *did_zero
= data
;
368 /* already zeroed? we're done. */
369 if (iomap
->type
== IOMAP_HOLE
|| iomap
->type
== IOMAP_UNWRITTEN
)
373 unsigned offset
, bytes
;
375 offset
= pos
& (PAGE_SIZE
- 1); /* Within page */
376 bytes
= min_t(unsigned, PAGE_SIZE
- offset
, count
);
379 status
= iomap_dax_zero(pos
, offset
, bytes
, iomap
);
381 status
= iomap_zero(inode
, pos
, offset
, bytes
, iomap
);
396 iomap_zero_range(struct inode
*inode
, loff_t pos
, loff_t len
, bool *did_zero
,
397 struct iomap_ops
*ops
)
402 ret
= iomap_apply(inode
, pos
, len
, IOMAP_ZERO
,
403 ops
, did_zero
, iomap_zero_range_actor
);
413 EXPORT_SYMBOL_GPL(iomap_zero_range
);
416 iomap_truncate_page(struct inode
*inode
, loff_t pos
, bool *did_zero
,
417 struct iomap_ops
*ops
)
419 unsigned blocksize
= (1 << inode
->i_blkbits
);
420 unsigned off
= pos
& (blocksize
- 1);
422 /* Block boundary? Nothing to do */
425 return iomap_zero_range(inode
, pos
, blocksize
- off
, did_zero
, ops
);
427 EXPORT_SYMBOL_GPL(iomap_truncate_page
);
430 iomap_page_mkwrite_actor(struct inode
*inode
, loff_t pos
, loff_t length
,
431 void *data
, struct iomap
*iomap
)
433 struct page
*page
= data
;
436 ret
= __block_write_begin_int(page
, pos
, length
, NULL
, iomap
);
440 block_commit_write(page
, 0, length
);
444 int iomap_page_mkwrite(struct vm_area_struct
*vma
, struct vm_fault
*vmf
,
445 struct iomap_ops
*ops
)
447 struct page
*page
= vmf
->page
;
448 struct inode
*inode
= file_inode(vma
->vm_file
);
449 unsigned long length
;
454 size
= i_size_read(inode
);
455 if ((page
->mapping
!= inode
->i_mapping
) ||
456 (page_offset(page
) > size
)) {
457 /* We overload EFAULT to mean page got truncated */
462 /* page is wholly or partially inside EOF */
463 if (((page
->index
+ 1) << PAGE_SHIFT
) > size
)
464 length
= size
& ~PAGE_MASK
;
468 offset
= page_offset(page
);
470 ret
= iomap_apply(inode
, offset
, length
, IOMAP_WRITE
,
471 ops
, page
, iomap_page_mkwrite_actor
);
472 if (unlikely(ret
<= 0))
478 set_page_dirty(page
);
479 wait_for_stable_page(page
);
485 EXPORT_SYMBOL_GPL(iomap_page_mkwrite
);
488 struct fiemap_extent_info
*fi
;
492 static int iomap_to_fiemap(struct fiemap_extent_info
*fi
,
493 struct iomap
*iomap
, u32 flags
)
495 switch (iomap
->type
) {
500 flags
|= FIEMAP_EXTENT_DELALLOC
| FIEMAP_EXTENT_UNKNOWN
;
502 case IOMAP_UNWRITTEN
:
503 flags
|= FIEMAP_EXTENT_UNWRITTEN
;
509 if (iomap
->flags
& IOMAP_F_MERGED
)
510 flags
|= FIEMAP_EXTENT_MERGED
;
511 if (iomap
->flags
& IOMAP_F_SHARED
)
512 flags
|= FIEMAP_EXTENT_SHARED
;
514 return fiemap_fill_next_extent(fi
, iomap
->offset
,
515 iomap
->blkno
!= IOMAP_NULL_BLOCK
? iomap
->blkno
<< 9: 0,
516 iomap
->length
, flags
);
521 iomap_fiemap_actor(struct inode
*inode
, loff_t pos
, loff_t length
, void *data
,
524 struct fiemap_ctx
*ctx
= data
;
527 if (iomap
->type
== IOMAP_HOLE
)
530 ret
= iomap_to_fiemap(ctx
->fi
, &ctx
->prev
, 0);
533 case 0: /* success */
535 case 1: /* extent array full */
542 int iomap_fiemap(struct inode
*inode
, struct fiemap_extent_info
*fi
,
543 loff_t start
, loff_t len
, struct iomap_ops
*ops
)
545 struct fiemap_ctx ctx
;
548 memset(&ctx
, 0, sizeof(ctx
));
550 ctx
.prev
.type
= IOMAP_HOLE
;
552 ret
= fiemap_check_flags(fi
, FIEMAP_FLAG_SYNC
);
556 if (fi
->fi_flags
& FIEMAP_FLAG_SYNC
) {
557 ret
= filemap_write_and_wait(inode
->i_mapping
);
563 ret
= iomap_apply(inode
, start
, len
, IOMAP_REPORT
, ops
, &ctx
,
565 /* inode with no (attribute) mapping will give ENOENT */
577 if (ctx
.prev
.type
!= IOMAP_HOLE
) {
578 ret
= iomap_to_fiemap(fi
, &ctx
.prev
, FIEMAP_EXTENT_LAST
);
585 EXPORT_SYMBOL_GPL(iomap_fiemap
);