PAPILIBRARYSUPPORTEDCALL(3PAPI) PAPI Library Functions

NAME

papiLibrarySupportedCall, papiLibrarySupportedCalls - determine if a
PAPI function returns valid data

SYNOPSIS

cc [ flag... ] file... -lpapi [ library... ]
#include <papi.h>

char papiLibrarySupportedCall(const char *name);


char **papiLibrarySupportedCalls(void);

PARAMETERS

name
the name of a PAPI function

DESCRIPTION

The papiLibrarySupportedCall() function queries to determine if a
particular PAPI function returns valid data other than
PAPI_OPERATION_NOT_SUPPORTED.


The papiLibrarySupportedCalls() function enumerates all PAPI
functions that return valid data other than
PAPI_OPERATION_NOT_SUPPORTED.

RETURN VALUES

The papiLibrarySupportedCall() function returns PAPI_TRUE if the
specified PAPI function returns valid data other than
PAPI_OPERATION_NOT_SUPPORTED. Otherwise, PAPI_FALSE is returned.


The papiLibrarySupportedCalls() function returns a null-terminated
array of strings listing all of the PAPI functions that return valid
data other than PAPI_OPERATION_NOT_SUPPORTED. Otherwise, NULL is
returned.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Volatile |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO

libpapi(3LIB), attributes(7)

January 17, 2007
PAPILIBRARYSUPPORTEDCALL(3PAPI)