root/tools/perf/util/cs-etm.h

INCLUDED FROM

DEFINITIONS

1. cs_etm__process_auxtrace_info
2. cs_etm__get_cpu
3. cs_etm__etmq_set_tid
4. cs_etm__etmq_is_timeless
5. cs_etm__etmq_set_traceid_queue_timestamp
6. cs_etm__etmq_get_packet_queue

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Copyright(C) 2015 Linaro Limited. All rights reserved.
   4  * Author: Mathieu Poirier <mathieu.poirier@linaro.org>
   5  */
   6 
   7 #ifndef INCLUDE__UTIL_PERF_CS_ETM_H__
   8 #define INCLUDE__UTIL_PERF_CS_ETM_H__
   9 
  10 #include "util/event.h"
  11 #include <linux/bits.h>
  12 
  13 struct perf_session;
  14 
  15 /* Versionning header in case things need tro change in the future.  That way
  16  * decoding of old snapshot is still possible.
  17  */
  18 enum {
  19         /* Starting with 0x0 */
  20         CS_HEADER_VERSION_0,
  21         /* PMU->type (32 bit), total # of CPUs (32 bit) */
  22         CS_PMU_TYPE_CPUS,
  23         CS_ETM_SNAPSHOT,
  24         CS_HEADER_VERSION_0_MAX,
  25 };
  26 
  27 /* Beginning of header common to both ETMv3 and V4 */
  28 enum {
  29         CS_ETM_MAGIC,
  30         CS_ETM_CPU,
  31 };
  32 
  33 /* ETMv3/PTM metadata */
  34 enum {
  35         /* Dynamic, configurable parameters */
  36         CS_ETM_ETMCR = CS_ETM_CPU + 1,
  37         CS_ETM_ETMTRACEIDR,
  38         /* RO, taken from sysFS */
  39         CS_ETM_ETMCCER,
  40         CS_ETM_ETMIDR,
  41         CS_ETM_PRIV_MAX,
  42 };
  43 
  44 /* ETMv4 metadata */
  45 enum {
  46         /* Dynamic, configurable parameters */
  47         CS_ETMV4_TRCCONFIGR = CS_ETM_CPU + 1,
  48         CS_ETMV4_TRCTRACEIDR,
  49         /* RO, taken from sysFS */
  50         CS_ETMV4_TRCIDR0,
  51         CS_ETMV4_TRCIDR1,
  52         CS_ETMV4_TRCIDR2,
  53         CS_ETMV4_TRCIDR8,
  54         CS_ETMV4_TRCAUTHSTATUS,
  55         CS_ETMV4_PRIV_MAX,
  56 };
  57 
  58 /*
  59  * ETMv3 exception encoding number:
  60  * See Embedded Trace Macrocell spcification (ARM IHI 0014Q)
  61  * table 7-12 Encoding of Exception[3:0] for non-ARMv7-M processors.
  62  */
  63 enum {
  64         CS_ETMV3_EXC_NONE = 0,
  65         CS_ETMV3_EXC_DEBUG_HALT = 1,
  66         CS_ETMV3_EXC_SMC = 2,
  67         CS_ETMV3_EXC_HYP = 3,
  68         CS_ETMV3_EXC_ASYNC_DATA_ABORT = 4,
  69         CS_ETMV3_EXC_JAZELLE_THUMBEE = 5,
  70         CS_ETMV3_EXC_PE_RESET = 8,
  71         CS_ETMV3_EXC_UNDEFINED_INSTR = 9,
  72         CS_ETMV3_EXC_SVC = 10,
  73         CS_ETMV3_EXC_PREFETCH_ABORT = 11,
  74         CS_ETMV3_EXC_DATA_FAULT = 12,
  75         CS_ETMV3_EXC_GENERIC = 13,
  76         CS_ETMV3_EXC_IRQ = 14,
  77         CS_ETMV3_EXC_FIQ = 15,
  78 };
  79 
  80 /*
  81  * ETMv4 exception encoding number:
  82  * See ARM Embedded Trace Macrocell Architecture Specification (ARM IHI 0064D)
  83  * table 6-12 Possible values for the TYPE field in an Exception instruction
  84  * trace packet, for ARMv7-A/R and ARMv8-A/R PEs.
  85  */
  86 enum {
  87         CS_ETMV4_EXC_RESET = 0,
  88         CS_ETMV4_EXC_DEBUG_HALT = 1,
  89         CS_ETMV4_EXC_CALL = 2,
  90         CS_ETMV4_EXC_TRAP = 3,
  91         CS_ETMV4_EXC_SYSTEM_ERROR = 4,
  92         CS_ETMV4_EXC_INST_DEBUG = 6,
  93         CS_ETMV4_EXC_DATA_DEBUG = 7,
  94         CS_ETMV4_EXC_ALIGNMENT = 10,
  95         CS_ETMV4_EXC_INST_FAULT = 11,
  96         CS_ETMV4_EXC_DATA_FAULT = 12,
  97         CS_ETMV4_EXC_IRQ = 14,
  98         CS_ETMV4_EXC_FIQ = 15,
  99         CS_ETMV4_EXC_END = 31,
 100 };
 101 
 102 enum cs_etm_sample_type {
 103         CS_ETM_EMPTY,
 104         CS_ETM_RANGE,
 105         CS_ETM_DISCONTINUITY,
 106         CS_ETM_EXCEPTION,
 107         CS_ETM_EXCEPTION_RET,
 108 };
 109 
 110 enum cs_etm_isa {
 111         CS_ETM_ISA_UNKNOWN,
 112         CS_ETM_ISA_A64,
 113         CS_ETM_ISA_A32,
 114         CS_ETM_ISA_T32,
 115 };
 116 
 117 /* RB tree for quick conversion between traceID and metadata pointers */
 118 struct intlist *traceid_list;
 119 
 120 struct cs_etm_queue;
 121 
 122 struct cs_etm_packet {
 123         enum cs_etm_sample_type sample_type;
 124         enum cs_etm_isa isa;
 125         u64 start_addr;
 126         u64 end_addr;
 127         u32 instr_count;
 128         u32 last_instr_type;
 129         u32 last_instr_subtype;
 130         u32 flags;
 131         u32 exception_number;
 132         u8 last_instr_cond;
 133         u8 last_instr_taken_branch;
 134         u8 last_instr_size;
 135         u8 trace_chan_id;
 136         int cpu;
 137 };
 138 
 139 #define CS_ETM_PACKET_MAX_BUFFER 1024
 140 
 141 /*
 142  * When working with per-thread scenarios the process under trace can
 143  * be scheduled on any CPU and as such, more than one traceID may be
 144  * associated with the same process.  Since a traceID of '0' is illegal
 145  * as per the CoreSight architecture, use that specific value to
 146  * identify the queue where all packets (with any traceID) are
 147  * aggregated.
 148  */
 149 #define CS_ETM_PER_THREAD_TRACEID 0
 150 
 151 struct cs_etm_packet_queue {
 152         u32 packet_count;
 153         u32 head;
 154         u32 tail;
 155         u32 instr_count;
 156         u64 timestamp;
 157         u64 next_timestamp;
 158         struct cs_etm_packet packet_buffer[CS_ETM_PACKET_MAX_BUFFER];
 159 };
 160 
 161 #define KiB(x) ((x) * 1024)
 162 #define MiB(x) ((x) * 1024 * 1024)
 163 
 164 #define CS_ETM_INVAL_ADDR 0xdeadbeefdeadbeefUL
 165 
 166 #define BMVAL(val, lsb, msb)    ((val & GENMASK(msb, lsb)) >> lsb)
 167 
 168 #define CS_ETM_HEADER_SIZE (CS_HEADER_VERSION_0_MAX * sizeof(u64))
 169 
 170 #define __perf_cs_etmv3_magic 0x3030303030303030ULL
 171 #define __perf_cs_etmv4_magic 0x4040404040404040ULL
 172 #define CS_ETMV3_PRIV_SIZE (CS_ETM_PRIV_MAX * sizeof(u64))
 173 #define CS_ETMV4_PRIV_SIZE (CS_ETMV4_PRIV_MAX * sizeof(u64))
 174 
 175 #ifdef HAVE_CSTRACE_SUPPORT
 176 int cs_etm__process_auxtrace_info(union perf_event *event,
 177                                   struct perf_session *session);
 178 int cs_etm__get_cpu(u8 trace_chan_id, int *cpu);
 179 int cs_etm__etmq_set_tid(struct cs_etm_queue *etmq,
 180                          pid_t tid, u8 trace_chan_id);
 181 bool cs_etm__etmq_is_timeless(struct cs_etm_queue *etmq);
 182 void cs_etm__etmq_set_traceid_queue_timestamp(struct cs_etm_queue *etmq,
 183                                               u8 trace_chan_id);
 184 struct cs_etm_packet_queue
 185 *cs_etm__etmq_get_packet_queue(struct cs_etm_queue *etmq, u8 trace_chan_id);
 186 #else
 187 static inline int
 188 cs_etm__process_auxtrace_info(union perf_event *event __maybe_unused,
 189                               struct perf_session *session __maybe_unused)
 190 {
 191         return -1;
 192 }
 193 
 194 static inline int cs_etm__get_cpu(u8 trace_chan_id __maybe_unused,
 195                                   int *cpu __maybe_unused)
 196 {
 197         return -1;
 198 }
 199 
 200 static inline int cs_etm__etmq_set_tid(
 201                                 struct cs_etm_queue *etmq __maybe_unused,
 202                                 pid_t tid __maybe_unused,
 203                                 u8 trace_chan_id __maybe_unused)
 204 {
 205         return -1;
 206 }
 207 
 208 static inline bool cs_etm__etmq_is_timeless(
 209                                 struct cs_etm_queue *etmq __maybe_unused)
 210 {
 211         /* What else to return? */
 212         return true;
 213 }
 214 
 215 static inline void cs_etm__etmq_set_traceid_queue_timestamp(
 216                                 struct cs_etm_queue *etmq __maybe_unused,
 217                                 u8 trace_chan_id __maybe_unused) {}
 218 
 219 static inline struct cs_etm_packet_queue *cs_etm__etmq_get_packet_queue(
 220                                 struct cs_etm_queue *etmq __maybe_unused,
 221                                 u8 trace_chan_id __maybe_unused)
 222 {
 223         return NULL;
 224 }
 225 #endif
 226 
 227 #endif