1 /* 2 * Copyright (C) 2001-2003 Hewlett-Packard Co 3 * Stephane Eranian <eranian@hpl.hp.com> 4 */ 5 6 #ifndef _ASM_IA64_PERFMON_H 7 #define _ASM_IA64_PERFMON_H 8 9 /* 10 * perfmon commands supported on all CPU models 11 */ 12 #define PFM_WRITE_PMCS 0x01 13 #define PFM_WRITE_PMDS 0x02 14 #define PFM_READ_PMDS 0x03 15 #define PFM_STOP 0x04 16 #define PFM_START 0x05 17 #define PFM_ENABLE 0x06 /* obsolete */ 18 #define PFM_DISABLE 0x07 /* obsolete */ 19 #define PFM_CREATE_CONTEXT 0x08 20 #define PFM_DESTROY_CONTEXT 0x09 /* obsolete use close() */ 21 #define PFM_RESTART 0x0a 22 #define PFM_PROTECT_CONTEXT 0x0b /* obsolete */ 23 #define PFM_GET_FEATURES 0x0c 24 #define PFM_DEBUG 0x0d 25 #define PFM_UNPROTECT_CONTEXT 0x0e /* obsolete */ 26 #define PFM_GET_PMC_RESET_VAL 0x0f 27 #define PFM_LOAD_CONTEXT 0x10 28 #define PFM_UNLOAD_CONTEXT 0x11 29 30 /* 31 * PMU model specific commands (may not be supported on all PMU models) 32 */ 33 #define PFM_WRITE_IBRS 0x20 34 #define PFM_WRITE_DBRS 0x21 35 36 /* 37 * context flags 38 */ 39 #define PFM_FL_NOTIFY_BLOCK 0x01 /* block task on user level notifications */ 40 #define PFM_FL_SYSTEM_WIDE 0x02 /* create a system wide context */ 41 #define PFM_FL_OVFL_NO_MSG 0x80 /* do not post overflow/end messages for notification */ 42 43 /* 44 * event set flags 45 */ 46 #define PFM_SETFL_EXCL_IDLE 0x01 /* exclude idle task (syswide only) XXX: DO NOT USE YET */ 47 48 /* 49 * PMC flags 50 */ 51 #define PFM_REGFL_OVFL_NOTIFY 0x1 /* send notification on overflow */ 52 #define PFM_REGFL_RANDOM 0x2 /* randomize sampling interval */ 53 54 /* 55 * PMD/PMC/IBR/DBR return flags (ignored on input) 56 * 57 * Those flags are used on output and must be checked in case EAGAIN is returned 58 * by any of the calls using a pfarg_reg_t or pfarg_dbreg_t structure. 59 */ 60 #define PFM_REG_RETFL_NOTAVAIL (1UL<<31) /* set if register is implemented but not available */ 61 #define PFM_REG_RETFL_EINVAL (1UL<<30) /* set if register entry is invalid */ 62 #define PFM_REG_RETFL_MASK (PFM_REG_RETFL_NOTAVAIL|PFM_REG_RETFL_EINVAL) 63 64 #define PFM_REG_HAS_ERROR(flag) (((flag) & PFM_REG_RETFL_MASK) != 0) 65 66 typedef unsigned char pfm_uuid_t[16]; /* custom sampling buffer identifier type */ 67 68 /* 69 * Request structure used to define a context 70 */ 71 typedef struct { 72 pfm_uuid_t ctx_smpl_buf_id; /* which buffer format to use (if needed) */ 73 unsigned long ctx_flags; /* noblock/block */ 74 unsigned short ctx_nextra_sets; /* number of extra event sets (you always get 1) */ 75 unsigned short ctx_reserved1; /* for future use */ 76 int ctx_fd; /* return arg: unique identification for context */ 77 void *ctx_smpl_vaddr; /* return arg: virtual address of sampling buffer, is used */ 78 unsigned long ctx_reserved2[11];/* for future use */ 79 } pfarg_context_t; 80 81 /* 82 * Request structure used to write/read a PMC or PMD 83 */ 84 typedef struct { 85 unsigned int reg_num; /* which register */ 86 unsigned short reg_set; /* event set for this register */ 87 unsigned short reg_reserved1; /* for future use */ 88 89 unsigned long reg_value; /* initial pmc/pmd value */ 90 unsigned long reg_flags; /* input: pmc/pmd flags, return: reg error */ 91 92 unsigned long reg_long_reset; /* reset after buffer overflow notification */ 93 unsigned long reg_short_reset; /* reset after counter overflow */ 94 95 unsigned long reg_reset_pmds[4]; /* which other counters to reset on overflow */ 96 unsigned long reg_random_seed; /* seed value when randomization is used */ 97 unsigned long reg_random_mask; /* bitmask used to limit random value */ 98 unsigned long reg_last_reset_val;/* return: PMD last reset value */ 99 100 unsigned long reg_smpl_pmds[4]; /* which pmds are accessed when PMC overflows */ 101 unsigned long reg_smpl_eventid; /* opaque sampling event identifier */ 102 103 unsigned long reg_reserved2[3]; /* for future use */ 104 } pfarg_reg_t; 105 106 typedef struct { 107 unsigned int dbreg_num; /* which debug register */ 108 unsigned short dbreg_set; /* event set for this register */ 109 unsigned short dbreg_reserved1; /* for future use */ 110 unsigned long dbreg_value; /* value for debug register */ 111 unsigned long dbreg_flags; /* return: dbreg error */ 112 unsigned long dbreg_reserved2[1]; /* for future use */ 113 } pfarg_dbreg_t; 114 115 typedef struct { 116 unsigned int ft_version; /* perfmon: major [16-31], minor [0-15] */ 117 unsigned int ft_reserved; /* reserved for future use */ 118 unsigned long reserved[4]; /* for future use */ 119 } pfarg_features_t; 120 121 typedef struct { 122 pid_t load_pid; /* process to load the context into */ 123 unsigned short load_set; /* first event set to load */ 124 unsigned short load_reserved1; /* for future use */ 125 unsigned long load_reserved2[3]; /* for future use */ 126 } pfarg_load_t; 127 128 typedef struct { 129 int msg_type; /* generic message header */ 130 int msg_ctx_fd; /* generic message header */ 131 unsigned long msg_ovfl_pmds[4]; /* which PMDs overflowed */ 132 unsigned short msg_active_set; /* active set at the time of overflow */ 133 unsigned short msg_reserved1; /* for future use */ 134 unsigned int msg_reserved2; /* for future use */ 135 unsigned long msg_tstamp; /* for perf tuning/debug */ 136 } pfm_ovfl_msg_t; 137 138 typedef struct { 139 int msg_type; /* generic message header */ 140 int msg_ctx_fd; /* generic message header */ 141 unsigned long msg_tstamp; /* for perf tuning */ 142 } pfm_end_msg_t; 143 144 typedef struct { 145 int msg_type; /* type of the message */ 146 int msg_ctx_fd; /* unique identifier for the context */ 147 unsigned long msg_tstamp; /* for perf tuning */ 148 } pfm_gen_msg_t; 149 150 #define PFM_MSG_OVFL 1 /* an overflow happened */ 151 #define PFM_MSG_END 2 /* task to which context was attached ended */ 152 153 typedef union { 154 pfm_ovfl_msg_t pfm_ovfl_msg; 155 pfm_end_msg_t pfm_end_msg; 156 pfm_gen_msg_t pfm_gen_msg; 157 } pfm_msg_t; 158 159 /* 160 * Define the version numbers for both perfmon as a whole and the sampling buffer format. 161 */ 162 #define PFM_VERSION_MAJ 2U 163 #define PFM_VERSION_MIN 0U 164 #define PFM_VERSION (((PFM_VERSION_MAJ&0xffff)<<16)|(PFM_VERSION_MIN & 0xffff)) 165 #define PFM_VERSION_MAJOR(x) (((x)>>16) & 0xffff) 166 #define PFM_VERSION_MINOR(x) ((x) & 0xffff) 167 168 169 /* 170 * miscellaneous architected definitions 171 */ 172 #define PMU_FIRST_COUNTER 4 /* first counting monitor (PMC/PMD) */ 173 #define PMU_MAX_PMCS 256 /* maximum architected number of PMC registers */ 174 #define PMU_MAX_PMDS 256 /* maximum architected number of PMD registers */ 175 176 #ifdef __KERNEL__ 177 178 extern long perfmonctl(int fd, int cmd, void *arg, int narg); 179 180 typedef struct { 181 void (*handler)(int irq, void *arg, struct pt_regs *regs); 182 } pfm_intr_handler_desc_t; 183 184 extern void pfm_save_regs (struct task_struct *); 185 extern void pfm_load_regs (struct task_struct *); 186 187 extern void pfm_exit_thread(struct task_struct *); 188 extern int pfm_use_debug_registers(struct task_struct *); 189 extern int pfm_release_debug_registers(struct task_struct *); 190 extern void pfm_syst_wide_update_task(struct task_struct *, unsigned long info, int is_ctxswin); 191 extern void pfm_inherit(struct task_struct *task, struct pt_regs *regs); 192 extern void pfm_init_percpu(void); 193 extern void pfm_handle_work(void); 194 extern int pfm_install_alt_pmu_interrupt(pfm_intr_handler_desc_t *h); 195 extern int pfm_remove_alt_pmu_interrupt(pfm_intr_handler_desc_t *h); 196 197 198 199 /* 200 * Reset PMD register flags 201 */ 202 #define PFM_PMD_SHORT_RESET 0 203 #define PFM_PMD_LONG_RESET 1 204 205 typedef union { 206 unsigned int val; 207 struct { 208 unsigned int notify_user:1; /* notify user program of overflow */ 209 unsigned int reset_ovfl_pmds:1; /* reset overflowed PMDs */ 210 unsigned int block_task:1; /* block monitored task on kernel exit */ 211 unsigned int mask_monitoring:1; /* mask monitors via PMCx.plm */ 212 unsigned int reserved:28; /* for future use */ 213 } bits; 214 } pfm_ovfl_ctrl_t; 215 216 typedef struct { 217 unsigned char ovfl_pmd; /* index of overflowed PMD */ 218 unsigned char ovfl_notify; /* =1 if monitor requested overflow notification */ 219 unsigned short active_set; /* event set active at the time of the overflow */ 220 pfm_ovfl_ctrl_t ovfl_ctrl; /* return: perfmon controls to set by handler */ 221 222 unsigned long pmd_last_reset; /* last reset value of of the PMD */ 223 unsigned long smpl_pmds[4]; /* bitmask of other PMD of interest on overflow */ 224 unsigned long smpl_pmds_values[PMU_MAX_PMDS]; /* values for the other PMDs of interest */ 225 unsigned long pmd_value; /* current 64-bit value of the PMD */ 226 unsigned long pmd_eventid; /* eventid associated with PMD */ 227 } pfm_ovfl_arg_t; 228 229 230 typedef struct { 231 char *fmt_name; 232 pfm_uuid_t fmt_uuid; 233 size_t fmt_arg_size; 234 unsigned long fmt_flags; 235 236 int (*fmt_validate)(struct task_struct *task, unsigned int flags, int cpu, void *arg); 237 int (*fmt_getsize)(struct task_struct *task, unsigned int flags, int cpu, void *arg, unsigned long *size); 238 int (*fmt_init)(struct task_struct *task, void *buf, unsigned int flags, int cpu, void *arg); 239 int (*fmt_handler)(struct task_struct *task, void *buf, pfm_ovfl_arg_t *arg, struct pt_regs *regs, unsigned long stamp); 240 int (*fmt_restart)(struct task_struct *task, pfm_ovfl_ctrl_t *ctrl, void *buf, struct pt_regs *regs); 241 int (*fmt_restart_active)(struct task_struct *task, pfm_ovfl_ctrl_t *ctrl, void *buf, struct pt_regs *regs); 242 int (*fmt_exit)(struct task_struct *task, void *buf, struct pt_regs *regs); 243 244 struct list_head fmt_list; 245 } pfm_buffer_fmt_t; 246 247 extern int pfm_register_buffer_fmt(pfm_buffer_fmt_t *fmt); 248 extern int pfm_unregister_buffer_fmt(pfm_uuid_t uuid); 249 250 /* 251 * perfmon interface exported to modules 252 */ 253 extern int pfm_mod_read_pmds(struct task_struct *, void *req, unsigned int nreq, struct pt_regs *regs); 254 extern int pfm_mod_write_pmcs(struct task_struct *, void *req, unsigned int nreq, struct pt_regs *regs); 255 extern int pfm_mod_write_ibrs(struct task_struct *task, void *req, unsigned int nreq, struct pt_regs *regs); 256 extern int pfm_mod_write_dbrs(struct task_struct *task, void *req, unsigned int nreq, struct pt_regs *regs); 257 258 /* 259 * describe the content of the local_cpu_date->pfm_syst_info field 260 */ 261 #define PFM_CPUINFO_SYST_WIDE 0x1 /* if set a system wide session exists */ 262 #define PFM_CPUINFO_DCR_PP 0x2 /* if set the system wide session has started */ 263 #define PFM_CPUINFO_EXCL_IDLE 0x4 /* the system wide session excludes the idle task */ 264 265 /* 266 * sysctl control structure. visible to sampling formats 267 */ 268 typedef struct { 269 int debug; /* turn on/off debugging via syslog */ 270 int debug_ovfl; /* turn on/off debug printk in overflow handler */ 271 int fastctxsw; /* turn on/off fast (unsecure) ctxsw */ 272 int expert_mode; /* turn on/off value checking */ 273 } pfm_sysctl_t; 274 extern pfm_sysctl_t pfm_sysctl; 275 276 277 #endif /* __KERNEL__ */ 278 279 #endif /* _ASM_IA64_PERFMON_H */ 280