pfm_strerror(3) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| RETURN \| ERRORS \| AUTHOR \| COLOPHON

LIBPFM(3)               Linux Programmer's Manual               LIBPFM(3)

NAME top

       pfm_strerror - return constant string describing error code

SYNOPSIS top

       #include <perfmon/pfmlib.h>

       const char *pfm_strerror(int code);

DESCRIPTION top

       This function returns a string which describes the libpfm error
       value in code. The string returned by the call is read-only.

       The function must only be used with libpfm calls documented to
       return specific error codes. The value -1 is not considered a
       specific error code.  Strings and pfm_pmu_t return values cannot
       be used with this function.  Typically NULL is returned in case of
       error for string values, and PFM_PMU_NONE is returned for
       pfm_pmu_t values.

       The function is also not designed to handle OS system call errors,
       i.e., errno values.

RETURN top

       The function returns a pointer to the constant string describing
       the error code. The string is in English. If code is invalid then
       a default error message is returned.

ERRORS top

       If the error code is invalid, then the function returns a pointer
       to a string which says "unknown error code".

AUTHOR top

       Stephane Eranian <eranian@gmail.com>

COLOPHON top

       This page is part of the perfmon2 (a performance monitoring
       library) project.  Information about the project can be found at
       ⟨http://perfmon2.sourceforge.net/⟩.  If you have a bug report for
       this manual page, send it to perfmon2-devel@lists.sourceforge.net.
       This page was obtained from the project's upstream Git repository
       ⟨git://git.code.sf.net/p/perfmon2/libpfm4 perfmon2-libpfm4⟩ on
       2025-02-02.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-01-27.)  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

                             September, 2009                    LIBPFM(3)