MdePkg/Include/Register/Amd/Ghcb.h

   1 /** @file
   2   Guest-Hypervisor Communication Block (GHCB) Definition.
   3
   4   Provides data types allowing an SEV-ES guest to interact with the hypervisor
   5   using the GHCB protocol.
   6
   7   Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>
   8   SPDX-License-Identifier: BSD-2-Clause-Patent
   9
  10   @par Specification Reference:
  11   SEV-ES Guest-Hypervisor Communication Block Standardization
  12
  13 **/
  14
  15 #ifndef __GHCB_H__
  16 #define __GHCB_H__
  17
  18 #include <Base.h>
  19 #include <Library/BaseLib.h>
  20 #include <Library/DebugLib.h>
  21
  22 #define UD_EXCEPTION  6
  23 #define GP_EXCEPTION 13
  24 #define VC_EXCEPTION 29
  25
  26 #define GHCB_VERSION_MIN     1
  27 #define GHCB_VERSION_MAX     1
  28
  29 #define GHCB_STANDARD_USAGE  0
  30
  31 //
  32 // SVM Exit Codes
  33 //
  34 #define SVM_EXIT_DR7_READ       0x27ULL
  35 #define SVM_EXIT_DR7_WRITE      0x37ULL
  36 #define SVM_EXIT_RDTSC          0x6EULL
  37 #define SVM_EXIT_RDPMC          0x6FULL
  38 #define SVM_EXIT_CPUID          0x72ULL
  39 #define SVM_EXIT_INVD           0x76ULL
  40 #define SVM_EXIT_IOIO_PROT      0x7BULL
  41 #define SVM_EXIT_MSR            0x7CULL
  42 #define SVM_EXIT_VMMCALL        0x81ULL
  43 #define SVM_EXIT_RDTSCP         0x87ULL
  44 #define SVM_EXIT_WBINVD         0x89ULL
  45 #define SVM_EXIT_MONITOR        0x8AULL
  46 #define SVM_EXIT_MWAIT          0x8BULL
  47 #define SVM_EXIT_NPF            0x400ULL
  48
  49 //
  50 // VMG Special Exit Codes
  51 //
  52 #define SVM_EXIT_MMIO_READ      0x80000001ULL
  53 #define SVM_EXIT_MMIO_WRITE     0x80000002ULL
  54 #define SVM_EXIT_NMI_COMPLETE   0x80000003ULL
  55 #define SVM_EXIT_AP_RESET_HOLD  0x80000004ULL
  56 #define SVM_EXIT_AP_JUMP_TABLE  0x80000005ULL
  57 #define SVM_EXIT_UNSUPPORTED    0x8000FFFFULL
  58
  59 //
  60 // IOIO Exit Information
  61 //
  62 #define IOIO_TYPE_STR       BIT2
  63 #define IOIO_TYPE_IN        1
  64 #define IOIO_TYPE_INS       (IOIO_TYPE_IN | IOIO_TYPE_STR)
  65 #define IOIO_TYPE_OUT       0
  66 #define IOIO_TYPE_OUTS      (IOIO_TYPE_OUT | IOIO_TYPE_STR)
  67
  68 #define IOIO_REP            BIT3
  69
  70 #define IOIO_ADDR_64        BIT9
  71 #define IOIO_ADDR_32        BIT8
  72 #define IOIO_ADDR_16        BIT7
  73
  74 #define IOIO_DATA_32        BIT6
  75 #define IOIO_DATA_16        BIT5
  76 #define IOIO_DATA_8         BIT4
  77 #define IOIO_DATA_MASK      (BIT6 | BIT5 | BIT4)
  78 #define IOIO_DATA_OFFSET    4
  79 #define IOIO_DATA_BYTES(x)  (((x) & IOIO_DATA_MASK) >> IOIO_DATA_OFFSET)
  80
  81 #define IOIO_SEG_ES         0
  82 #define IOIO_SEG_DS         (BIT11 | BIT10)
  83
  84
  85 typedef enum {
  86   GhcbCpl              = 25,
  87   GhcbRflags           = 46,
  88   GhcbRip,
  89   GhcbRsp              = 59,
  90   GhcbRax              = 63,
  91   GhcbRcx              = 97,
  92   GhcbRdx,
  93   GhcbRbx,
  94   GhcbRbp              = 101,
  95   GhcbRsi,
  96   GhcbRdi,
  97   GhcbR8,
  98   GhcbR9,
  99   GhcbR10,
 100   GhcbR11,
 101   GhcbR12,
 102   GhcbR13,
 103   GhcbR14,
 104   GhcbR15,
 105   GhcbXCr0             = 125,
 106 } GHCB_REGISTER;
 107
 108 typedef PACKED struct {
 109   UINT8                  Reserved1[203];
 110   UINT8                  Cpl;
 111   UINT8                  Reserved2[148];
 112   UINT64                 Dr7;
 113   UINT8                  Reserved3[144];
 114   UINT64                 Rax;
 115   UINT8                  Reserved4[264];
 116   UINT64                 Rcx;
 117   UINT64                 Rdx;
 118   UINT64                 Rbx;
 119   UINT8                  Reserved5[112];
 120   UINT64                 SwExitCode;
 121   UINT64                 SwExitInfo1;
 122   UINT64                 SwExitInfo2;
 123   UINT64                 SwScratch;
 124   UINT8                  Reserved6[56];
 125   UINT64                 XCr0;
 126   UINT8                  ValidBitmap[16];
 127   UINT64                 X87StateGpa;
 128   UINT8                  Reserved7[1016];
 129 } GHCB_SAVE_AREA;
 130
 131 typedef PACKED struct {
 132   GHCB_SAVE_AREA         SaveArea;
 133   UINT8                  SharedBuffer[2032];
 134   UINT8                  Reserved1[10];
 135   UINT16                 ProtocolVersion;
 136   UINT32                 GhcbUsage;
 137 } GHCB;
 138
 139 typedef union {
 140   struct {
 141     UINT32  Lower32Bits;
 142     UINT32  Upper32Bits;
 143   } Elements;
 144
 145   UINT64    Uint64;
 146 } GHCB_EXIT_INFO;
 147
 148 typedef union {
 149   struct {
 150     UINT32  Vector:8;
 151     UINT32  Type:3;
 152     UINT32  ErrorCodeValid:1;
 153     UINT32  Rsvd:19;
 154     UINT32  Valid:1;
 155     UINT32  ErrorCode;
 156   } Elements;
 157
 158   UINT64    Uint64;
 159 } GHCB_EVENT_INJECTION;
 160
 161 #define GHCB_EVENT_INJECTION_TYPE_INT        0
 162 #define GHCB_EVENT_INJECTION_TYPE_NMI        2
 163 #define GHCB_EVENT_INJECTION_TYPE_EXCEPTION  3
 164 #define GHCB_EVENT_INJECTION_TYPE_SOFT_INT   4
 165
 166 #endif