kmtime(1)
NAME
kmtime - time control server for Performance Co-Pilot
SYNOPSIS
kmtime [-p port]
DESCRIPTION
kmtime is a graphical user interface for performance monitoring applications using the PCP infrastructure and requiring interactive time
control.
kmtime is not normally invoked directly by users. Rather, it is more
typical for it to be started by client applications (e.g. kmchart(1)
and pmval(1)).
There are two modes of interacting with a kmtime process - live host
mode, and historical archive mode. In archive mode the window presents
time controls suitable for manipulating the archive position, allowing
full VCR control to move forwards and backwards in time at configurable
rates and intervals. In live mode the kmtime window contains the simpler time controls suitable for live monitoring.
The arguments to kmtime are as follows:
- -p port is the port number which kmtime will use for communication
- with its clients (monitoring applications).
- Note that the kmtime window is only made visible when explicitly requested. Multiple client applications can be connected to a single kmtime server - when the final client application exits, kmtime will also exit.
ENVIRONMENT
When a port number is not explicitly requested on the command line via
the -p option, the environment variable KMTIME_PORT can be set to specify the port number from which available-port probing will commence
when kmtime is searching for a port number to use.
The default starting port number is 43334.
SEE ALSO
- PCPIntro(1), kmchart(1), and pmval(1).