1papiStatusString(3PAPI)     PAPI Library Functions     papiStatusString(3PAPI)
2
3
4

NAME

6       papiStatusString - return the string equivalent of a papi_status_t
7

SYNOPSIS

9       cc [ flag... ] file... -lpapi [ library... ]
10       #include <papi.h>
11
12       char *papiStatusString(papi_status_t status);
13
14

PARAMETERS

16       status    a papi_status_t returned from most papi*() functions
17
18

DESCRIPTION

20       The  papiStatusString()  function  takes  a  status value and returns a
21       localized human-readable version of the supplied status.
22

RETURN VALUES

24       The papiStatusString() function always returns a text string.
25

ERRORS

27       None.
28

EXAMPLES

30       Example 1 Print status.
31
32         #include <stdio.h>
33         #include <papi.h>
34
35         /*ARGSUSED*/
36         int
37         main(int ac, char *av[])
38         {
39
40             printf("status: %s\n", papiStatusString(PAPI_OK));
41             printf("status: %s\n", papiStatusString(PAPI_DEVICE_ERROR));
42             printf("status: %s\n", papiStatusString(PAPI_DOCUMENT_ACCESS_ERROR));
43
44             exit(0);
45         }
46
47

ATTRIBUTES

49       See attributes(5) for descriptions of the following attributes:
50
51
52
53
54       ┌─────────────────────────────┬─────────────────────────────┐
55       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │Interface Stability          │Volatile                     │
58       ├─────────────────────────────┼─────────────────────────────┤
59       │MT-Level                     │Safe                         │
60       └─────────────────────────────┴─────────────────────────────┘
61

SEE ALSO

63       libpapi(3LIB), attributes(5)
64
65
66
67SunOS 5.11                        17 Jan 2007          papiStatusString(3PAPI)
Impressum