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,