LIBPFM(3)

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>