]> git.proxmox.com Git - mirror_ubuntu-kernels.git/blame - arch/x86/kernel/cpu/perf_counter.c
perf_counter, x86: change and remove pmu initialization checks
[mirror_ubuntu-kernels.git] / arch / x86 / kernel / cpu / perf_counter.c
CommitLineData
241771ef
IM
1/*
2 * Performance counter x86 architecture code
3 *
4 * Copyright(C) 2008 Thomas Gleixner <tglx@linutronix.de>
5 * Copyright(C) 2008 Red Hat, Inc., Ingo Molnar
b56a3802 6 * Copyright(C) 2009 Jaswinder Singh Rajput
39d81eab 7 * Copyright(C) 2009 Advanced Micro Devices, Inc., Robert Richter
241771ef
IM
8 *
9 * For licencing details see kernel-base/COPYING
10 */
11
12#include <linux/perf_counter.h>
13#include <linux/capability.h>
14#include <linux/notifier.h>
15#include <linux/hardirq.h>
16#include <linux/kprobes.h>
4ac13294 17#include <linux/module.h>
241771ef
IM
18#include <linux/kdebug.h>
19#include <linux/sched.h>
d7d59fb3 20#include <linux/uaccess.h>
241771ef 21
241771ef 22#include <asm/apic.h>
d7d59fb3 23#include <asm/stacktrace.h>
4e935e47 24#include <asm/nmi.h>
241771ef 25
862a1a5f 26static u64 perf_counter_mask __read_mostly;
703e937c 27
241771ef 28struct cpu_hw_counters {
862a1a5f
IM
29 struct perf_counter *counters[X86_PMC_IDX_MAX];
30 unsigned long used[BITS_TO_LONGS(X86_PMC_IDX_MAX)];
93904966 31 unsigned long active[BITS_TO_LONGS(X86_PMC_IDX_MAX)];
4b39fd96 32 unsigned long interrupts;
b0f3f28e 33 u64 throttle_ctrl;
b0f3f28e 34 int enabled;
241771ef
IM
35};
36
37/*
5f4ec28f 38 * struct x86_pmu - generic x86 pmu
241771ef 39 */
5f4ec28f 40struct x86_pmu {
faa28ae0
RR
41 const char *name;
42 int version;
39d81eab 43 int (*handle_irq)(struct pt_regs *, int);
169e41eb 44 u64 (*save_disable_all)(void);
b0f3f28e 45 void (*restore_all)(u64);
7c90cc45 46 void (*enable)(struct hw_perf_counter *, int);
d4369891 47 void (*disable)(struct hw_perf_counter *, int);
169e41eb
JSR
48 unsigned eventsel;
49 unsigned perfctr;
b0f3f28e
PZ
50 u64 (*event_map)(int);
51 u64 (*raw_event)(u64);
169e41eb 52 int max_events;
0933e5c6
RR
53 int num_counters;
54 int num_counters_fixed;
55 int counter_bits;
56 u64 counter_mask;
b56a3802
JSR
57};
58
4a06bd85 59static struct x86_pmu x86_pmu __read_mostly;
b56a3802 60
b0f3f28e
PZ
61static DEFINE_PER_CPU(struct cpu_hw_counters, cpu_hw_counters) = {
62 .enabled = 1,
63};
241771ef 64
b56a3802
JSR
65/*
66 * Intel PerfMon v3. Used on Core2 and later.
67 */
b0f3f28e 68static const u64 intel_perfmon_event_map[] =
241771ef 69{
f650a672 70 [PERF_COUNT_CPU_CYCLES] = 0x003c,
241771ef
IM
71 [PERF_COUNT_INSTRUCTIONS] = 0x00c0,
72 [PERF_COUNT_CACHE_REFERENCES] = 0x4f2e,
73 [PERF_COUNT_CACHE_MISSES] = 0x412e,
74 [PERF_COUNT_BRANCH_INSTRUCTIONS] = 0x00c4,
75 [PERF_COUNT_BRANCH_MISSES] = 0x00c5,
f650a672 76 [PERF_COUNT_BUS_CYCLES] = 0x013c,
241771ef
IM
77};
78
5f4ec28f 79static u64 intel_pmu_event_map(int event)
b56a3802
JSR
80{
81 return intel_perfmon_event_map[event];
82}
241771ef 83
5f4ec28f 84static u64 intel_pmu_raw_event(u64 event)
b0f3f28e 85{
82bae4f8
PZ
86#define CORE_EVNTSEL_EVENT_MASK 0x000000FFULL
87#define CORE_EVNTSEL_UNIT_MASK 0x0000FF00ULL
88#define CORE_EVNTSEL_COUNTER_MASK 0xFF000000ULL
b0f3f28e
PZ
89
90#define CORE_EVNTSEL_MASK \
91 (CORE_EVNTSEL_EVENT_MASK | \
92 CORE_EVNTSEL_UNIT_MASK | \
93 CORE_EVNTSEL_COUNTER_MASK)
94
95 return event & CORE_EVNTSEL_MASK;
96}
97
f87ad35d
JSR
98/*
99 * AMD Performance Monitor K7 and later.
100 */
b0f3f28e 101static const u64 amd_perfmon_event_map[] =
f87ad35d
JSR
102{
103 [PERF_COUNT_CPU_CYCLES] = 0x0076,
104 [PERF_COUNT_INSTRUCTIONS] = 0x00c0,
105 [PERF_COUNT_CACHE_REFERENCES] = 0x0080,
106 [PERF_COUNT_CACHE_MISSES] = 0x0081,
107 [PERF_COUNT_BRANCH_INSTRUCTIONS] = 0x00c4,
108 [PERF_COUNT_BRANCH_MISSES] = 0x00c5,
109};
110
5f4ec28f 111static u64 amd_pmu_event_map(int event)
f87ad35d
JSR
112{
113 return amd_perfmon_event_map[event];
114}
115
5f4ec28f 116static u64 amd_pmu_raw_event(u64 event)
b0f3f28e 117{
82bae4f8
PZ
118#define K7_EVNTSEL_EVENT_MASK 0x7000000FFULL
119#define K7_EVNTSEL_UNIT_MASK 0x00000FF00ULL
120#define K7_EVNTSEL_COUNTER_MASK 0x0FF000000ULL
b0f3f28e
PZ
121
122#define K7_EVNTSEL_MASK \
123 (K7_EVNTSEL_EVENT_MASK | \
124 K7_EVNTSEL_UNIT_MASK | \
125 K7_EVNTSEL_COUNTER_MASK)
126
127 return event & K7_EVNTSEL_MASK;
128}
129
ee06094f
IM
130/*
131 * Propagate counter elapsed time into the generic counter.
132 * Can only be executed on the CPU where the counter is active.
133 * Returns the delta events processed.
134 */
135static void
136x86_perf_counter_update(struct perf_counter *counter,
137 struct hw_perf_counter *hwc, int idx)
138{
139 u64 prev_raw_count, new_raw_count, delta;
140
ee06094f
IM
141 /*
142 * Careful: an NMI might modify the previous counter value.
143 *
144 * Our tactic to handle this is to first atomically read and
145 * exchange a new raw count - then add that new-prev delta
146 * count to the generic counter atomically:
147 */
148again:
149 prev_raw_count = atomic64_read(&hwc->prev_count);
150 rdmsrl(hwc->counter_base + idx, new_raw_count);
151
152 if (atomic64_cmpxchg(&hwc->prev_count, prev_raw_count,
153 new_raw_count) != prev_raw_count)
154 goto again;
155
156 /*
157 * Now we have the new raw value and have updated the prev
158 * timestamp already. We can now calculate the elapsed delta
159 * (counter-)time and add that to the generic counter.
160 *
161 * Careful, not all hw sign-extends above the physical width
162 * of the count, so we do that by clipping the delta to 32 bits:
163 */
164 delta = (u64)(u32)((s32)new_raw_count - (s32)prev_raw_count);
ee06094f
IM
165
166 atomic64_add(delta, &counter->count);
167 atomic64_sub(delta, &hwc->period_left);
168}
169
4e935e47
PZ
170static atomic_t num_counters;
171static DEFINE_MUTEX(pmc_reserve_mutex);
172
173static bool reserve_pmc_hardware(void)
174{
175 int i;
176
177 if (nmi_watchdog == NMI_LOCAL_APIC)
178 disable_lapic_nmi_watchdog();
179
0933e5c6 180 for (i = 0; i < x86_pmu.num_counters; i++) {
4a06bd85 181 if (!reserve_perfctr_nmi(x86_pmu.perfctr + i))
4e935e47
PZ
182 goto perfctr_fail;
183 }
184
0933e5c6 185 for (i = 0; i < x86_pmu.num_counters; i++) {
4a06bd85 186 if (!reserve_evntsel_nmi(x86_pmu.eventsel + i))
4e935e47
PZ
187 goto eventsel_fail;
188 }
189
190 return true;
191
192eventsel_fail:
193 for (i--; i >= 0; i--)
4a06bd85 194 release_evntsel_nmi(x86_pmu.eventsel + i);
4e935e47 195
0933e5c6 196 i = x86_pmu.num_counters;
4e935e47
PZ
197
198perfctr_fail:
199 for (i--; i >= 0; i--)
4a06bd85 200 release_perfctr_nmi(x86_pmu.perfctr + i);
4e935e47
PZ
201
202 if (nmi_watchdog == NMI_LOCAL_APIC)
203 enable_lapic_nmi_watchdog();
204
205 return false;
206}
207
208static void release_pmc_hardware(void)
209{
210 int i;
211
0933e5c6 212 for (i = 0; i < x86_pmu.num_counters; i++) {
4a06bd85
RR
213 release_perfctr_nmi(x86_pmu.perfctr + i);
214 release_evntsel_nmi(x86_pmu.eventsel + i);
4e935e47
PZ
215 }
216
217 if (nmi_watchdog == NMI_LOCAL_APIC)
218 enable_lapic_nmi_watchdog();
219}
220
221static void hw_perf_counter_destroy(struct perf_counter *counter)
222{
223 if (atomic_dec_and_mutex_lock(&num_counters, &pmc_reserve_mutex)) {
224 release_pmc_hardware();
225 mutex_unlock(&pmc_reserve_mutex);
226 }
227}
228
85cf9dba
RR
229static inline int x86_pmu_initialized(void)
230{
231 return x86_pmu.handle_irq != NULL;
232}
233
241771ef
IM
234/*
235 * Setup the hardware configuration for a given hw_event_type
236 */
621a01ea 237static int __hw_perf_counter_init(struct perf_counter *counter)
241771ef 238{
9f66a381 239 struct perf_counter_hw_event *hw_event = &counter->hw_event;
241771ef 240 struct hw_perf_counter *hwc = &counter->hw;
4e935e47 241 int err;
241771ef 242
39d81eab
RR
243 /* disable temporarily */
244 if (boot_cpu_data.x86_vendor == X86_VENDOR_AMD)
245 return -ENOSYS;
246
85cf9dba
RR
247 if (!x86_pmu_initialized())
248 return -ENODEV;
241771ef 249
4e935e47
PZ
250 err = 0;
251 if (atomic_inc_not_zero(&num_counters)) {
252 mutex_lock(&pmc_reserve_mutex);
253 if (atomic_read(&num_counters) == 0 && !reserve_pmc_hardware())
254 err = -EBUSY;
255 else
256 atomic_inc(&num_counters);
257 mutex_unlock(&pmc_reserve_mutex);
258 }
259 if (err)
260 return err;
261
241771ef 262 /*
0475f9ea 263 * Generate PMC IRQs:
241771ef
IM
264 * (keep 'enabled' bit clear for now)
265 */
0475f9ea 266 hwc->config = ARCH_PERFMON_EVENTSEL_INT;
241771ef
IM
267
268 /*
0475f9ea 269 * Count user and OS events unless requested not to.
241771ef 270 */
0475f9ea
PM
271 if (!hw_event->exclude_user)
272 hwc->config |= ARCH_PERFMON_EVENTSEL_USR;
273 if (!hw_event->exclude_kernel)
241771ef 274 hwc->config |= ARCH_PERFMON_EVENTSEL_OS;
0475f9ea
PM
275
276 /*
277 * If privileged enough, allow NMI events:
278 */
279 hwc->nmi = 0;
280 if (capable(CAP_SYS_ADMIN) && hw_event->nmi)
281 hwc->nmi = 1;
241771ef 282
9f66a381 283 hwc->irq_period = hw_event->irq_period;
241771ef
IM
284 /*
285 * Intel PMCs cannot be accessed sanely above 32 bit width,
286 * so we install an artificial 1<<31 period regardless of
287 * the generic counter period:
288 */
f87ad35d
JSR
289 if (boot_cpu_data.x86_vendor == X86_VENDOR_INTEL)
290 if ((s64)hwc->irq_period <= 0 || hwc->irq_period > 0x7FFFFFFF)
291 hwc->irq_period = 0x7FFFFFFF;
241771ef 292
ee06094f 293 atomic64_set(&hwc->period_left, hwc->irq_period);
241771ef
IM
294
295 /*
dfa7c899 296 * Raw event type provide the config in the event structure
241771ef 297 */
f4a2deb4 298 if (perf_event_raw(hw_event)) {
4a06bd85 299 hwc->config |= x86_pmu.raw_event(perf_event_config(hw_event));
241771ef 300 } else {
4a06bd85 301 if (perf_event_id(hw_event) >= x86_pmu.max_events)
241771ef
IM
302 return -EINVAL;
303 /*
304 * The generic map:
305 */
4a06bd85 306 hwc->config |= x86_pmu.event_map(perf_event_id(hw_event));
241771ef 307 }
241771ef 308
4e935e47
PZ
309 counter->destroy = hw_perf_counter_destroy;
310
241771ef
IM
311 return 0;
312}
313
5f4ec28f 314static u64 intel_pmu_save_disable_all(void)
4ac13294
TG
315{
316 u64 ctrl;
317
318 rdmsrl(MSR_CORE_PERF_GLOBAL_CTRL, ctrl);
862a1a5f 319 wrmsrl(MSR_CORE_PERF_GLOBAL_CTRL, 0);
2b9ff0db 320
4ac13294 321 return ctrl;
241771ef 322}
b56a3802 323
5f4ec28f 324static u64 amd_pmu_save_disable_all(void)
f87ad35d 325{
b0f3f28e
PZ
326 struct cpu_hw_counters *cpuc = &__get_cpu_var(cpu_hw_counters);
327 int enabled, idx;
328
329 enabled = cpuc->enabled;
330 cpuc->enabled = 0;
60b3df9c
PZ
331 /*
332 * ensure we write the disable before we start disabling the
5f4ec28f
RR
333 * counters proper, so that amd_pmu_enable_counter() does the
334 * right thing.
60b3df9c 335 */
b0f3f28e 336 barrier();
f87ad35d 337
0933e5c6 338 for (idx = 0; idx < x86_pmu.num_counters; idx++) {
b0f3f28e
PZ
339 u64 val;
340
93904966 341 if (!test_bit(idx, cpuc->active))
4295ee62 342 continue;
f87ad35d 343 rdmsrl(MSR_K7_EVNTSEL0 + idx, val);
4295ee62
RR
344 if (!(val & ARCH_PERFMON_EVENTSEL0_ENABLE))
345 continue;
346 val &= ~ARCH_PERFMON_EVENTSEL0_ENABLE;
347 wrmsrl(MSR_K7_EVNTSEL0 + idx, val);
f87ad35d
JSR
348 }
349
b0f3f28e 350 return enabled;
f87ad35d
JSR
351}
352
b56a3802
JSR
353u64 hw_perf_save_disable(void)
354{
85cf9dba 355 if (!x86_pmu_initialized())
b56a3802 356 return 0;
4a06bd85 357 return x86_pmu.save_disable_all();
b56a3802 358}
b0f3f28e
PZ
359/*
360 * Exported because of ACPI idle
361 */
01b2838c 362EXPORT_SYMBOL_GPL(hw_perf_save_disable);
241771ef 363
5f4ec28f 364static void intel_pmu_restore_all(u64 ctrl)
b56a3802
JSR
365{
366 wrmsrl(MSR_CORE_PERF_GLOBAL_CTRL, ctrl);
367}
368
5f4ec28f 369static void amd_pmu_restore_all(u64 ctrl)
f87ad35d 370{
b0f3f28e 371 struct cpu_hw_counters *cpuc = &__get_cpu_var(cpu_hw_counters);
f87ad35d
JSR
372 int idx;
373
b0f3f28e
PZ
374 cpuc->enabled = ctrl;
375 barrier();
376 if (!ctrl)
377 return;
378
0933e5c6 379 for (idx = 0; idx < x86_pmu.num_counters; idx++) {
4295ee62 380 u64 val;
b0f3f28e 381
93904966 382 if (!test_bit(idx, cpuc->active))
4295ee62
RR
383 continue;
384 rdmsrl(MSR_K7_EVNTSEL0 + idx, val);
385 if (val & ARCH_PERFMON_EVENTSEL0_ENABLE)
386 continue;
387 val |= ARCH_PERFMON_EVENTSEL0_ENABLE;
388 wrmsrl(MSR_K7_EVNTSEL0 + idx, val);
f87ad35d
JSR
389 }
390}
391
ee06094f
IM
392void hw_perf_restore(u64 ctrl)
393{
85cf9dba 394 if (!x86_pmu_initialized())
2b9ff0db 395 return;
4a06bd85 396 x86_pmu.restore_all(ctrl);
ee06094f 397}
b0f3f28e
PZ
398/*
399 * Exported because of ACPI idle
400 */
ee06094f
IM
401EXPORT_SYMBOL_GPL(hw_perf_restore);
402
b7f8859a 403static inline u64 intel_pmu_get_status(u64 mask)
b0f3f28e
PZ
404{
405 u64 status;
406
b7f8859a 407 rdmsrl(MSR_CORE_PERF_GLOBAL_STATUS, status);
b0f3f28e 408
b7f8859a 409 return status;
b0f3f28e
PZ
410}
411
dee5d906 412static inline void intel_pmu_ack_status(u64 ack)
b0f3f28e
PZ
413{
414 wrmsrl(MSR_CORE_PERF_GLOBAL_OVF_CTRL, ack);
415}
416
7c90cc45 417static inline void x86_pmu_enable_counter(struct hw_perf_counter *hwc, int idx)
b0f3f28e 418{
7c90cc45 419 int err;
7c90cc45
RR
420 err = checking_wrmsrl(hwc->config_base + idx,
421 hwc->config | ARCH_PERFMON_EVENTSEL0_ENABLE);
b0f3f28e
PZ
422}
423
d4369891 424static inline void x86_pmu_disable_counter(struct hw_perf_counter *hwc, int idx)
b0f3f28e 425{
d4369891 426 int err;
d4369891
RR
427 err = checking_wrmsrl(hwc->config_base + idx,
428 hwc->config);
b0f3f28e
PZ
429}
430
2f18d1e8 431static inline void
d4369891 432intel_pmu_disable_fixed(struct hw_perf_counter *hwc, int __idx)
2f18d1e8
IM
433{
434 int idx = __idx - X86_PMC_IDX_FIXED;
435 u64 ctrl_val, mask;
436 int err;
437
438 mask = 0xfULL << (idx * 4);
439
440 rdmsrl(hwc->config_base, ctrl_val);
441 ctrl_val &= ~mask;
442 err = checking_wrmsrl(hwc->config_base, ctrl_val);
443}
444
7e2ae347 445static inline void
d4369891 446intel_pmu_disable_counter(struct hw_perf_counter *hwc, int idx)
7e2ae347 447{
d4369891
RR
448 if (unlikely(hwc->config_base == MSR_ARCH_PERFMON_FIXED_CTR_CTRL)) {
449 intel_pmu_disable_fixed(hwc, idx);
450 return;
451 }
452
453 x86_pmu_disable_counter(hwc, idx);
454}
455
456static inline void
457amd_pmu_disable_counter(struct hw_perf_counter *hwc, int idx)
458{
459 x86_pmu_disable_counter(hwc, idx);
7e2ae347
IM
460}
461
2f18d1e8 462static DEFINE_PER_CPU(u64, prev_left[X86_PMC_IDX_MAX]);
241771ef 463
ee06094f
IM
464/*
465 * Set the next IRQ period, based on the hwc->period_left value.
466 * To be called with the counter disabled in hw:
467 */
468static void
26816c28 469x86_perf_counter_set_period(struct perf_counter *counter,
ee06094f 470 struct hw_perf_counter *hwc, int idx)
241771ef 471{
2f18d1e8 472 s64 left = atomic64_read(&hwc->period_left);
595258aa 473 s64 period = hwc->irq_period;
2f18d1e8 474 int err;
ee06094f 475
ee06094f
IM
476 /*
477 * If we are way outside a reasoable range then just skip forward:
478 */
479 if (unlikely(left <= -period)) {
480 left = period;
481 atomic64_set(&hwc->period_left, left);
482 }
483
484 if (unlikely(left <= 0)) {
485 left += period;
486 atomic64_set(&hwc->period_left, left);
487 }
241771ef 488
ee06094f
IM
489 per_cpu(prev_left[idx], smp_processor_id()) = left;
490
491 /*
492 * The hw counter starts counting from this counter offset,
493 * mark it to be able to extra future deltas:
494 */
2f18d1e8 495 atomic64_set(&hwc->prev_count, (u64)-left);
ee06094f 496
2f18d1e8 497 err = checking_wrmsrl(hwc->counter_base + idx,
0933e5c6 498 (u64)(-left) & x86_pmu.counter_mask);
2f18d1e8
IM
499}
500
501static inline void
7c90cc45 502intel_pmu_enable_fixed(struct hw_perf_counter *hwc, int __idx)
2f18d1e8
IM
503{
504 int idx = __idx - X86_PMC_IDX_FIXED;
505 u64 ctrl_val, bits, mask;
506 int err;
507
508 /*
0475f9ea
PM
509 * Enable IRQ generation (0x8),
510 * and enable ring-3 counting (0x2) and ring-0 counting (0x1)
511 * if requested:
2f18d1e8 512 */
0475f9ea
PM
513 bits = 0x8ULL;
514 if (hwc->config & ARCH_PERFMON_EVENTSEL_USR)
515 bits |= 0x2;
2f18d1e8
IM
516 if (hwc->config & ARCH_PERFMON_EVENTSEL_OS)
517 bits |= 0x1;
518 bits <<= (idx * 4);
519 mask = 0xfULL << (idx * 4);
520
521 rdmsrl(hwc->config_base, ctrl_val);
522 ctrl_val &= ~mask;
523 ctrl_val |= bits;
524 err = checking_wrmsrl(hwc->config_base, ctrl_val);
7e2ae347
IM
525}
526
7c90cc45 527static void intel_pmu_enable_counter(struct hw_perf_counter *hwc, int idx)
7e2ae347 528{
7c90cc45
RR
529 if (unlikely(hwc->config_base == MSR_ARCH_PERFMON_FIXED_CTR_CTRL)) {
530 intel_pmu_enable_fixed(hwc, idx);
531 return;
532 }
533
534 x86_pmu_enable_counter(hwc, idx);
535}
536
537static void amd_pmu_enable_counter(struct hw_perf_counter *hwc, int idx)
538{
539 struct cpu_hw_counters *cpuc = &__get_cpu_var(cpu_hw_counters);
540
541 if (cpuc->enabled)
542 x86_pmu_enable_counter(hwc, idx);
2b583d8b 543 else
d4369891 544 x86_pmu_disable_counter(hwc, idx);
241771ef
IM
545}
546
2f18d1e8
IM
547static int
548fixed_mode_idx(struct perf_counter *counter, struct hw_perf_counter *hwc)
862a1a5f 549{
2f18d1e8
IM
550 unsigned int event;
551
f87ad35d
JSR
552 if (boot_cpu_data.x86_vendor == X86_VENDOR_AMD)
553 return -1;
554
2f18d1e8
IM
555 if (unlikely(hwc->nmi))
556 return -1;
557
558 event = hwc->config & ARCH_PERFMON_EVENT_MASK;
559
4a06bd85 560 if (unlikely(event == x86_pmu.event_map(PERF_COUNT_INSTRUCTIONS)))
2f18d1e8 561 return X86_PMC_IDX_FIXED_INSTRUCTIONS;
4a06bd85 562 if (unlikely(event == x86_pmu.event_map(PERF_COUNT_CPU_CYCLES)))
2f18d1e8 563 return X86_PMC_IDX_FIXED_CPU_CYCLES;
4a06bd85 564 if (unlikely(event == x86_pmu.event_map(PERF_COUNT_BUS_CYCLES)))
2f18d1e8
IM
565 return X86_PMC_IDX_FIXED_BUS_CYCLES;
566
862a1a5f
IM
567 return -1;
568}
569
ee06094f
IM
570/*
571 * Find a PMC slot for the freshly enabled / scheduled in counter:
572 */
4aeb0b42 573static int x86_pmu_enable(struct perf_counter *counter)
241771ef
IM
574{
575 struct cpu_hw_counters *cpuc = &__get_cpu_var(cpu_hw_counters);
576 struct hw_perf_counter *hwc = &counter->hw;
2f18d1e8 577 int idx;
241771ef 578
2f18d1e8
IM
579 idx = fixed_mode_idx(counter, hwc);
580 if (idx >= 0) {
581 /*
582 * Try to get the fixed counter, if that is already taken
583 * then try to get a generic counter:
584 */
585 if (test_and_set_bit(idx, cpuc->used))
586 goto try_generic;
0dff86aa 587
2f18d1e8
IM
588 hwc->config_base = MSR_ARCH_PERFMON_FIXED_CTR_CTRL;
589 /*
590 * We set it so that counter_base + idx in wrmsr/rdmsr maps to
591 * MSR_ARCH_PERFMON_FIXED_CTR0 ... CTR2:
592 */
593 hwc->counter_base =
594 MSR_ARCH_PERFMON_FIXED_CTR0 - X86_PMC_IDX_FIXED;
241771ef 595 hwc->idx = idx;
2f18d1e8
IM
596 } else {
597 idx = hwc->idx;
598 /* Try to get the previous generic counter again */
599 if (test_and_set_bit(idx, cpuc->used)) {
600try_generic:
0933e5c6
RR
601 idx = find_first_zero_bit(cpuc->used,
602 x86_pmu.num_counters);
603 if (idx == x86_pmu.num_counters)
2f18d1e8
IM
604 return -EAGAIN;
605
606 set_bit(idx, cpuc->used);
607 hwc->idx = idx;
608 }
4a06bd85
RR
609 hwc->config_base = x86_pmu.eventsel;
610 hwc->counter_base = x86_pmu.perfctr;
241771ef
IM
611 }
612
613 perf_counters_lapic_init(hwc->nmi);
614
d4369891 615 x86_pmu.disable(hwc, idx);
241771ef 616
862a1a5f 617 cpuc->counters[idx] = counter;
09534238 618 set_bit(idx, cpuc->active);
7e2ae347 619
26816c28 620 x86_perf_counter_set_period(counter, hwc, idx);
7c90cc45 621 x86_pmu.enable(hwc, idx);
95cdd2e7
IM
622
623 return 0;
241771ef
IM
624}
625
626void perf_counter_print_debug(void)
627{
2f18d1e8 628 u64 ctrl, status, overflow, pmc_ctrl, pmc_count, prev_left, fixed;
0dff86aa 629 struct cpu_hw_counters *cpuc;
1e125676
IM
630 int cpu, idx;
631
0933e5c6 632 if (!x86_pmu.num_counters)
1e125676 633 return;
241771ef
IM
634
635 local_irq_disable();
636
637 cpu = smp_processor_id();
0dff86aa 638 cpuc = &per_cpu(cpu_hw_counters, cpu);
241771ef 639
faa28ae0 640 if (x86_pmu.version >= 2) {
a1ef58f4
JSR
641 rdmsrl(MSR_CORE_PERF_GLOBAL_CTRL, ctrl);
642 rdmsrl(MSR_CORE_PERF_GLOBAL_STATUS, status);
643 rdmsrl(MSR_CORE_PERF_GLOBAL_OVF_CTRL, overflow);
644 rdmsrl(MSR_ARCH_PERFMON_FIXED_CTR_CTRL, fixed);
645
646 pr_info("\n");
647 pr_info("CPU#%d: ctrl: %016llx\n", cpu, ctrl);
648 pr_info("CPU#%d: status: %016llx\n", cpu, status);
649 pr_info("CPU#%d: overflow: %016llx\n", cpu, overflow);
650 pr_info("CPU#%d: fixed: %016llx\n", cpu, fixed);
f87ad35d 651 }
a1ef58f4 652 pr_info("CPU#%d: used: %016llx\n", cpu, *(u64 *)cpuc->used);
241771ef 653
0933e5c6 654 for (idx = 0; idx < x86_pmu.num_counters; idx++) {
4a06bd85
RR
655 rdmsrl(x86_pmu.eventsel + idx, pmc_ctrl);
656 rdmsrl(x86_pmu.perfctr + idx, pmc_count);
241771ef 657
ee06094f 658 prev_left = per_cpu(prev_left[idx], cpu);
241771ef 659
a1ef58f4 660 pr_info("CPU#%d: gen-PMC%d ctrl: %016llx\n",
241771ef 661 cpu, idx, pmc_ctrl);
a1ef58f4 662 pr_info("CPU#%d: gen-PMC%d count: %016llx\n",
241771ef 663 cpu, idx, pmc_count);
a1ef58f4 664 pr_info("CPU#%d: gen-PMC%d left: %016llx\n",
ee06094f 665 cpu, idx, prev_left);
241771ef 666 }
0933e5c6 667 for (idx = 0; idx < x86_pmu.num_counters_fixed; idx++) {
2f18d1e8
IM
668 rdmsrl(MSR_ARCH_PERFMON_FIXED_CTR0 + idx, pmc_count);
669
a1ef58f4 670 pr_info("CPU#%d: fixed-PMC%d count: %016llx\n",
2f18d1e8
IM
671 cpu, idx, pmc_count);
672 }
241771ef
IM
673 local_irq_enable();
674}
675
4aeb0b42 676static void x86_pmu_disable(struct perf_counter *counter)
241771ef
IM
677{
678 struct cpu_hw_counters *cpuc = &__get_cpu_var(cpu_hw_counters);
679 struct hw_perf_counter *hwc = &counter->hw;
6f00cada 680 int idx = hwc->idx;
241771ef 681
09534238
RR
682 /*
683 * Must be done before we disable, otherwise the nmi handler
684 * could reenable again:
685 */
686 clear_bit(idx, cpuc->active);
d4369891 687 x86_pmu.disable(hwc, idx);
241771ef 688
2f18d1e8
IM
689 /*
690 * Make sure the cleared pointer becomes visible before we
691 * (potentially) free the counter:
692 */
527e26af 693 barrier();
241771ef 694
ee06094f
IM
695 /*
696 * Drain the remaining delta count out of a counter
697 * that we are disabling:
698 */
699 x86_perf_counter_update(counter, hwc, idx);
09534238
RR
700 cpuc->counters[idx] = NULL;
701 clear_bit(idx, cpuc->used);
241771ef
IM
702}
703
7e2ae347 704/*
ee06094f
IM
705 * Save and restart an expired counter. Called by NMI contexts,
706 * so it has to be careful about preempting normal counter ops:
7e2ae347 707 */
55de0f2e 708static void intel_pmu_save_and_restart(struct perf_counter *counter)
241771ef
IM
709{
710 struct hw_perf_counter *hwc = &counter->hw;
711 int idx = hwc->idx;
241771ef 712
ee06094f 713 x86_perf_counter_update(counter, hwc, idx);
26816c28 714 x86_perf_counter_set_period(counter, hwc, idx);
7e2ae347 715
2f18d1e8 716 if (counter->state == PERF_COUNTER_STATE_ACTIVE)
7c90cc45 717 intel_pmu_enable_counter(hwc, idx);
241771ef
IM
718}
719
4b39fd96
MG
720/*
721 * Maximum interrupt frequency of 100KHz per CPU
722 */
169e41eb 723#define PERFMON_MAX_INTERRUPTS (100000/HZ)
4b39fd96 724
241771ef
IM
725/*
726 * This handler is triggered by the local APIC, so the APIC IRQ handling
727 * rules apply:
728 */
39d81eab 729static int intel_pmu_handle_irq(struct pt_regs *regs, int nmi)
241771ef
IM
730{
731 int bit, cpu = smp_processor_id();
4b39fd96 732 u64 ack, status;
1b023a96 733 struct cpu_hw_counters *cpuc = &per_cpu(cpu_hw_counters, cpu);
b0f3f28e 734 int ret = 0;
43874d23 735
55de0f2e 736 cpuc->throttle_ctrl = intel_pmu_save_disable_all();
241771ef 737
b7f8859a 738 status = intel_pmu_get_status(cpuc->throttle_ctrl);
87b9cf46
IM
739 if (!status)
740 goto out;
741
b0f3f28e 742 ret = 1;
241771ef 743again:
d278c484 744 inc_irq_stat(apic_perf_irqs);
241771ef 745 ack = status;
2f18d1e8 746 for_each_bit(bit, (unsigned long *)&status, X86_PMC_IDX_MAX) {
862a1a5f 747 struct perf_counter *counter = cpuc->counters[bit];
241771ef
IM
748
749 clear_bit(bit, (unsigned long *) &status);
09534238 750 if (!test_bit(bit, cpuc->active))
241771ef
IM
751 continue;
752
55de0f2e 753 intel_pmu_save_and_restart(counter);
78f13e95 754 if (perf_counter_overflow(counter, nmi, regs, 0))
d4369891 755 intel_pmu_disable_counter(&counter->hw, bit);
241771ef
IM
756 }
757
dee5d906 758 intel_pmu_ack_status(ack);
241771ef
IM
759
760 /*
761 * Repeat if there is more work to be done:
762 */
b7f8859a 763 status = intel_pmu_get_status(cpuc->throttle_ctrl);
241771ef
IM
764 if (status)
765 goto again;
87b9cf46 766out:
241771ef 767 /*
1b023a96 768 * Restore - do not reenable when global enable is off or throttled:
241771ef 769 */
4b39fd96 770 if (++cpuc->interrupts < PERFMON_MAX_INTERRUPTS)
55de0f2e 771 intel_pmu_restore_all(cpuc->throttle_ctrl);
b0f3f28e
PZ
772
773 return ret;
1b023a96
MG
774}
775
39d81eab
RR
776static int amd_pmu_handle_irq(struct pt_regs *regs, int nmi) { return 0; }
777
1b023a96
MG
778void perf_counter_unthrottle(void)
779{
780 struct cpu_hw_counters *cpuc;
781
85cf9dba 782 if (!x86_pmu_initialized())
1b023a96
MG
783 return;
784
85cf9dba 785 if (!cpu_has(&boot_cpu_data, X86_FEATURE_ARCH_PERFMON))
1b023a96
MG
786 return;
787
b0f3f28e 788 cpuc = &__get_cpu_var(cpu_hw_counters);
4b39fd96 789 if (cpuc->interrupts >= PERFMON_MAX_INTERRUPTS) {
1b023a96 790 if (printk_ratelimit())
4b39fd96 791 printk(KERN_WARNING "PERFMON: max interrupts exceeded!\n");
b0f3f28e 792 hw_perf_restore(cpuc->throttle_ctrl);
1b023a96 793 }
4b39fd96 794 cpuc->interrupts = 0;
241771ef
IM
795}
796
797void smp_perf_counter_interrupt(struct pt_regs *regs)
798{
799 irq_enter();
241771ef 800 apic_write(APIC_LVTPC, LOCAL_PERF_VECTOR);
b0f3f28e 801 ack_APIC_irq();
4a06bd85 802 x86_pmu.handle_irq(regs, 0);
241771ef
IM
803 irq_exit();
804}
805
b6276f35
PZ
806void smp_perf_pending_interrupt(struct pt_regs *regs)
807{
808 irq_enter();
809 ack_APIC_irq();
810 inc_irq_stat(apic_pending_irqs);
811 perf_counter_do_pending();
812 irq_exit();
813}
814
815void set_perf_counter_pending(void)
816{
817 apic->send_IPI_self(LOCAL_PENDING_VECTOR);
818}
819
3415dd91 820void perf_counters_lapic_init(int nmi)
241771ef
IM
821{
822 u32 apic_val;
823
85cf9dba 824 if (!x86_pmu_initialized())
241771ef 825 return;
85cf9dba 826
241771ef
IM
827 /*
828 * Enable the performance counter vector in the APIC LVT:
829 */
830 apic_val = apic_read(APIC_LVTERR);
831
832 apic_write(APIC_LVTERR, apic_val | APIC_LVT_MASKED);
833 if (nmi)
834 apic_write(APIC_LVTPC, APIC_DM_NMI);
835 else
836 apic_write(APIC_LVTPC, LOCAL_PERF_VECTOR);
837 apic_write(APIC_LVTERR, apic_val);
838}
839
840static int __kprobes
841perf_counter_nmi_handler(struct notifier_block *self,
842 unsigned long cmd, void *__args)
843{
844 struct die_args *args = __args;
845 struct pt_regs *regs;
b0f3f28e
PZ
846 int ret;
847
848 switch (cmd) {
849 case DIE_NMI:
850 case DIE_NMI_IPI:
851 break;
241771ef 852
b0f3f28e 853 default:
241771ef 854 return NOTIFY_DONE;
b0f3f28e 855 }
241771ef
IM
856
857 regs = args->regs;
858
859 apic_write(APIC_LVTPC, APIC_DM_NMI);
4a06bd85 860 ret = x86_pmu.handle_irq(regs, 1);
241771ef 861
b0f3f28e 862 return ret ? NOTIFY_STOP : NOTIFY_OK;
241771ef
IM
863}
864
865static __read_mostly struct notifier_block perf_counter_nmi_notifier = {
5b75af0a
MG
866 .notifier_call = perf_counter_nmi_handler,
867 .next = NULL,
868 .priority = 1
241771ef
IM
869};
870
5f4ec28f 871static struct x86_pmu intel_pmu = {
faa28ae0 872 .name = "Intel",
39d81eab 873 .handle_irq = intel_pmu_handle_irq,
5f4ec28f
RR
874 .save_disable_all = intel_pmu_save_disable_all,
875 .restore_all = intel_pmu_restore_all,
5f4ec28f
RR
876 .enable = intel_pmu_enable_counter,
877 .disable = intel_pmu_disable_counter,
b56a3802
JSR
878 .eventsel = MSR_ARCH_PERFMON_EVENTSEL0,
879 .perfctr = MSR_ARCH_PERFMON_PERFCTR0,
5f4ec28f
RR
880 .event_map = intel_pmu_event_map,
881 .raw_event = intel_pmu_raw_event,
b56a3802
JSR
882 .max_events = ARRAY_SIZE(intel_perfmon_event_map),
883};
884
5f4ec28f 885static struct x86_pmu amd_pmu = {
faa28ae0 886 .name = "AMD",
39d81eab 887 .handle_irq = amd_pmu_handle_irq,
5f4ec28f
RR
888 .save_disable_all = amd_pmu_save_disable_all,
889 .restore_all = amd_pmu_restore_all,
5f4ec28f
RR
890 .enable = amd_pmu_enable_counter,
891 .disable = amd_pmu_disable_counter,
f87ad35d
JSR
892 .eventsel = MSR_K7_EVNTSEL0,
893 .perfctr = MSR_K7_PERFCTR0,
5f4ec28f
RR
894 .event_map = amd_pmu_event_map,
895 .raw_event = amd_pmu_raw_event,
f87ad35d 896 .max_events = ARRAY_SIZE(amd_perfmon_event_map),
0933e5c6
RR
897 .num_counters = 4,
898 .counter_bits = 48,
899 .counter_mask = (1ULL << 48) - 1,
f87ad35d
JSR
900};
901
72eae04d 902static int intel_pmu_init(void)
241771ef 903{
7bb497bd 904 union cpuid10_edx edx;
241771ef 905 union cpuid10_eax eax;
703e937c 906 unsigned int unused;
7bb497bd 907 unsigned int ebx;
faa28ae0 908 int version;
241771ef 909
da1a776b 910 if (!cpu_has(&boot_cpu_data, X86_FEATURE_ARCH_PERFMON))
72eae04d 911 return -ENODEV;
da1a776b 912
241771ef
IM
913 /*
914 * Check whether the Architectural PerfMon supports
915 * Branch Misses Retired Event or not.
916 */
703e937c 917 cpuid(10, &eax.full, &ebx, &unused, &edx.full);
241771ef 918 if (eax.split.mask_length <= ARCH_PERFMON_BRANCH_MISSES_RETIRED)
72eae04d 919 return -ENODEV;
241771ef 920
faa28ae0
RR
921 version = eax.split.version_id;
922 if (version < 2)
72eae04d 923 return -ENODEV;
7bb497bd 924
4a06bd85 925 x86_pmu = intel_pmu;
faa28ae0 926 x86_pmu.version = version;
0933e5c6
RR
927 x86_pmu.num_counters = eax.split.num_counters;
928 x86_pmu.num_counters_fixed = edx.split.num_counters_fixed;
929 x86_pmu.counter_bits = eax.split.bit_width;
930 x86_pmu.counter_mask = (1ULL << eax.split.bit_width) - 1;
b56a3802 931
72eae04d 932 return 0;
b56a3802
JSR
933}
934
72eae04d 935static int amd_pmu_init(void)
f87ad35d 936{
4a06bd85 937 x86_pmu = amd_pmu;
72eae04d 938 return 0;
f87ad35d
JSR
939}
940
b56a3802
JSR
941void __init init_hw_perf_counters(void)
942{
72eae04d
RR
943 int err;
944
b56a3802
JSR
945 switch (boot_cpu_data.x86_vendor) {
946 case X86_VENDOR_INTEL:
72eae04d 947 err = intel_pmu_init();
b56a3802 948 break;
f87ad35d 949 case X86_VENDOR_AMD:
72eae04d 950 err = amd_pmu_init();
f87ad35d 951 break;
4138960a
RR
952 default:
953 return;
b56a3802 954 }
72eae04d 955 if (err != 0)
b56a3802
JSR
956 return;
957
faa28ae0
RR
958 pr_info("%s Performance Monitoring support detected.\n", x86_pmu.name);
959 pr_info("... version: %d\n", x86_pmu.version);
960 pr_info("... bit width: %d\n", x86_pmu.counter_bits);
961
0933e5c6
RR
962 pr_info("... num counters: %d\n", x86_pmu.num_counters);
963 if (x86_pmu.num_counters > X86_PMC_MAX_GENERIC) {
964 x86_pmu.num_counters = X86_PMC_MAX_GENERIC;
241771ef 965 WARN(1, KERN_ERR "hw perf counters %d > max(%d), clipping!",
0933e5c6 966 x86_pmu.num_counters, X86_PMC_MAX_GENERIC);
241771ef 967 }
0933e5c6
RR
968 perf_counter_mask = (1 << x86_pmu.num_counters) - 1;
969 perf_max_counters = x86_pmu.num_counters;
241771ef 970
0933e5c6 971 pr_info("... value mask: %016Lx\n", x86_pmu.counter_mask);
2f18d1e8 972
0933e5c6
RR
973 if (x86_pmu.num_counters_fixed > X86_PMC_MAX_FIXED) {
974 x86_pmu.num_counters_fixed = X86_PMC_MAX_FIXED;
703e937c 975 WARN(1, KERN_ERR "hw perf counters fixed %d > max(%d), clipping!",
0933e5c6 976 x86_pmu.num_counters_fixed, X86_PMC_MAX_FIXED);
703e937c 977 }
0933e5c6 978 pr_info("... fixed counters: %d\n", x86_pmu.num_counters_fixed);
862a1a5f 979
0933e5c6
RR
980 perf_counter_mask |=
981 ((1LL << x86_pmu.num_counters_fixed)-1) << X86_PMC_IDX_FIXED;
241771ef 982
a1ef58f4 983 pr_info("... counter mask: %016Lx\n", perf_counter_mask);
75f224cf 984
241771ef
IM
985 perf_counters_lapic_init(0);
986 register_die_notifier(&perf_counter_nmi_notifier);
241771ef 987}
621a01ea 988
bb775fc2 989static inline void x86_pmu_read(struct perf_counter *counter)
ee06094f
IM
990{
991 x86_perf_counter_update(counter, &counter->hw, counter->hw.idx);
992}
993
4aeb0b42
RR
994static const struct pmu pmu = {
995 .enable = x86_pmu_enable,
996 .disable = x86_pmu_disable,
997 .read = x86_pmu_read,
621a01ea
IM
998};
999
4aeb0b42 1000const struct pmu *hw_perf_counter_init(struct perf_counter *counter)
621a01ea
IM
1001{
1002 int err;
1003
1004 err = __hw_perf_counter_init(counter);
1005 if (err)
9ea98e19 1006 return ERR_PTR(err);
621a01ea 1007
4aeb0b42 1008 return &pmu;
621a01ea 1009}
d7d59fb3
PZ
1010
1011/*
1012 * callchain support
1013 */
1014
1015static inline
1016void callchain_store(struct perf_callchain_entry *entry, unsigned long ip)
1017{
1018 if (entry->nr < MAX_STACK_DEPTH)
1019 entry->ip[entry->nr++] = ip;
1020}
1021
1022static DEFINE_PER_CPU(struct perf_callchain_entry, irq_entry);
1023static DEFINE_PER_CPU(struct perf_callchain_entry, nmi_entry);
1024
1025
1026static void
1027backtrace_warning_symbol(void *data, char *msg, unsigned long symbol)
1028{
1029 /* Ignore warnings */
1030}
1031
1032static void backtrace_warning(void *data, char *msg)
1033{
1034 /* Ignore warnings */
1035}
1036
1037static int backtrace_stack(void *data, char *name)
1038{
1039 /* Don't bother with IRQ stacks for now */
1040 return -1;
1041}
1042
1043static void backtrace_address(void *data, unsigned long addr, int reliable)
1044{
1045 struct perf_callchain_entry *entry = data;
1046
1047 if (reliable)
1048 callchain_store(entry, addr);
1049}
1050
1051static const struct stacktrace_ops backtrace_ops = {
1052 .warning = backtrace_warning,
1053 .warning_symbol = backtrace_warning_symbol,
1054 .stack = backtrace_stack,
1055 .address = backtrace_address,
1056};
1057
1058static void
1059perf_callchain_kernel(struct pt_regs *regs, struct perf_callchain_entry *entry)
1060{
1061 unsigned long bp;
1062 char *stack;
5872bdb8 1063 int nr = entry->nr;
d7d59fb3
PZ
1064
1065 callchain_store(entry, instruction_pointer(regs));
1066
1067 stack = ((char *)regs + sizeof(struct pt_regs));
1068#ifdef CONFIG_FRAME_POINTER
1069 bp = frame_pointer(regs);
1070#else
1071 bp = 0;
1072#endif
1073
1074 dump_trace(NULL, regs, (void *)stack, bp, &backtrace_ops, entry);
5872bdb8
PZ
1075
1076 entry->kernel = entry->nr - nr;
d7d59fb3
PZ
1077}
1078
1079
1080struct stack_frame {
1081 const void __user *next_fp;
1082 unsigned long return_address;
1083};
1084
1085static int copy_stack_frame(const void __user *fp, struct stack_frame *frame)
1086{
1087 int ret;
1088
1089 if (!access_ok(VERIFY_READ, fp, sizeof(*frame)))
1090 return 0;
1091
1092 ret = 1;
1093 pagefault_disable();
1094 if (__copy_from_user_inatomic(frame, fp, sizeof(*frame)))
1095 ret = 0;
1096 pagefault_enable();
1097
1098 return ret;
1099}
1100
1101static void
1102perf_callchain_user(struct pt_regs *regs, struct perf_callchain_entry *entry)
1103{
1104 struct stack_frame frame;
1105 const void __user *fp;
5872bdb8 1106 int nr = entry->nr;
d7d59fb3
PZ
1107
1108 regs = (struct pt_regs *)current->thread.sp0 - 1;
1109 fp = (void __user *)regs->bp;
1110
1111 callchain_store(entry, regs->ip);
1112
1113 while (entry->nr < MAX_STACK_DEPTH) {
1114 frame.next_fp = NULL;
1115 frame.return_address = 0;
1116
1117 if (!copy_stack_frame(fp, &frame))
1118 break;
1119
1120 if ((unsigned long)fp < user_stack_pointer(regs))
1121 break;
1122
1123 callchain_store(entry, frame.return_address);
1124 fp = frame.next_fp;
1125 }
5872bdb8
PZ
1126
1127 entry->user = entry->nr - nr;
d7d59fb3
PZ
1128}
1129
1130static void
1131perf_do_callchain(struct pt_regs *regs, struct perf_callchain_entry *entry)
1132{
1133 int is_user;
1134
1135 if (!regs)
1136 return;
1137
1138 is_user = user_mode(regs);
1139
1140 if (!current || current->pid == 0)
1141 return;
1142
1143 if (is_user && current->state != TASK_RUNNING)
1144 return;
1145
1146 if (!is_user)
1147 perf_callchain_kernel(regs, entry);
1148
1149 if (current->mm)
1150 perf_callchain_user(regs, entry);
1151}
1152
1153struct perf_callchain_entry *perf_callchain(struct pt_regs *regs)
1154{
1155 struct perf_callchain_entry *entry;
1156
1157 if (in_nmi())
1158 entry = &__get_cpu_var(nmi_entry);
1159 else
1160 entry = &__get_cpu_var(irq_entry);
1161
1162 entry->nr = 0;
5872bdb8
PZ
1163 entry->hv = 0;
1164 entry->kernel = 0;
1165 entry->user = 0;
d7d59fb3
PZ
1166
1167 perf_do_callchain(regs, entry);
1168
1169 return entry;
1170}