PMLOGLABEL(1)               General Commands Manual              PMLOGLABEL(1)

<?><?><?> (NAME)
       pmloglabel - <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pmloglabel [-lLsv?] [-D debug] [-h hostname] [-p pid] [-V version] [-Z
       timezone] archive

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pmloglabel <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> Performance Co-Pilot
       (PCP) <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> archive <?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> pmlogger(1)
       <?><?><?><?><?> <?><?><?> <?><?><?><?>.

       <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> PCP (<?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?>)
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> PCP <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> pmloglabel
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.  <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> pmloglabel <?>
       pmlogextract <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> PCP
       <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> "*.index" <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

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

       -h hostname, --host=hostname
            <?><?><?><?><?> hostname <?><?><?><?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>.

       -l, --label
            <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
            <?><?><?><?> <?> <?><?><?><?><?> (<?><?><?><?>) <?><?><?><?><?><?>
            <?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
            <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

       -L   <?><?><?><?><?> -l<?> <?><?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.

       -p pid, --pid=pid
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?> pid<?> <?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>.

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

       -v, --verbose
            <?><?><?><?> <?><?><?><?>.  <?><?><?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -V version, --version=version
            <?><?><?> <?><?><?><?><?> <?><?><?><?> version <?><?> <?><?><?><?>
            <?><?><?> <?><?><?><?><?><?> (magic number) <?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?>.

       -Z timezone, --timezone=timezone
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> timezone <?><?>
            <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> TZ <?><?><?><?><?>
            <?><?> <?><?><?><?> <?><?> environ(7) <?><?><?> <?><?><?><?>
            <?><?><?> <?><?><?>.

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

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       pmloglabel <?><?> <?><?> <?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> (PID) <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> "20080125" <?><?><?><?> <?><?><?><?><?><?>.

                 $ pmlogdump -l 20080125
                 pmlogdump: Cannot open archive "20080125": Illegal label record at start of a PCP archive file
                 $ pmloglabel 20080125
                 Mismatched PID (5264/5011) between temporal index and data volume 0
                 $ pmloglabel -p 5264 20080125
                 $ pmlogdump -l 20080125
                 Log Label (Log Format Version 2)
                 Performance metrics from host fw1
                   commencing Fri Jan 25 00:10:09.341 2008
                   ending     Sat Jan 26 00:09:54.344 2008

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?> pmloglabel <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> 0 <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> 1
       <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> 2 <?><?><?><?><?> <?><?><?>.  <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> 3 <?><?><?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       $PCP_LOG_DIR/pmlogger/<hostname>
            <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?> PCP <?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
            <hostname>.

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

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       PCPIntro(1), pmlogcheck(1), pmlogdump(1), pmlogextract(1), pmlogger(1),
       pmlogger_check(1), pmlogger_daily(1), pmlogrewrite(1), pcp.conf(5) <?>
       pcp.env(5).


Performance Co-Pilot                  PCP                        PMLOGLABEL(1)