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