pfm_initialize - initialize performance monitoring library


SYNOPSIS

       #include <perfmon/pfmlib.h>

       int pfm_initialize(void);


DESCRIPTION

       This is the  first  function  that  a  program  using  the
       library  must call otherwise the library will not function
       at all.  This function will probe the host CPU  and  auto­
       matically  detect  which  PMU  it  has.  All internal data
       structures will be initialized as a result of this call.


RETURN

       The function returns whether or  not  it  was  successful,
       i.e.,  the  host  PMU has been correctly identified and is
       supported. A return value of PFMLIB_SUCCESS indicates suc­
       cess, otherwise the value is an error code.


ERRORS

       PFMLIB_ERR_NOTSUPP
              the host PMU is not supported.


AUTHOR

       Stephane Eranian <eranian@hpl.hp.com>


Man(1) output converted with man2html