opensolaris man page for papilibrarysupportedcall

papiLibrarySupportedCall(3PAPI) 			      PAPI Library Functions				   papiLibrarySupportedCall(3PAPI)

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_OPERA-
       TION_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_OPERA-
       TION_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(5) for descriptions of the following attributes:

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

SEE ALSO
       libpapi(3LIB), attributes(5)

SunOS 5.11							    17 Jan 2007 				   papiLibrarySupportedCall(3PAPI)