PMDADM(1)                   General Commands Manual                  PMDADM(1)

<?><?><?> (NAME)
       pmdadm - <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (PMDA) <?><?><?><?> Device Mapper

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       $PCP_PMDAS_DIR/dm/pmdadm [-D debug]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pmdadm <?><?> <<<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>>> (PMDA) <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> Device
       Mapper <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> PMDA <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> dmsetup(8) <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (API) dmstats
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> dmstats(8) <?><?><?><?><?>
       <?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> device-mapper <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?> rc.local <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>).  <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> (overhead) <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> pmdadm
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?> (INSTALLATION)
       <?><?><?><?> DM PMDA <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> Install <?><?> <?><?><?><?><?><?> <?><?><?><?>
       (root) <?><?><?> <?><?><?><?>:

           # cd $PCP_PMDAS_DIR/dm
           # ./Install

       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>:

           # cd $PCP_PMDAS_DIR/dm
           # ./Remove

       <?><?><?><?><?> pmdadm <?><?><?><?> pmcd(1)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> Install <?> Remove <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> pmcd
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?> PMDA <?><?> dmstats API (<?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> device-mapper <?><?> <?><?><?><?>
       <?><?><?><?><?><?>) <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> device-mapper <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> PMDA<?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> device-mapper <?><?> <?><?><?><?>
       <?><?><?><?><?><?> (libdevmapper) <?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> dmstats(8) <?><?><?><?>
       <?><?><?><?><?>.  <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> device-mapper <?><?><?><?>
       PCP<?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (statistics
       regions) <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> device-
       mapper<?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:

            # dmstats create --alldevices

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>:

            # dmstats create --alldevices --bounds histogram_boundaries

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> ns<?> us<?> ms <?><?> s <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

            # dmstats create --alldevices --bounds 10us,30us,50us,70us,90us

       <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       dmstats(8) <?><?><?><?>.

<?><?><?><?><?><?><?> (METRICS)
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (Basic Counters)
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?> /proc/diskstats <?><?> /sys/block/*/*/stat
           <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.

           dmstats.read
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.reads_merged
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.read_bytes
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.reads_time
               <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.write
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.writes_merged
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.write_bytes
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.writes_time
               <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?> <?><?><?><?><?><?> device-mapper.

           dmstats.in_progress
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?><?> device-mapper.

           dmstats.io_ticks
               <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?><?> device-mapper.

           dmstats.queue_ticks
               <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> I/O<?>
               <?><?><?><?><?> I/O<?> <?><?><?><?><?> I/O<?> <?><?>
               <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?> <?><?><?><?><?> I/O<?><?><?> <?><?>
               <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?> I/O <?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.
               <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
               <?><?><?><?> <?><?><?><?><?> I/O <?> <?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?> (backlog) <?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
               <?><?><?> <?><?><?><?><?>.

           dmstats.read_ticks
               <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?><?> device-mapper.

           dmstats.write_ticks
               <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?><?> device-mapper.

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (Histogram fields)
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> I/O
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (bin)
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           devicename<?> <?><?><?><?><?> <?><?><?><?><?> (region id) <?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

           dmstats.histogram.hist_count
               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               I/O<?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?>.

           dmstats.histogram.hist.bins
               <?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       # dmstats create looptest0 --bounds 10us,30us,50us
       looptest0: Created new region with 1 area(s) as region ID 0

       # pminfo -f dmstats.read dmstats.histogram.hist_count

       dmstats.read
           inst [0 or "looptest0"] value 4099

       dmstats.histogram.hist_count
           inst [0 or "looptest0:0:0s"] value 1
           inst [1 or "looptest0:0:10us"] value 3752
           inst [2 or "looptest0:0:30us"] value 250
           inst [3 or "looptest0:0:50us"] value 96

<?><?><?><?><?><?><?> (FILES)
       $PCP_PMDAS_DIR/dm/help
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> dm

       $PCP_PMDAS_DIR/dm/Install
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> pmdadm

       $PCP_PMDAS_DIR/dm/Remove
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           pmdadm

       $PCP_LOG_DIR/pmcd/dm.log
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> pmdadm

<?><?><?><?> PCP (PCP ENVIRONMENT)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> PCP_
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> PCP <?><?> <?><?><?>
       <?><?><?><?><?><?><?>. <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       /etc/pcp.conf <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?> $PCP_CONF
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> pcp.conf(5)
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (DEBUGGING
       OPTIONS)
       <?><?><?><?><?> -D <?><?> --debug <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> stderr
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>.  debug <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> pmdbg(1)
       <?><?><?><?><?> <?><?> <?><?><?><?><?> -l <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       PCPIntro(1)<?> pmcd(1)<?> pmstore(1)<?> dmsetup(8) <?> dmstats(8).


Performance Co-Pilot                  PCP                            PMDADM(1)