pcp-uptime(1)

pcp-uptime1

Tell how long the system has been running

Usage

pcp [pcp options] uptime [-V?]

Overview

pcp-uptime gives a one line display of the following information. The current time, how long the system has been running, how many users are currently logged on, and the system load averages for the past 1, 5, and 15 minutes.

When invoked via the pcp(1) command, the -h/ --host, -a/ --archive, -O/ --origin, -Z/ --timezone and several other pcp options become indirectly available.

Options

The available command line options are:

-V, --version

Display version number and exit.

-?, --help

Display usage message and exit.

When replaying from an archive using the -a option, the required information may not be available at the default starting time, in which case the reported values will be ``?''. In this case, use the -S or -O options to move the starting time into a point in the archive where the required information is available.

Notes

pcp-uptime is inspired by the uptime(1) command and aims to be command line and output compatible with it.

PCP environment

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

For environment variables affecting PCP tools, see pmGetOptions(3).

Releases

6 releases since Debian 8 (Jessie); the text changed 3 times.

  1. 8
  2. 10
  3. 11–13
  4. Arch

--help since Debian 11 (Bullseye); --version since Debian 11 (Bullseye); -? since Debian 11 (Bullseye); -V since Debian 11 (Bullseye).

From pcp 7.2.2-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.