trusty (3) pfm_initialize.3.gz

NAME

       pfm_initialize - initialize library

SYNOPSIS

       #include <perfmon/pfmlib.h>

       int pfm_initialize(void);

DESCRIPTION

       This is the first function that a program must call otherwise the library will not function at all.  This
       function probes the underlying hardware looking for  valid  PMUs  event  tables  to  activate.   Multiple
       distinct PMU tables may be activated at the same time.

       The function must be called only once.

RETURN

       The  function  returns  whether  or not it was successful, i.e., at least one PMU was activated. A return
       value of PFMLIB_SUCCESS indicates success, otherwise the value is an error code.

ERRORS

       PFMLIB_ERR_NOTSUPP
              No PMU was activated.

AUTHOR

       Stephane Eranian <eranian@gmail.com>

                                                 September, 2009                                       LIBPFM(3)