PMGETOPT(1)                 General Commands Manual                PMGETOPT(1)

<?><?><?> (NAME)
       pmgetopt - <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       Performance Co-Pilot

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       $PCP_BINADM_DIR/pmgetopt [-u?] [-c file] [-D debug] [-p name] [--]
       [parameters]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pmgetopt <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> Performance Co-Pilot (<?><?><?><?><?><?>
       <?><?><?><?><?> PCP) <?><?> <?><?><?> <?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       (<?><?><?><?><?><?>) <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       pmgetopt <?><?> <?><?> <?><?><?> <?><?><?><?><?>: <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> pmgetopt <?><?><?><?><?> <?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> -- <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       (<?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> "$@" <?><?><?><?>
       <?><?><?><?><?><?><?>).

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

       -c=file, --config=file
            <?><?> file <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
            <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
            <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
            <?><?><?><?><?> <?><?> pmconfig <?><?><?><?><?>
            <?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?> <?><?><?>
            <?><?><?><?><?><?> pmconfig <?><?><?><?><?><?><?><?> <?><?><?>
            <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       -p=name, --progname=name
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?> <?><?>
            <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> pmgetopt
            <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
            name <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?>.

       -u, --usage
            <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
            <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?> <?><?><?><?><?> <?><?><?>.

       -?, --help
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?> <?><?><?><?> pmgetopt <?> <?><?><?><?>.

       pmgetopt <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       (source <?><?><?><?>) <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> pmgetopt <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (-?) <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> (--) <?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> getopt<?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> $OPTARG
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> eval<?> set <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> shift <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> pmgetopt
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?> <?><?><?><?><?> -?<?> --help)
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> - <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> (#) <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> (<?><?> <?><?>
       <?><?><?><?>) <?><?><?><?> <?><?><?><?><?><?><?>.  <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:
       getopt (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>)<?>
       usage (<?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> progname <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>)<?> <?> end <?><?> <?><?> pmgetopt
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?> - <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> PCP<?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> PCPIntro(1) <?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       <?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       (<?><?><?><?> <?><?><?><?> --host) <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> (<?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
       <?> <?><?><?><?>).

       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> (<<=>>)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?>.  <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>:

            # Usage: [options] node...

            Options:
                --archive
                -d, --delay            pause between updates for archive replay
                --host
                --interval
                -i=INST, --insts=INST  comma-separated metrics instance list
                -r                     output raw counters (no rate conversion)
                --width=N              set the width of each column of output
                --timezone
                --help


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

            $ pmgetopt --usage --progname=clusterstat -- "$@"
            Usage: clusterstat [options] node...

            Options:
              -a FILE, --archive=FILE
                                    metrics source is a PCP archive
              -d, --delay           pause between updates for archive replay
              -h HOST, --host=HOST  metrics source is PMCD on host
              -t DELTA, --interval=DELTA
                                    sampling interval
              -i INST, --insts=INST comma-separated metrics instance list
              -r                    output raw counters (no rate conversion)
              --width=N             set the width of each column of output
              -Z TZ, --timezone=TZ  set reporting timezone
              -?, --help            show this usage message and exit


       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> pmgetopt
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> PCP <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> pcp(1) <?> pmlogmv(1)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

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

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pcp(1)<?> pmlogmv(1)<?> pmgetopt_r(3)<?> pcp.conf(5) <?> pcp.env(5).


Performance Co-Pilot                  PCP                          PMGETOPT(1)