The available command line options are:
-a archive, --archive=archive
Performance metric values are retrieved from the set of
Performance Co-Pilot (PCP) archive logs identified by this
option, by default. The argument is a comma-separated list
of names, each of which may be the base name of an archive
or the name of a directory containing one or more archives.
The resulting set of archives will be the source of the
performance metrics. The initial Tab created will be an
archive mode Tab. Multiple -a options can be presented, and
the resulting list of sets of archives is used for sourcing
metric values. Any sources listed on the command line are
assumed to be sets of archives if this option is used.
-A align, --align=align
Force the initial sample to be aligned on the boundary of a
natural time unit align. Refer to PCPIntro(1) for a
complete description of the syntax for align.
--archive-folio=folio
Read metric source archives from the PCP archive folio.
-c configfile, --view=configfile
configfile specifies an initial view to load, using the
default source of metrics. Multiple -c views can be
specified, and they will all be opened in the default Tab
with the default source of metrics.
-c, --check
Used with -c, the view(s) are parsed, any errors are
reported, and the tool exits. This is primarily intended
for testing purposes. If a second -C option is presented,
pmchart also connects to pmcd(1) to check the semantics of
metrics.
-f family, --font-family=family
Specify the default font family to be used in several chart
components, such as the chart title, legend, and Y-axis
label. The default value is "Sans Serif". This setting
does not affect the rest of the user interface, where the
value is inherited from the environment in which pmchart
operates, and differs according to the look-and-feel of each
platform.
-F point, --font-size=point
Specify the default font point size to be used in several
chart components, such as the chart title, legend, and Y-
axis label. The default is platform dependent, but is
either 7, 8 or 9. This setting does not affect the rest of
the user interface.
-g geometry, --geometry=geometry
Generate image with the specified geometry (width and
height). This option is only useful when used in
conjunction with the -o option for generating an output
image. The geometry argument takes the form "WxH" (e.g.
240x120). When NOT using the -o flag, to specify the
display window geometry, use -geometry geometry where
geometry specifies the desired window width, height and
optional placement.
-h host, --host=host
Current performance metric values are retrieved from the
nominated host machine by default. Multiple -h options can
be presented, and the list of hosts is used for sourcing
metric values. Any sources listed on the command line are
assumed to be hosts if this option is used.
-H path, --hostsfile=path
Specify the path to a file containing a set of hostnames
where pmcd(1) is running , rather than using the default
localhost.
-K spec, --spec-local=spec
When fetching metrics from a local context (see -L), the -K
option may be used to control the DSO PMDAs that should be
made accessible. The spec argument conforms to the syntax
described in pmSpecLocalPMDA(3). More than one -K option
may be used.
-L, --local-PMDA
Use a local context to collect metrics from DSO PMDAs on the
local host without PMCD. See also -K.
-n pmnsfile, --namespace=pmnsfile
Load an alternative Performance Metrics Name Space (PMNS(5))
from the file pmnsfile.
-o outfile, --output=outfile
Generate an image file named outfile, and then exit. This
is most useful when run with a set of archives and one or
more views. The generated image will be in the format
specified as the file extension (automatically determined
from outfile). If no extension can be determined, then the
GIF format is used and the generated file is named with this
extension. The supported image file formats include: bmp,
jpeg, jpg, png, ppm, tif, tiff, xbm, and xpm.
-O origin, --origin=origin
When reporting archived metrics, start reporting at origin
within the time window (see -S and -T). Refer to
PCPIntro(1) for a complete description of the syntax for
origin.
-p port, --guiport=port
port number for connection to an existing pmtime time
control process.
-s samples, --samples=samples
Specifies the number of samples that will be retained before
discarding old data (replaced by new values at the current
time position). This value can subsequently be modified
through the Edit Tab dialog.
-S starttime, --start=starttime
When reporting archived metrics, the report will be
restricted to those records logged at or after starttime.
Refer to PCPIntro(1) for a complete description of the
syntax for starttime.
-t interval, --interval=interval
Sets the inital update interval to something other than the
default 1 second. The interval argument follows the syntax
described in PCPIntro(1), and in the simplest form may be an
unsigned integer (the implied units in this case are
seconds).
-T endtime, --finish=endtime
When reporting archived metrics, the report will be
restricted to those records logged before or at endtime.
Refer to PCPIntro(1) for a complete description of the
syntax for endtime.
-v samples, --visible=samples
Sets the initial visible samples that will be displayed in
all charts in the default Tab. This value must be less than
or equal to the total number of samples retained (the -s
value).
-V, --version
Display pmchart version number and exit
-W, fB--white
Export images using an opaque(white) background
-z, --hostzone
Change the reporting timezone to the local timezone at the
host that is the source of the performance metrics, as
identified via either the -h or -a options.
-Z timezone, --timezone=timezone
By default, pmtime reports the time of day according to the
local timezone on the system where pmchart is run. The -Z
option changes the timezone to timezone in the format of the
environment variable TZ as described in environ(7).
-?, --help
Display usage message and exit.
