PMDATRACE(1)                General Commands Manual               PMDATRACE(1)

<?><?><?> (NAME)
       pmdatrace - <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       $PCP_PMDAS_DIR/trace/pmdatrace [-D debug] [-d domain] [-l logfile] [-A
       access] [-I port] [-M username] [-N buckets] [-T period] [-U units]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> pmdatrace <?><?> <<<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>>> (PMDA) <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> pcp_trace
       (<?><?><?><?><?><?><?><?><?><?><?><?> <?><?> pmdatrace(3))
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

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

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

       -l   <?><?><?> <?><?><?><?> <?><?><?><?><?> (log). <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?> <?><?><?> trace.log <?><?> <?><?><?><?><?><?><?><?><?>
            <?><?><?><?> pmcd(1) <?><?> <?><?><?><?><?> <?><?><?><?> pmdatrace
            (<?><?><?><?> $PCP_LOG_DIR/pmcd) <?><?><?><?><?>
            <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?>.

       -A   <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?><?> <?><?><?><?> pmdatrace.  <?><?><?><?><?> access
            <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
            <?><?> <?><?><?><?><?><?><?> <?><?> allow:hostspec:maxconns <?><?>
            disallow:hostspec <?><?><?><?><?> <?><?> <?><?> <?><?> `allow' <?>
            `disallow' <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            `hostspec' <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
            <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
            <?><?> <?><?><?> pmcd(1) <?> pmlogger(1) <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?> `maxconns' <?><?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
            `hostspec' <?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?> <?><?>
            <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
            `hostspec' <?><?><?><?><?><?> <?><?><?>.

       -I   <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> pcp_trace
            <?><?> <?><?><?><?> port <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?> $PCP_TRACE_PORT <?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
            (<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -I <?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>).
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> 4323 <?><?><?>.

       -T   <?><?><?><?><?> period <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?>
            (<?><?><?><?><?><?><?>) <?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> PCPIntro(1)
            <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> -t <?><?> PCP
            <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> 30 seconds
            <?><?> 1 min.  <?><?><?><?><?><?><?> 60 <?><?><?><?><?> <?><?><?>.

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

       -N   <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            period <?><?> <?><?><?><?><?><?><?> bucket <?><?><?><?><?>
            <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?>
            <?><?> period/bucket <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
            <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
            -T 60 <?> -N 12 <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
            <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?>.

       -U   <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?> (dimension) <?> <?><?><?><?><?> (scale)
            <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.
            <?><?><?><?><?> units <?><?> <?><?><?><?> <?><?><?><?><?><?>
            <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?>: <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
            <?><?><?><?><?>.  <?><?><?><?> <?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> ``none'' <?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> ``0,0,0,0,0,0'' <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?> -U <?><?><?><?><?><?><?>.
            <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -d (<?><?><?>
            <?><?><?><?><?>) <?><?> pminfo(1) <?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?>.  <?><?><?><?><?><?><?> Install <?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
            <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?><?><?> units <?><?>
            <?><?><?><?><?><?><?> Install <?><?><?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> period <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

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

            # cd $PCP_PMDAS_DIR/trace
            # ./Install

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

            # cd $PCP_PMDAS_DIR/trace
            # ./Remove

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

<?><?><?><?><?><?><?> (FILES)
       $PCP_PMCDCONF_PATH
                 <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> pmdatrace
       $PCP_PMDAS_DIR/trace/help
                 <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
                 trace
       $PCP_DEMOS_DIR/trace/*
                 <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
                 <?><?><?><?><?><?><?><?> pcp_trace <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?>
       $PCP_PMDAS_DIR/trace/Install
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
                 pmdatrace
       $PCP_PMDAS_DIR/trace/Remove
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
                 pmdatrace
       $PCP_LOG_DIR/pmcd/trace.log
                 <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?>
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?> pmdatrace

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

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

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

       +----------------+-----------------------------------------------------+
       |<?><?><?><?><?> | <?><?><?><?><?><?><?>                               |
       +----------------+-----------------------------------------------------+
       |appl0           | <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>     |
       |                | <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> IPC<?>  |
       |                | <?><?><?><?><?><?><?><?><?>                         |
       |                | <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>        |
       |                | <?><?><?><?><?><?><?>                               |
       +----------------+-----------------------------------------------------+
       |appl1           | <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>     |
       |                | <?><?><?><?><?><?><?><?> <?><?><?>                  |
       +----------------+-----------------------------------------------------+
<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       PCPIntro(1)<?> pmcd(1)<?> pmtrace(1)<?> PMAPI(3) <?> pmdatrace(3).


Performance Co-Pilot                  PCP                         PMDATRACE(1)