blob: 6a2af1f1b0d0b23f9a99aee3a4bc33429df12048 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
.TH PMTIME 1 "" "Performance Co-Pilot"
.SH NAME
\f3pmtime\f1 \- time control server for Performance Co-Pilot
.SH SYNOPSIS
\f3pmtime\f1
[\f3\-p\f1 \f2port\f1]
.SH DESCRIPTION
.B pmtime
is a graphical user interface for performance monitoring applications
using the PCP infrastructure and requiring interactive time control.
.PP
.B pmtime
is not normally invoked directly by users.
Rather, it is more typical for it to be started by client applications
(e.g.
.BR pmchart (1)
and
.BR pmval (1)).
.PP
There are two modes of interacting with a
.B pmtime
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
.B pmtime
window contains the simpler time controls suitable for
live monitoring.
.PP
The arguments to
.B pmtime
are as follows:
.TP 5
.B \-p
.I port
is the port number which
.B pmtime
will use for communication with its clients (monitoring applications).
.PP
Note that the
.B pmtime
window is only made visible when explicitly requested.
Multiple client applications can be connected to a single
.B pmtime
server \- when the final client application exits,
.B pmtime
will also exit.
.SH ENVIRONMENT
When a port number is not explicitly requested on the command line
via the
.B \-p
option, the environment variable
.I PMTIME_PORT
can be set to specify the port number from which available-port
probing will commence when
.B pmtime
is searching for a port number to use.
.PP
The default starting port number is 43334.
.SH SEE ALSO
.BR PCPIntro (1),
.BR pmchart (1),
and
.BR pmval (1).
|
