pmie – inference engine for performance metrics Synopsispmie [-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 …] Descriptionpmie accepts a collection of arithmetic, logical, and rule expressions to be evaluated at specified frequencies. The base…
pmhostname – report hostname Synopsis$PCP_BINADM_DIR/pmhostname [hostname] Descriptionpmhostname 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 by Performance Co-Pilot…
pmgetopt – Performance Co-Pilot shell script option parser Synopsis$PCP_BINADM_DIR/pmgetopt [-c|–config file] [-p|–progname name] [-u|–usage] [—] [parameters] Descriptionpmgetopt 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 two forms: initially,…
pmgenmap – generate C code to simplify handling of performance metrics Synopsispmgenmap [infile] DescriptionGiven 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 simplify the coding…
pmfunc – cat out a function from a module DescriptionGiven 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(‘.’); }RestrictionsOnly subroutines that are defined in the normal fashion are seen, since a simple pattern-match is what does…
pmfind – find PCP services on the network Synopsispmfind [-q] [-m mechanism] [-s service] [-r] [-t timeout] Descriptionpmfind 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, however a specific…
pmexp – show a module’s exports DescriptionGiven 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, and parse_line…
pmval, pmevent – arbitrary performance metrics value dumper Synopsispmval [-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 Descriptionpmval prints current or archived values for the nominated performance…
pmeth – show a Perl class’s methods DescriptionGiven a class name, print out all methods available to that class. It does this by loading in the class module, and walking its symbol table and those of its ancestor classes. A regular method call shows up simply: $ pmeth IO::Socket | grep ‘^con’ confess configure connect…
pmerr – translate Performance Co-Pilot error codes into error messages Synopsispmerr code … pmerr -l Descriptionpmerr accepts standard Performance Co-Pilot (PCP) error codes via the code argument(s) and generates the corresponding error text. Each code may be an integer, a hexadecimal value or a hexadecimal value prefixed by either “0x” or “0X”. Error codes must…
pmempool – Persistent Memory Pool Management Tool Synopsispmempool [–help] [–version] <command> [<args>] DescriptionThe pmempool is a management tool for Persistent Memory pool files created by NVML libraries. The main purpose of pmempool is to provide a user with a set of utilities for off-line analysis and manipulation of pools created by pmem libraries. The pmempool…
pmempool-rm – Remove (unlink) poolset files Synopsispmempool rm [<options>] <file>.. DescriptionThe pmempool invoked with rm command removes (unlinks) all files specified in command line arguments. If the specified file is a poolset file all parts will be removed. All files are removed using the unlink (3) call. Without specifying the -i|–interactive option, the rm command…
pmempool-info – Print basic information about Persistent Memory Pool file Synopsispmempool info [<options>] <file> DescriptionThe pmempool invoked with info command analyzes an existing pool created by NVML libraries. The main task of this command is to print all usable information from pool headers and user data in human readable format. It automatically recognizes pool type…
pmempool-dump – Dump user data from specified pool Synopsispmempool dump [<options>] <file> DescriptionThe pmempool invoked with dump command dumps user data from specified pool file. The output format may be either binary or hexadecimal. By default the output format is hexadecimal. By default data is dumped to standard output. It is possible to dump data…
pmempool-create – Create Persistent Memory Pool of specified type Synopsispmempool create [<options>] [<type>] [<bsize>] <file> DescriptionThe pmempool invoked with create command creates a pool file of specified type. Depending on a pool type it is possible to provide more properties of pool. Valid pool types are: blk, log and obj which stands for pmemblk, pmemlog…
pmempool-convert – Convert pool files from old layout versions to the newest one. Synopsispmempool convert <file> DescriptionThe pmempool invoked with the convert command performs a conversion of the specified pool to the newest layout supported by this tool. Currently only libpmemobj(3) pools are supported. It is advised to have a backup of the pool before…
pmempool-check – Check and repair Persistent Memory Pool Synopsispmempool check [<options>] <file> DescriptionThe pmempool invoked with check command checks consistency of a given pool file. If the pool file is consistent pmempool exits with 0 value. If the pool file is not consistent non-zero error code is returned. In case of any errors, the proper…
pmdumptext – dump performance metrics to an ASCII table Synopsispmdumptext [-CFGHilmMNoruXz] [-A align] [-a archive[,archive,…]] [-c config] [-d delimiter] [-f format] [-h host] [-n pmnsfile] [-O offset] [-P precision] [-R lines] [-s sample] [-S starttime] [-t interval] [-T endtime] [-U string] [-w width] [-Z timezone] [metric …] Descriptionpmdumptext outputs the values of performance metrics collected…
pmdumplog – dump internal details of a performance metrics archive log Synopsispmdumplog [-adilLmMrstxz] [-n pmnsfile] [-S starttime] [-T endtime] [-Z timezone] archive [metricname …] pmdumplog [-v file] Descriptionpmdumplog dumps assorted control, metadata, index and state information from the files of a Performance Co-Pilot (PCP) archive log. The archive log has the base name archive and…
pmdiff – compares archives and report significant differences Synopsispmdiff [-d/–keep] [-z/–hostzone] [-p/–precision precision] [-q/–threshold thres] [-S/–start starttime] [-T/–finish endtime] [-B/–begin starttime] [-E/–end endtime] [-x metric] [-X file] [–skip-excluded] [–skip-missing] [-Z/–timezone timezone] archive1 [archive2] Descriptionpmdiff compares the average values for every metric in either one or two sets of archives, in a given time window, for…