1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * intel_pt_pkt_decoder.h: Intel Processor Trace support
4 * Copyright (c) 2013-2014, Intel Corporation.
5 */
6
7 #ifndef INCLUDE__INTEL_PT_PKT_DECODER_H__
8 #define INCLUDE__INTEL_PT_PKT_DECODER_H__
9
10 #include <stddef.h>
11 #include <stdint.h>
12
13 #define INTEL_PT_PKT_DESC_MAX 256
14
15 #define INTEL_PT_NEED_MORE_BYTES -1
16 #define INTEL_PT_BAD_PACKET -2
17
18 #define INTEL_PT_PSB_STR "\002\202\002\202\002\202\002\202" \
19 "\002\202\002\202\002\202\002\202"
20 #define INTEL_PT_PSB_LEN 16
21
22 #define INTEL_PT_PKT_MAX_SZ 16
23
24 #define INTEL_PT_VMX_NR_FLAG 1
25
26 enum intel_pt_pkt_type {
27 INTEL_PT_BAD,
28 INTEL_PT_PAD,
29 INTEL_PT_TNT,
30 INTEL_PT_TIP_PGD,
31 INTEL_PT_TIP_PGE,
32 INTEL_PT_TSC,
33 INTEL_PT_TMA,
34 INTEL_PT_MODE_EXEC,
35 INTEL_PT_MODE_TSX,
36 INTEL_PT_MTC,
37 INTEL_PT_TIP,
38 INTEL_PT_FUP,
39 INTEL_PT_CYC,
40 INTEL_PT_VMCS,
41 INTEL_PT_PSB,
42 INTEL_PT_PSBEND,
43 INTEL_PT_CBR,
44 INTEL_PT_TRACESTOP,
45 INTEL_PT_PIP,
46 INTEL_PT_OVF,
47 INTEL_PT_MNT,
48 INTEL_PT_PTWRITE,
49 INTEL_PT_PTWRITE_IP,
50 INTEL_PT_EXSTOP,
51 INTEL_PT_EXSTOP_IP,
52 INTEL_PT_MWAIT,
53 INTEL_PT_PWRE,
54 INTEL_PT_PWRX,
55 INTEL_PT_BBP,
56 INTEL_PT_BIP,
57 INTEL_PT_BEP,
58 INTEL_PT_BEP_IP,
59 INTEL_PT_CFE,
60 INTEL_PT_CFE_IP,
61 INTEL_PT_EVD,
62 };
63
64 struct intel_pt_pkt {
65 enum intel_pt_pkt_type type;
66 int count;
67 uint64_t payload;
68 };
69
70 /*
71 * Decoding of BIP packets conflicts with single-byte TNT packets. Since BIP
72 * packets only occur in the context of a block (i.e. between BBP and BEP), that
73 * context must be recorded and passed to the packet decoder.
74 */
75 enum intel_pt_pkt_ctx {
76 INTEL_PT_NO_CTX, /* BIP packets are invalid */
77 INTEL_PT_BLK_4_CTX, /* 4-byte BIP packets */
78 INTEL_PT_BLK_8_CTX, /* 8-byte BIP packets */
79 };
80
81 const char *intel_pt_pkt_name(enum intel_pt_pkt_type);
82
83 int intel_pt_get_packet(const unsigned char *buf, size_t len,
84 struct intel_pt_pkt *packet,
85 enum intel_pt_pkt_ctx *ctx);
86
87 void intel_pt_upd_pkt_ctx(const struct intel_pt_pkt *packet,
88 enum intel_pt_pkt_ctx *ctx);
89
90 int intel_pt_pkt_desc(const struct intel_pt_pkt *packet, char *buf, size_t len);
91
92 #endif
93
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.