1PAPI_DECODE(1)              General Commands Manual             PAPI_DECODE(1)
2
3
4

NAME

6       papi_decode  -  provides  availability  and detail information for PAPI
7       preset events.
8
9

SYNOPSIS

11       papi_decode [-ah]
12
13
14

DESCRIPTION

16       papi_decode is a PAPI utility program that converts  the  PAPI  presets
17       for  the  existing library into a comma separated value format that can
18       then be viewed or modified in spreadsheet applications or text editors,
19       and can be supplied to PAPI_encode_events(3) as a way of adding or mod‐
20       ifying event definitions for specialized applications.  The format  for
21       the  csv  output consists of a line of field names, followed by a blank
22       line, followed by one line of comma separated  values  for  each  event
23       contained in the preset table. A portion of this output (for Pentium 4)
24       is shown below:
25
26       name,derived,postfix,short_descr,long_descr,note,[native,...]
27
28       PAPI_L1_ICM,NOT_DERIVED,,"L1I cache misses","Level 1 instruction cache misses",,BPU_fetch_request_TCMISS
29       PAPI_L2_TCM,NOT_DERIVED,,"L2 cache misses","Level 2 cache misses",,BSQ_cache_reference_RD_2ndL_MISS_WR_2ndL_MISS
30       PAPI_TLB_DM,NOT_DERIVED,,"Data TLB misses","Data translation lookaside buffer misses",,page_walk_type_DTMISS
31
32

OPTIONS

34       -a     Convert only the available PAPI preset events.
35
36
37       -h     Display help information about this utility.
38
39

BUGS

41       There are no known bugs in this utility.
42
43       If you find a bug, it should be reported to the PAPI  Mailing  List  at
44       <ptools-perfapi@ptools.org>.
45
46

SEE ALSO

48       PAPI(3),    papi_avail(1),    papi_clockres(1),   papi_command_line(1),
49       papi_cost(1),         papi_event_chooser(1),          papi_mem_info(1),
50       papi_native_avail(1)
51
52
53
54
55
56
57                                   May, 2005                    PAPI_DECODE(1)