pmapi.h 文件

在线编辑

用途

描述性能监视器 API 子例程所使用的结构和常量。

语法

#include <pmapi.h>

描述

pmapi.h 文件定义以下符号常量，类型和结构:

符号常量

项 描述
最大计数器数 受支持的最大计数器数
MIN_THRESH_VALUE 最小阈值
MAX_THRESH_VALUE 最大阈值
无计数 指定非计数事件

事件过滤器的常量

项 描述
已验证 PM_VERICED 指定已验证的事件
未验证的 PM_UNVERICED 指定还未验证的事件
PM_CAVEAT 指定与警告一起使用的事件
PM_GET_GROUPS 不是过滤器; 指定受支持的事件组将由 pm_init 返回。
Constants for Processor Idents
项 描述
PM_CURRENT 指定要对当前处理器类型初始化的 PMAPI。
PM_PowerPC®604 指定将返回 PowerPC®604 的受支持事件。
PM_PowerPC®604e 指定将返回 PowerPC604e 的受支持事件。
PM_RS64_II 指定要返回 RS64-II 的受支持事件。
PM_POWER3 指定要返回 POWER3 的受支持事件。
PM_RS64_III 指定要返回 RS64-III 的受支持事件。
PM_POWER3_II 指定将返回 POWER3-II 支持的事件。
PM_POWER4 指定要返回 POWER4 的受支持事件和/或组。
PM_MPC7450 指定将返回 MPC7450 所支持的事件
PM_POWER4_II 指定要返回 POWER4-II 的受支持事件和/或组。
PM_POWER5 指定要返回 POWER5 的受支持事件和/或组。
PM_PowerPC 970 指定要返回 PowerPC 970 的受支持事件和/或组。
PM_POWER6® 指定返回POWER6支持的事件和/或组。
PM_PPowerPC 970MP 指定将返回 PowerPC 970MP 的受支持事件和/或组。
PM_POWER7® 指定返回POWER7支持的事件和/或组。
POWER8® 指定返回POWER8支持的事件和/或组。
POWER9 指定要返回 POWER9 的受支持事件和/或组。
PM_MAXPROCTYPE 最大处理器啮齿数。

用于设置方式位的常量

项 描述
PM_PROPTREE 打开进程树计数
PM_COUNT 立即开启计数
PM_USER 开启用户方式计数
PM_KERNEL 开启内核方式计数
PM_PROCESS 创建进程级别组
结构 pm_info_t 中包含以下成员:
int             maxpmcs             number of available counters
int             *maxevents          number of events for each hw counter 
pm_events_t     **list_events       list of available events 
int             thresholdmult       threshold multiplier 
char            *proc_name          processor name
int             hthresholdmult      upper threshold multiplier

结构 pm_events_t 中包含以下成员:

int             event_id            event number 
char            status              'v': verified 
                                    'u': unverified
                                    'c': caveat
char            threshold           'y': thresholdable 
                                    'g': group-only
                                    'G': thresholdable group-only
char            *short_name          mnemonic name 
char            *long_name           long name 
char            *description         full description
结构 pm_info2_t 包含以下成员:
int              maxpmcs             number of available counters
int              *maxevents          number of events for each hw counter 
pm_events2_t     **list_events       list of available events 
int              thresholdmult       threshold multiplier 
int              hthresholdmult      upper threshold multiplier
int              Hthresholdmult      hyper threshold multiplier
char             *proc_name          processor name
pm_feature_t     proc_feature        processor feature list
结构 pm_events2_t 包含以下成员:
int              event_id            event number 
pm_status_t      status              event status 
char             *short_name         mnemonic name 
char             *long_name          long name 
char             *description        full description
结构 pm_status_t 包含以下成员:
unsigned:1       b.unverified        unverified event
unsigned:1       b.verified          verified event
unsigned:1       b.caveat            event verified with some caveat(see description)
unsigned:1       b.group_only        event can only be used within a group
unsigned:1       b.threshold         event can be used with a threshold
unsigned:1       b.shared            event is shared between hardware threads
unsigned:1       b.support_mode      support user, kernel, hypervisor and proctree counting modes applied
unsigned:1       b.overflow          generate an interrupt on overflow
unsigned:1       b.marked            marked event
结构 pm_feature_t 包含以下成员:
unsigned:1       b.hypervisor        hypervisor counting mode is supported
结构 pm_groups_info_t 中包含以下成员:
  int            maxgroups          number of available groups
  pm_groups_t    *event_groups      list of event groups
结构 pm_groups_t 中包含以下成员:
  int            group_id           group number
  int            *events            events in this group, by ID #
  char           *short_name        mnemonic name
  char           *long_name         long name
  char           *description       full description
结构 pm_prog_t 中包含以下成员:
unsigned:6       mode.b.threshold        threshold value 
unsigned:1       mode.b.thresh_res       uses upper threshold mutiplier if set
unsigned:1       mode.b.thresh_hres      uses hyper threshold mutiplier if set
unsigned:1       mode.b.nointerrupt      interrupt counting disable
unsigned:1       mode.b.runlatch         runlatch enable/disable
unsigned:1       mode.b.is_group         is an event group
unsigned:1       mode.b.process          process level group indicator 
unsigned:1       mode.b.hypervisor       turns hypervisor mode counting on
unsigned:1       mode.b.kernel           turns kernel mode counting on 
unsigned:1       mode.b.user             turns user mode counting on 
unsigned:1       mode.b.count            counting state 
unsigned:1       mode.b.proctree         turns process tree counting on
unsigned:1       mode.b.shared           turns multiplexing on
int              events[MAX_COUNTERS]    list of counted events
注: mode.b.shared 标志必须由用户设置。
结构 pm_data_t 中包含以下成员:
pm_ginfo_t       ginfo                 group information 
long long        accu[MAX_COUNTERS]    accumulated data
结构 pm_ginfo_t 中包含以下成员:
int              members;              number of threads in group 
unsigned:1       flags.b.process       process level group indicator 
unsigned:1       flags.b.consistent    group data consistent with members
结构 pm_accu_time_t 包含以下成员:
timebasestruct_t  accu_timebase       accumulated time base
timebasestruct_t  accu_purr           accumulated PURR time
timebasestruct_t  accu_spurr          accumulated SPURR time
时间片的类型:
typedef    int         pm_events_prog_t[MAX_COUNTERS] array of counted events
结构 pm_prog_mx_t 包含以下成员:
unsigned:6             mode.b.threshold        threshold value
unsigned:1             mode.b.thresh_res       uses upper threshold mutiplier if set
unsigned:1             mode.b.thresh_hres      uses hyper threshold mutiplier if set
unsigned:1             mode.b.runlatch         runlatch enable/disable
unsigned:1             mode.b.is_group         is an event group
unsigned:1             mode.b.process          process level group indicator
unsigned:1             mode.b.hypervisor       turns hypervisor mode counting on
unsigned:1             mode.b.kernel           turns kernel mode counting on
unsigned:1             mode.b.user             turns user mode counting on
unsigned:1             mode.b.count            counting state
unsigned:1             mode.b.proctree         turns process tree counting on
int                    slice_duration          duration of each time slice in ms
int                    nb_events_prog          number of counted event sets
pm_events_prog_t       *events_set;            array of counted event sets
unsigned:1             mode.b.shared           turns multiplexing on
注: mode.b.shared 标志必须由用户设置。
结构 pm_prog_mm_t 包含以下成员:
int            proctree               turns process tree counting on
int            slice_duration         duration of each time slice in ms
int            nb_set_prog            number of counted event sets
pm_prog_t      *prog_set;             array of counted event sets / counting mode
结构 pm_accu_mx_t 包含以下成员:
timebasestruct_t    accu_time               accumulated time
timebasestruct_t    accu_purr               accumulated PURR time
timebasestruct_t    accu_spurr              accumulated SPURR time
long long           accu_data[MAX_COUNTERS] accumulated data
结构 pm_data_mx_t 包含以下成员:
pm_ginfo_t     ginfo         group information
int            nb_accu_mx    number of data accumulator sets
int            nb_mx_round   number of loops on all the event sets
pm_accu_mx_t   *accu_set     array of data accumulator sets
结构 pm_wpar_ctx_info_t 包含以下成员:
cid_t           cid                           WPAR ID
char            name[MAXCORRALNAMELEN + 1]    WPAR name
pm_wp_handle_t  hwpar                         WPAR opaque handle (unique identifier)
profiler_type_t 枚举包含以下成员:
P_THREAD = 0
P_THREAD_GROUP

typedef pm_accu_mx_t pm_accu_t;
pm_data_time_t 结构包含以下成员:
int                 nb_accu;              number of data accumulator sets 
int		    nb_mx_round;	   number of loops on all the event sets 
timebasestruct_t    total_active_time;    total time the context is active and competing for PMU 
timebasestruct_t    total_active_purr;    total PURR time the context is active and competing for PMU
timebasestruct_t    total_active_spurr;   total SPURR time the context is active and competing for PMU
timebasestruct_t    total_profiled_time;  total time the context got the PMU
timebasestruct_t    total_profiled_purr;  total PURR time the context got the PMU 
timebasestruct_t    total_profiled_spurr; total SPURR time the context got the PMU
pm_ginfo_t          ginfo;                group information   
pm_accu_t           *accu_set;            array of data accumulator sets
以下内容声明为函数:
double pm_cycles(void)
void   pm_error(char *where, int error)
int    pm_get_proctype()

int    pm_init(int filter, pm_info_t *pminfo, pm_groups_info_t *pmgroupsinfo)
int    pm_initialize(int filter, pm_info2_t *pminfo, pm_groups_info_t *pmgroups, int proctype)
 
int    pm_set_program(pm_prog_t *prog)
int    pm_set_program_wp(cid_t cid, pm_prog_t *prog)
int    pm_get_program(pm_prog_t *prog)
int    pm_get_program_wp(cid_t cid, pm_prog_t *prog)
int    pm_start(void)
int    pm_tstart(timebasestruct_t *time)
int    pm_start_wp(cid_t cid)
int    pm_tstart_wp(cid_t cid, timebasestruct_t *time)
int    pm_stop(void)
int    pm_tstop(timebasestruct_t *time)
int    pm_stop_wp(cid_t cid)
int    pm_tstop_wp(cid_t cid, timebasestruct_t *time)
int    pm_reset_data(void)
int    pm_reset_data_wp(cid_t cid)
int    pm_get_data(pm_data_t *data)
int    pm_get_tdata(pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata(pm_data_t *data, pm_accu_time_t *time)
int    pm_get_data_wp(pm_wp_handle_t wp_handle, pm_data_t *data)
int    pm_get_tdata_wp(pm_wp_handle_t wp_handle, pm_data_t *data)
int    pm_get_Tdata_wp(pm_wp_handle_t wp_handle, pm_data_t *data)
int    pm_get_data_cpu(int cpuid, pm_data_t *data)
int    pm_get_tdata_cpu(int cpuid, pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_cpu(int cpuid, pm_data_t *data, pm_accu_time_t *time)
int    pm_get_data_lcpu(int lcpuid, pm_data_t *data)
int    pm_get_tdata_lcpu(int lcpuid, pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_lcpu(int lcpuid, pm_data_t *data, pm_accu_time_t *time)
int    pm_get_data_lcpu_wp(pm_wp_handle_t wp_handle, int lcpuid, pm_data_t *data)
int    pm_get_tdata_lcpu_wp(pm_wp_handle_t wp_handle, 
                            int lcpuid, pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_lcpu_wp(pm_wp_handle_t wp_handle, 
                            int lcpuid, pm_data_t *data, pm_accu_time_t *time)
int    pm_get_wplist(const char *name, pm_wpar_ctx_info_t *wp_list, int *size)
int    pm_delete_program(void)
int    pm_delete_program_wp(cid_t cid, pm_prog_t *prog)
 
int    pm_set_program_mythread(pm_prog_t *prog)
int    pm_get_program_mythread(pm_prog_t *prog)
int    pm_start_mythread(void)
int    pm_tstart_mythread(timebasestruct_t *time)
int    pm_stop_mythread(void)
int    pm_tstop_mythread(timebasestruct_t *time)
int    pm_reset_data_mythread(void)
int    pm_get_data_mythread(pm_data_t *data)
int    pm_get_tdata_mythread(pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_mythread(pm_data_t *data, pm_accu_time_t *time)
int    pm_delete_program_mythread(void)
 
int    pm_set_program_thread(pid_t pid, tid_t tid, pm_prog_t *prog)
int    pm_get_program_thread(pid_t pid, tid_t tid, pm_prog_t *prog)
int    pm_start_thread(pid_t pid, tid_t tid)
int    pm_tstart_thread(pid_t pid, tid_t tid, timebasestruct_t *time)
int    pm_stop_thread(pid_t pid, tid_t tid)
int    pm_tstop_thread(pid_t pid, tid_t tid, timebasestruct_t *time)
int    pm_reset_data_thread(pid_t pid, tid_t tid)
int    pm_get_data_thread(pid_t pid, tid_t tid, pm_data_t *data)
int    pm_get_tdata_thread(pid_t pid, tid_t tid, pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_thread(pid_t pid, tid_t tid, pm_data_t *data, pm_accu_time_t *time)
int    pm_delete_program_thread(pid_t pid, tid_t tid)
 
int    pm_set_program_mygroup(pm_prog_t *prog)
int    pm_get_program_mygroup(pm_prog_t *prog)
int    pm_start_mygroup(void)
int    pm_tstart_mygroup(timebasestruct_t *time)
int    pm_stop_mygroup(void)
int    pm_tstop_mygroup(timebasestruct_t *time)
int    pm_reset_data_mygroup(void)
int    pm_get_data_mygroup(pm_data_t *data)
int    pm_get_tdata_mygroup(pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_mygroup(pm_data_t *data, pm_accu_time_t *time)
int    pm_delete_program_mygroup(void)
 
int    pm_set_program_group(pid_t pid, tid_t tid, pm_prog_t *prog)
int    pm_get_program_group(pid_t pid, tid_t tid, pm_prog_t *prog)
int    pm_start_group(pid_t pid, tid_t tid)
int    pm_tstart_group(pid_t pid, tid_t tid, timebasestruct_t *time)
int    pm_stop_group(pid_t pid, tid_t tid)
int    pm_tstop_group(pid_t pid, tid_t tid, timebasestruct_t *time)
int    pm_reset_data_group(pid_t pid, tid_t tid)
int    pm_get_data_group(pid_t pid, tid_t tid, pm_data_t *data)
int    pm_get_tdata_group(pid_t pid, tid_t tid, pm_data_t *data, timebasestruct_t *time)
int    pm_get_Tdata_group(pid_t pid, tid_t tid, pm_data_t *data, pm_accu_time_t *time)
int    pm_delete_program_group(pid_t pid, tid_t tid)

int    pm_set_program_pthread(pid_t pid, tid_t tid,  ptid_t ptid, pm_prog_t *prog)
int    pm_set_program_pgroup(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_t *prog)
int    pm_get_program_pthread(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_t *prog)
int    pm_get_program_pgroup(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_t *prog)
int    pm_start_pthread(pid_t pid, tid_t tid, ptid_t ptid)
int    pm_tstart_pthread(pid_t pid, tid_t tid, ptid_t ptid,timebasestruct_t *time)
int    pm_start_pgroup(pid_t pid, tid_t tid, ptid_t ptid)
int    pm_tstart_pgroup(pid_t pid, tid_t tid, ptid_t ptid,timebasestruct_t *time)
int    pm_stop_pthread(pid_t pid, tid_t tid, ptid_t ptid)
int    pm_tstop_pthread(pid_t pid, tid_t tid, ptid_t ptid,timebasestruct_t *time)
int    pm_stop_pgroup(pid_t pid, tid_t tid, ptid_t ptid)
int    pm_tstop_pgroup(pid_t pid, tid_t tid, ptid_t ptid,timebasestruct_t *time)
int    pm_reset_data_pthread(pid_t pid, tid_t tid,  ptid_t ptid)
int    pm_reset_data_pgroup(pid_t pid, tid_t tid,  ptid_t ptid)
int    pm_get_data_pthread(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data)
int    pm_get_tdata_pthread(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data,
           timebasestruct_t *time)
int    pm_get_Tdata_pthread(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data, 
           pm_accu_time_t *time)
int    pm_get_data_pgroup(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data)
int    pm_get_tdata_pgroup(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data,
           timebasestruct_t *time)
int    pm_get_Tdata_pgroup(pid_t pid, tid_t tid, ptid_t ptid, pm_data_t *data, 
           pm_accu_time_t *time)
int    pm_delete_program_pthread(pid_t pid, tid_t tid,  ptid_t ptid)
int    pm_delete_program_pgroup(pid_t pid, tid_t tid,  ptid_t ptid) 

int    pm_set_program_mx(pm_prog_mx_t *prog)
int    pm_get_program_mx(pm_prog_mx_t *prog)
int    pm_set_program_mm(pm_prog_mm_t *prog)
int    pm_set_program_wp_mm(cid_t cid, pm_prog_mm_t *prog)
int    pm_get_program_mm(pm_prog_mm_t *prog)
int    pm_get_program_wp_mm(cid_t cid, pm_prog_mm_t *prog)
int    pm_get_data_mx(pm_data_mx_t *data)
int    pm_get_tdata_mx(pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_cpu_mx(int cpuid, pm_data_mx_t *data)
int    pm_get_tdata_cpu_mx(int cpuid, pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_lcpu_mx(int lcpuid, pm_data_mx_t *data)
int    pm_get_tdata_lcpu_mx(int lcpuid, pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_wp_mx(pm_wp_handle_t wp_handle, pm_data_mx_t *data)
int    pm_get_tdata_wp_mx(pm_wp_handle_t wp_handle, pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_lcpu_wp_mx(pm_wp_handle_t wp_handle, int lcpuid, pm_data_mx_t *data)
int    pm_get_tdata_lcpu_wp_mx(pm_wp_handle_t wp_handle, 
                               int lcpuid, pm_data_mx_t *data, timebasestruct_t *time)
int    pm_set_program_mythread_mx(pm_prog_mx_t *prog)
int    pm_get_program_mythread_mx(pm_prog_mx_t *prog)
int    pm_set_program_mythread_mm(pm_prog_mm_t *prog)
int    pm_get_program_mythread_mm(pm_prog_mm_t *prog)
int    pm_get_data_mythread_mx(pm_data_mx_t *data)
int    pm_get_tdata_mythread_mx(pm_data_mx_t *data, timebasestruct_t *time)

int    pm_set_program_thread_mx(pid_t pid, tid_t tid, pm_prog_mx_t *prog)
int    pm_get_program_thread_mx(pid_t pid, tid_t tid, pm_prog_mx_t *prog)
int    pm_set_program_thread_mm(pid_t pid, tid_t tid, pm_prog_mm_t *prog)
int    pm_get_program_thread_mm(pid_t pid, tid_t tid, pm_prog_mm_t *prog)
int    pm_get_data_thread_mx(pid_t pid, tid_t tid, pm_data_mx_t *data)
int    pm_get_tdata_thread_mx(pid_t pid, tid_t tid, pm_data_mx_t *data, 
          timebasestruct_t *time)
 
int    pm_set_program_mygroup_mx(pm_prog_mx_t *prog)
int    pm_get_program_mygroup_mx(pm_prog_mx_t *prog)
int    pm_set_program_mygroup_mm(pm_prog_mm_t *prog)
int    pm_get_program_mygroup_mm(pm_prog_mm_t *prog)
int    pm_get_data_mygroup_mx(pm_data_mx_t *data)
int    pm_get_tdata_mygroup_mx(pm_data_mx_t *data, timebasestruct_t *time)
 
int    pm_set_program_group_mx(pid_t pid, tid_t tid, pm_prog_mx_t *prog)
int    pm_get_program_group_mx(pid_t pid, tid_t tid, pm_prog_mx_t *prog)
int    pm_set_program_group_mm(pid_t pid, tid_t tid, pm_prog_mm_t *prog)
int    pm_get_program_group_mm(pid_t pid, tid_t tid, pm_prog_mm_t *prog)
int    pm_get_data_group_mx(pid_t pid, tid_t tid, pm_data_mx_t *data)
int    pm_get_tdata_group_mx(pid_t pid, tid_t tid, pm_data_mx_t *data, 
           timebasestruct_t *time)

int    pm_set_program_pthread_mx(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mx_t *prog)
int    pm_set_program_pgroup_mx(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mx_t *prog)
int    pm_get_program_pthread_mx(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mx_t *prog)
int    pm_get_program_pgroup_mx(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mx_t *prog)
int    pm_set_program_pthread_mm(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mm_t *prog)
int    pm_set_program_pgroup_mm(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mm_t *prog)
int    pm_get_program_pthread_mm(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mm_t *prog)
int    pm_get_program_pgroup_mm(pid_t pid, tid_t tid, ptid_t ptid, pm_prog_mm_t *prog)
int    pm_get_data_pthread_mx(pid_t pid, tid_t tid, ptid_t ptid, pm_data_mx_t *data)
int    pm_get_tdata_pthread_mx(pid_t pid, tid_t tid, ptid_t ptid, 
           pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_pgroup_mx(pid_t pid, tid_t tid, ptid_t ptid, 
           pm_data_mx_t *data)
int    pm_get_tdata_pgroup_mx(pid_t pid, tid_t tid, ptid_t ptid, 
           pm_data_mx_t *data, timebasestruct_t *time)
int    pm_get_data_generic ( pid_t pid, tid_t tid, ptid_t ptid, 
           profiler_type_t prof_type, pm_data_time_t *data)