pmtime(1) — Linux manual page


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), pmstat(1) or 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

OPTIONS         top

       The available command line options are:

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

       -?, --help
            Display usage message and exit.

       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), pmstat(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
       2020-11-01.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-10-30.)  If you discover any
       rendering problems in this HTML version 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 manual page), send a mail to

Performance Co-Pilot                                               PMTIME(1)

Pages that refer to this page: pcpintro(1)PCPIntro(1)pcp-vmstat(1)pmchart(1)pmevent(1)pmstat(1)pmval(1)pmview(1)pcpintro(3)PCPIntro(3)pmFreeOptions(3)pmGetContextOptions(3)pmgetoptions(3)pmGetOptions(3)pmgetopt_r(3)pmtime(3)pmTimeConnect(3)pmTimeDisconnect(3)pmTimeRecv(3)pmTimeSendAck(3)pmTimeShowDialog(3)pmUsageMessage(3)pmview(5)