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