1LIBPFM(3) Linux Programmer's Manual LIBPFM(3)
2
6 pfm_initialize - initialize performance monitoring library
7
9 #include <perfmon/pfmlib.h>
10 int pfm_initialize(void);
12
15 This is the first function that a program using the library must call
16 otherwise the library will not function at all. This function will
17 probe the host CPU and automatically detect which PMU it has. All
18 internal data structures will be initialized as a result of this call.
19 In the case of a multi-threaded application, this function needs to be
20 called only once, most likely by the initial thread.
21
25 The function returns whether or not it was successful, i.e., the host
26 PMU has been correctly identified and is supported. A return value of
27 PFMLIB_SUCCESS indicates success, otherwise the value is an error code.
28
30 PFMLIB_ERR_NOTSUPP
31 the host PMU is not supported.
32
34 Stephane Eranian <eranian@hpl.hp.com>
35 November, 2003 LIBPFM(3)