.TH LIBPFM 3  "November, 2003" "" "Linux Programmer's Manual"
.SH NAME
pfm_get_version \- get performance monitoring library version
.SH SYNOPSIS
.nf
.B #include <perfmon/pfmlib.h>
.sp
.BI "int pfm_get_version(unsigned int *"version);
.sp
.SH DESCRIPTION
This function can be called at any time to get the revision
level of the library. The version is encoded into an
unsigned integer and returned in the \fBversion\fR argument.
A revision number is composed of two fields: a major number
and a minor number. Both can be extracted from the returned
argument using macros provided in the header file:
.TP
.B PFMLIB_MAJ_VERSION(v)
returns the major number encoded in v.
.TP
.B PFMLIB_MIN_VERSION(v)
returns the minor number encoded in v.
.SH RETURN
The function returns whether or not it was successful.
A return value of \fBPFMLIB_SUCCESS\fR indicates success, 
otherwise the value is the error code.
.SH ERRORS
.TP
.B PFMLIB_ERR_INVAL 
the argument is invalid, most likely a NULL pointer.
.SH AUTHOR
Stephane Eranian <eranian@hpl.hp.com>
.PP