pcu-fsync: add support for syncfs() on Linux (-f flag)
[pcu.git] / README
blobe78b2e9c9c3dc63f4c6620270aa0d4a10e786022
1 pcu - Page Cache Utilities
2 ==========================
4 This package contains command-line utilities for viewing/managing the
5 kernel page cache.
7 * [pcu-fadvise(1)](pcu-fadvise.1.html) - runs [posix_fadvise(2)][1]
8   on given files
9 * [pcu-mincore(1)](pcu-mincore.1.html) - shows the pages in the page cache
10   for given files via [mmap(2)][3] and [mincore(2)][2].
12 See manpages for the individual commands for more details.  Neither
13 command requires privileges other than read access to the files
14 specified on the command-line.
16 Download
17 --------
18 You may also browse the source code or obtain tarballs from cgit or gitweb:
20 * <http://bogomips.org/pcu.git>
21 * <http://repo.or.cz/w/pcu.git>
23 Contact
24 -------
25 Please direct all bug reports/questions/patches/comments to <pcu@librelist.com>
27 Mailing list archives are available as gzipped mbox files at
28 <http://bogomips.org/pcu/archives/> in addition to the
29 [librelist.com](http://librelist.com)-provided Maildir archives at
30 <http://librelist.com/archives/pcu/>.
32 Source
33 ------
34 You may clone the source repository via [git](http://git-scm.com):
36 * git://bogomips.org/pcu.git
37 * git://repo.or.cz/pcu.git (mirror)
39 License
40 -------
41 pcu is 100% Free Software.
42 Copyright Eric Wong <normalperson@yhbt.net> and contributors.
43 It is covered under the [GNU General Public License,
44 version 2](http://gnu.org/licenses/gpl-2.0.html).
46 [1]: http://opengroup.org/onlinepubs/009695399/functions/posix_fadvise.html
47 [2]: http://kernel.org/doc/man-pages/online/pages/man2/mincore.2.html
48 [3]: http://opengroup.org/onlinepubs/009695399/functions/mmap.html