Commit | Line | Data |
---|---|---|
1da177e4 LT |
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 comamnds 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 | ||
a1ecf7f6 TL |
180 | typedef struct { |
181 | void (*handler)(int irq, void *arg, struct pt_regs *regs); | |
182 | } pfm_intr_handler_desc_t; | |
183 | ||
1da177e4 LT |
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); | |
a1ecf7f6 TL |
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 | ||
1da177e4 LT |
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 | ||
4944930a SE |
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 | ||
1da177e4 LT |
277 | #endif /* __KERNEL__ */ |
278 | ||
279 | #endif /* _ASM_IA64_PERFMON_H */ |