opensolaris man page for papistatusstring

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)