The -S
, -T
, -O
and -A
options may be used to define a time window
to restrict the samples retrieved, set an initial origin within
the time window, or specify a ``natural'' alignment of the sample
times; refer to PCPIntro(1)
for a complete description of these
options.
The other available options are:
-a
archive[,
archive,
...]]
Specify an archive from which metrics can be obtained for
a particular host. archive is the basename of an archive,
or the name of a directory conytaining archives,
previously created by pmlogger(1). Multiple sets of
archives (separated by commas or in different -a
options)
from different hosts may be given, but an error will occur
if there is more than one set of archives from the same
host. Any metrics that are not associated with a specific
host or archive in the configuration file will use the
first set of archives as their source.
-C
Parse the configuration file and exit before displaying
the pmview
window. Any errors in the configuration file
are displayed.
-c
configfile
Load the configuration from configfile rather than
standard input.
-h
host
Fetch performance metrics from pmcd(1) on host, rather
than the default localhost. Implies that pmview
will run
in live mode, so no archives can be specified on the
command line or in the configuration file. Only one -h
option may be given.
-n
pmnsfile
Normally pmview
operates on the distributed Performance
Metrics Name Space (PMNS), however if the -n
option is
specified an alternative local PMNS is loaded from the
file pmnsfile.
-p
port
Connect to the time controls (see pmtime(1)) on this port
.
Used when a tool launches another tool so that they can
connect to the same time controls.
-R
logconfig
Use logconfig as the pmlogger(1) config when recording.
-r
addconfig
Append addconfig onto the pmlogger(1) config generated by
pmview
when recording.
-t
interval
The update interval used to fetch metrics from the live or
archive sources. 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). The default is 2.0 seconds.
-x
version
Use the specified version of the pmlaunch
(5)
specification. The versions currently supported are
``1.0'' and the default version ``2.0''.
-Z
timezone
By default, pmview
reports the time of day according to
the local timezone on the system where pmview
is run. The
-Z
option changes the default timezone to timezone which
should be in the format of the environment variable TZ
as
described in environ(7).
-z
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
option, or the first -a
option.
-geometry
geometry
-display
display
-name
name
-title
title
-xrm "
resourceName: value"
Most standard X
(1) command line arguments may be used.