PMTRACE(1)                  General Commands Manual                 PMTRACE(1)

<?><?><?> (NAME)
       pmtrace - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pmtrace [-q?] [-c value | -e command | -v value] [-h host] [-S state]
       tag

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pmtrace <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (PMDA) <?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> pcp_trace
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> pmtrace <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> PMDA <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> tag <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?>
       tag <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> trace.point
       <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:

       -c value
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> (value) <?><?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?><?><?><?><?> trace.count <?><?><?><?>
            <?><?><?>.

       -e command
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?> command
            <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.  <?><?> <?><?><?><?>
            <?><?> <?><?><?> command <?><?><?><?> <?><?><?><?> <?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.  <?><?><?><?><?><?><?>
            <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
            trace.transact <?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?>.

       -h host
            <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
            PMDA <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?>
            host <?><?><?><?><?><?> localhost.  <?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            PCP_TRACE_HOST <?><?> <?><?><?> <?><?><?><?><?><?>.

       -q   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
            <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> pmtrace
            <?><?> <?><?><?><?> (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>)
            <?><?><?><?> <?><?><?>.

       -S state
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?>
            <?><?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?><?> state
            <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
            pmtracestate(3) <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?>
            <?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?> strtol(3) <?><?><?><?>
            <?><?><?>.

       -v value
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?><?> (value) <?><?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?><?><?><?><?> trace.observe <?><?><?><?>
            <?><?><?>.

       -?   <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
            <?> <?><?><?><?>.

<?><?><?><?><?> (DIAGNOSTICS)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?> pmtrace <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> -e
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> command <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       $PCP_DEMOS_DIR/trace/pmtrace.c
            <?><?> <?><?><?><?> <?><?><?><?> pmtrace

<?><?><?><?> (ENVIRONMENT)
       <?><?> <?><?><?><?> <?><?> pmtrace <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> libpcp_trace <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       PCP_TRACE_HOST<?> PCP_TRACE_PORT <?> PCP_TRACE_TIMEOUT <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> pmdatrace(3) <?><?><?><?><?><?> <?><?><?><?>.

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pmcd(1)<?> pmdatrace(1)<?> pmprobe(1)<?> PMAPI(3) <?> pmdatrace(3).


Performance Co-Pilot                  PCP                           PMTRACE(1)