---
name: "kmtime"
section: "1"
platform: "linux"
package: "kmchart"
version: "1.2.7"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/kmtime"
---

# kmtime(1)

time control server for Performance Co-Pilot

}

## NAME

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

## SYNOPSIS

**kmtime** \[**-p** *port*\]

## DESCRIPTION

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

**kmtime** is not normally invoked directly by users. Rather, it is more typical for it to be started by client applications (e.g. [**kmchart**(1)](/kmchart/1.md) and [**pmval**(1)](/pmval/1.md)).

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

The arguments to **kmtime** are as follows:

- **-p**

  *port* is the port number which **kmtime** will use for communication with its clients (monitoring applications).

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

## ENVIRONMENT

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

The default starting port number is 43334.

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**kmchart**(1)](/kmchart/1.md), and [**pmval**(1)](/pmval/1.md).