1LIBPFM(3)                  Linux Programmer's Manual                 LIBPFM(3)
2
3
4

NAME

6       pfm_initialize - initialize library
7

SYNOPSIS

9       #include <perfmon/pfmlib.h>
10
11       int pfm_initialize(void);
12
13

DESCRIPTION

15       This  is  the  first  function  that  a program must call otherwise the
16       library will not operate.  This function probes the underlying hardware
17       looking  for valid PMU event tables to activate.  Multiple distinct PMU
18       tables may be activated at the same time.
19
20       The function must be called only once. If the function is  called  more
21       than  once,  it  does not execute the initialization multiple times, it
22       simply returns the same value as for the first call.
23
24

RETURN

26       The function returns whether or not it was successful, i.e.,  at  least
27       one  PMU was activated. A return value of PFMLIB_SUCCESS indicates suc‐
28       cess, otherwise the value is an error code.
29

ERRORS

31       PFMLIB_ERR_NOTSUPP
32              No PMU was activated.
33

AUTHOR

35       Stephane Eranian <eranian@gmail.com>
36
37                                September, 2009                      LIBPFM(3)