arch/arm64/kvm/debug.c

   1 /*
   2  * Debug and Guest Debug support
   3  *
   4  * Copyright (C) 2015 - Linaro Ltd
   5  * Author: Alex Bennée <alex.bennee@linaro.org>
   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 version 2 as
   9  * published by the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include <linux/kvm_host.h>
  21 #include <linux/hw_breakpoint.h>
  22
  23 #include <asm/debug-monitors.h>
  24 #include <asm/kvm_asm.h>
  25 #include <asm/kvm_arm.h>
  26 #include <asm/kvm_emulate.h>
  27
  28 #include "trace.h"
  29
  30 /* These are the bits of MDSCR_EL1 we may manipulate */
  31 #define MDSCR_EL1_DEBUG_MASK    (DBG_MDSCR_SS | \
  32                                 DBG_MDSCR_KDE | \
  33                                 DBG_MDSCR_MDE)
  34
  35 static DEFINE_PER_CPU(u32, mdcr_el2);
  36
  37 /**
  38  * save/restore_guest_debug_regs
  39  *
  40  * For some debug operations we need to tweak some guest registers. As
  41  * a result we need to save the state of those registers before we
  42  * make those modifications.
  43  *
  44  * Guest access to MDSCR_EL1 is trapped by the hypervisor and handled
  45  * after we have restored the preserved value to the main context.
  46  */
  47 static void save_guest_debug_regs(struct kvm_vcpu *vcpu)
  48 {
  49         vcpu->arch.guest_debug_preserved.mdscr_el1 = vcpu_sys_reg(vcpu, MDSCR_EL1);
  50
  51         trace_kvm_arm_set_dreg32("Saved MDSCR_EL1",
  52                                 vcpu->arch.guest_debug_preserved.mdscr_el1);
  53 }
  54
  55 static void restore_guest_debug_regs(struct kvm_vcpu *vcpu)
  56 {
  57         vcpu_sys_reg(vcpu, MDSCR_EL1) = vcpu->arch.guest_debug_preserved.mdscr_el1;
  58
  59         trace_kvm_arm_set_dreg32("Restored MDSCR_EL1",
  60                                 vcpu_sys_reg(vcpu, MDSCR_EL1));
  61 }
  62
  63 /**
  64  * kvm_arm_init_debug - grab what we need for debug
  65  *
  66  * Currently the sole task of this function is to retrieve the initial
  67  * value of mdcr_el2 so we can preserve MDCR_EL2.HPMN which has
  68  * presumably been set-up by some knowledgeable bootcode.
  69  *
  70  * It is called once per-cpu during CPU hyp initialisation.
  71  */
  72
  73 void kvm_arm_init_debug(void)
  74 {
  75         __this_cpu_write(mdcr_el2, kvm_call_hyp(__kvm_get_mdcr_el2));
  76 }
  77
  78 /**
  79  * kvm_arm_reset_debug_ptr - reset the debug ptr to point to the vcpu state
  80  */
  81
  82 void kvm_arm_reset_debug_ptr(struct kvm_vcpu *vcpu)
  83 {
  84         vcpu->arch.debug_ptr = &vcpu->arch.vcpu_debug_state;
  85 }
  86
  87 /**
  88  * kvm_arm_setup_debug - set up debug related stuff
  89  *
  90  * @vcpu:       the vcpu pointer
  91  *
  92  * This is called before each entry into the hypervisor to setup any
  93  * debug related registers. Currently this just ensures we will trap
  94  * access to:
  95  *  - Performance monitors (MDCR_EL2_TPM/MDCR_EL2_TPMCR)
  96  *  - Debug ROM Address (MDCR_EL2_TDRA)
  97  *  - OS related registers (MDCR_EL2_TDOSA)
  98  *  - Statistical profiler (MDCR_EL2_TPMS/MDCR_EL2_E2PB)
  99  *  - Self-hosted Trace Filter controls (MDCR_EL2_TTRF)
 100  *
 101  * Additionally, KVM only traps guest accesses to the debug registers if
 102  * the guest is not actively using them (see the KVM_ARM64_DEBUG_DIRTY
 103  * flag on vcpu->arch.debug_flags).  Since the guest must not interfere
 104  * with the hardware state when debugging the guest, we must ensure that
 105  * trapping is enabled whenever we are debugging the guest using the
 106  * debug registers.
 107  */
 108
 109 void kvm_arm_setup_debug(struct kvm_vcpu *vcpu)
 110 {
 111         bool trap_debug = !(vcpu->arch.debug_flags & KVM_ARM64_DEBUG_DIRTY);
 112
 113         trace_kvm_arm_setup_debug(vcpu, vcpu->guest_debug);
 114
 115         /*
 116          * This also clears MDCR_EL2_E2PB_MASK to disable guest access
 117          * to the profiling buffer.
 118          */
 119         vcpu->arch.mdcr_el2 = __this_cpu_read(mdcr_el2) & MDCR_EL2_HPMN_MASK;
 120         vcpu->arch.mdcr_el2 |= (MDCR_EL2_TPM |
 121                                 MDCR_EL2_TPMS |
 122                                 MDCR_EL2_TTRF |
 123                                 MDCR_EL2_TPMCR |
 124                                 MDCR_EL2_TDRA |
 125                                 MDCR_EL2_TDOSA);
 126
 127         /* Is Guest debugging in effect? */
 128         if (vcpu->guest_debug) {
 129                 /* Route all software debug exceptions to EL2 */
 130                 vcpu->arch.mdcr_el2 |= MDCR_EL2_TDE;
 131
 132                 /* Save guest debug state */
 133                 save_guest_debug_regs(vcpu);
 134
 135                 /*
 136                  * Single Step (ARM ARM D2.12.3 The software step state
 137                  * machine)
 138                  *
 139                  * If we are doing Single Step we need to manipulate
 140                  * the guest's MDSCR_EL1.SS and PSTATE.SS. Once the
 141                  * step has occurred the hypervisor will trap the
 142                  * debug exception and we return to userspace.
 143                  *
 144                  * If the guest attempts to single step its userspace
 145                  * we would have to deal with a trapped exception
 146                  * while in the guest kernel. Because this would be
 147                  * hard to unwind we suppress the guest's ability to
 148                  * do so by masking MDSCR_EL.SS.
 149                  *
 150                  * This confuses guest debuggers which use
 151                  * single-step behind the scenes but everything
 152                  * returns to normal once the host is no longer
 153                  * debugging the system.
 154                  */
 155                 if (vcpu->guest_debug & KVM_GUESTDBG_SINGLESTEP) {
 156                         *vcpu_cpsr(vcpu) |=  DBG_SPSR_SS;
 157                         vcpu_sys_reg(vcpu, MDSCR_EL1) |= DBG_MDSCR_SS;
 158                 } else {
 159                         vcpu_sys_reg(vcpu, MDSCR_EL1) &= ~DBG_MDSCR_SS;
 160                 }
 161
 162                 trace_kvm_arm_set_dreg32("SPSR_EL2", *vcpu_cpsr(vcpu));
 163
 164                 /*
 165                  * HW Breakpoints and watchpoints
 166                  *
 167                  * We simply switch the debug_ptr to point to our new
 168                  * external_debug_state which has been populated by the
 169                  * debug ioctl. The existing KVM_ARM64_DEBUG_DIRTY
 170                  * mechanism ensures the registers are updated on the
 171                  * world switch.
 172                  */
 173                 if (vcpu->guest_debug & KVM_GUESTDBG_USE_HW) {
 174                         /* Enable breakpoints/watchpoints */
 175                         vcpu_sys_reg(vcpu, MDSCR_EL1) |= DBG_MDSCR_MDE;
 176
 177                         vcpu->arch.debug_ptr = &vcpu->arch.external_debug_state;
 178                         vcpu->arch.debug_flags |= KVM_ARM64_DEBUG_DIRTY;
 179                         trap_debug = true;
 180
 181                         trace_kvm_arm_set_regset("BKPTS", get_num_brps(),
 182                                                 &vcpu->arch.debug_ptr->dbg_bcr[0],
 183                                                 &vcpu->arch.debug_ptr->dbg_bvr[0]);
 184
 185                         trace_kvm_arm_set_regset("WAPTS", get_num_wrps(),
 186                                                 &vcpu->arch.debug_ptr->dbg_wcr[0],
 187                                                 &vcpu->arch.debug_ptr->dbg_wvr[0]);
 188                 }
 189         }
 190
 191         BUG_ON(!vcpu->guest_debug &&
 192                 vcpu->arch.debug_ptr != &vcpu->arch.vcpu_debug_state);
 193
 194         /* Trap debug register access */
 195         if (trap_debug)
 196                 vcpu->arch.mdcr_el2 |= MDCR_EL2_TDA;
 197
 198         trace_kvm_arm_set_dreg32("MDCR_EL2", vcpu->arch.mdcr_el2);
 199         trace_kvm_arm_set_dreg32("MDSCR_EL1", vcpu_sys_reg(vcpu, MDSCR_EL1));
 200 }
 201
 202 void kvm_arm_clear_debug(struct kvm_vcpu *vcpu)
 203 {
 204         trace_kvm_arm_clear_debug(vcpu->guest_debug);
 205
 206         if (vcpu->guest_debug) {
 207                 restore_guest_debug_regs(vcpu);
 208
 209                 /*
 210                  * If we were using HW debug we need to restore the
 211                  * debug_ptr to the guest debug state.
 212                  */
 213                 if (vcpu->guest_debug & KVM_GUESTDBG_USE_HW) {
 214                         kvm_arm_reset_debug_ptr(vcpu);
 215
 216                         trace_kvm_arm_set_regset("BKPTS", get_num_brps(),
 217                                                 &vcpu->arch.debug_ptr->dbg_bcr[0],
 218                                                 &vcpu->arch.debug_ptr->dbg_bvr[0]);
 219
 220                         trace_kvm_arm_set_regset("WAPTS", get_num_wrps(),
 221                                                 &vcpu->arch.debug_ptr->dbg_wcr[0],
 222                                                 &vcpu->arch.debug_ptr->dbg_wvr[0]);
 223                 }
 224         }
 225 }