4 * Copyright (C) 1992, 1993, 1994, 1995
5 * Remy Card (card@masi.ibp.fr)
6 * Laboratoire MASI - Institut Blaise Pascal
7 * Universite Pierre et Marie Curie (Paris VI)
11 * linux/fs/minix/file.c
13 * Copyright (C) 1991, 1992 Linus Torvalds
15 * ext4 fs regular file handling primitives
17 * 64-bit file support on 64-bit platforms by Jakub Jelinek
18 * (jj@sunsite.ms.mff.cuni.cz)
21 #include <linux/time.h>
23 #include <linux/mount.h>
24 #include <linux/path.h>
25 #include <linux/quotaops.h>
26 #include <linux/pagevec.h>
27 #include <linux/uio.h>
29 #include "ext4_jbd2.h"
34 * Called when an inode is released. Note that this is different
35 * from ext4_file_open: open gets called at every open, but release
36 * gets called only when /all/ the files are closed.
38 static int ext4_release_file(struct inode
*inode
, struct file
*filp
)
40 if (ext4_test_inode_state(inode
, EXT4_STATE_DA_ALLOC_CLOSE
)) {
41 ext4_alloc_da_blocks(inode
);
42 ext4_clear_inode_state(inode
, EXT4_STATE_DA_ALLOC_CLOSE
);
44 /* if we are the last writer on the inode, drop the block reservation */
45 if ((filp
->f_mode
& FMODE_WRITE
) &&
46 (atomic_read(&inode
->i_writecount
) == 1) &&
47 !EXT4_I(inode
)->i_reserved_data_blocks
)
49 down_write(&EXT4_I(inode
)->i_data_sem
);
50 ext4_discard_preallocations(inode
);
51 up_write(&EXT4_I(inode
)->i_data_sem
);
53 if (is_dx(inode
) && filp
->private_data
)
54 ext4_htree_free_dir_info(filp
->private_data
);
59 static void ext4_unwritten_wait(struct inode
*inode
)
61 wait_queue_head_t
*wq
= ext4_ioend_wq(inode
);
63 wait_event(*wq
, (atomic_read(&EXT4_I(inode
)->i_unwritten
) == 0));
67 * This tests whether the IO in question is block-aligned or not.
68 * Ext4 utilizes unwritten extents when hole-filling during direct IO, and they
69 * are converted to written only after the IO is complete. Until they are
70 * mapped, these blocks appear as holes, so dio_zero_block() will assume that
71 * it needs to zero out portions of the start and/or end block. If 2 AIO
72 * threads are at work on the same unwritten block, they must be synchronized
73 * or one thread will zero the other's data, causing corruption.
76 ext4_unaligned_aio(struct inode
*inode
, struct iov_iter
*from
, loff_t pos
)
78 struct super_block
*sb
= inode
->i_sb
;
79 int blockmask
= sb
->s_blocksize
- 1;
81 if (pos
>= i_size_read(inode
))
84 if ((pos
| iov_iter_alignment(from
)) & blockmask
)
91 ext4_file_write_iter(struct kiocb
*iocb
, struct iov_iter
*from
)
93 struct file
*file
= iocb
->ki_filp
;
94 struct inode
*inode
= file_inode(iocb
->ki_filp
);
95 struct mutex
*aio_mutex
= NULL
;
97 int o_direct
= iocb
->ki_flags
& IOCB_DIRECT
;
102 * Unaligned direct AIO must be serialized; see comment above
103 * In the case of O_APPEND, assume that we must always serialize
106 ext4_test_inode_flag(inode
, EXT4_INODE_EXTENTS
) &&
107 !is_sync_kiocb(iocb
) &&
108 (iocb
->ki_flags
& IOCB_APPEND
||
109 ext4_unaligned_aio(inode
, from
, iocb
->ki_pos
))) {
110 aio_mutex
= ext4_aio_mutex(inode
);
111 mutex_lock(aio_mutex
);
112 ext4_unwritten_wait(inode
);
115 mutex_lock(&inode
->i_mutex
);
116 ret
= generic_write_checks(iocb
, from
);
121 * If we have encountered a bitmap-format file, the size limit
122 * is smaller than s_maxbytes, which is for extent-mapped files.
124 if (!(ext4_test_inode_flag(inode
, EXT4_INODE_EXTENTS
))) {
125 struct ext4_sb_info
*sbi
= EXT4_SB(inode
->i_sb
);
127 if (iocb
->ki_pos
>= sbi
->s_bitmap_maxbytes
) {
131 iov_iter_truncate(from
, sbi
->s_bitmap_maxbytes
- iocb
->ki_pos
);
134 iocb
->private = &overwrite
;
136 size_t length
= iov_iter_count(from
);
137 loff_t pos
= iocb
->ki_pos
;
138 blk_start_plug(&plug
);
140 /* check whether we do a DIO overwrite or not */
141 if (ext4_should_dioread_nolock(inode
) && !aio_mutex
&&
142 !file
->f_mapping
->nrpages
&& pos
+ length
<= i_size_read(inode
)) {
143 struct ext4_map_blocks map
;
144 unsigned int blkbits
= inode
->i_blkbits
;
147 map
.m_lblk
= pos
>> blkbits
;
148 map
.m_len
= (EXT4_BLOCK_ALIGN(pos
+ length
, blkbits
) >> blkbits
)
152 err
= ext4_map_blocks(NULL
, inode
, &map
, 0);
154 * 'err==len' means that all of blocks has
155 * been preallocated no matter they are
156 * initialized or not. For excluding
157 * unwritten extents, we need to check
158 * m_flags. There are two conditions that
159 * indicate for initialized extents. 1) If we
160 * hit extent cache, EXT4_MAP_MAPPED flag is
161 * returned; 2) If we do a real lookup,
162 * non-flags are returned. So we should check
163 * these two conditions.
165 if (err
== len
&& (map
.m_flags
& EXT4_MAP_MAPPED
))
170 ret
= __generic_file_write_iter(iocb
, from
);
171 mutex_unlock(&inode
->i_mutex
);
176 err
= generic_write_sync(file
, iocb
->ki_pos
- ret
, ret
);
181 blk_finish_plug(&plug
);
184 mutex_unlock(aio_mutex
);
188 mutex_unlock(&inode
->i_mutex
);
190 mutex_unlock(aio_mutex
);
195 static void ext4_end_io_unwritten(struct buffer_head
*bh
, int uptodate
)
197 struct inode
*inode
= bh
->b_assoc_map
->host
;
198 /* XXX: breaks on 32-bit > 16GB. Is that even supported? */
199 loff_t offset
= (loff_t
)(uintptr_t)bh
->b_private
<< inode
->i_blkbits
;
203 WARN_ON(!buffer_unwritten(bh
));
204 err
= ext4_convert_unwritten_extents(NULL
, inode
, offset
, bh
->b_size
);
207 static int ext4_dax_fault(struct vm_area_struct
*vma
, struct vm_fault
*vmf
)
209 return dax_fault(vma
, vmf
, ext4_get_block
, ext4_end_io_unwritten
);
210 /* Is this the right get_block? */
213 static int ext4_dax_mkwrite(struct vm_area_struct
*vma
, struct vm_fault
*vmf
)
215 return dax_mkwrite(vma
, vmf
, ext4_get_block
, ext4_end_io_unwritten
);
218 static const struct vm_operations_struct ext4_dax_vm_ops
= {
219 .fault
= ext4_dax_fault
,
220 .page_mkwrite
= ext4_dax_mkwrite
,
221 .pfn_mkwrite
= dax_pfn_mkwrite
,
224 #define ext4_dax_vm_ops ext4_file_vm_ops
227 static const struct vm_operations_struct ext4_file_vm_ops
= {
228 .fault
= ext4_filemap_fault
,
229 .map_pages
= filemap_map_pages
,
230 .page_mkwrite
= ext4_page_mkwrite
,
233 static int ext4_file_mmap(struct file
*file
, struct vm_area_struct
*vma
)
235 struct inode
*inode
= file
->f_mapping
->host
;
237 if (ext4_encrypted_inode(inode
)) {
238 int err
= ext4_generate_encryption_key(inode
);
243 if (IS_DAX(file_inode(file
))) {
244 vma
->vm_ops
= &ext4_dax_vm_ops
;
245 vma
->vm_flags
|= VM_MIXEDMAP
;
247 vma
->vm_ops
= &ext4_file_vm_ops
;
252 static int ext4_file_open(struct inode
* inode
, struct file
* filp
)
254 struct super_block
*sb
= inode
->i_sb
;
255 struct ext4_sb_info
*sbi
= EXT4_SB(inode
->i_sb
);
256 struct vfsmount
*mnt
= filp
->f_path
.mnt
;
261 if (unlikely(!(sbi
->s_mount_flags
& EXT4_MF_MNTDIR_SAMPLED
) &&
262 !(sb
->s_flags
& MS_RDONLY
))) {
263 sbi
->s_mount_flags
|= EXT4_MF_MNTDIR_SAMPLED
;
265 * Sample where the filesystem has been mounted and
266 * store it in the superblock for sysadmin convenience
267 * when trying to sort through large numbers of block
268 * devices or filesystem images.
270 memset(buf
, 0, sizeof(buf
));
272 path
.dentry
= mnt
->mnt_root
;
273 cp
= d_path(&path
, buf
, sizeof(buf
));
278 handle
= ext4_journal_start_sb(sb
, EXT4_HT_MISC
, 1);
280 return PTR_ERR(handle
);
281 BUFFER_TRACE(sbi
->s_sbh
, "get_write_access");
282 err
= ext4_journal_get_write_access(handle
, sbi
->s_sbh
);
284 ext4_journal_stop(handle
);
287 strlcpy(sbi
->s_es
->s_last_mounted
, cp
,
288 sizeof(sbi
->s_es
->s_last_mounted
));
289 ext4_handle_dirty_super(handle
, sb
);
290 ext4_journal_stop(handle
);
294 * Set up the jbd2_inode if we are opening the inode for
295 * writing and the journal is present
297 if (filp
->f_mode
& FMODE_WRITE
) {
298 ret
= ext4_inode_attach_jinode(inode
);
302 ret
= dquot_file_open(inode
, filp
);
303 if (!ret
&& ext4_encrypted_inode(inode
)) {
304 ret
= ext4_generate_encryption_key(inode
);
312 * Here we use ext4_map_blocks() to get a block mapping for a extent-based
313 * file rather than ext4_ext_walk_space() because we can introduce
314 * SEEK_DATA/SEEK_HOLE for block-mapped and extent-mapped file at the same
315 * function. When extent status tree has been fully implemented, it will
316 * track all extent status for a file and we can directly use it to
317 * retrieve the offset for SEEK_DATA/SEEK_HOLE.
321 * When we retrieve the offset for SEEK_DATA/SEEK_HOLE, we would need to
322 * lookup page cache to check whether or not there has some data between
323 * [startoff, endoff] because, if this range contains an unwritten extent,
324 * we determine this extent as a data or a hole according to whether the
325 * page cache has data or not.
327 static int ext4_find_unwritten_pgoff(struct inode
*inode
,
329 struct ext4_map_blocks
*map
,
333 unsigned int blkbits
;
341 blkbits
= inode
->i_sb
->s_blocksize_bits
;
344 endoff
= (loff_t
)(map
->m_lblk
+ map
->m_len
) << blkbits
;
346 index
= startoff
>> PAGE_CACHE_SHIFT
;
347 end
= endoff
>> PAGE_CACHE_SHIFT
;
349 pagevec_init(&pvec
, 0);
352 unsigned long nr_pages
;
354 num
= min_t(pgoff_t
, end
- index
, PAGEVEC_SIZE
);
355 nr_pages
= pagevec_lookup(&pvec
, inode
->i_mapping
, index
,
358 if (whence
== SEEK_DATA
)
361 BUG_ON(whence
!= SEEK_HOLE
);
363 * If this is the first time to go into the loop and
364 * offset is not beyond the end offset, it will be a
365 * hole at this offset
367 if (lastoff
== startoff
|| lastoff
< endoff
)
373 * If this is the first time to go into the loop and
374 * offset is smaller than the first page offset, it will be a
375 * hole at this offset.
377 if (lastoff
== startoff
&& whence
== SEEK_HOLE
&&
378 lastoff
< page_offset(pvec
.pages
[0])) {
383 for (i
= 0; i
< nr_pages
; i
++) {
384 struct page
*page
= pvec
.pages
[i
];
385 struct buffer_head
*bh
, *head
;
388 * If the current offset is not beyond the end of given
389 * range, it will be a hole.
391 if (lastoff
< endoff
&& whence
== SEEK_HOLE
&&
400 if (unlikely(page
->mapping
!= inode
->i_mapping
)) {
405 if (!page_has_buffers(page
)) {
410 if (page_has_buffers(page
)) {
411 lastoff
= page_offset(page
);
412 bh
= head
= page_buffers(page
);
414 if (buffer_uptodate(bh
) ||
415 buffer_unwritten(bh
)) {
416 if (whence
== SEEK_DATA
)
419 if (whence
== SEEK_HOLE
)
423 *offset
= max_t(loff_t
,
428 lastoff
+= bh
->b_size
;
429 bh
= bh
->b_this_page
;
430 } while (bh
!= head
);
433 lastoff
= page_offset(page
) + PAGE_SIZE
;
438 * The no. of pages is less than our desired, that would be a
441 if (nr_pages
< num
&& whence
== SEEK_HOLE
) {
447 index
= pvec
.pages
[i
- 1]->index
+ 1;
448 pagevec_release(&pvec
);
449 } while (index
<= end
);
452 pagevec_release(&pvec
);
457 * ext4_seek_data() retrieves the offset for SEEK_DATA.
459 static loff_t
ext4_seek_data(struct file
*file
, loff_t offset
, loff_t maxsize
)
461 struct inode
*inode
= file
->f_mapping
->host
;
462 struct ext4_map_blocks map
;
463 struct extent_status es
;
464 ext4_lblk_t start
, last
, end
;
465 loff_t dataoff
, isize
;
469 mutex_lock(&inode
->i_mutex
);
471 isize
= i_size_read(inode
);
472 if (offset
>= isize
) {
473 mutex_unlock(&inode
->i_mutex
);
477 blkbits
= inode
->i_sb
->s_blocksize_bits
;
478 start
= offset
>> blkbits
;
480 end
= isize
>> blkbits
;
485 map
.m_len
= end
- last
+ 1;
486 ret
= ext4_map_blocks(NULL
, inode
, &map
, 0);
487 if (ret
> 0 && !(map
.m_flags
& EXT4_MAP_UNWRITTEN
)) {
489 dataoff
= (loff_t
)last
<< blkbits
;
494 * If there is a delay extent at this offset,
495 * it will be as a data.
497 ext4_es_find_delayed_extent_range(inode
, last
, last
, &es
);
498 if (es
.es_len
!= 0 && in_range(last
, es
.es_lblk
, es
.es_len
)) {
500 dataoff
= (loff_t
)last
<< blkbits
;
505 * If there is a unwritten extent at this offset,
506 * it will be as a data or a hole according to page
507 * cache that has data or not.
509 if (map
.m_flags
& EXT4_MAP_UNWRITTEN
) {
511 unwritten
= ext4_find_unwritten_pgoff(inode
, SEEK_DATA
,
518 dataoff
= (loff_t
)last
<< blkbits
;
519 } while (last
<= end
);
521 mutex_unlock(&inode
->i_mutex
);
526 return vfs_setpos(file
, dataoff
, maxsize
);
530 * ext4_seek_hole() retrieves the offset for SEEK_HOLE.
532 static loff_t
ext4_seek_hole(struct file
*file
, loff_t offset
, loff_t maxsize
)
534 struct inode
*inode
= file
->f_mapping
->host
;
535 struct ext4_map_blocks map
;
536 struct extent_status es
;
537 ext4_lblk_t start
, last
, end
;
538 loff_t holeoff
, isize
;
542 mutex_lock(&inode
->i_mutex
);
544 isize
= i_size_read(inode
);
545 if (offset
>= isize
) {
546 mutex_unlock(&inode
->i_mutex
);
550 blkbits
= inode
->i_sb
->s_blocksize_bits
;
551 start
= offset
>> blkbits
;
553 end
= isize
>> blkbits
;
558 map
.m_len
= end
- last
+ 1;
559 ret
= ext4_map_blocks(NULL
, inode
, &map
, 0);
560 if (ret
> 0 && !(map
.m_flags
& EXT4_MAP_UNWRITTEN
)) {
562 holeoff
= (loff_t
)last
<< blkbits
;
567 * If there is a delay extent at this offset,
568 * we will skip this extent.
570 ext4_es_find_delayed_extent_range(inode
, last
, last
, &es
);
571 if (es
.es_len
!= 0 && in_range(last
, es
.es_lblk
, es
.es_len
)) {
572 last
= es
.es_lblk
+ es
.es_len
;
573 holeoff
= (loff_t
)last
<< blkbits
;
578 * If there is a unwritten extent at this offset,
579 * it will be as a data or a hole according to page
580 * cache that has data or not.
582 if (map
.m_flags
& EXT4_MAP_UNWRITTEN
) {
584 unwritten
= ext4_find_unwritten_pgoff(inode
, SEEK_HOLE
,
588 holeoff
= (loff_t
)last
<< blkbits
;
595 } while (last
<= end
);
597 mutex_unlock(&inode
->i_mutex
);
602 return vfs_setpos(file
, holeoff
, maxsize
);
606 * ext4_llseek() handles both block-mapped and extent-mapped maxbytes values
607 * by calling generic_file_llseek_size() with the appropriate maxbytes
610 loff_t
ext4_llseek(struct file
*file
, loff_t offset
, int whence
)
612 struct inode
*inode
= file
->f_mapping
->host
;
615 if (!(ext4_test_inode_flag(inode
, EXT4_INODE_EXTENTS
)))
616 maxbytes
= EXT4_SB(inode
->i_sb
)->s_bitmap_maxbytes
;
618 maxbytes
= inode
->i_sb
->s_maxbytes
;
624 return generic_file_llseek_size(file
, offset
, whence
,
625 maxbytes
, i_size_read(inode
));
627 return ext4_seek_data(file
, offset
, maxbytes
);
629 return ext4_seek_hole(file
, offset
, maxbytes
);
635 const struct file_operations ext4_file_operations
= {
636 .llseek
= ext4_llseek
,
637 .read_iter
= generic_file_read_iter
,
638 .write_iter
= ext4_file_write_iter
,
639 .unlocked_ioctl
= ext4_ioctl
,
641 .compat_ioctl
= ext4_compat_ioctl
,
643 .mmap
= ext4_file_mmap
,
644 .open
= ext4_file_open
,
645 .release
= ext4_release_file
,
646 .fsync
= ext4_sync_file
,
647 .splice_read
= generic_file_splice_read
,
648 .splice_write
= iter_file_splice_write
,
649 .fallocate
= ext4_fallocate
,
652 const struct inode_operations ext4_file_inode_operations
= {
653 .setattr
= ext4_setattr
,
654 .getattr
= ext4_getattr
,
655 .setxattr
= generic_setxattr
,
656 .getxattr
= generic_getxattr
,
657 .listxattr
= ext4_listxattr
,
658 .removexattr
= generic_removexattr
,
659 .get_acl
= ext4_get_acl
,
660 .set_acl
= ext4_set_acl
,
661 .fiemap
= ext4_fiemap
,