blob: 02c38fec1c370199dff83f68864f5001dfdeca31 [file] [log] [blame]
Adrian Hunterf4aa0812015-07-17 19:33:40 +03001/*
2 * intel_pt_decoder.h: Intel Processor Trace support
3 * Copyright (c) 2013-2014, Intel Corporation.
4 *
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
8 *
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
13 *
14 */
15
16#ifndef INCLUDE__INTEL_PT_DECODER_H__
17#define INCLUDE__INTEL_PT_DECODER_H__
18
19#include <stdint.h>
20#include <stddef.h>
21#include <stdbool.h>
22
23#include "intel-pt-insn-decoder.h"
24
25#define INTEL_PT_IN_TX (1 << 0)
26#define INTEL_PT_ABORT_TX (1 << 1)
27#define INTEL_PT_ASYNC (1 << 2)
28
29enum intel_pt_sample_type {
30 INTEL_PT_BRANCH = 1 << 0,
31 INTEL_PT_INSTRUCTION = 1 << 1,
32 INTEL_PT_TRANSACTION = 1 << 2,
33};
34
35enum intel_pt_period_type {
36 INTEL_PT_PERIOD_NONE,
37 INTEL_PT_PERIOD_INSTRUCTIONS,
38 INTEL_PT_PERIOD_TICKS,
Adrian Hunter79b58422015-07-17 19:33:55 +030039 INTEL_PT_PERIOD_MTC,
Adrian Hunterf4aa0812015-07-17 19:33:40 +030040};
41
42enum {
43 INTEL_PT_ERR_NOMEM = 1,
44 INTEL_PT_ERR_INTERN,
45 INTEL_PT_ERR_BADPKT,
46 INTEL_PT_ERR_NODATA,
47 INTEL_PT_ERR_NOINSN,
48 INTEL_PT_ERR_MISMAT,
49 INTEL_PT_ERR_OVR,
50 INTEL_PT_ERR_LOST,
51 INTEL_PT_ERR_UNK,
52 INTEL_PT_ERR_NELOOP,
53 INTEL_PT_ERR_MAX,
54};
55
56struct intel_pt_state {
57 enum intel_pt_sample_type type;
58 int err;
59 uint64_t from_ip;
60 uint64_t to_ip;
61 uint64_t cr3;
Adrian Hunter2a21d032015-07-17 19:33:48 +030062 uint64_t tot_insn_cnt;
Adrian Hunterf4aa0812015-07-17 19:33:40 +030063 uint64_t timestamp;
64 uint64_t est_timestamp;
65 uint64_t trace_nr;
66 uint32_t flags;
67 enum intel_pt_insn_op insn_op;
68 int insn_len;
69};
70
71struct intel_pt_insn;
72
73struct intel_pt_buffer {
74 const unsigned char *buf;
75 size_t len;
76 bool consecutive;
77 uint64_t ref_timestamp;
78 uint64_t trace_nr;
79};
80
81struct intel_pt_params {
82 int (*get_trace)(struct intel_pt_buffer *buffer, void *data);
83 int (*walk_insn)(struct intel_pt_insn *intel_pt_insn,
84 uint64_t *insn_cnt_ptr, uint64_t *ip, uint64_t to_ip,
85 uint64_t max_insn_cnt, void *data);
86 void *data;
87 bool return_compression;
88 uint64_t period;
89 enum intel_pt_period_type period_type;
90 unsigned max_non_turbo_ratio;
Adrian Hunter11fa7cb2015-07-17 19:33:54 +030091 unsigned int mtc_period;
92 uint32_t tsc_ctc_ratio_n;
93 uint32_t tsc_ctc_ratio_d;
Adrian Hunterf4aa0812015-07-17 19:33:40 +030094};
95
96struct intel_pt_decoder;
97
98struct intel_pt_decoder *intel_pt_decoder_new(struct intel_pt_params *params);
99void intel_pt_decoder_free(struct intel_pt_decoder *decoder);
100
101const struct intel_pt_state *intel_pt_decode(struct intel_pt_decoder *decoder);
102
103unsigned char *intel_pt_find_overlap(unsigned char *buf_a, size_t len_a,
104 unsigned char *buf_b, size_t len_b,
105 bool have_tsc);
106
107int intel_pt__strerror(int code, char *buf, size_t buflen);
108
109#endif