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 [pcp options] free [-bkmgroltV?] [-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 pcp options become indirectly available, see PCPIntro(1) for
19 their descriptions.
20
22 The available command line options are:
23
24 -b, --bytes
25 Display the amount of memory in bytes.
26
27 -c count, --samples=count
28 Terminate the display after count iterations. See also -s.
29
30 -g, --gigabytes
31 Display the amount of memory in gigabytes.
32
33 -k, --kilobytes
34 Display the amount of memory in kilobytes. This is the default.
35
36 -l Display detailed low and high memory statistics.
37
38 -m, --megabytes
39 Display the amount of memory in megabytes.
40
41 -o Disable the display of a "buffer adjusted" line. If the -o option
42 is not specified, free subtracts buffer memory from the used mem‐
43 ory and adds it to the free memory reported.
44
45 -r, --terabytes
46 Display the amount of memory in terabytes.
47
48 -s delay, --interval=delay
49 Activate continuous polling delay seconds apart. You may specify
50 any floating point number for delay, or indeed any valid pmPar‐
51 seInterval(3) specification, which includes microsecond resolution
52 delay times. This can be used in conjunction with the -c option.
53
54 -t, --total
55 Display a line containing the totals.
56
57 -V, --version
58 Display version number and exit.
59
60 -?, --help
61 Display usage message and exit.
62
64 pcp-free is inspired by the free(1) command and aims to be command line
65 and output compatible with it.
66
67 The shared memory column should be ignored; it is obsolete.
68
70 Environment variables with the prefix PCP_ are used to parameterize the
71 file and directory names used by PCP. On each installation, the file
72 /etc/pcp.conf contains the local values for these variables. The
73 $PCP_CONF variable may be used to specify an alternative configuration
74 file, as described in pcp.conf(5).
75
76 For environment variables affecting PCP tools, see pmGetOptions(3).
77
79 PCPIntro(1), pcp(1), free(1), pmParseInterval(3) and environ(7).
80
81
82
83Performance Co-Pilot PCP PCP-FREE(1)