PMTIME(1)                  General Commands Manual                 PMTIME(1)

NAME         top

       pmtime - time control server for Performance Co-Pilot

SYNOPSIS         top

       pmtime [-p port]

DESCRIPTION         top

       pmtime is a graphical user interface for performance monitoring
       applications using the PCP infrastructure and requiring interactive
       time control.

       pmtime is not normally invoked directly by users.  Rather, it is more
       typical for it to be started by client applications (e.g.  pmchart(1)
       and pmval(1)).

       There are two modes of interacting with a 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 pmtime
       window contains the simpler time controls suitable for live

       The arguments to pmtime are as follows:

       -p   port is the port number which pmtime will use for communication
            with its clients (monitoring applications).

       Note that the pmtime window is only made visible when explicitly
       requested.  Multiple client applications can be connected to a single
       pmtime server - when the final client application exits, pmtime will
       also exit.

ENVIRONMENT         top

       When a port number is not explicitly requested on the command line
       via the -p option, the environment variable PMTIME_PORT can be set to
       specify the port number from which available-port probing will
       commence when pmtime is searching for a port number to use.

       The default starting port number is 43334.

SEE ALSO         top

       PCPIntro(1), pmchart(1), and pmval(1).

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨⟩ on
       2017-09-15.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to

Performance Co-Pilot                                               PMTIME(1)

Pages that refer to this page: pcpintro(1)pmchart(1)pmdumptext(1)pmstat(1)pmval(1)pmview(1)pcpintro(3)pmtime(3)pmview(5)