PMGENMAP(1)                 General Commands Manual                PMGENMAP(1)

<?><?><?> (NAME)
       pmgenmap - <?><?><?><?><?> <?><?> C <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pmgenmap [infile]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> infile <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> pmgenmap
       <?><?><?><?><?><?><?><?><?> C <?> <?><?><?><?><?><?><?><?> cpp(1)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <<<?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>>> (PMAPI) <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       pmgenmap <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> PMAPI
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

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

            listname {
                metricname1 symbolname1
                metricname2 symbolname2
                ...
            }

       <?><?> <?><?><?><?><?><?><?><?><?> C <?> cpp(1) <?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>:

            char *listname[] = {
            #define symbolname1 0
                "metricname1",
            #define symbolname2 1
                "metricname2",
                ...
            };

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> pmLookupName(3) <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       #define <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> vset <?><?> <?><?> <?><?><?><?><?><?>
       pmResult <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> pmFetch(3)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?> <?><?> listname <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> C <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       symbolname <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> cpp(1)
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> metricname <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> PMNS(5) <?><?><?><?><?><?>
       <?><?><?><?>).

       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> sh <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <<#>> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> C
       <?><?> <?><?><?> K&R <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>:


            # leading block of multi-line comments
            # initialization group
            foo {
                    a.b.c   ONE
                    d.e.f.g TWO
                    # embedded block of multi-lines
                    # comments and boring pad text
                    xx.yy.zz        THREE
            }

            # trailing single line comment


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

            /*
             * leading block of multi-line comments
             * initialization group
             */
            char *foo[] = {
            #define ONE 0
                    "a.b.c",
            #define TWO 1
                    "d.e.f.g",
            /*
             * embedded block of multi-lines
             * comments and boring pad text
             */
            #define THREE 2
                    "xx.yy.zz",

            };


            /* trailing single line comment */

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?> <?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>

            mystats {
                kernel.percpu.cpu.idle     IDLE
                kernel.percpu.cpu.sys      SYS
                kernel.percpu.cpu.user     USER
                hinv.ncpu                       NCPU
            }

       <?><?> C <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> #include <?><?><?><?> <?><?><?><?><?> <?><?><?>:

            /*
             * Performance Metrics Name Space Map
             * Built by pmgenmap from the file
             * mystats.metrics
             * on Wed Dec 28 19:44:17 EST 1994
             *
             * Do not edit this file!
             */

            char *mystats[] = {
            #define IDLE    0
                    "kernel.percpu.cpu.idle",
            #define SYS     1
                    "kernel.percpu.cpu.sys",
            #define USER    2
                    "kernel.percpu.cpu.user",
            #define NCPU    3
                    "hinv.ncpu",

            };

       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> pmgenmap<?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <<<?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>>>
       (PMCS) <?><?> <?><?><?> <?><?><?><?><?>:


            #define MAX_PMID 4

                int         trip = 0;
                int         numpmid = sizeof(mystats)/sizeof(mystats[0]);
                double      duration;
                pmResult    *resp;
                pmResult    *prev;
                pmID        pmidlist[MAX_PMID];

                pmNewContext(PM_CONTEXT_HOST, "localhost");
                pmLookupName(numpmid, mystats, pmidlist);
                pmFetch(numpmid, pmidlist, &resp);

                printf("%d CPUs: %d usr   %d sys   %d   idle0,
                       resp->vset[NCPU]->vlist[0].value.lval,
                       resp->vset[USER]->vlist[0].value.lval,
                       resp->vset[SYS]->vlist[0].value.lval,
                       resp->vset[IDLE]->vlist[0].value.lval);

       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> - <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       pmLookupDesc(3) <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> pmgenmap <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> PCP <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> $PCP_DEMOS_DIR/pmclient.

<?><?><?><?><?><?><?> (FILES)
       $PCP_VAR_DIR/pmns/*
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
            PMNS

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       cpp(1)<?> PMAPI(3)<?> pmFetch(3)<?> pmLookupName(3)<?>
       pmNewContext(3)<?> pcp.conf(5)<?> pcp.env(5) <?> PMNS(5).


Performance Co-Pilot                  PCP                          PMGENMAP(1)