1PMTIME(1) General Commands Manual PMTIME(1)
2
3
4
6 pmtime - time control server for Performance Co-Pilot
7
9 pmtime [-?] [-p port]
10
12 pmtime is a graphical user interface for performance monitoring appli‐
13 cations using the PCP infrastructure and requiring interactive time
14 control.
15
16 pmtime is not normally invoked directly by users. Rather, it is more
17 typical for it to be started by client applications (e.g. pmchart(1),
18 pmstat(1) or pmval(1)).
19
20 There are two modes of interacting with a pmtime process - live host
21 mode, and historical archive mode. In archive mode the window presents
22 time controls suitable for manipulating the archive position, allowing
23 full VCR control to move forwards and backwards in time at configurable
24 rates and intervals. In live mode the pmtime window contains the sim‐
25 pler time controls suitable for live monitoring.
26
28 The arguments to pmtime are as follows:
29
30 -p port, --port=port
31 port is the port number which pmtime will use for communication
32 with its clients (monitoring applications).
33
34 -?, --help
35 Display usage message and exit.
36
37 Note that the pmtime window is only made visible when explicitly
38 requested. Multiple client applications can be connected to a single
39 pmtime server - when the final client application exits, pmtime will
40 also exit.
41
43 When a port number is not explicitly requested on the command line via
44 the -p option, the environment variable PMTIME_PORT can be set to spec‐
45 ify the port number from which available-port probing will commence
46 when pmtime is searching for a port number to use.
47
48 The default starting port number is 43334.
49
51 PCPIntro(1), pmchart(1), pmstat(1) and pmval(1).
52
53
54
55Performance Co-Pilot PMTIME(1)