gdb/arch/aarch64.h

   1 /* Common target-dependent functionality for AArch64.
   2
   3    Copyright (C) 2017-2022 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef ARCH_AARCH64_H
  21 #define ARCH_AARCH64_H
  22
  23 #include "gdbsupport/tdesc.h"
  24
  25 /* Holds information on what architectural features are available.  This is
  26    used to select register sets.  */
  27 struct aarch64_features
  28 {
  29   /* A non zero VQ value indicates both the presence of SVE and the
  30      Vector Quotient - the number of 128bit chunks in an SVE Z
  31      register.  */
  32   uint64_t vq = 0;
  33
  34   bool pauth = false;
  35   bool mte = false;
  36
  37   /* A positive TLS value indicates the number of TLS registers available.  */
  38   uint8_t tls = 0;
  39 };
  40
  41 inline bool operator==(const aarch64_features &lhs, const aarch64_features &rhs)
  42 {
  43   return lhs.vq == rhs.vq
  44     && lhs.pauth == rhs.pauth
  45     && lhs.mte == rhs.mte
  46     && lhs.tls == rhs.tls;
  47 }
  48
  49 namespace std
  50 {
  51   template<>
  52   struct hash<aarch64_features>
  53   {
  54     std::size_t operator()(const aarch64_features &features) const noexcept
  55     {
  56       std::size_t h;
  57
  58       h = features.vq;
  59       h = h << 1 | features.pauth;
  60       h = h << 1 | features.mte;
  61       /* Shift by two bits for now.  We may need to increase this in the future
  62          if more TLS registers get added.  */
  63       h = h << 2 | features.tls;
  64       return h;
  65     }
  66   };
  67 }
  68
  69 /* Create the aarch64 target description.  */
  70
  71 target_desc *
  72   aarch64_create_target_description (const aarch64_features &features);
  73
  74 /* Register numbers of various important registers.
  75    Note that on SVE, the Z registers reuse the V register numbers and the V
  76    registers become pseudo registers.  */
  77 enum aarch64_regnum
  78 {
  79   AARCH64_X0_REGNUM,            /* First integer register.  */
  80   AARCH64_FP_REGNUM = AARCH64_X0_REGNUM + 29,   /* Frame register, if used.  */
  81   AARCH64_LR_REGNUM = AARCH64_X0_REGNUM + 30,   /* Return address.  */
  82   AARCH64_SP_REGNUM,            /* Stack pointer.  */
  83   AARCH64_PC_REGNUM,            /* Program counter.  */
  84   AARCH64_CPSR_REGNUM,          /* Current Program Status Register.  */
  85   AARCH64_V0_REGNUM,            /* First fp/vec register.  */
  86   AARCH64_V31_REGNUM = AARCH64_V0_REGNUM + 31,  /* Last fp/vec register.  */
  87   AARCH64_SVE_Z0_REGNUM = AARCH64_V0_REGNUM,    /* First SVE Z register.  */
  88   AARCH64_SVE_Z31_REGNUM = AARCH64_V31_REGNUM,  /* Last SVE Z register.  */
  89   AARCH64_FPSR_REGNUM,          /* Floating Point Status Register.  */
  90   AARCH64_FPCR_REGNUM,          /* Floating Point Control Register.  */
  91   AARCH64_SVE_P0_REGNUM,        /* First SVE predicate register.  */
  92   AARCH64_SVE_P15_REGNUM = AARCH64_SVE_P0_REGNUM + 15,  /* Last SVE predicate
  93                                                            register.  */
  94   AARCH64_SVE_FFR_REGNUM,       /* SVE First Fault Register.  */
  95   AARCH64_SVE_VG_REGNUM,        /* SVE Vector Granule.  */
  96
  97   /* Other useful registers.  */
  98   AARCH64_LAST_X_ARG_REGNUM = AARCH64_X0_REGNUM + 7,
  99   AARCH64_STRUCT_RETURN_REGNUM = AARCH64_X0_REGNUM + 8,
 100   AARCH64_LAST_V_ARG_REGNUM = AARCH64_V0_REGNUM + 7
 101 };
 102
 103 /* Sizes of various AArch64 registers.  */
 104 #define AARCH64_TLS_REGISTER_SIZE 8
 105 #define V_REGISTER_SIZE   16
 106
 107 /* Pseudo register base numbers.  */
 108 #define AARCH64_Q0_REGNUM 0
 109 #define AARCH64_D0_REGNUM (AARCH64_Q0_REGNUM + AARCH64_D_REGISTER_COUNT)
 110 #define AARCH64_S0_REGNUM (AARCH64_D0_REGNUM + 32)
 111 #define AARCH64_H0_REGNUM (AARCH64_S0_REGNUM + 32)
 112 #define AARCH64_B0_REGNUM (AARCH64_H0_REGNUM + 32)
 113 #define AARCH64_SVE_V0_REGNUM (AARCH64_B0_REGNUM + 32)
 114
 115 #define AARCH64_PAUTH_DMASK_REGNUM(pauth_reg_base) (pauth_reg_base)
 116 #define AARCH64_PAUTH_CMASK_REGNUM(pauth_reg_base) (pauth_reg_base + 1)
 117 #define AARCH64_PAUTH_REGS_SIZE (16)
 118
 119 #define AARCH64_X_REGS_NUM 31
 120 #define AARCH64_V_REGS_NUM 32
 121 #define AARCH64_SVE_Z_REGS_NUM AARCH64_V_REGS_NUM
 122 #define AARCH64_SVE_P_REGS_NUM 16
 123 #define AARCH64_NUM_REGS AARCH64_FPCR_REGNUM + 1
 124 #define AARCH64_SVE_NUM_REGS AARCH64_SVE_VG_REGNUM + 1
 125
 126 /* There are a number of ways of expressing the current SVE vector size:
 127
 128    VL : Vector Length.
 129         The number of bytes in an SVE Z register.
 130    VQ : Vector Quotient.
 131         The number of 128bit chunks in an SVE Z register.
 132    VG : Vector Granule.
 133         The number of 64bit chunks in an SVE Z register.  */
 134
 135 #define sve_vg_from_vl(vl)      ((vl) / 8)
 136 #define sve_vl_from_vg(vg)      ((vg) * 8)
 137 #ifndef sve_vq_from_vl
 138 #define sve_vq_from_vl(vl)      ((vl) / 0x10)
 139 #endif
 140 #ifndef sve_vl_from_vq
 141 #define sve_vl_from_vq(vq)      ((vq) * 0x10)
 142 #endif
 143 #define sve_vq_from_vg(vg)      (sve_vq_from_vl (sve_vl_from_vg (vg)))
 144 #define sve_vg_from_vq(vq)      (sve_vg_from_vl (sve_vl_from_vq (vq)))
 145
 146
 147 /* Maximum supported VQ value.  Increase if required.  */
 148 #define AARCH64_MAX_SVE_VQ  16
 149
 150 #endif /* ARCH_AARCH64_H */