tools/perf/util/intel-pt-decoder/intel-pt-pkt-decoder.h

   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 };
  60
  61 struct intel_pt_pkt {
  62         enum intel_pt_pkt_type  type;
  63         int                     count;
  64         uint64_t                payload;
  65 };
  66
  67 /*
  68  * Decoding of BIP packets conflicts with single-byte TNT packets. Since BIP
  69  * packets only occur in the context of a block (i.e. between BBP and BEP), that
  70  * context must be recorded and passed to the packet decoder.
  71  */
  72 enum intel_pt_pkt_ctx {
  73         INTEL_PT_NO_CTX,        /* BIP packets are invalid */
  74         INTEL_PT_BLK_4_CTX,     /* 4-byte BIP packets */
  75         INTEL_PT_BLK_8_CTX,     /* 8-byte BIP packets */
  76 };
  77
  78 const char *intel_pt_pkt_name(enum intel_pt_pkt_type);
  79
  80 int intel_pt_get_packet(const unsigned char *buf, size_t len,
  81                         struct intel_pt_pkt *packet,
  82                         enum intel_pt_pkt_ctx *ctx);
  83
  84 void intel_pt_upd_pkt_ctx(const struct intel_pt_pkt *packet,
  85                           enum intel_pt_pkt_ctx *ctx);
  86
  87 int intel_pt_pkt_desc(const struct intel_pt_pkt *packet, char *buf, size_t len);
  88
  89 #endif