papiStatusString(3PAPI) PAPI Library Functions papiStatusString(3PAPI)
NAME
papiStatusString - return the string equivalent of a papi_status_t
SYNOPSIS
cc [ flag... ] file... -lpapi [ library... ]
#include <papi.h>
char *papiStatusString(papi_status_t status);
PARAMETERS
status a papi_status_t returned from most papi*() functions
DESCRIPTION
The papiStatusString() function takes a status value and returns a localized human-readable version of the supplied status.
RETURN VALUES
The papiStatusString() function always returns a text string.
ERRORS
None.
EXAMPLES
Example 1 Print status.
#include <stdio.h>
#include <papi.h>
/*ARGSUSED*/
int
main(int ac, char *av[])
{
printf("status: %s
", papiStatusString(PAPI_OK));
printf("status: %s
", papiStatusString(PAPI_DEVICE_ERROR));
printf("status: %s
", papiStatusString(PAPI_DOCUMENT_ACCESS_ERROR));
exit(0);
}
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 papiStatusString(3PAPI)