[ man7.org ](../../../index.html) > Linux > [ man-pages ](../index.html) |  [ Linux/UNIX system programming training ](http://man7.org/training/)  
---|---  
  
* * *

#  pmerr(1) — Linux manual page

NAME  |  SYNOPSIS  |  DESCRIPTION  |  OPTIONS  |  PCP ENVIRONMENT  |  SEE ALSO  |  COLOPHON   
---  
|  
      
    
    _PMERR_(1)                 General Commands Manual                _PMERR_(1)
    

##  NAME  top

    
    
           **pmerr** - translate Performance Co-Pilot error codes into error
           messages
    

##  SYNOPSIS  top

    
    
           **pmerr**[**-?**]  _code_ ...
           **pmerr -l**
    

##  DESCRIPTION  top

    
    
           **pmerr** accepts standard Performance Co-Pilot (PCP) error codes via
           the _code_ argument(s) and generates the corresponding error text.
    
           Each _code_ may be an integer, a hexadecimal value or a hexadecimal
           value prefixed by either ``0x'' or ``0X''.
    
           Error codes must be less than zero, so if _code_ is a positive
           number, a warning message is produced, and the negated value is
           used.
    

##  OPTIONS  top

    
    
           The available command line options are:
    
           **-l** , **--list**
                This alternative invocation causes all known error codes to
                be listed, along with their symbolic names and error text.
    
           **-?** , **--help**
                Display usage message and exit.
    

##  PCP ENVIRONMENT  top

    
    
           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by PCP.  On each
           installation, the file _/etc/pcp.conf_ contains the local values
           for these variables.  The **$PCP_CONF** variable may be used to
           specify an alternative configuration file, as described in
           [pcp.conf(5)](../man5/pcp.conf.5.html).
    

##  SEE ALSO  top

    
    
           [PMAPI(3)](../man3/PMAPI.3.html), [pmErrStr(3)](../man3/pmErrStr.3.html), [pcp.conf(5)](../man5/pcp.conf.5.html) and [pcp.env(5)](../man5/pcp.env.5.html).
    

##  COLOPHON  top

    
    
           This page is part of the _PCP_ (Performance Co-Pilot) project.
           Information about the project can be found at 
           â¨<http://www.pcp.io/>â©.  If you have a bug report for this manual
           page, send it to pcp@groups.io.  This page was obtained from the
           project's upstream Git repository
           â¨<https://github.com/performancecopilot/pcp.git>â© on 2023-12-22.
           (At that time, the date of the most recent commit that was found
           in the repository was 2023-12-16.)  If you discover any rendering
           problems in this HTML version of the page, or you believe there
           is a better or more up-to-date source for the page, or you have
           corrections or improvements to the information in this COLOPHON
           (which is _not_ part of the original manual page), send a mail to
           man-pages@man7.org
    
    Performance Co-Pilot               PCP                          _PMERR_(1)
    

* * *

Pages that refer to this page: [ pmcd(1) ](../man1/pmcd.1.html) , [ pmprobe(1)
](../man1/pmprobe.1.html) , [ pcpintro(3) ](../man3/pcpintro.3.html) , [
pmdiscoversetup(3) ](../man3/pmdiscoversetup.3.html) , [ pmerrstr(3)
](../man3/pmerrstr.3.html)

* * *

* * *

HTML rendering created 2023-12-22 by [ Michael Kerrisk ](https://man7.org/mtk/index.html) , author of [ _The Linux Programming Interface_ ](https://man7.org/tlpi/) .  For details of in-depth **Linux/UNIX system programming training courses** that I teach, look [ here ](https://man7.org/training/) .  Hosting by [ jambit GmbH ](https://www.jambit.com/index_en.html) .  |  |  [ ![Cover of TLPI](https://man7.org/tlpi/cover/TLPI-front-cover-vsmall.png) ](https://man7.org/tlpi/)  
---|---|---  
  
* * *

[ ![Web Analytics Made Easy -

StatCounter](https://c.