PMDABASH(1)                 General Commands Manual                PMDABASH(1)

<?><?><?> (NAME)
       pmdabash - <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> Bourne-Again

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       $PCP_PMDAS_DIR/bash/pmdabash [-C] [-D debug] [-d domain] [-l logfile]
       [-I interval] [-t timeout] [-U username] configfile

<?><?><?><?><?><?><?> (DESCRIPTION)
       pmdabash <?><?> <<<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>>> (PMDA) <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <<xtrace>> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> bash(1)
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> set -x <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (PID) <?><?><?><?><?> <?><?> <?><?>
       <?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?> bash <?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?> <?><?><?>.

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

       -d   <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> ( domain ) <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?>.  <?><?>
            <?><?><?> <?><?><?><?> <?><?> domain <?><?><?><?> <?><?><?><?>
            <?><?> PMDA <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?> domain
            <?><?><?><?> <?><?><?><?> <?><?><?><?> PMDA <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       -l   <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> (log).
            <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> pmdabash <?><?> <?><?><?><?>
            <?><?><?> <?><?> <?><?><?> bash.log <?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> pmcd(1) <?><?><?><?>
            $PCP_LOG_DIR/pmcd <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
            <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?><?><?>.

       -s   <?><?><?> <?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?>)
            <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?>(<?><?><?>) <?><?><?><?>
            <?><?><?><?><?><?> <?><?>.  <?><?><?><?><?><?><?> <?>
            <?><?><?><?><?> <?><?><?>.

       -m   <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> (<?><?><?> <?><?>
            <?><?><?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?>).  <?><?><?><?><?><?><?> <?>
            <?><?><?><?><?><?><?> <?><?><?>.

       -U   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
            <?><?> <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?>
            <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> PCP <?><?><?><?>
            <?><?><?><?><?><?><?><?> "pcp" <?><?><?><?> <?><?><?> <?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> ("root")
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?><?>.

<?><?><?> (INSTALLATION)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> bash
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> (root) <?><?><?><?><?>
       <?><?><?><?>:

            # cd $PCP_PMDAS_DIR/bash
            # ./Install

       <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> (<?><?><?> <<<?><?><?><?><?> <?><?>
       (INSTRUMENTATION)>> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>)
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> (root) <?><?><?><?><?> <?><?><?><?>:

            # cd $PCP_PMDAS_DIR/bash
            # ./Remove

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

<?><?><?><?><?> <?><?> (INSTRUMENTATION)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> bash(1) <?> pmdabash<?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?>:

            #!/bin/sh
            source $PCP_DIR/etc/pcp.env
            source $PCP_SHARE_DIR/lib/bashproc.sh

            pcp_trace on $@       # enable tracing
            echo "awoke, $count"

            pcp_trace off         # disable tracing

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

            $ pminfo bash
            bash.xtrace.numclients
            bash.xtrace.maxmem
            bash.xtrace.queuemem
            bash.xtrace.count
            bash.xtrace.records
            bash.xtrace.parameters.pid
            bash.xtrace.parameters.parent
            bash.xtrace.parameters.lineno
            bash.xtrace.parameters.function
            bash.xtrace.parameters.command

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> pmevent(1) <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?>:

            $ pmevent -t 1 -x '' bash.xtrace.records
            host:      localhost
            samples:   all
            bash.xtrace.records["4538 ./test-trace.sh 1 2 3"]: 5 event records
              10:00:05.000 --- event record [0] flags 0x19 (point,id,parent) ---
                bash.xtrace.parameters.pid 4538
                bash.xtrace.parameters.parent 4432
                bash.xtrace.parameters.lineno 43
                bash.xtrace.parameters.command "true"
              10:00:05.000 --- event record [1] flags 0x19 (point,id,parent) ---
                bash.xtrace.parameters.pid 4538
                bash.xtrace.parameters.parent 4432
                bash.xtrace.parameters.lineno 45
                bash.xtrace.parameters.command "((  count++  ))"
              10:00:05.000 --- event record [2] flags 0x19 (point,id,parent) ---
                bash.xtrace.parameters.pid 4538
                bash.xtrace.parameters.parent 4432
                bash.xtrace.parameters.lineno 46
                bash.xtrace.parameters.command "echo 'awoke, 3'"
              10:00:05.000 --- event record [3] flags 0x19 (point,id,parent) ---
                bash.xtrace.parameters.pid 4538
                bash.xtrace.parameters.parent 4432
                bash.xtrace.parameters.lineno 47
                bash.xtrace.parameters.command "tired 2"
              10:00:05.000 --- event record [4] flags 0x19 (point,id,parent) ---
                bash.xtrace.parameters.pid 4538
                bash.xtrace.parameters.parent 4432
                bash.xtrace.parameters.lineno 38
                bash.xtrace.parameters.function "tired"
                bash.xtrace.parameters.command "sleep 2"

<?><?><?><?><?><?><?> (FILES)
       $PCP_PMCDCONF_PATH
                 <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> pmdabash
       $PCP_PMDAS_DIR/bash/help
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> bash
       $PCP_PMDAS_DIR/bash/Install
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
                 pmdabash
       $PCP_PMDAS_DIR/bash/Remove
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
                 pmdabash
       $PCP_LOG_DIR/pmcd/bash.log
                 <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?> pmdabash

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

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

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

       +----------------+-------------------------------------------------------------------------------------------------------------------------------+
       |<?><?><?><?><?> | <?><?><?><?><?><?><?>                                                                                                         |
       +----------------+-------------------------------------------------------------------------------------------------------------------------------+
       |appl0           | <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> (verbose) <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> |
       +----------------+-------------------------------------------------------------------------------------------------------------------------------+
<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bash(1)<?> pmevent(1) <?> pmcd(1).


Performance Co-Pilot                  PCP                          PMDABASH(1)