1 // SPDX-License-Identifier: GPL-2.0-only
5 * Written 1992,1993 by Werner Almesberger
7 * regular file handling primitives for fat-based filesystems
10 #include <linux/capability.h>
11 #include <linux/module.h>
12 #include <linux/compat.h>
13 #include <linux/mount.h>
14 #include <linux/blkdev.h>
15 #include <linux/backing-dev.h>
16 #include <linux/fsnotify.h>
17 #include <linux/security.h>
18 #include <linux/falloc.h>
21 static long fat_fallocate(struct file
*file
, int mode
,
22 loff_t offset
, loff_t len
);
24 static int fat_ioctl_get_attributes(struct inode
*inode
, u32 __user
*user_attr
)
29 attr
= fat_make_attrs(inode
);
32 return put_user(attr
, user_attr
);
35 static int fat_ioctl_set_attributes(struct file
*file
, u32 __user
*user_attr
)
37 struct inode
*inode
= file_inode(file
);
38 struct msdos_sb_info
*sbi
= MSDOS_SB(inode
->i_sb
);
39 int is_dir
= S_ISDIR(inode
->i_mode
);
44 err
= get_user(attr
, user_attr
);
48 err
= mnt_want_write_file(file
);
54 * ATTR_VOLUME and ATTR_DIR cannot be changed; this also
55 * prevents the user from turning us into a VFAT
56 * longname entry. Also, we obviously can't set
57 * any of the NTFS attributes in the high 24 bits.
59 attr
&= 0xff & ~(ATTR_VOLUME
| ATTR_DIR
);
60 /* Merge in ATTR_VOLUME and ATTR_DIR */
61 attr
|= (MSDOS_I(inode
)->i_attrs
& ATTR_VOLUME
) |
62 (is_dir
? ATTR_DIR
: 0);
63 oldattr
= fat_make_attrs(inode
);
65 /* Equivalent to a chmod() */
66 ia
.ia_valid
= ATTR_MODE
| ATTR_CTIME
;
67 ia
.ia_ctime
= current_time(inode
);
69 ia
.ia_mode
= fat_make_mode(sbi
, attr
, S_IRWXUGO
);
71 ia
.ia_mode
= fat_make_mode(sbi
, attr
,
72 S_IRUGO
| S_IWUGO
| (inode
->i_mode
& S_IXUGO
));
75 /* The root directory has no attributes */
76 if (inode
->i_ino
== MSDOS_ROOT_INO
&& attr
!= ATTR_DIR
) {
78 goto out_unlock_inode
;
81 if (sbi
->options
.sys_immutable
&&
82 ((attr
| oldattr
) & ATTR_SYS
) &&
83 !capable(CAP_LINUX_IMMUTABLE
)) {
85 goto out_unlock_inode
;
89 * The security check is questionable... We single
90 * out the RO attribute for checking by the security
91 * module, just because it maps to a file mode.
93 err
= security_inode_setattr(file
->f_path
.dentry
, &ia
);
95 goto out_unlock_inode
;
97 /* This MUST be done before doing anything irreversible... */
98 err
= fat_setattr(file
->f_path
.dentry
, &ia
);
100 goto out_unlock_inode
;
102 fsnotify_change(file
->f_path
.dentry
, ia
.ia_valid
);
103 if (sbi
->options
.sys_immutable
) {
105 inode
->i_flags
|= S_IMMUTABLE
;
107 inode
->i_flags
&= ~S_IMMUTABLE
;
110 fat_save_attrs(inode
, attr
);
111 mark_inode_dirty(inode
);
114 mnt_drop_write_file(file
);
119 static int fat_ioctl_get_volume_id(struct inode
*inode
, u32 __user
*user_attr
)
121 struct msdos_sb_info
*sbi
= MSDOS_SB(inode
->i_sb
);
122 return put_user(sbi
->vol_id
, user_attr
);
125 static int fat_ioctl_fitrim(struct inode
*inode
, unsigned long arg
)
127 struct super_block
*sb
= inode
->i_sb
;
128 struct fstrim_range __user
*user_range
;
129 struct fstrim_range range
;
130 struct request_queue
*q
= bdev_get_queue(sb
->s_bdev
);
133 if (!capable(CAP_SYS_ADMIN
))
136 if (!blk_queue_discard(q
))
139 user_range
= (struct fstrim_range __user
*)arg
;
140 if (copy_from_user(&range
, user_range
, sizeof(range
)))
143 range
.minlen
= max_t(unsigned int, range
.minlen
,
144 q
->limits
.discard_granularity
);
146 err
= fat_trim_fs(inode
, &range
);
150 if (copy_to_user(user_range
, &range
, sizeof(range
)))
156 long fat_generic_ioctl(struct file
*filp
, unsigned int cmd
, unsigned long arg
)
158 struct inode
*inode
= file_inode(filp
);
159 u32 __user
*user_attr
= (u32 __user
*)arg
;
162 case FAT_IOCTL_GET_ATTRIBUTES
:
163 return fat_ioctl_get_attributes(inode
, user_attr
);
164 case FAT_IOCTL_SET_ATTRIBUTES
:
165 return fat_ioctl_set_attributes(filp
, user_attr
);
166 case FAT_IOCTL_GET_VOLUME_ID
:
167 return fat_ioctl_get_volume_id(inode
, user_attr
);
169 return fat_ioctl_fitrim(inode
, arg
);
171 return -ENOTTY
; /* Inappropriate ioctl for device */
176 static long fat_generic_compat_ioctl(struct file
*filp
, unsigned int cmd
,
180 return fat_generic_ioctl(filp
, cmd
, (unsigned long)compat_ptr(arg
));
184 static int fat_file_release(struct inode
*inode
, struct file
*filp
)
186 if ((filp
->f_mode
& FMODE_WRITE
) &&
187 MSDOS_SB(inode
->i_sb
)->options
.flush
) {
188 fat_flush_inodes(inode
->i_sb
, inode
, NULL
);
189 congestion_wait(BLK_RW_ASYNC
, HZ
/10);
194 int fat_file_fsync(struct file
*filp
, loff_t start
, loff_t end
, int datasync
)
196 struct inode
*inode
= filp
->f_mapping
->host
;
199 err
= __generic_file_fsync(filp
, start
, end
, datasync
);
203 err
= sync_mapping_buffers(MSDOS_SB(inode
->i_sb
)->fat_inode
->i_mapping
);
207 return blkdev_issue_flush(inode
->i_sb
->s_bdev
, GFP_KERNEL
, NULL
);
211 const struct file_operations fat_file_operations
= {
212 .llseek
= generic_file_llseek
,
213 .read_iter
= generic_file_read_iter
,
214 .write_iter
= generic_file_write_iter
,
215 .mmap
= generic_file_mmap
,
216 .release
= fat_file_release
,
217 .unlocked_ioctl
= fat_generic_ioctl
,
219 .compat_ioctl
= fat_generic_compat_ioctl
,
221 .fsync
= fat_file_fsync
,
222 .splice_read
= generic_file_splice_read
,
223 .splice_write
= iter_file_splice_write
,
224 .fallocate
= fat_fallocate
,
227 static int fat_cont_expand(struct inode
*inode
, loff_t size
)
229 struct address_space
*mapping
= inode
->i_mapping
;
230 loff_t start
= inode
->i_size
, count
= size
- inode
->i_size
;
233 err
= generic_cont_expand_simple(inode
, size
);
237 fat_truncate_time(inode
, NULL
, S_CTIME
|S_MTIME
);
238 mark_inode_dirty(inode
);
239 if (IS_SYNC(inode
)) {
243 * Opencode syncing since we don't have a file open to use
244 * standard fsync path.
246 err
= filemap_fdatawrite_range(mapping
, start
,
248 err2
= sync_mapping_buffers(mapping
);
251 err2
= write_inode_now(inode
, 1);
255 err
= filemap_fdatawait_range(mapping
, start
,
264 * Preallocate space for a file. This implements fat's fallocate file
265 * operation, which gets called from sys_fallocate system call. User
266 * space requests len bytes at offset. If FALLOC_FL_KEEP_SIZE is set
267 * we just allocate clusters without zeroing them out. Otherwise we
268 * allocate and zero out clusters via an expanding truncate.
270 static long fat_fallocate(struct file
*file
, int mode
,
271 loff_t offset
, loff_t len
)
273 int nr_cluster
; /* Number of clusters to be allocated */
274 loff_t mm_bytes
; /* Number of bytes to be allocated for file */
275 loff_t ondisksize
; /* block aligned on-disk size in bytes*/
276 struct inode
*inode
= file
->f_mapping
->host
;
277 struct super_block
*sb
= inode
->i_sb
;
278 struct msdos_sb_info
*sbi
= MSDOS_SB(sb
);
281 /* No support for hole punch or other fallocate flags. */
282 if (mode
& ~FALLOC_FL_KEEP_SIZE
)
285 /* No support for dir */
286 if (!S_ISREG(inode
->i_mode
))
290 if (mode
& FALLOC_FL_KEEP_SIZE
) {
291 ondisksize
= inode
->i_blocks
<< 9;
292 if ((offset
+ len
) <= ondisksize
)
295 /* First compute the number of clusters to be allocated */
296 mm_bytes
= offset
+ len
- ondisksize
;
297 nr_cluster
= (mm_bytes
+ (sbi
->cluster_size
- 1)) >>
300 /* Start the allocation.We are not zeroing out the clusters */
301 while (nr_cluster
-- > 0) {
302 err
= fat_add_cluster(inode
);
307 if ((offset
+ len
) <= i_size_read(inode
))
310 /* This is just an expanding truncate */
311 err
= fat_cont_expand(inode
, (offset
+ len
));
319 /* Free all clusters after the skip'th cluster. */
320 static int fat_free(struct inode
*inode
, int skip
)
322 struct super_block
*sb
= inode
->i_sb
;
323 int err
, wait
, free_start
, i_start
, i_logstart
;
325 if (MSDOS_I(inode
)->i_start
== 0)
328 fat_cache_inval_inode(inode
);
330 wait
= IS_DIRSYNC(inode
);
331 i_start
= free_start
= MSDOS_I(inode
)->i_start
;
332 i_logstart
= MSDOS_I(inode
)->i_logstart
;
334 /* First, we write the new file size. */
336 MSDOS_I(inode
)->i_start
= 0;
337 MSDOS_I(inode
)->i_logstart
= 0;
339 MSDOS_I(inode
)->i_attrs
|= ATTR_ARCH
;
340 fat_truncate_time(inode
, NULL
, S_CTIME
|S_MTIME
);
342 err
= fat_sync_inode(inode
);
344 MSDOS_I(inode
)->i_start
= i_start
;
345 MSDOS_I(inode
)->i_logstart
= i_logstart
;
349 mark_inode_dirty(inode
);
351 /* Write a new EOF, and get the remaining cluster chain for freeing. */
353 struct fat_entry fatent
;
354 int ret
, fclus
, dclus
;
356 ret
= fat_get_cluster(inode
, skip
- 1, &fclus
, &dclus
);
359 else if (ret
== FAT_ENT_EOF
)
362 fatent_init(&fatent
);
363 ret
= fat_ent_read(inode
, &fatent
, dclus
);
364 if (ret
== FAT_ENT_EOF
) {
365 fatent_brelse(&fatent
);
367 } else if (ret
== FAT_ENT_FREE
) {
369 "%s: invalid cluster chain (i_pos %lld)",
370 __func__
, MSDOS_I(inode
)->i_pos
);
372 } else if (ret
> 0) {
373 err
= fat_ent_write(inode
, &fatent
, FAT_ENT_EOF
, wait
);
377 fatent_brelse(&fatent
);
383 inode
->i_blocks
= skip
<< (MSDOS_SB(sb
)->cluster_bits
- 9);
385 /* Freeing the remained cluster chain */
386 return fat_free_clusters(inode
, free_start
);
389 void fat_truncate_blocks(struct inode
*inode
, loff_t offset
)
391 struct msdos_sb_info
*sbi
= MSDOS_SB(inode
->i_sb
);
392 const unsigned int cluster_size
= sbi
->cluster_size
;
396 * This protects against truncating a file bigger than it was then
397 * trying to write into the hole.
399 if (MSDOS_I(inode
)->mmu_private
> offset
)
400 MSDOS_I(inode
)->mmu_private
= offset
;
402 nr_clusters
= (offset
+ (cluster_size
- 1)) >> sbi
->cluster_bits
;
404 fat_free(inode
, nr_clusters
);
405 fat_flush_inodes(inode
->i_sb
, inode
, NULL
);
408 int fat_getattr(const struct path
*path
, struct kstat
*stat
,
409 u32 request_mask
, unsigned int flags
)
411 struct inode
*inode
= d_inode(path
->dentry
);
412 generic_fillattr(inode
, stat
);
413 stat
->blksize
= MSDOS_SB(inode
->i_sb
)->cluster_size
;
415 if (MSDOS_SB(inode
->i_sb
)->options
.nfs
== FAT_NFS_NOSTALE_RO
) {
416 /* Use i_pos for ino. This is used as fileid of nfs. */
417 stat
->ino
= fat_i_pos_read(MSDOS_SB(inode
->i_sb
), inode
);
421 EXPORT_SYMBOL_GPL(fat_getattr
);
423 static int fat_sanitize_mode(const struct msdos_sb_info
*sbi
,
424 struct inode
*inode
, umode_t
*mode_ptr
)
429 * Note, the basic check is already done by a caller of
430 * (attr->ia_mode & ~FAT_VALID_MODE)
433 if (S_ISREG(inode
->i_mode
))
434 mask
= sbi
->options
.fs_fmask
;
436 mask
= sbi
->options
.fs_dmask
;
438 perm
= *mode_ptr
& ~(S_IFMT
| mask
);
441 * Of the r and x bits, all (subject to umask) must be present. Of the
442 * w bits, either all (subject to umask) or none must be present.
444 * If fat_mode_can_hold_ro(inode) is false, can't change w bits.
446 if ((perm
& (S_IRUGO
| S_IXUGO
)) != (inode
->i_mode
& (S_IRUGO
|S_IXUGO
)))
448 if (fat_mode_can_hold_ro(inode
)) {
449 if ((perm
& S_IWUGO
) && ((perm
& S_IWUGO
) != (S_IWUGO
& ~mask
)))
452 if ((perm
& S_IWUGO
) != (S_IWUGO
& ~mask
))
456 *mode_ptr
&= S_IFMT
| perm
;
461 static int fat_allow_set_time(struct msdos_sb_info
*sbi
, struct inode
*inode
)
463 umode_t allow_utime
= sbi
->options
.allow_utime
;
465 if (!uid_eq(current_fsuid(), inode
->i_uid
)) {
466 if (in_group_p(inode
->i_gid
))
468 if (allow_utime
& MAY_WRITE
)
472 /* use a default check */
476 #define TIMES_SET_FLAGS (ATTR_MTIME_SET | ATTR_ATIME_SET | ATTR_TIMES_SET)
477 /* valid file mode bits */
478 #define FAT_VALID_MODE (S_IFREG | S_IFDIR | S_IRWXUGO)
480 int fat_setattr(struct dentry
*dentry
, struct iattr
*attr
)
482 struct msdos_sb_info
*sbi
= MSDOS_SB(dentry
->d_sb
);
483 struct inode
*inode
= d_inode(dentry
);
484 unsigned int ia_valid
;
487 /* Check for setting the inode time. */
488 ia_valid
= attr
->ia_valid
;
489 if (ia_valid
& TIMES_SET_FLAGS
) {
490 if (fat_allow_set_time(sbi
, inode
))
491 attr
->ia_valid
&= ~TIMES_SET_FLAGS
;
494 error
= setattr_prepare(dentry
, attr
);
495 attr
->ia_valid
= ia_valid
;
497 if (sbi
->options
.quiet
)
503 * Expand the file. Since inode_setattr() updates ->i_size
504 * before calling the ->truncate(), but FAT needs to fill the
505 * hole before it. XXX: this is no longer true with new truncate
508 if (attr
->ia_valid
& ATTR_SIZE
) {
509 inode_dio_wait(inode
);
511 if (attr
->ia_size
> inode
->i_size
) {
512 error
= fat_cont_expand(inode
, attr
->ia_size
);
513 if (error
|| attr
->ia_valid
== ATTR_SIZE
)
515 attr
->ia_valid
&= ~ATTR_SIZE
;
519 if (((attr
->ia_valid
& ATTR_UID
) &&
520 (!uid_eq(attr
->ia_uid
, sbi
->options
.fs_uid
))) ||
521 ((attr
->ia_valid
& ATTR_GID
) &&
522 (!gid_eq(attr
->ia_gid
, sbi
->options
.fs_gid
))) ||
523 ((attr
->ia_valid
& ATTR_MODE
) &&
524 (attr
->ia_mode
& ~FAT_VALID_MODE
)))
528 if (sbi
->options
.quiet
)
534 * We don't return -EPERM here. Yes, strange, but this is too
537 if (attr
->ia_valid
& ATTR_MODE
) {
538 if (fat_sanitize_mode(sbi
, inode
, &attr
->ia_mode
) < 0)
539 attr
->ia_valid
&= ~ATTR_MODE
;
542 if (attr
->ia_valid
& ATTR_SIZE
) {
543 error
= fat_block_truncate_page(inode
, attr
->ia_size
);
546 down_write(&MSDOS_I(inode
)->truncate_lock
);
547 truncate_setsize(inode
, attr
->ia_size
);
548 fat_truncate_blocks(inode
, attr
->ia_size
);
549 up_write(&MSDOS_I(inode
)->truncate_lock
);
553 * setattr_copy can't truncate these appropriately, so we'll
554 * copy them ourselves
556 if (attr
->ia_valid
& ATTR_ATIME
)
557 fat_truncate_time(inode
, &attr
->ia_atime
, S_ATIME
);
558 if (attr
->ia_valid
& ATTR_CTIME
)
559 fat_truncate_time(inode
, &attr
->ia_ctime
, S_CTIME
);
560 if (attr
->ia_valid
& ATTR_MTIME
)
561 fat_truncate_time(inode
, &attr
->ia_mtime
, S_MTIME
);
562 attr
->ia_valid
&= ~(ATTR_ATIME
|ATTR_CTIME
|ATTR_MTIME
);
564 setattr_copy(inode
, attr
);
565 mark_inode_dirty(inode
);
569 EXPORT_SYMBOL_GPL(fat_setattr
);
571 const struct inode_operations fat_file_inode_operations
= {
572 .setattr
= fat_setattr
,
573 .getattr
= fat_getattr
,
574 .update_time
= fat_update_time
,