1PCP-FREE(1)                 General Commands Manual                PCP-FREE(1)
2
3
4

NAME

6       pcp-free - report on free and used memory in the system
7

SYNOPSIS

9       pcp [pcp options] free [-bkmgroltV?]  [-c count] [-s interval]
10

DESCRIPTION

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

OPTIONS

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

NOTES

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

PCP ENVIRONMENT

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

SEE ALSO

79       PCPIntro(1), pcp(1), free(1), pmParseInterval(3) and environ(7).
80
81
82
83Performance Co-Pilot                  PCP                          PCP-FREE(1)
Impressum