Section 1: user commands and tools
NAME pmeth – show a Perl class’s methods DESCRIPTION Given 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…
NAME pmerr – translate Performance Co-Pilot error codes into error messages SYNOPSIS pmerr code … pmerr -l DESCRIPTION pmerr 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”….
NAME pmempool – Persistent Memory Pool Management Tool SYNOPSIS pmempool [–help] [–version] <command> [<args>] DESCRIPTION The 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…
NAME pmempool-rm – Remove (unlink) poolset files SYNOPSIS pmempool rm [<options>] <file>.. DESCRIPTION The 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,…
NAME pmempool-info – Print basic information about Persistent Memory Pool file SYNOPSIS pmempool info [<options>] <file> DESCRIPTION The 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…
NAME pmempool-dump – Dump user data from specified pool SYNOPSIS pmempool dump [<options>] <file> DESCRIPTION The 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…
NAME pmempool-create – Create Persistent Memory Pool of specified type SYNOPSIS pmempool create [<options>] [<type>] [<bsize>] <file> DESCRIPTION The 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…
NAME pmempool-convert – Convert pool files from old layout versions to the newest one. SYNOPSIS pmempool convert <file> DESCRIPTION The 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…
NAME pmempool-check – Check and repair Persistent Memory Pool SYNOPSIS pmempool check [<options>] <file> DESCRIPTION The 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…
NAME pmdumptext – dump performance metrics to an ASCII table SYNOPSIS pmdumptext [-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 …] DESCRIPTION pmdumptext outputs the values of…
NAME pmdumplog – dump internal details of a performance metrics archive log SYNOPSIS pmdumplog [-adilLmMrstxz] [-n pmnsfile] [-S starttime] [-T endtime] [-Z timezone] archive [metricname …] pmdumplog [-v file] DESCRIPTION pmdumplog 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 pmdiff – compares archives and report significant differences SYNOPSIS pmdiff [-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] DESCRIPTION pmdiff compares the average values for every metric in either one or two sets of archives, in a given…
NAME pmdesc – print out version and whatis description of perl modules DESCRIPTION Given one or more module names, show the version number (if known) and the `whatis’ line, that is, the NAME section’s description, typically used for generation whatis databases. EXAMPLES $ pmdesc IO::Socket IO::Socket (1.25) – Object interface to socket communications $ oldperl…
NAME pmdbg – translate Performance Co-Pilot debug control flags SYNOPSIS pmdbg code … pmdbg -l pmdbg -D name[,name …] DESCRIPTION The components of the Performance Co-Pilot (PCP) use a global vector of bit-fields to control diagnostic and debug output. pmdbg with a -l argument prints out the mnemonic and decimal values of all the bit-fields…
NAME pmdazswap – zswap (compressed swap) PMDA DESCRIPTION pmdazswap is a Performance Metrics Domain Agent (PMDA) which exports metric values about compressed swap operation, as tracked by the zswap Linux kernel module. Zswap is a lightweight compressed cache for swap pages. It takes pages that are in the process of being swapped out and attempts…
NAME pmdazimbra – Zimbra Collaboration Suite (ZCS) PMDA DESCRIPTION pmdazimbra is a Performance Metrics Domain Agent (PMDA) which exports metric values from several subsystems of the Zimbra Suite. Further details on Zimbra can be found at http://www.zimbra.com/. INSTALLATION Install the zimbra PMDA by using the Install script as root: # cd $PCP_PMDAS_DIR/zimbra # ./Install To uninstall, do the…
NAME pmdaxfs – XFS filesystem performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/xfs/pmdaxfs [-d domain] [-l logfile] DESCRIPTION pmdaxfs is a Performance Metrics Domain Agent (PMDA) which extracts performance metrics describing the state of the XFS filesystem from the Linux kernel. The xfs PMDA exports metrics that measure information about metadata buffer usage, the journal, btree…
NAME pmdaweblog – performance metrics domain agent (PMDA) for Web server logs SYNOPSIS $PCP_PMDAS_DIR/weblog/pmdaweblog [-Cp] [-d domain] [-h helpfile] [-i port] [-l logfile] [-n idlesec] [-S num] [-t delay] [-u socket] [-U username] configfile DESCRIPTION pmdaweblog is a Performance Metrics Domain Agent (PMDA(3)) that scans Web server logs to extract metrics characterizing Web server activity….
NAME pmdavmware – VMware performance metrics domain agent (PMDA) DESCRIPTION pmdavmware is a Performance Metrics Domain Agent (PMDA) which exports metric values from a (possibly remote) VMware virtualisation host. This implementation uses the VMare Perl API (refer to the online docs at http://www.vmware.com/support/developer/viperltoolkit). VIPerl is a prerequisite for this PMDA, it needs to be installed…
NAME pmdaunbound – Unbound resolver PMDA DESCRIPTION pmdaunbound is a Performance Metrics Domain Agent (PMDA) which exports metric values about the Unbound DNS resolver using the unbound-control(8) stats_noreset command. This gives lots of insight into query types, response time, cache hits/misses, etc. Please see the unbound-control(8) man page for explanation about each statistics counter. Further…