文档介绍：Overview of PAPI
Performance Application Programming Interface.
PAPI 、标准化、实现的实用而高效的API.
PAPI能测量许多计算机体系结构的许多性能特性,同时它也是理解你的程序性能的一个有效工具。
PAPI Calling Interfaces
PAPI是用C写的,但可用C和Fortran调用
,与之一致的形式为:
<返回类型> PAPI_“function_name”(“arg1, arg2”,…)
,与之一致的形式为:
PAPIF_''function_name''(''arg1, arg2'', …, check)
正如你所看见,C函数调用等价于Fortran函数调用。
这在大多数情况下是对的,除了返回指向结构体的
C指针,这些函数要么没有用Fortran实现,要么用
不同的调用语义。(可举例)
在用Fortran接口调用的函数中返回的是与C接
口调用一致的函数的参数--check
PAPI Counter Interfaces
PAPI为潜在的硬件计数器提供三类接口:
LOW-LEVEL 接口
以用户定义(user-defined)组-事件集(Event Set)的方式管理硬件事件。
HIGH-LEVEL接口
简单提供对于一个特定事件列表的计数器的start,stop 以及read的能力。
可视化工具以查看信息
LOW-LEVEL API可以和HIGH-LEVEL API一起使用。但是必须确保第一个LOW-LEVEL API调用前PAPI库已被初始化。或者可以先调用HIGH-LEVEL API(潜在已经初始化)。
PAPI Implementation
PAPI Constants
PAPI常量定义在以下两个头文件中:
,这些常量部分在后面的表中有列出,用户可结合文档来了解这些常量及其意义。
(return codes)
以及其他一些内部定义。
Standardized Event Definitions
以下是一个被视为与调试程序性能相关的或实用的硬件事件表,这些事件在不同的平台上有着相同的作用(尽管它们可能有不同的语义)。另外