pcu.git  about / heads / tags
page cache utilities for Linux
blob e0d907517d401233d80b9f548fa9869067eed502 1405 bytes (raw)
$ git show HEAD:pcu-mincore.1.txt	# shows this blob on the CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
% PCU-MINCORE(1) Page Cache Utilities Manual
% Eric Wong <normalperson@yhbt.net>
% July 26, 2009

# NAME
pcu-mincore - shows cache status for given files

# SYNOPSIS
pcu-mincore [-o OFFSET] [-l LENGTH] [-s] FILE...

# DESCRIPTION
A command-line interface to the mincore(2) syscall to inspect
whether or not certain pages belonging to a file are cached in
resident memory.

# OPTIONS
-o OFFSET
:   Scan only pages on or after the given offset.
    This offset is rounded down to the previous page offset.
    The default offset is zero (beginning of the file)

-l LENGTH
:    Check only the given length in bytes.
    This length is rounded up next page offset.
    The default is to scan the entire file.

-s
:   Display the summary output as a floating point number between
    0.0 and 1.0 representing the percentage of the file in core.

# OUTPUT
The following output is displayed unless "-s" summary format
is chosen.

One line for every page scanned in the following format:

   \<filename\>: \<offset\> \<incore\>

offset is a hexadecimal number for a given range of PAGE_SIZE bytes.
incore is a boolean value indicating whether or not the page beginning
at a particular offset is cached in resident memory or not.

# ENVIRONMENT
none

# SEE ALSO
[`mincore`(2)][2]

# BUGS
None known. Email <pcu@librelist.com> if you find any.

[2]: http://kernel.org/doc/man-pages/online/pages/man2/mincore.2.html

git clone https://yhbt.net/pcu.git