1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2/* 3 * Copyright (C) 2001-2003 Hewlett-Packard Co 4 * Stephane Eranian <eranian@hpl.hp.com> 5 */ 6 7#ifndef _UAPI_ASM_IA64_PERFMON_H 8#define _UAPI_ASM_IA64_PERFMON_H 9 10/* 11 * perfmon commands supported on all CPU models 12 */ 13#define PFM_WRITE_PMCS 0x01 14#define PFM_WRITE_PMDS 0x02 15#define PFM_READ_PMDS 0x03 16#define PFM_STOP 0x04 17#define PFM_START 0x05 18#define PFM_ENABLE 0x06 /* obsolete */ 19#define PFM_DISABLE 0x07 /* obsolete */ 20#define PFM_CREATE_CONTEXT 0x08 21#define PFM_DESTROY_CONTEXT 0x09 /* obsolete use close() */ 22#define PFM_RESTART 0x0a 23#define PFM_PROTECT_CONTEXT 0x0b /* obsolete */ 24#define PFM_GET_FEATURES 0x0c 25#define PFM_DEBUG 0x0d 26#define PFM_UNPROTECT_CONTEXT 0x0e /* obsolete */ 27#define PFM_GET_PMC_RESET_VAL 0x0f 28#define PFM_LOAD_CONTEXT 0x10 29#define PFM_UNLOAD_CONTEXT 0x11 30 31/* 32 * PMU model specific commands (may not be supported on all PMU models) 33 */ 34#define PFM_WRITE_IBRS 0x20 35#define PFM_WRITE_DBRS 0x21 36 37/* 38 * context flags 39 */ 40#define PFM_FL_NOTIFY_BLOCK 0x01 /* block task on user level notifications */ 41#define PFM_FL_SYSTEM_WIDE 0x02 /* create a system wide context */ 42#define PFM_FL_OVFL_NO_MSG 0x80 /* do not post overflow/end messages for notification */ 43 44/* 45 * event set flags 46 */ 47#define PFM_SETFL_EXCL_IDLE 0x01 /* exclude idle task (syswide only) XXX: DO NOT USE YET */ 48 49/* 50 * PMC flags 51 */ 52#define PFM_REGFL_OVFL_NOTIFY 0x1 /* send notification on overflow */ 53#define PFM_REGFL_RANDOM 0x2 /* randomize sampling interval */ 54 55/* 56 * PMD/PMC/IBR/DBR return flags (ignored on input) 57 * 58 * Those flags are used on output and must be checked in case EAGAIN is returned 59 * by any of the calls using a pfarg_reg_t or pfarg_dbreg_t structure. 60 */ 61#define PFM_REG_RETFL_NOTAVAIL (1UL<<31) /* set if register is implemented but not available */ 62#define PFM_REG_RETFL_EINVAL (1UL<<30) /* set if register entry is invalid */ 63#define PFM_REG_RETFL_MASK (PFM_REG_RETFL_NOTAVAIL|PFM_REG_RETFL_EINVAL) 64 65#define PFM_REG_HAS_ERROR(flag) (((flag) & PFM_REG_RETFL_MASK) != 0) 66 67typedef unsigned char pfm_uuid_t[16]; /* custom sampling buffer identifier type */ 68 69/* 70 * Request structure used to define a context 71 */ 72typedef struct { 73 pfm_uuid_t ctx_smpl_buf_id; /* which buffer format to use (if needed) */ 74 unsigned long ctx_flags; /* noblock/block */ 75 unsigned short ctx_nextra_sets; /* number of extra event sets (you always get 1) */ 76 unsigned short ctx_reserved1; /* for future use */ 77 int ctx_fd; /* return arg: unique identification for context */ 78 void *ctx_smpl_vaddr; /* return arg: virtual address of sampling buffer, is used */ 79 unsigned long ctx_reserved2[11];/* for future use */ 80} pfarg_context_t; 81 82/* 83 * Request structure used to write/read a PMC or PMD 84 */ 85typedef struct { 86 unsigned int reg_num; /* which register */ 87 unsigned short reg_set; /* event set for this register */ 88 unsigned short reg_reserved1; /* for future use */ 89 90 unsigned long reg_value; /* initial pmc/pmd value */ 91 unsigned long reg_flags; /* input: pmc/pmd flags, return: reg error */ 92 93 unsigned long reg_long_reset; /* reset after buffer overflow notification */ 94 unsigned long reg_short_reset; /* reset after counter overflow */ 95 96 unsigned long reg_reset_pmds[4]; /* which other counters to reset on overflow */ 97 unsigned long reg_random_seed; /* seed value when randomization is used */ 98 unsigned long reg_random_mask; /* bitmask used to limit random value */ 99 unsigned long reg_last_reset_val;/* return: PMD last reset value */ 100 101 unsigned long reg_smpl_pmds[4]; /* which pmds are accessed when PMC overflows */ 102 unsigned long reg_smpl_eventid; /* opaque sampling event identifier */ 103 104 unsigned long reg_reserved2[3]; /* for future use */ 105} pfarg_reg_t; 106 107typedef struct { 108 unsigned int dbreg_num; /* which debug register */ 109 unsigned short dbreg_set; /* event set for this register */ 110 unsigned short dbreg_reserved1; /* for future use */ 111 unsigned long dbreg_value; /* value for debug register */ 112 unsigned long dbreg_flags; /* return: dbreg error */ 113 unsigned long dbreg_reserved2[1]; /* for future use */ 114} pfarg_dbreg_t; 115 116typedef struct { 117 unsigned int ft_version; /* perfmon: major [16-31], minor [0-15] */ 118 unsigned int ft_reserved; /* reserved for future use */ 119 unsigned long reserved[4]; /* for future use */ 120} pfarg_features_t; 121 122typedef struct { 123 pid_t load_pid; /* process to load the context into */ 124 unsigned short load_set; /* first event set to load */ 125 unsigned short load_reserved1; /* for future use */ 126 unsigned long load_reserved2[3]; /* for future use */ 127} pfarg_load_t; 128 129typedef struct { 130 int msg_type; /* generic message header */ 131 int msg_ctx_fd; /* generic message header */ 132 unsigned long msg_ovfl_pmds[4]; /* which PMDs overflowed */ 133 unsigned short msg_active_set; /* active set at the time of overflow */ 134 unsigned short msg_reserved1; /* for future use */ 135 unsigned int msg_reserved2; /* for future use */ 136 unsigned long msg_tstamp; /* for perf tuning/debug */ 137} pfm_ovfl_msg_t; 138 139typedef struct { 140 int msg_type; /* generic message header */ 141 int msg_ctx_fd; /* generic message header */ 142 unsigned long msg_tstamp; /* for perf tuning */ 143} pfm_end_msg_t; 144 145typedef struct { 146 int msg_type; /* type of the message */ 147 int msg_ctx_fd; /* unique identifier for the context */ 148 unsigned long msg_tstamp; /* for perf tuning */ 149} pfm_gen_msg_t; 150 151#define PFM_MSG_OVFL 1 /* an overflow happened */ 152#define PFM_MSG_END 2 /* task to which context was attached ended */ 153 154typedef union { 155 pfm_ovfl_msg_t pfm_ovfl_msg; 156 pfm_end_msg_t pfm_end_msg; 157 pfm_gen_msg_t pfm_gen_msg; 158} pfm_msg_t; 159 160/* 161 * Define the version numbers for both perfmon as a whole and the sampling buffer format. 162 */ 163#define PFM_VERSION_MAJ 2U 164#define PFM_VERSION_MIN 0U 165#define PFM_VERSION (((PFM_VERSION_MAJ&0xffff)<<16)|(PFM_VERSION_MIN & 0xffff)) 166#define PFM_VERSION_MAJOR(x) (((x)>>16) & 0xffff) 167#define PFM_VERSION_MINOR(x) ((x) & 0xffff) 168 169 170/* 171 * miscellaneous architected definitions 172 */ 173#define PMU_FIRST_COUNTER 4 /* first counting monitor (PMC/PMD) */ 174#define PMU_MAX_PMCS 256 /* maximum architected number of PMC registers */ 175#define PMU_MAX_PMDS 256 /* maximum architected number of PMD registers */ 176 177 178#endif /* _UAPI_ASM_IA64_PERFMON_H */ 179