]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - fs/sync.c
objtool: Add entry UNRET validation
[mirror_ubuntu-jammy-kernel.git] / fs / sync.c
CommitLineData
b2441318 1// SPDX-License-Identifier: GPL-2.0
f79e2abb
AM
2/*
3 * High-level sync()-related operations
4 */
5
6#include <linux/kernel.h>
7#include <linux/file.h>
8#include <linux/fs.h>
5a0e3ad6 9#include <linux/slab.h>
630d9c47 10#include <linux/export.h>
b7ed78f5 11#include <linux/namei.h>
914e2637 12#include <linux/sched.h>
f79e2abb
AM
13#include <linux/writeback.h>
14#include <linux/syscalls.h>
15#include <linux/linkage.h>
16#include <linux/pagemap.h>
cf9a2ae8 17#include <linux/quotaops.h>
5129a469 18#include <linux/backing-dev.h>
5a3e5cb8 19#include "internal.h"
f79e2abb
AM
20
21#define VALID_FLAGS (SYNC_FILE_RANGE_WAIT_BEFORE|SYNC_FILE_RANGE_WRITE| \
22 SYNC_FILE_RANGE_WAIT_AFTER)
23
c15c54f5 24/*
d8a8559c
JA
25 * Do the filesystem syncing work. For simple filesystems
26 * writeback_inodes_sb(sb) just dirties buffers with inodes so we have to
27 * submit IO for these buffers via __sync_blockdev(). This also speeds up the
28 * wait == 1 case since in that case write_inode() functions do
29 * sync_dirty_buffer() and thus effectively write one block at a time.
c15c54f5 30 */
7fea21ae 31int __sync_filesystem(struct super_block *sb, int wait)
c15c54f5 32{
5fb324ad 33 if (wait)
0dc83bd3 34 sync_inodes_sb(sb);
5fb324ad 35 else
0e175a18 36 writeback_inodes_sb(sb, WB_REASON_SYNC);
5fb324ad 37
c15c54f5
JK
38 if (sb->s_op->sync_fs)
39 sb->s_op->sync_fs(sb, wait);
40 return __sync_blockdev(sb->s_bdev, wait);
41}
7fea21ae 42EXPORT_SYMBOL_GPL(__sync_filesystem);
c15c54f5
JK
43
44/*
45 * Write out and wait upon all dirty data associated with this
46 * superblock. Filesystem data as well as the underlying block
47 * device. Takes the superblock lock.
48 */
60b0680f 49int sync_filesystem(struct super_block *sb)
c15c54f5
JK
50{
51 int ret;
52
5af7926f
CH
53 /*
54 * We need to be protected against the filesystem going from
55 * r/o to r/w or vice versa.
56 */
57 WARN_ON(!rwsem_is_locked(&sb->s_umount));
58
59 /*
60 * No point in syncing out anything if the filesystem is read-only.
61 */
bc98a42c 62 if (sb_rdonly(sb))
5af7926f
CH
63 return 0;
64
0dc83bd3 65 ret = __sync_filesystem(sb, 0);
c15c54f5
JK
66 if (ret < 0)
67 return ret;
0dc83bd3 68 return __sync_filesystem(sb, 1);
c15c54f5 69}
10096fb1 70EXPORT_SYMBOL(sync_filesystem);
c15c54f5 71
b3de6531 72static void sync_inodes_one_sb(struct super_block *sb, void *arg)
01a05b33 73{
bc98a42c 74 if (!sb_rdonly(sb))
0dc83bd3 75 sync_inodes_sb(sb);
01a05b33 76}
b3de6531 77
b3de6531
JK
78static void sync_fs_one_sb(struct super_block *sb, void *arg)
79{
32b1924b
KK
80 if (!sb_rdonly(sb) && !(sb->s_iflags & SB_I_SKIP_SYNC) &&
81 sb->s_op->sync_fs)
b3de6531
JK
82 sb->s_op->sync_fs(sb, *(int *)arg);
83}
84
3beab0b4 85/*
4ea425b6
JK
86 * Sync everything. We start by waking flusher threads so that most of
87 * writeback runs on all devices in parallel. Then we sync all inodes reliably
88 * which effectively also waits for all flusher threads to finish doing
89 * writeback. At this point all data is on disk so metadata should be stable
90 * and we tell filesystems to sync their metadata via ->sync_fs() calls.
91 * Finally, we writeout all block devices because some filesystems (e.g. ext2)
92 * just write metadata (such as inodes or bitmaps) to block device page cache
93 * and do not sync it on their own in ->sync_fs().
3beab0b4 94 */
70f68ee8 95void ksys_sync(void)
cf9a2ae8 96{
b3de6531
JK
97 int nowait = 0, wait = 1;
98
9ba4b2df 99 wakeup_flusher_threads(WB_REASON_SYNC);
0dc83bd3 100 iterate_supers(sync_inodes_one_sb, NULL);
4ea425b6 101 iterate_supers(sync_fs_one_sb, &nowait);
b3de6531 102 iterate_supers(sync_fs_one_sb, &wait);
c2841809
CH
103 sync_bdevs(false);
104 sync_bdevs(true);
cf9a2ae8
DH
105 if (unlikely(laptop_mode))
106 laptop_sync_completion();
70f68ee8
DB
107}
108
109SYSCALL_DEFINE0(sync)
110{
111 ksys_sync();
cf9a2ae8
DH
112 return 0;
113}
114
a2a9537a
JA
115static void do_sync_work(struct work_struct *work)
116{
b3de6531
JK
117 int nowait = 0;
118
5cee5815
JK
119 /*
120 * Sync twice to reduce the possibility we skipped some inodes / pages
121 * because they were temporarily locked
122 */
b3de6531
JK
123 iterate_supers(sync_inodes_one_sb, &nowait);
124 iterate_supers(sync_fs_one_sb, &nowait);
c2841809 125 sync_bdevs(false);
b3de6531
JK
126 iterate_supers(sync_inodes_one_sb, &nowait);
127 iterate_supers(sync_fs_one_sb, &nowait);
c2841809 128 sync_bdevs(false);
5cee5815 129 printk("Emergency Sync complete\n");
a2a9537a
JA
130 kfree(work);
131}
132
cf9a2ae8
DH
133void emergency_sync(void)
134{
a2a9537a
JA
135 struct work_struct *work;
136
137 work = kmalloc(sizeof(*work), GFP_ATOMIC);
138 if (work) {
139 INIT_WORK(work, do_sync_work);
140 schedule_work(work);
141 }
cf9a2ae8
DH
142}
143
b7ed78f5
SW
144/*
145 * sync a single super
146 */
147SYSCALL_DEFINE1(syncfs, int, fd)
148{
2903ff01 149 struct fd f = fdget(fd);
b7ed78f5 150 struct super_block *sb;
735e4ae5 151 int ret, ret2;
b7ed78f5 152
2903ff01 153 if (!f.file)
b7ed78f5 154 return -EBADF;
b583043e 155 sb = f.file->f_path.dentry->d_sb;
b7ed78f5
SW
156
157 down_read(&sb->s_umount);
158 ret = sync_filesystem(sb);
159 up_read(&sb->s_umount);
160
735e4ae5
JL
161 ret2 = errseq_check_and_advance(&sb->s_wb_err, &f.file->f_sb_err);
162
2903ff01 163 fdput(f);
735e4ae5 164 return ret ? ret : ret2;
b7ed78f5
SW
165}
166
4c728ef5 167/**
148f948b 168 * vfs_fsync_range - helper to sync a range of data & metadata to disk
4c728ef5 169 * @file: file to sync
148f948b
JK
170 * @start: offset in bytes of the beginning of data range to sync
171 * @end: offset in bytes of the end of data range (inclusive)
172 * @datasync: perform only datasync
4c728ef5 173 *
148f948b
JK
174 * Write back data in range @start..@end and metadata for @file to disk. If
175 * @datasync is set only metadata needed to access modified file data is
176 * written.
4c728ef5 177 */
8018ab05 178int vfs_fsync_range(struct file *file, loff_t start, loff_t end, int datasync)
cf9a2ae8 179{
0ae45f63
TT
180 struct inode *inode = file->f_mapping->host;
181
72c2d531 182 if (!file->f_op->fsync)
02c24a82 183 return -EINVAL;
0d07e557 184 if (!datasync && (inode->i_state & I_DIRTY_TIME))
0ae45f63 185 mark_inode_dirty_sync(inode);
0f41074a 186 return file->f_op->fsync(file, start, end, datasync);
cf9a2ae8 187}
148f948b
JK
188EXPORT_SYMBOL(vfs_fsync_range);
189
190/**
191 * vfs_fsync - perform a fsync or fdatasync on a file
192 * @file: file to sync
148f948b
JK
193 * @datasync: only perform a fdatasync operation
194 *
195 * Write back data and metadata for @file to disk. If @datasync is
196 * set only metadata needed to access modified file data is written.
148f948b 197 */
8018ab05 198int vfs_fsync(struct file *file, int datasync)
148f948b 199{
8018ab05 200 return vfs_fsync_range(file, 0, LLONG_MAX, datasync);
148f948b 201}
4c728ef5 202EXPORT_SYMBOL(vfs_fsync);
cf9a2ae8 203
4c728ef5 204static int do_fsync(unsigned int fd, int datasync)
cf9a2ae8 205{
2903ff01 206 struct fd f = fdget(fd);
cf9a2ae8
DH
207 int ret = -EBADF;
208
2903ff01
AV
209 if (f.file) {
210 ret = vfs_fsync(f.file, datasync);
211 fdput(f);
cf9a2ae8
DH
212 }
213 return ret;
214}
215
a5f8fa9e 216SYSCALL_DEFINE1(fsync, unsigned int, fd)
cf9a2ae8 217{
4c728ef5 218 return do_fsync(fd, 0);
cf9a2ae8
DH
219}
220
a5f8fa9e 221SYSCALL_DEFINE1(fdatasync, unsigned int, fd)
cf9a2ae8 222{
4c728ef5 223 return do_fsync(fd, 1);
cf9a2ae8
DH
224}
225
22f96b38
JA
226int sync_file_range(struct file *file, loff_t offset, loff_t nbytes,
227 unsigned int flags)
f79e2abb
AM
228{
229 int ret;
7a0ad10c 230 struct address_space *mapping;
f79e2abb 231 loff_t endbyte; /* inclusive */
f79e2abb
AM
232 umode_t i_mode;
233
234 ret = -EINVAL;
235 if (flags & ~VALID_FLAGS)
236 goto out;
237
238 endbyte = offset + nbytes;
239
240 if ((s64)offset < 0)
241 goto out;
242 if ((s64)endbyte < 0)
243 goto out;
244 if (endbyte < offset)
245 goto out;
246
247 if (sizeof(pgoff_t) == 4) {
09cbfeaf 248 if (offset >= (0x100000000ULL << PAGE_SHIFT)) {
f79e2abb
AM
249 /*
250 * The range starts outside a 32 bit machine's
251 * pagecache addressing capabilities. Let it "succeed"
252 */
253 ret = 0;
254 goto out;
255 }
09cbfeaf 256 if (endbyte >= (0x100000000ULL << PAGE_SHIFT)) {
f79e2abb
AM
257 /*
258 * Out to EOF
259 */
260 nbytes = 0;
261 }
262 }
263
264 if (nbytes == 0)
111ebb6e 265 endbyte = LLONG_MAX;
f79e2abb
AM
266 else
267 endbyte--; /* inclusive */
268
22f96b38 269 i_mode = file_inode(file)->i_mode;
f79e2abb
AM
270 ret = -ESPIPE;
271 if (!S_ISREG(i_mode) && !S_ISBLK(i_mode) && !S_ISDIR(i_mode) &&
272 !S_ISLNK(i_mode))
22f96b38 273 goto out;
f79e2abb 274
22f96b38 275 mapping = file->f_mapping;
7a0ad10c
CH
276 ret = 0;
277 if (flags & SYNC_FILE_RANGE_WAIT_BEFORE) {
22f96b38 278 ret = file_fdatawait_range(file, offset, endbyte);
7a0ad10c 279 if (ret < 0)
22f96b38 280 goto out;
7a0ad10c
CH
281 }
282
283 if (flags & SYNC_FILE_RANGE_WRITE) {
c553ea4f
AG
284 int sync_mode = WB_SYNC_NONE;
285
286 if ((flags & SYNC_FILE_RANGE_WRITE_AND_WAIT) ==
287 SYNC_FILE_RANGE_WRITE_AND_WAIT)
288 sync_mode = WB_SYNC_ALL;
289
23d01270 290 ret = __filemap_fdatawrite_range(mapping, offset, endbyte,
c553ea4f 291 sync_mode);
7a0ad10c 292 if (ret < 0)
22f96b38 293 goto out;
7a0ad10c
CH
294 }
295
296 if (flags & SYNC_FILE_RANGE_WAIT_AFTER)
22f96b38 297 ret = file_fdatawait_range(file, offset, endbyte);
7a0ad10c 298
f79e2abb
AM
299out:
300 return ret;
301}
302
22f96b38 303/*
c553ea4f 304 * ksys_sync_file_range() permits finely controlled syncing over a segment of
22f96b38 305 * a file in the range offset .. (offset+nbytes-1) inclusive. If nbytes is
c553ea4f 306 * zero then ksys_sync_file_range() will operate from offset out to EOF.
22f96b38
JA
307 *
308 * The flag bits are:
309 *
310 * SYNC_FILE_RANGE_WAIT_BEFORE: wait upon writeout of all pages in the range
311 * before performing the write.
312 *
313 * SYNC_FILE_RANGE_WRITE: initiate writeout of all those dirty pages in the
314 * range which are not presently under writeback. Note that this may block for
315 * significant periods due to exhaustion of disk request structures.
316 *
317 * SYNC_FILE_RANGE_WAIT_AFTER: wait upon writeout of all pages in the range
318 * after performing the write.
319 *
320 * Useful combinations of the flag bits are:
321 *
322 * SYNC_FILE_RANGE_WAIT_BEFORE|SYNC_FILE_RANGE_WRITE: ensures that all pages
c553ea4f 323 * in the range which were dirty on entry to ksys_sync_file_range() are placed
22f96b38
JA
324 * under writeout. This is a start-write-for-data-integrity operation.
325 *
326 * SYNC_FILE_RANGE_WRITE: start writeout of all dirty pages in the range which
327 * are not presently under writeout. This is an asynchronous flush-to-disk
328 * operation. Not suitable for data integrity operations.
329 *
330 * SYNC_FILE_RANGE_WAIT_BEFORE (or SYNC_FILE_RANGE_WAIT_AFTER): wait for
331 * completion of writeout of all pages in the range. This will be used after an
332 * earlier SYNC_FILE_RANGE_WAIT_BEFORE|SYNC_FILE_RANGE_WRITE operation to wait
333 * for that operation to complete and to return the result.
334 *
c553ea4f
AG
335 * SYNC_FILE_RANGE_WAIT_BEFORE|SYNC_FILE_RANGE_WRITE|SYNC_FILE_RANGE_WAIT_AFTER
336 * (a.k.a. SYNC_FILE_RANGE_WRITE_AND_WAIT):
22f96b38
JA
337 * a traditional sync() operation. This is a write-for-data-integrity operation
338 * which will ensure that all pages in the range which were dirty on entry to
c553ea4f
AG
339 * ksys_sync_file_range() are written to disk. It should be noted that disk
340 * caches are not flushed by this call, so there are no guarantees here that the
341 * data will be available on disk after a crash.
22f96b38
JA
342 *
343 *
344 * SYNC_FILE_RANGE_WAIT_BEFORE and SYNC_FILE_RANGE_WAIT_AFTER will detect any
345 * I/O errors or ENOSPC conditions and will return those to the caller, after
346 * clearing the EIO and ENOSPC flags in the address_space.
347 *
348 * It should be noted that none of these operations write out the file's
349 * metadata. So unless the application is strictly performing overwrites of
350 * already-instantiated disk blocks, there are no guarantees here that the data
351 * will be available after a crash.
352 */
353int ksys_sync_file_range(int fd, loff_t offset, loff_t nbytes,
354 unsigned int flags)
355{
356 int ret;
357 struct fd f;
358
359 ret = -EBADF;
360 f = fdget(fd);
361 if (f.file)
362 ret = sync_file_range(f.file, offset, nbytes, flags);
363
364 fdput(f);
365 return ret;
366}
367
806cbae1
DB
368SYSCALL_DEFINE4(sync_file_range, int, fd, loff_t, offset, loff_t, nbytes,
369 unsigned int, flags)
370{
371 return ksys_sync_file_range(fd, offset, nbytes, flags);
372}
373
edd5cd4a
DW
374/* It would be nice if people remember that not all the world's an i386
375 when they introduce new system calls */
4a0fd5bf
AV
376SYSCALL_DEFINE4(sync_file_range2, int, fd, unsigned int, flags,
377 loff_t, offset, loff_t, nbytes)
edd5cd4a 378{
806cbae1 379 return ksys_sync_file_range(fd, offset, nbytes, flags);
edd5cd4a 380}