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\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(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 PAPISTATUSSTRING(3PAPI)