Blame src/libpfm-3.y/docs/man3/pfm_initialize.3
|
Packit Service |
a1973e |
.TH LIBPFM 3 "November, 2003" "" "Linux Programmer's Manual"
|
|
Packit Service |
a1973e |
.SH NAME
|
|
Packit Service |
a1973e |
pfm_initialize \- initialize performance monitoring library
|
|
Packit Service |
a1973e |
.SH SYNOPSIS
|
|
Packit Service |
a1973e |
.nf
|
|
Packit Service |
a1973e |
.B #include <perfmon/pfmlib.h>
|
|
Packit Service |
a1973e |
.sp
|
|
Packit Service |
a1973e |
.BI "int pfm_initialize(void);"
|
|
Packit Service |
a1973e |
.sp
|
|
Packit Service |
a1973e |
.SH DESCRIPTION
|
|
Packit Service |
a1973e |
This is the first function that a program using the library
|
|
Packit Service |
a1973e |
\fBmust\fR call otherwise the library will not function at all.
|
|
Packit Service |
a1973e |
This function probes the host PMU and initialize the internal
|
|
Packit Service |
a1973e |
state of the library. In the case of a multi-threaded application,
|
|
Packit Service |
a1973e |
this function needs to be called only once, most likely by the initial
|
|
Packit Service |
a1973e |
thread.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.SH RETURN
|
|
Packit Service |
a1973e |
The function returns whether or not it was successful, i.e., the
|
|
Packit Service |
a1973e |
host PMU has been correctly identified and is supported. A return
|
|
Packit Service |
a1973e |
value of \fBPFMLIB_SUCCESS\fR indicates success, otherwise the value is
|
|
Packit Service |
a1973e |
an error code.
|
|
Packit Service |
a1973e |
.SH ERRORS
|
|
Packit Service |
a1973e |
.TP
|
|
Packit Service |
a1973e |
.B PFMLIB_ERR_NOTSUPP
|
|
Packit Service |
a1973e |
the host
|
|
Packit Service |
a1973e |
PMU is not supported.
|
|
Packit Service |
a1973e |
.SH AUTHOR
|
|
Packit Service |
a1973e |
Stephane Eranian <eranian@hpl.hp.com>
|
|
Packit Service |
a1973e |
.PP
|