Section 1: user commands and tools
NAME pmlogcheck – checks for invalid data in a PCP archive SYNOPSIS pmlogcheck [-lz] [-n pmnsfile] [-S start] [-T finish] [-Z timezone] archive DESCRIPTION pmlogcheck prints information about the nature of any invalid data which it detects in the files of a PCP archive. The archive has the base name archive and must have been…
NAME pmlock – simple file-based mutex SYNOPSIS $PCP_BINADM_DIR/pmlock [ -v ] file DESCRIPTION pmlock attempts to acquire an exclusive lock by creating file with a mode of 0. The exit status is 0 for success, 1 for failure. To release the lock, unlink file. In the event of a failure, the -v option produces an…
NAME pmload – show what files a given module loads at compile time DESCRIPTION Given an argument of a module name, show all the files that are loaded directly or indirectly when the module is used at compile-time. EXAMPLES $ pmload IO::Handle /usr/local/devperl/lib/5.00554/Exporter.pm /usr/local/devperl/lib/5.00554/Carp.pm /usr/local/devperl/lib/5.00554/strict.pm /usr/local/devperl/lib/5.00554/vars.pm /usr/local/devperl/lib/5.00554/i686-linux/DynaLoader.pm /usr/local/devperl/lib/5.00554/i686-linux/IO/Handle.pm /usr/local/devperl/lib/5.00554/Symbol.pm /usr/local/devperl/lib/5.00554/i686-linux/IO/File.pm /usr/local/devperl/lib/5.00554/SelectSaver.pm /usr/local/devperl/lib/5.00554/i686-linux/Fcntl.pm /usr/local/devperl/lib/5.00554/AutoLoader.pm /usr/local/devperl/lib/5.00554/i686-linux/IO.pm /usr/local/devperl/lib/5.00554/i686-linux/IO/Seekable.pm…
NAME pmlc – configure active Performance Co-Pilot pmlogger(s) interactively SYNOPSIS pmlc [-e] [-h host] [-i] [-n pmnsfile] [-P] [-p port] [-Z timezone] [-z] [pid] DESCRIPTION pmlc may be used to change those metrics and instances which a pmlogger(1) writes to a Performance Co-Pilot archive (see PCPIntro(1)), the frequency with which the metrics are collected and…
NAME pmkdir – make directory SYNOPSIS pmkdir [-d LEVEL] [-p DEVNAME] [-h] DIRECTORY DESCRIPTION pmkdir creates a directory on a device connected through SynCE. Forward slashes (‘/’) on the command line are converted to backward slashes (‘\’). OPTIONS -d LEVEL Set debug log level: 0 – No logging (default) 1 – Errors only 2 –…
NAME pminst – find modules whose names match this pattern SYNOPSIS pminst [-s] [-l] [pattern] DESCRIPTION Without arguments, show the names of all installed modules. Given a pattern, show all module names that match it. The -l flag will show the full pathname. The -s flag will separate the base directory from @INC from the…
NAME pminfo – display information about performance metrics SYNOPSIS pminfo [-dfFLmMtTvxz] [-a archive] [-b batchsize] [-c dmfile] [-h hostname] [-K spec] [–[n|N] pmnsfile] [-O time] [-Z timezone] [metricname …] DESCRIPTION pminfo displays various types of information about performance metrics available through the facilities of the Performance Co-Pilot (PCP). Normally pminfo operates on the distributed Performance…
NAME pminclude – show the include path for modules (@INC) DESCRIPTION This is mostly here for people too lazy to type: $ perl -V | tail EXAMPLES $ pminclude /etc/perl /usr/local/lib/perl/5.14.2 /usr/local/share/perl/5.14.2 /usr/lib/perl5 /usr/share/perl5 /usr/lib/perl/5.14 /usr/share/perl/5.14 /usr/local/lib/site_perl SEE ALSO pmls(1), pmpath(1) AUTHORS and COPYRIGHTS Copyright (C) 2013-2014 Mark Leighton Fisher. LICENSE This is free software;…
NAME pmiestatus – display information from pmie stats file SYNOPSIS pmiestatus statsfile […] DESCRIPTION pmiestatus displays information used to identify a running pmie process. It is mostly used by pmie_check and pmie_daily when they hunt for instances of pmie to check against the control file. FILES $PCP_TMP_DIR/pmie/* pmie stats files PCP ENVIRONMENT Environment variables with…
NAME pmieconf – display and set configurable pmie rule variables SYNOPSIS pmieconf [-cFv] [-f file] [-r rulepath] [command [args…]] DESCRIPTION pmieconf is a utility for viewing and configuring variables from generalized pmie(1) rules. The set of generalized rules is read in from rulepath, and the output file produced by pmieconf is a valid input file…
NAME pmie_check, pmie_daily – administration of the Performance Co-Pilot inference engine SYNOPSIS $PCP_BINADM_DIR/pmie_check [-CNsV] [-c control] [-l logfile] $PCP_BINADM_DIR/pmie_daily [-NV] [-c control] [-k discard] [-l logfile] [-m addresses] [-x compress] [-X program] [-Y regex] DESCRIPTION This series of shell scripts and associated control files may be used to create a customized regime of administration and…
NAME pmie2col – convert pmie output to multi-column format SYNOPSIS pmie2col [-d delimiter] [-p precision] [-w width] DESCRIPTION pmie2col is a simple tool that converts output from pmie(1) into regular column format. Each column is 7 characters wide (by default, may be changed with the -w option) with a single space between columns. That single…
NAME pmie – inference engine for performance metrics SYNOPSIS pmie [-bCdefHqVvWxz] [-A align] [-a archive] [-c filename] [-h host] [-l logfile] [-j stompfile] [-n pmnsfile] [-O offset] [-S starttime] [-T endtime] [-t interval] [-U username] [-Z timezone] [filename …] DESCRIPTION pmie accepts a collection of arithmetic, logical, and rule expressions to be evaluated at specified…
NAME pmhostname – report hostname SYNOPSIS $PCP_BINADM_DIR/pmhostname [hostname] DESCRIPTION pmhostname reports the name of the host hostname as returned by gethostbyname(3). If hostname is not specified, then the local host name is retrieved using gethostname(2) and this is than passed to gethostbyname(3). pmhostname provides a service for shell scripts that mimics the logic formerly used…
NAME pmgetopt – Performance Co-Pilot shell script option parser SYNOPSIS $PCP_BINADM_DIR/pmgetopt [-c|–config file] [-p|–progname name] [-u|–usage] [—] [parameters] DESCRIPTION pmgetopt is used to perform command line option parsing for shell scripts used in the Performance Co-Pilot (PCP toolkit). It is also used to generate usage messages for those scripts. The parameters given to pmgetopt take…
NAME pmgenmap – generate C code to simplify handling of performance metrics SYNOPSIS pmgenmap [infile] DESCRIPTION Given one or more lists of metric names in infile or on standard input, pmgenmap generates C declarations and cpp(1) macros suitable for use across the Performance Metrics Programming Interface (PMAPI) on standard output. The declarations produced by pmgenmap…
NAME pmfunc – cat out a function from a module DESCRIPTION Given a fully-qualified function, this program opens up the file and attempts to cat out the source for that function. EXAMPLES $ pmfunc Cwd::getcwd sub getcwd { abs_path(‘.’); } RESTRICTIONS Only subroutines that are defined in the normal fashion are seen, since a simple…
NAME pmfind – find PCP services on the network SYNOPSIS pmfind [-q] [-m mechanism] [-s service] [-r] [-t timeout] DESCRIPTION pmfind searches for instances of the specified PCP service being advertised on the network and prints a list of URLs corresponding to the services discovered. By default pmfind will search for all supported PCP services,…
NAME pmexp – show a module’s exports DESCRIPTION Given a module name, this program identifies which symbols are automatically exported (in that package’s @EXPORT), those which are optionally exported (in that package’s @EXPORT_OK), and also lists out the import groups (in that package’s %EXPORT_TAGS hash). EXAMPLES $ pmexp Text::ParseWords Text::ParseWords automatically exports shellwords, quotewords, nested_quotewords,…
NAME pmval, pmevent – arbitrary performance metrics value dumper SYNOPSIS pmval [-dgLrvz] [-A align] [-a archive] [-f N] [-h host] [-i instances] [-K spec] [-n pmnsfile] [-O offset] [-p port] [-S starttime] [-s samples] [-T endtime] [-t interval] [-U archive] [-w width] [-x pattern] [-Z timezone] metricname DESCRIPTION pmval prints current or archived values for…