1PCP-FREE(1) General Commands Manual PCP-FREE(1)
2
3
4
6 pcp-free - report on free and used memory in the system
7
9 pcp free [-bkmgoltV] [-c count] [-s interval]
10
12 pcp-free gives a summary display of the total amount of free and used
13 physical memory and swap in the system, as well as the caches used by
14 the kernel.
15
16 When invoked via the pcp(1) command, the -h/--host, -a/--archive,
17 -O/--origin, -s/--samples, -t/--interval, -Z/--timezone and several
18 other options become indirectly available.
19
20 Options
21 The -b/--bytes switch displays the amount of memory in bytes; the
22 -k/--kilobytes switch (set by default) displays it in kilobytes; the
23 -m/--megabytes switch displays it in megabytes.
24
25 The -t/--total switch displays a line containing the totals.
26
27 The -o switch disables the display of a "buffer adjusted" line. If the
28 -o option is not specified, free subtracts buffer memory from the used
29 memory and adds it to the free memory reported.
30
31 The -s/--interval switch activates continuous polling delay seconds
32 apart. You may specify any floating point number for delay, or indeed
33 any valid pmParseInterval(3) specification, which includes microsecond
34 resolution delay times. This can be used in conjunction with the
35 -c/--samples option to terminate the display after count iterations.
36
37 The -l switch shows detailed low and high memory statistics.
38
39 The current version of pcp-free can be queried using the -V/--version
40 option.
41
43 pcp-free is inspired by the free(1) command and aims to be command line
44 and output compatible with it.
45
46 The shared memory column should be ignored; it is obsolete.
47
49 pcp(1), free(1), PCPIntro(1), pmParseInterval(3) and environ(7).
50
51
52
53Performance Co-Pilot PCP PCP-FREE(1)