PAPISTATUSSTRING(3PAPI)PAPISTATUSSTRING(3PAPI)NAMEpapiStatusString - 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\n", papiStatusString(PAPI_OK));
printf("status: %s\n", papiStatusString(PAPI_DEVICE_ERROR));
printf("status: %s\n", 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 ALSOlibpapi(3LIB), attributes(5)
Jan 17, 2007 PAPISTATUSSTRING(3PAPI)