arch/powerpc/include/asm/perf_counter.h

   1 /*
   2  * Performance counter support - PowerPC-specific definitions.
   3  *
   4  * Copyright 2008-2009 Paul Mackerras, IBM Corporation.
   5  *
   6  * This program is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU General Public License
   8  * as published by the Free Software Foundation; either version
   9  * 2 of the License, or (at your option) any later version.
  10  */
  11 #include <linux/types.h>
  12
  13 #define MAX_HWCOUNTERS          8
  14 #define MAX_EVENT_ALTERNATIVES  8
  15 #define MAX_LIMITED_HWCOUNTERS  2
  16
  17 /*
  18  * This struct provides the constants and functions needed to
  19  * describe the PMU on a particular POWER-family CPU.
  20  */
  21 struct power_pmu {
  22         int     n_counter;
  23         int     max_alternatives;
  24         u64     add_fields;
  25         u64     test_adder;
  26         int     (*compute_mmcr)(u64 events[], int n_ev,
  27                                 unsigned int hwc[], u64 mmcr[]);
  28         int     (*get_constraint)(u64 event, u64 *mskp, u64 *valp);
  29         int     (*get_alternatives)(u64 event, unsigned int flags,
  30                                     u64 alt[]);
  31         void    (*disable_pmc)(unsigned int pmc, u64 mmcr[]);
  32         int     (*limited_pmc_event)(u64 event);
  33         int     limited_pmc5_6; /* PMC5 and PMC6 have limited function */
  34         int     n_generic;
  35         int     *generic_events;
  36 };
  37
  38 extern struct power_pmu *ppmu;
  39
  40 /*
  41  * Values for flags to get_alternatives()
  42  */
  43 #define PPMU_LIMITED_PMC_OK     1       /* can put this on a limited PMC */
  44 #define PPMU_LIMITED_PMC_REQD   2       /* have to put this on a limited PMC */
  45 #define PPMU_ONLY_COUNT_RUN     4       /* only counting in run state */
  46
  47 /*
  48  * The power_pmu.get_constraint function returns a 64-bit value and
  49  * a 64-bit mask that express the constraints between this event and
  50  * other events.
  51  *
  52  * The value and mask are divided up into (non-overlapping) bitfields
  53  * of three different types:
  54  *
  55  * Select field: this expresses the constraint that some set of bits
  56  * in MMCR* needs to be set to a specific value for this event.  For a
  57  * select field, the mask contains 1s in every bit of the field, and
  58  * the value contains a unique value for each possible setting of the
  59  * MMCR* bits.  The constraint checking code will ensure that two events
  60  * that set the same field in their masks have the same value in their
  61  * value dwords.
  62  *
  63  * Add field: this expresses the constraint that there can be at most
  64  * N events in a particular class.  A field of k bits can be used for
  65  * N <= 2^(k-1) - 1.  The mask has the most significant bit of the field
  66  * set (and the other bits 0), and the value has only the least significant
  67  * bit of the field set.  In addition, the 'add_fields' and 'test_adder'
  68  * in the struct power_pmu for this processor come into play.  The
  69  * add_fields value contains 1 in the LSB of the field, and the
  70  * test_adder contains 2^(k-1) - 1 - N in the field.
  71  *
  72  * NAND field: this expresses the constraint that you may not have events
  73  * in all of a set of classes.  (For example, on PPC970, you can't select
  74  * events from the FPU, ISU and IDU simultaneously, although any two are
  75  * possible.)  For N classes, the field is N+1 bits wide, and each class
  76  * is assigned one bit from the least-significant N bits.  The mask has
  77  * only the most-significant bit set, and the value has only the bit
  78  * for the event's class set.  The test_adder has the least significant
  79  * bit set in the field.
  80  *
  81  * If an event is not subject to the constraint expressed by a particular
  82  * field, then it will have 0 in both the mask and value for that field.
  83  */