PCU-MINCORE(1) Page Cache Utilities Manual

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)

BUGS

None known. Email pcu@librelist.com if you find any.