# pmtime

## NAME



           **pmtime** - time control server for Performance Co-Pilot
    


## SYNOPSIS



           **pmtime**[**-D** _debug_] [**-V?**]  [**-p** _port_]
    


## DESCRIPTION



           **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 monitoring.
    
           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.
    


## OPTIONS



           The available command line options are:
    
           **-p** _port_ , **--guiport** =_port_
                _port_ is the port number which **pmtime** will use for
                communication with its clients (monitoring applications).
    
           **-V** , **--version**
                Display version number and exit.
    
           **-?** , **--help**
                Display usage message and exit.
    


## ENVIRONMENT



           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**.
    


## DEBUGGING OPTIONS



           The **-D** or **--debug** option enables the output of additional
           diagnostics on _stderr_ to help triage problems, although the
           information is sometimes cryptic and primarily intended to provide
           guidance for developers rather end-users.  _debug_ is a comma
           separated list of debugging options; use pmdbg(1) with the **-l**
           option to obtain a list of the available debugging options and
           their meaning.
    
           Debugging options specific to **pmtime** are as follows:
           ┌────────┬───────────────────────────────────────────────────────┐
           │ **Option** │ **Description** │
           ├────────┼───────────────────────────────────────────────────────┤
           │ **appl0** │ enable internal diagnostics that report all **pmtime** │
           │        │ events, e.g. setting timezone, state changes,         │
           │        │ interval changes, timescale changes, etc.             │
           └────────┴───────────────────────────────────────────────────────┘
    


* * *