Quelle  intel-pt-pkt-decoder.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0-only
/*
 * intel_pt_pkt_decoder.c: Intel Processor Trace support
 * Copyright (c) 2013-2014, Intel Corporation.
 */

#include <stdio.h>
#include <string.h>
#include <endian.h>
#include <byteswap.h>
#include <linux/kernel.h>
#include <linux/compiler.h>
#include <linux/unaligned.h>

#include "intel-pt-pkt-decoder.h"

#define BIT(n)  (1 << (n))

#define BIT63  ((uint64_t)1 << 63)

#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
#define memcpy_le64(d, s, n) do { \
 memcpy((d), (s), (n));    \
 *(d) = le64_to_cpu(*(d)); \
} while (0)
#else
#define memcpy_le64 memcpy
#endif

static const char * const packet_name[] = {
 [INTEL_PT_BAD]  = "Bad Packet!",
 [INTEL_PT_PAD]  = "PAD",
 [INTEL_PT_TNT]  = "TNT",
 [INTEL_PT_TIP_PGD] = "TIP.PGD",
 [INTEL_PT_TIP_PGE] = "TIP.PGE",
 [INTEL_PT_TSC]  = "TSC",
 [INTEL_PT_TMA]  = "TMA",
 [INTEL_PT_MODE_EXEC] = "MODE.Exec",
 [INTEL_PT_MODE_TSX] = "MODE.TSX",
 [INTEL_PT_MTC]  = "MTC",
 [INTEL_PT_TIP]  = "TIP",
 [INTEL_PT_FUP]  = "FUP",
 [INTEL_PT_CYC]  = "CYC",
 [INTEL_PT_VMCS]  = "VMCS",
 [INTEL_PT_PSB]  = "PSB",
 [INTEL_PT_PSBEND] = "PSBEND",
 [INTEL_PT_CBR]  = "CBR",
 [INTEL_PT_TRACESTOP] = "TraceSTOP",
 [INTEL_PT_PIP]  = "PIP",
 [INTEL_PT_OVF]  = "OVF",
 [INTEL_PT_MNT]  = "MNT",
 [INTEL_PT_PTWRITE] = "PTWRITE",
 [INTEL_PT_PTWRITE_IP] = "PTWRITE",
 [INTEL_PT_EXSTOP] = "EXSTOP",
 [INTEL_PT_EXSTOP_IP] = "EXSTOP",
 [INTEL_PT_MWAIT] = "MWAIT",
 [INTEL_PT_PWRE]  = "PWRE",
 [INTEL_PT_PWRX]  = "PWRX",
 [INTEL_PT_BBP]  = "BBP",
 [INTEL_PT_BIP]  = "BIP",
 [INTEL_PT_BEP]  = "BEP",
 [INTEL_PT_BEP_IP] = "BEP",
 [INTEL_PT_CFE]  = "CFE",
 [INTEL_PT_CFE_IP] = "CFE",
 [INTEL_PT_EVD]  = "EVD",
};

const char *intel_pt_pkt_name(enum intel_pt_pkt_type type)
{
 return packet_name[type];
}

static int intel_pt_get_long_tnt(const unsigned char *buf, size_t len,
     struct intel_pt_pkt *packet)
{
 uint64_t payload;
 int count;

 if (len < 8)
  return INTEL_PT_NEED_MORE_BYTES;

 payload = get_unaligned_le64(buf);

 for (count = 47; count; count--) {
  if (payload & BIT63)
   break;
  payload <<= 1;
 }

 packet->type = INTEL_PT_TNT;
 packet->count = count;
 packet->payload = payload << 1;
 return 8;
}

static int intel_pt_get_pip(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 uint64_t payload = 0;

 if (len < 8)
  return INTEL_PT_NEED_MORE_BYTES;

 packet->type = INTEL_PT_PIP;
 memcpy_le64(&payload, buf + 2, 6);
 packet->payload = payload;

 return 8;
}

static int intel_pt_get_tracestop(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_TRACESTOP;
 return 2;
}

static int intel_pt_get_cbr(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 4)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_CBR;
 packet->payload = get_unaligned_le16(buf + 2);
 return 4;
}

static int intel_pt_get_vmcs(const unsigned char *buf, size_t len,
        struct intel_pt_pkt *packet)
{
 if (len < 7)
  return INTEL_PT_NEED_MORE_BYTES;

 packet->type = INTEL_PT_VMCS;
 packet->count = 5;
 memcpy_le64(&packet->payload, buf + 2, 5);

 return 7;
}

static int intel_pt_get_ovf(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_OVF;
 return 2;
}

static int intel_pt_get_psb(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 int i;

 if (len < 16)
  return INTEL_PT_NEED_MORE_BYTES;

 for (i = 2; i < 16; i += 2) {
  if (buf[i] != 2 || buf[i + 1] != 0x82)
   return INTEL_PT_BAD_PACKET;
 }

 packet->type = INTEL_PT_PSB;
 return 16;
}

static int intel_pt_get_psbend(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_PSBEND;
 return 2;
}

static int intel_pt_get_tma(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 7)
  return INTEL_PT_NEED_MORE_BYTES;

 packet->type = INTEL_PT_TMA;
 packet->payload = buf[2] | (buf[3] << 8);
 packet->count = buf[5] | ((buf[6] & BIT(0)) << 8);
 return 7;
}

static int intel_pt_get_pad(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_PAD;
 return 1;
}

static int intel_pt_get_mnt(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 11)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_MNT;
 packet->payload = get_unaligned_le64(buf + 3);
 return 11;
}

static int intel_pt_get_3byte(const unsigned char *buf, size_t len,
         struct intel_pt_pkt *packet)
{
 if (len < 3)
  return INTEL_PT_NEED_MORE_BYTES;

 switch (buf[2]) {
 case 0x88: /* MNT */
  return intel_pt_get_mnt(buf, len, packet);
 default:
  return INTEL_PT_BAD_PACKET;
 }
}

static int intel_pt_get_ptwrite(const unsigned char *buf, size_t len,
    struct intel_pt_pkt *packet)
{
 packet->count = (buf[1] >> 5) & 0x3;
 packet->type = buf[1] & BIT(7) ? INTEL_PT_PTWRITE_IP :
      INTEL_PT_PTWRITE;

 switch (packet->count) {
 case 0:
  if (len < 6)
   return INTEL_PT_NEED_MORE_BYTES;
  packet->payload = get_unaligned_le32(buf + 2);
  return 6;
 case 1:
  if (len < 10)
   return INTEL_PT_NEED_MORE_BYTES;
  packet->payload = get_unaligned_le64(buf + 2);
  return 10;
 default:
  return INTEL_PT_BAD_PACKET;
 }
}

static int intel_pt_get_exstop(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_EXSTOP;
 return 2;
}

static int intel_pt_get_exstop_ip(struct intel_pt_pkt *packet)
{
 packet->type = INTEL_PT_EXSTOP_IP;
 return 2;
}

static int intel_pt_get_mwait(const unsigned char *buf, size_t len,
         struct intel_pt_pkt *packet)
{
 if (len < 10)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_MWAIT;
 packet->payload = get_unaligned_le64(buf + 2);
 return 10;
}

static int intel_pt_get_pwre(const unsigned char *buf, size_t len,
        struct intel_pt_pkt *packet)
{
 if (len < 4)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_PWRE;
 memcpy_le64(&packet->payload, buf + 2, 2);
 return 4;
}

static int intel_pt_get_pwrx(const unsigned char *buf, size_t len,
        struct intel_pt_pkt *packet)
{
 if (len < 7)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_PWRX;
 memcpy_le64(&packet->payload, buf + 2, 5);
 return 7;
}

static int intel_pt_get_bbp(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 3)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_BBP;
 packet->count = buf[2] >> 7;
 packet->payload = buf[2] & 0x1f;
 return 3;
}

static int intel_pt_get_bip_4(const unsigned char *buf, size_t len,
         struct intel_pt_pkt *packet)
{
 if (len < 5)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_BIP;
 packet->count = buf[0] >> 3;
 memcpy_le64(&packet->payload, buf + 1, 4);
 return 5;
}

static int intel_pt_get_bip_8(const unsigned char *buf, size_t len,
         struct intel_pt_pkt *packet)
{
 if (len < 9)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_BIP;
 packet->count = buf[0] >> 3;
 packet->payload = get_unaligned_le64(buf + 1);
 return 9;
}

static int intel_pt_get_bep(size_t len, struct intel_pt_pkt *packet)
{
 if (len < 2)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_BEP;
 return 2;
}

static int intel_pt_get_bep_ip(size_t len, struct intel_pt_pkt *packet)
{
 if (len < 2)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_BEP_IP;
 return 2;
}

static int intel_pt_get_cfe(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 4)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = buf[2] & 0x80 ? INTEL_PT_CFE_IP : INTEL_PT_CFE;
 packet->count = buf[2] & 0x1f;
 packet->payload = buf[3];
 return 4;
}

static int intel_pt_get_evd(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 11)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_EVD;
 packet->count = buf[2] & 0x3f;
 packet->payload = buf[3];
 packet->payload = get_unaligned_le64(buf + 3);
 return 11;
}

static int intel_pt_get_ext(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 2)
  return INTEL_PT_NEED_MORE_BYTES;

 if ((buf[1] & 0x1f) == 0x12)
  return intel_pt_get_ptwrite(buf, len, packet);

 switch (buf[1]) {
 case 0xa3: /* Long TNT */
  return intel_pt_get_long_tnt(buf, len, packet);
 case 0x43: /* PIP */
  return intel_pt_get_pip(buf, len, packet);
 case 0x83: /* TraceStop */
  return intel_pt_get_tracestop(packet);
 case 0x03: /* CBR */
  return intel_pt_get_cbr(buf, len, packet);
 case 0xc8: /* VMCS */
  return intel_pt_get_vmcs(buf, len, packet);
 case 0xf3: /* OVF */
  return intel_pt_get_ovf(packet);
 case 0x82: /* PSB */
  return intel_pt_get_psb(buf, len, packet);
 case 0x23: /* PSBEND */
  return intel_pt_get_psbend(packet);
 case 0x73: /* TMA */
  return intel_pt_get_tma(buf, len, packet);
 case 0xC3: /* 3-byte header */
  return intel_pt_get_3byte(buf, len, packet);
 case 0x62: /* EXSTOP no IP */
  return intel_pt_get_exstop(packet);
 case 0xE2: /* EXSTOP with IP */
  return intel_pt_get_exstop_ip(packet);
 case 0xC2: /* MWAIT */
  return intel_pt_get_mwait(buf, len, packet);
 case 0x22: /* PWRE */
  return intel_pt_get_pwre(buf, len, packet);
 case 0xA2: /* PWRX */
  return intel_pt_get_pwrx(buf, len, packet);
 case 0x63: /* BBP */
  return intel_pt_get_bbp(buf, len, packet);
 case 0x33: /* BEP no IP */
  return intel_pt_get_bep(len, packet);
 case 0xb3: /* BEP with IP */
  return intel_pt_get_bep_ip(len, packet);
 case 0x13: /* CFE */
  return intel_pt_get_cfe(buf, len, packet);
 case 0x53: /* EVD */
  return intel_pt_get_evd(buf, len, packet);
 default:
  return INTEL_PT_BAD_PACKET;
 }
}

static int intel_pt_get_short_tnt(unsigned int byte,
      struct intel_pt_pkt *packet)
{
 int count;

 for (count = 6; count; count--) {
  if (byte & BIT(7))
   break;
  byte <<= 1;
 }

 packet->type = INTEL_PT_TNT;
 packet->count = count;
 packet->payload = (uint64_t)byte << 57;

 return 1;
}

static int intel_pt_get_cyc(unsigned int byte, const unsigned char *buf,
       size_t len, struct intel_pt_pkt *packet)
{
 unsigned int offs = 1, shift;
 uint64_t payload = byte >> 3;

 byte >>= 2;
 len -= 1;
 for (shift = 5; byte & 1; shift += 7) {
  if (offs > 9)
   return INTEL_PT_BAD_PACKET;
  if (len < offs)
   return INTEL_PT_NEED_MORE_BYTES;
  byte = buf[offs++];
  payload |= ((uint64_t)byte >> 1) << shift;
 }

 packet->type = INTEL_PT_CYC;
 packet->payload = payload;
 return offs;
}

static int intel_pt_get_ip(enum intel_pt_pkt_type type, unsigned int byte,
      const unsigned char *buf, size_t len,
      struct intel_pt_pkt *packet)
{
 int ip_len;

 packet->count = byte >> 5;

 switch (packet->count) {
 case 0:
  ip_len = 0;
  break;
 case 1:
  if (len < 3)
   return INTEL_PT_NEED_MORE_BYTES;
  ip_len = 2;
  packet->payload = get_unaligned_le16(buf + 1);
  break;
 case 2:
  if (len < 5)
   return INTEL_PT_NEED_MORE_BYTES;
  ip_len = 4;
  packet->payload = get_unaligned_le32(buf + 1);
  break;
 case 3:
 case 4:
  if (len < 7)
   return INTEL_PT_NEED_MORE_BYTES;
  ip_len = 6;
  memcpy_le64(&packet->payload, buf + 1, 6);
  break;
 case 6:
  if (len < 9)
   return INTEL_PT_NEED_MORE_BYTES;
  ip_len = 8;
  packet->payload = get_unaligned_le64(buf + 1);
  break;
 default:
  return INTEL_PT_BAD_PACKET;
 }

 packet->type = type;

 return ip_len + 1;
}

static int intel_pt_get_mode(const unsigned char *buf, size_t len,
        struct intel_pt_pkt *packet)
{
 if (len < 2)
  return INTEL_PT_NEED_MORE_BYTES;

 switch (buf[1] >> 5) {
 case 0:
  packet->type = INTEL_PT_MODE_EXEC;
  packet->count = buf[1];
  switch (buf[1] & 3) {
  case 0:
   packet->payload = 16;
   break;
  case 1:
   packet->payload = 64;
   break;
  case 2:
   packet->payload = 32;
   break;
  default:
   return INTEL_PT_BAD_PACKET;
  }
  break;
 case 1:
  packet->type = INTEL_PT_MODE_TSX;
  if ((buf[1] & 3) == 3)
   return INTEL_PT_BAD_PACKET;
  packet->payload = buf[1] & 3;
  break;
 default:
  return INTEL_PT_BAD_PACKET;
 }

 return 2;
}

static int intel_pt_get_tsc(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 8)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_TSC;
 memcpy_le64(&packet->payload, buf + 1, 7);
 return 8;
}

static int intel_pt_get_mtc(const unsigned char *buf, size_t len,
       struct intel_pt_pkt *packet)
{
 if (len < 2)
  return INTEL_PT_NEED_MORE_BYTES;
 packet->type = INTEL_PT_MTC;
 packet->payload = buf[1];
 return 2;
}

static int intel_pt_do_get_packet(const unsigned char *buf, size_t len,
      struct intel_pt_pkt *packet,
      enum intel_pt_pkt_ctx ctx)
{
 unsigned int byte;

 memset(packet, 0, sizeof(struct intel_pt_pkt));

 if (!len)
  return INTEL_PT_NEED_MORE_BYTES;

 byte = buf[0];

 switch (ctx) {
 case INTEL_PT_NO_CTX:
  break;
 case INTEL_PT_BLK_4_CTX:
  if ((byte & 0x7) == 4)
   return intel_pt_get_bip_4(buf, len, packet);
  break;
 case INTEL_PT_BLK_8_CTX:
  if ((byte & 0x7) == 4)
   return intel_pt_get_bip_8(buf, len, packet);
  break;
 default:
  break;
 }

 if (!(byte & BIT(0))) {
  if (byte == 0)
   return intel_pt_get_pad(packet);
  if (byte == 2)
   return intel_pt_get_ext(buf, len, packet);
  return intel_pt_get_short_tnt(byte, packet);
 }

 if ((byte & 2))
  return intel_pt_get_cyc(byte, buf, len, packet);

 switch (byte & 0x1f) {
 case 0x0D:
  return intel_pt_get_ip(INTEL_PT_TIP, byte, buf, len, packet);
 case 0x11:
  return intel_pt_get_ip(INTEL_PT_TIP_PGE, byte, buf, len,
           packet);
 case 0x01:
  return intel_pt_get_ip(INTEL_PT_TIP_PGD, byte, buf, len,
           packet);
 case 0x1D:
  return intel_pt_get_ip(INTEL_PT_FUP, byte, buf, len, packet);
 case 0x19:
  switch (byte) {
  case 0x99:
   return intel_pt_get_mode(buf, len, packet);
  case 0x19:
   return intel_pt_get_tsc(buf, len, packet);
  case 0x59:
   return intel_pt_get_mtc(buf, len, packet);
  default:
   return INTEL_PT_BAD_PACKET;
  }
 default:
  return INTEL_PT_BAD_PACKET;
 }
}

void intel_pt_upd_pkt_ctx(const struct intel_pt_pkt *packet,
     enum intel_pt_pkt_ctx *ctx)
{
 switch (packet->type) {
 case INTEL_PT_BAD:
 case INTEL_PT_PAD:
 case INTEL_PT_TSC:
 case INTEL_PT_TMA:
 case INTEL_PT_MTC:
 case INTEL_PT_FUP:
 case INTEL_PT_CYC:
 case INTEL_PT_CBR:
 case INTEL_PT_MNT:
 case INTEL_PT_EXSTOP:
 case INTEL_PT_EXSTOP_IP:
 case INTEL_PT_PWRE:
 case INTEL_PT_PWRX:
 case INTEL_PT_BIP:
  break;
 case INTEL_PT_TNT:
 case INTEL_PT_TIP:
 case INTEL_PT_TIP_PGD:
 case INTEL_PT_TIP_PGE:
 case INTEL_PT_MODE_EXEC:
 case INTEL_PT_MODE_TSX:
 case INTEL_PT_PIP:
 case INTEL_PT_OVF:
 case INTEL_PT_VMCS:
 case INTEL_PT_TRACESTOP:
 case INTEL_PT_PSB:
 case INTEL_PT_PSBEND:
 case INTEL_PT_PTWRITE:
 case INTEL_PT_PTWRITE_IP:
 case INTEL_PT_MWAIT:
 case INTEL_PT_BEP:
 case INTEL_PT_BEP_IP:
 case INTEL_PT_CFE:
 case INTEL_PT_CFE_IP:
 case INTEL_PT_EVD:
  *ctx = INTEL_PT_NO_CTX;
  break;
 case INTEL_PT_BBP:
  if (packet->count)
   *ctx = INTEL_PT_BLK_4_CTX;
  else
   *ctx = INTEL_PT_BLK_8_CTX;
  break;
 default:
  break;
 }
}

int intel_pt_get_packet(const unsigned char *buf, size_t len,
   struct intel_pt_pkt *packet, enum intel_pt_pkt_ctx *ctx)
{
 int ret;

 ret = intel_pt_do_get_packet(buf, len, packet, *ctx);
 if (ret > 0) {
  while (ret < 8 && len > (size_t)ret && !buf[ret])
   ret += 1;
  intel_pt_upd_pkt_ctx(packet, ctx);
 }
 return ret;
}

int intel_pt_pkt_desc(const struct intel_pt_pkt *packet, char *buf,
        size_t buf_len)
{
 int ret, i, nr;
 unsigned long long payload = packet->payload;
 const char *name = intel_pt_pkt_name(packet->type);

 switch (packet->type) {
 case INTEL_PT_BAD:
 case INTEL_PT_PAD:
 case INTEL_PT_PSB:
 case INTEL_PT_PSBEND:
 case INTEL_PT_TRACESTOP:
 case INTEL_PT_OVF:
  return snprintf(buf, buf_len, "%s", name);
 case INTEL_PT_TNT: {
  size_t blen = buf_len;

  ret = snprintf(buf, blen, "%s ", name);
  if (ret < 0)
   return ret;
  buf += ret;
  blen -= ret;
  for (i = 0; i < packet->count; i++) {
   if (payload & BIT63)
    ret = snprintf(buf, blen, "T");
   else
    ret = snprintf(buf, blen, "N");
   if (ret < 0)
    return ret;
   buf += ret;
   blen -= ret;
   payload <<= 1;
  }
  ret = snprintf(buf, blen, " (%d)", packet->count);
  if (ret < 0)
   return ret;
  blen -= ret;
  return buf_len - blen;
 }
 case INTEL_PT_TIP_PGD:
 case INTEL_PT_TIP_PGE:
 case INTEL_PT_TIP:
 case INTEL_PT_FUP:
  if (!(packet->count))
   return snprintf(buf, buf_len, "%s no ip", name);
  fallthrough;
 case INTEL_PT_CYC:
 case INTEL_PT_VMCS:
 case INTEL_PT_MTC:
 case INTEL_PT_MNT:
 case INTEL_PT_CBR:
 case INTEL_PT_TSC:
  return snprintf(buf, buf_len, "%s 0x%llx", name, payload);
 case INTEL_PT_TMA:
  return snprintf(buf, buf_len, "%s CTC 0x%x FC 0x%x", name,
    (unsigned)payload, packet->count);
 case INTEL_PT_MODE_EXEC:
  return snprintf(buf, buf_len, "%s IF:%d %lld",
    name, !!(packet->count & 4), payload);
 case INTEL_PT_MODE_TSX:
  return snprintf(buf, buf_len, "%s TXAbort:%u InTX:%u",
    name, (unsigned)(payload >> 1) & 1,
    (unsigned)payload & 1);
 case INTEL_PT_PIP:
  nr = packet->payload & INTEL_PT_VMX_NR_FLAG ? 1 : 0;
  payload &= ~INTEL_PT_VMX_NR_FLAG;
  ret = snprintf(buf, buf_len, "%s 0x%llx (NR=%d)",
          name, payload >> 1, nr);
  return ret;
 case INTEL_PT_PTWRITE:
  return snprintf(buf, buf_len, "%s 0x%llx IP:0", name, payload);
 case INTEL_PT_PTWRITE_IP:
  return snprintf(buf, buf_len, "%s 0x%llx IP:1", name, payload);
 case INTEL_PT_BEP:
 case INTEL_PT_EXSTOP:
  return snprintf(buf, buf_len, "%s IP:0", name);
 case INTEL_PT_BEP_IP:
 case INTEL_PT_EXSTOP_IP:
  return snprintf(buf, buf_len, "%s IP:1", name);
 case INTEL_PT_MWAIT:
  return snprintf(buf, buf_len, "%s 0x%llx Hints 0x%x Extensions 0x%x",
    name, payload, (unsigned int)(payload & 0xff),
    (unsigned int)((payload >> 32) & 0x3));
 case INTEL_PT_PWRE:
  return snprintf(buf, buf_len, "%s 0x%llx HW:%u CState:%u Sub-CState:%u",
    name, payload, !!(payload & 0x80),
    (unsigned int)((payload >> 12) & 0xf),
    (unsigned int)((payload >> 8) & 0xf));
 case INTEL_PT_PWRX:
  return snprintf(buf, buf_len, "%s 0x%llx Last CState:%u Deepest CState:%u Wake Reason 0x%x",
    name, payload,
    (unsigned int)((payload >> 4) & 0xf),
    (unsigned int)(payload & 0xf),
    (unsigned int)((payload >> 8) & 0xf));
 case INTEL_PT_BBP:
  return snprintf(buf, buf_len, "%s SZ %s-byte Type 0x%llx",
    name, packet->count ? "4" : "8", payload);
 case INTEL_PT_BIP:
  return snprintf(buf, buf_len, "%s ID 0x%02x Value 0x%llx",
    name, packet->count, payload);
 case INTEL_PT_CFE:
 case INTEL_PT_CFE_IP:
  return snprintf(buf, buf_len, "%s IP:%d Type 0x%02x Vector 0x%llx",
    name, packet->type == INTEL_PT_CFE_IP, packet->count, payload);
 case INTEL_PT_EVD:
  return snprintf(buf, buf_len, "%s Type 0x%02x Payload 0x%llx",
    name, packet->count, payload);
 default:
  break;
 }
 return snprintf(buf, buf_len, "%s 0x%llx (%d)",
   name, payload, packet->count);
}