Section 1: user commands and tools
NAME pmprobe – lightweight probe for performance metrics SYNOPSIS pmprobe [-fIiLVvz] [-a archive] [-h hostname] [-K spec] [-n pmnsfile] [-O time] [-Z timezone] [metricname …] DESCRIPTION pmprobe determines the availability of performance metrics exported through the facilities of the Performance Co-Pilot (PCP). The metrics of interest are named in the metricname arguments. If metricname is…
NAME pmpost – append messages to the Performance Co-Pilot notice board SYNOPSIS $PCP_BINADM_DIR/pmpost message DESCRIPTION pmpost will append the text message to the end of the Performance Co-Pilot (PCP) notice board file ($PCP_LOG_DIR/NOTICES) in an atomic manner that guards against corruption of the notice board file by concurrent invocations of pmpost. The PCP notice board…
NAME pmpause, pmsleep – portable subsecond-capable sleep SYNOPSIS $PCP_BINADM_DIR/pmpause $PCP_BINADM_DIR/pmsleep interval DESCRIPTION pmpause sleeps indefinitely, until interrupted by SIGKILL. pmsleep sleeps for the specified interval. The interval argument follows the syntax described in PCPIntro(1) for -t, and in the simplest form may be an unsigned integer or floating point constant (the implied units in this…
NAME pmpath – show full path to a perl module SYNOPSIS pmpath module … DESCRIPTION For each module name given as an argument, produces its full path on the standard output, one per line. EXAMPLES $ pmpath CGI /usr/local/devperl/lib/5.00554/CGI.pm $ filsperl -S pmpath IO::Socket CGI::Carp /usr/local/filsperl/lib/5.00554/i686-linux-thread/IO/Socket.pm /usr/local/filsperl/lib/5.00554/CGI/Carp.pm $ oldperl -S pmpath CGI CGI::Imagemap /usr/lib/perl5/CGI.pm /usr/lib/perl5/site_perl/CGI/Imagemap.pm…
NAME pmount – mount arbitrary hotpluggable devices as normal user SYNOPSIS pmount [ options ] device pmount [ options ] device label pmount –lock [ options ] device pid pmount –unlock [ options ] device pid pmount DESCRIPTION pmount ("policy mount") is a wrapper around the standard mount program which permits normal users to mount…
NAME pmnsmerge – merge multiple versions of a Performance Co-Pilot PMNS SYNOPSIS $PCP_BINADM_DIR/pmnsmerge [-adfxv] infile […] outfile DESCRIPTION pmnsmerge merges multiple instances of a Performance Metrics Name Space (PMNS), as used by the components of the Performance Co-Pilot (PCP). Each infile argument names a file that includes the root of a PMNS, of the form…
NAME pmnsdel – delete a subtree of names from the Performance Co-Pilot PMNS SYNOPSIS $PCP_BINADM_DIR/pmnsdel [-n namespace] metricpath [ … ] DESCRIPTION pmnsdel removes subtrees of names from a Performance Metrics Name Space (PMNS), as used by the components of the Performance Co-Pilot (PCP). Normally pmnsdel operates on the default Performance Metrics Name Space (PMNS),…
NAME pmnsadd – add new names to the Performance Co-Pilot PMNS SYNOPSIS $PCP_BINADM_DIR/pmnsadd [-n namespace] file DESCRIPTION pmnsmerge(1) performs the same function as pmnsadd and is faster, more robust and more flexible. It is therefore recommended that pmnsmerge(1) be used instead. pmnsadd adds subtree(s) of new names into a Performance Metrics Name Space (PMNS), as…
NAME pmnewlog – stop and restart archive logging for PCP performance metrics SYNOPSIS $PCP_BINADM_DIR/pmnewlog [-a accessfile] [-C saveconfig] [-c configfile] [-N] [-n pmnsfile] [-P] [-p pid] [-s] [-V] [other pmlogger options] archive DESCRIPTION pmnewlog may be used to stop and restart a running instance of pmlogger(1). This is most useful for managing multiple sets of…
NAME pmmgr – pcp daemon manager SYNOPSIS pmmgr [-v] [-c config-directory] [-p polling-interval] [-l log-file] DESCRIPTION pmmgr manages a collection of PCP daemons for a set of discovered local and remote hosts running the Performance Metrics Collection Daemon (PMCD), according to zero or more configuration directories. It keeps a matching set of pmlogger, pmie, and…
NAME pmls – long list the module path DESCRIPTION This is mostly here for people too lazy to type $ ls -l `pmpath CGI` EXAMPLES $ pmls CGI – r– r– r– 1 root root 190901 Dec 6 03 : 19 / usr / local / devperl / lib / 5.00554 / CGI.pm $ oldperl…
NAME pmlogsummary – calculate averages of metrics stored in a set of PCP archives SYNOPSIS pmlogsummary [-abfFHiIlmMNsvxyz] [-B nbins] [-n pmnsfile] [-p precision] [-S starttime] [-T endtime] [-Z timezone] archive [metricname …] DESCRIPTION pmlogsummary prints statistical information about metrics of numeric type contained within the files of a set of Performance Co-Pilot (PCP) archive logs….
NAME pmlogrewrite – rewrite Performance Co-Pilot archives SYNOPSIS $PCP_BINADM_DIR/pmlogrewrite [-Cdiqsvw ] [-c config] inlog [outlog] DESCRIPTION pmlogrewrite reads a set of Performance Co-Pilot (PCP) archive logs identified by inlog and creates a PCP archive log in outlog. Under normal usage, the -c option will be used to nominate a configuration file or files that contains…
NAME pmlogreduce – temporal reduction of Performance Co-Pilot archives SYNOPSIS $PCP_BINADM_DIR/pmlogreduce [-z] [-A align] [-S starttime] [-s samples] [-T endtime] [-t interval] [-v volsamples] [-Z timezone] input output DESCRIPTION pmlogreduce reads one set of Performance Co-Pilot (PCP) archives identified by input and creates a temporally reduced PCP archive in output. input is a comma-separated list…
NAME pmlogmv – move (rename) Performance Co-Pilot archive files SYNOPSIS pmlogmv [-NV] oldname newname DESCRIPTION A Performance Co-Pilot (PCP) archive consists of multiple files as created by pmlogger(1). pmlogmv allows all the files of a single PCP archive to be moved or renamed as a group in a single operation. The oldname argument identifies the…
NAME pmloglabel – check and repair a performance metrics archive label SYNOPSIS pmloglabel [-Llsv] [-h hostname] [-p pid] [-V version] [-Z timezone] archive DESCRIPTION pmloglabel verifies, reports on, and can modify all details of the labels in each of the files of a Performance Co-Pilot (PCP) archive log. The archive log has the base name…
NAME pmlogger_check, pmlogger_daily, pmlogger_merge – administration of Performance Co-Pilot archive log files SYNOPSIS $PCP_BINADM_DIR/pmlogger_check [-CNsTV] [-c control] [-l logfile] $PCP_BINADM_DIR/pmlogger_daily [-NorV] [-c control] [-k discard] [-l logfile] [-m addresses] [-s size] [-t want] [-x compress] [-X program] [-Y regex] $PCP_BINADM_DIR/pmlogger_merge [-fNV] [input-basename … output-name] DESCRIPTION This series of shell scripts and associated control files may…
NAME pmlogger – create archive log for performance metrics SYNOPSIS pmlogger [-c configfile] [-h host] [-K spec] [-l logfile] [-L] [-m note] [-n pmnsfile] [-o] [-p pid] [-P] [-r] [-s endsize] [-t interval] [-T endtime] [-u] [-U username] [-v volsize] [-V version] [-x fd] [-y] archive DESCRIPTION pmlogger creates the archive logs of performance metric…
NAME pmlogextract – reduce, extract, concatenate and merge Performance Co-Pilot archives SYNOPSIS pmlogextract [-dfwz] [-c configfile] [-S starttime] [-s samples] [-T endtime] [-v volsamples] [-Z timezone] input […] output DESCRIPTION pmlogextract reads one or more Performance Co-Pilot (PCP) archive logs identified by input and creates a temporally merged and/or reduced PCP archive log in output….
NAME pmlogconf – create/edit a pmlogger configuration file SYNOPSIS pmlogconf [-cqrv] [-d groupsdir] [-h hostname] configfile DESCRIPTION pmlogconf may be used to create and modify a generic configuration file for the PCP archive logger, pmlogger(1). If configfile does not exist, pmlogconf will create a generic configuration file with a default set of enabled metrics and…