Makefile: remove --sanitize-html for pandoc
[pcu.git] / pcu-fsync.1.txt
blob3cafe08a58e053002517f80c836457fc44217a05
1 % PCU-FSYNC(1) Page Cache Utilities Manual
2 % Eric Wong <normalperson@yhbt.net>
3 % Jan 26, 2010
5 # NAME
6 pcu-fsync - synchronizes a files in-core state with storage device
8 # SYNOPSIS
9 pcu-fsync [-D] [-d] [-f] FILE...
11 # DESCRIPTION
12 A command-line interface to the fsync(2) and fdatasync(2) system calls
13 to flush modified buffers for a given file to the underlying storage device.
14 This is useful for explicitly flushing files to the storage device when
15 using applications that fail to explicitly do so.
17 # OPTIONS
19 :   Flush the directory containing the file as well as the file
20     itself.  This is useful and needed if the file was recently
21     rename(2)-ed or created.
24 :   Flush data (but not metadata) using fdatasync(2).  This is for
25     special cases where applications do not require the performance
26     overhead of flushing metadata to the storage device.
29 :   Flush data on the filesystem containing the specified file
30     (or directory).  This uses the syncfs(2) syscall under Linux,
31     and falls back to sync(2) if unavailable.
33 # OUTPUT
34 Errors only.
36 # ENVIRONMENT
37 None.
39 # SEE ALSO
40 [`fsync`(2)][1]
41 [`fdatasync`(2)][2]
43 # BUGS
44 None known. Email <pcu@librelist.com> if you find any.
46 [1]: http://kernel.org/doc/man-pages/online/pages/man2/fsync.2.html
47 [2]: http://kernel.org/doc/man-pages/online/pages/man2/fdatasync.2.html