base.hh revision 11168
19651SAndreas.Sandberg@ARM.com/* 29651SAndreas.Sandberg@ARM.com * Copyright (c) 2012 ARM Limited 39651SAndreas.Sandberg@ARM.com * All rights reserved 49651SAndreas.Sandberg@ARM.com * 59651SAndreas.Sandberg@ARM.com * The license below extends only to copyright in the software and shall 69651SAndreas.Sandberg@ARM.com * not be construed as granting a license to any other intellectual 79651SAndreas.Sandberg@ARM.com * property including but not limited to intellectual property relating 89651SAndreas.Sandberg@ARM.com * to a hardware implementation of the functionality of the software 99651SAndreas.Sandberg@ARM.com * licensed hereunder. You may use the software subject to the license 109651SAndreas.Sandberg@ARM.com * terms below provided that you ensure that this notice is replicated 119651SAndreas.Sandberg@ARM.com * unmodified and in its entirety in all distributions of the software, 129651SAndreas.Sandberg@ARM.com * modified or unmodified, in source code or in binary form. 139651SAndreas.Sandberg@ARM.com * 149651SAndreas.Sandberg@ARM.com * Redistribution and use in source and binary forms, with or without 159651SAndreas.Sandberg@ARM.com * modification, are permitted provided that the following conditions are 169651SAndreas.Sandberg@ARM.com * met: redistributions of source code must retain the above copyright 179651SAndreas.Sandberg@ARM.com * notice, this list of conditions and the following disclaimer; 189651SAndreas.Sandberg@ARM.com * redistributions in binary form must reproduce the above copyright 199651SAndreas.Sandberg@ARM.com * notice, this list of conditions and the following disclaimer in the 209651SAndreas.Sandberg@ARM.com * documentation and/or other materials provided with the distribution; 219651SAndreas.Sandberg@ARM.com * neither the name of the copyright holders nor the names of its 229651SAndreas.Sandberg@ARM.com * contributors may be used to endorse or promote products derived from 239651SAndreas.Sandberg@ARM.com * this software without specific prior written permission. 249651SAndreas.Sandberg@ARM.com * 259651SAndreas.Sandberg@ARM.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 269651SAndreas.Sandberg@ARM.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 279651SAndreas.Sandberg@ARM.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 289651SAndreas.Sandberg@ARM.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 299651SAndreas.Sandberg@ARM.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 309651SAndreas.Sandberg@ARM.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 319651SAndreas.Sandberg@ARM.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 329651SAndreas.Sandberg@ARM.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 339651SAndreas.Sandberg@ARM.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 349651SAndreas.Sandberg@ARM.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 359651SAndreas.Sandberg@ARM.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 369651SAndreas.Sandberg@ARM.com * 379651SAndreas.Sandberg@ARM.com * Authors: Andreas Sandberg 389651SAndreas.Sandberg@ARM.com */ 399651SAndreas.Sandberg@ARM.com 409651SAndreas.Sandberg@ARM.com#ifndef __CPU_KVM_BASE_HH__ 419651SAndreas.Sandberg@ARM.com#define __CPU_KVM_BASE_HH__ 429651SAndreas.Sandberg@ARM.com 4310114Sandreas@sandberg.pp.se#include <pthread.h> 4410114Sandreas@sandberg.pp.se 4510114Sandreas@sandberg.pp.se#include <csignal> 469651SAndreas.Sandberg@ARM.com#include <memory> 479651SAndreas.Sandberg@ARM.com 489651SAndreas.Sandberg@ARM.com#include "base/statistics.hh" 499651SAndreas.Sandberg@ARM.com#include "cpu/kvm/perfevent.hh" 509651SAndreas.Sandberg@ARM.com#include "cpu/kvm/timer.hh" 519651SAndreas.Sandberg@ARM.com#include "cpu/kvm/vm.hh" 529651SAndreas.Sandberg@ARM.com#include "cpu/base.hh" 539651SAndreas.Sandberg@ARM.com#include "cpu/simple_thread.hh" 549651SAndreas.Sandberg@ARM.com 5510114Sandreas@sandberg.pp.se/** Signal to use to trigger exits from KVM */ 5610114Sandreas@sandberg.pp.se#define KVM_KICK_SIGNAL SIGRTMIN 579892Sandreas@sandberg.pp.se 589651SAndreas.Sandberg@ARM.com// forward declarations 599651SAndreas.Sandberg@ARM.comclass ThreadContext; 609651SAndreas.Sandberg@ARM.comstruct BaseKvmCPUParams; 619651SAndreas.Sandberg@ARM.com 629651SAndreas.Sandberg@ARM.com/** 639651SAndreas.Sandberg@ARM.com * Base class for KVM based CPU models 649651SAndreas.Sandberg@ARM.com * 659651SAndreas.Sandberg@ARM.com * All architecture specific KVM implementation should inherit from 669651SAndreas.Sandberg@ARM.com * this class. The most basic CPU models only need to override the 679651SAndreas.Sandberg@ARM.com * updateKvmState() and updateThreadContext() methods to implement 689651SAndreas.Sandberg@ARM.com * state synchronization between gem5 and KVM. 699651SAndreas.Sandberg@ARM.com * 709651SAndreas.Sandberg@ARM.com * The architecture specific implementation is also responsible for 719651SAndreas.Sandberg@ARM.com * delivering interrupts into the VM. This is typically done by 729651SAndreas.Sandberg@ARM.com * overriding tick() and checking the thread context before entering 739651SAndreas.Sandberg@ARM.com * into the VM. In order to deliver an interrupt, the implementation 749651SAndreas.Sandberg@ARM.com * then calls KvmVM::setIRQLine() or BaseKvmCPU::kvmInterrupt() 759651SAndreas.Sandberg@ARM.com * depending on the specifics of the underlying hardware/drivers. 769651SAndreas.Sandberg@ARM.com */ 779651SAndreas.Sandberg@ARM.comclass BaseKvmCPU : public BaseCPU 789651SAndreas.Sandberg@ARM.com{ 799651SAndreas.Sandberg@ARM.com public: 809651SAndreas.Sandberg@ARM.com BaseKvmCPU(BaseKvmCPUParams *params); 819651SAndreas.Sandberg@ARM.com virtual ~BaseKvmCPU(); 829651SAndreas.Sandberg@ARM.com 839651SAndreas.Sandberg@ARM.com void init(); 849651SAndreas.Sandberg@ARM.com void startup(); 859651SAndreas.Sandberg@ARM.com void regStats(); 869651SAndreas.Sandberg@ARM.com 8711168Sandreas.hansson@arm.com void serializeThread(CheckpointOut &cp, ThreadID tid) const override; 8811168Sandreas.hansson@arm.com void unserializeThread(CheckpointIn &cp, ThreadID tid) override; 899651SAndreas.Sandberg@ARM.com 9011168Sandreas.hansson@arm.com DrainState drain() override; 9111168Sandreas.hansson@arm.com void drainResume() override; 929651SAndreas.Sandberg@ARM.com 939651SAndreas.Sandberg@ARM.com void switchOut(); 949651SAndreas.Sandberg@ARM.com void takeOverFrom(BaseCPU *cpu); 959651SAndreas.Sandberg@ARM.com 969651SAndreas.Sandberg@ARM.com void verifyMemoryMode() const; 979651SAndreas.Sandberg@ARM.com 989688Sandreas@sandberg.pp.se MasterPort &getDataPort() { return dataPort; } 999688Sandreas@sandberg.pp.se MasterPort &getInstPort() { return instPort; } 1009651SAndreas.Sandberg@ARM.com 10111168Sandreas.hansson@arm.com void wakeup(ThreadID tid = 0) override; 10210407Smitch.hayenga@arm.com void activateContext(ThreadID thread_num); 1039651SAndreas.Sandberg@ARM.com void suspendContext(ThreadID thread_num); 1049651SAndreas.Sandberg@ARM.com void deallocateContext(ThreadID thread_num); 1059651SAndreas.Sandberg@ARM.com void haltContext(ThreadID thread_num); 1069651SAndreas.Sandberg@ARM.com 1079652SAndreas.Sandberg@ARM.com ThreadContext *getContext(int tn); 1089652SAndreas.Sandberg@ARM.com 1099651SAndreas.Sandberg@ARM.com Counter totalInsts() const; 1109651SAndreas.Sandberg@ARM.com Counter totalOps() const; 1119651SAndreas.Sandberg@ARM.com 1129651SAndreas.Sandberg@ARM.com /** Dump the internal state to the terminal. */ 11310905Sandreas.sandberg@arm.com virtual void dump() const; 1149651SAndreas.Sandberg@ARM.com 1159652SAndreas.Sandberg@ARM.com /** 11610114Sandreas@sandberg.pp.se * Force an exit from KVM. 11710114Sandreas@sandberg.pp.se * 11810114Sandreas@sandberg.pp.se * Send a signal to the thread owning this vCPU to get it to exit 11910114Sandreas@sandberg.pp.se * from KVM. Ignored if the vCPU is not executing. 12010114Sandreas@sandberg.pp.se */ 12110114Sandreas@sandberg.pp.se void kick() const { pthread_kill(vcpuThread, KVM_KICK_SIGNAL); } 12210114Sandreas@sandberg.pp.se 12310114Sandreas@sandberg.pp.se /** 1249652SAndreas.Sandberg@ARM.com * A cached copy of a thread's state in the form of a SimpleThread 1259652SAndreas.Sandberg@ARM.com * object. 1269652SAndreas.Sandberg@ARM.com * 1279652SAndreas.Sandberg@ARM.com * Normally the actual thread state is stored in the KVM vCPU. If KVM has 1289652SAndreas.Sandberg@ARM.com * been running this copy is will be out of date. If we recently handled 1299652SAndreas.Sandberg@ARM.com * some events within gem5 that required state to be updated this could be 1309652SAndreas.Sandberg@ARM.com * the most up-to-date copy. When getContext() or updateThreadContext() is 1319652SAndreas.Sandberg@ARM.com * called this copy gets updated. The method syncThreadContext can 1329652SAndreas.Sandberg@ARM.com * be used within a KVM CPU to update the thread context if the 1339652SAndreas.Sandberg@ARM.com * KVM state is dirty (i.e., the vCPU has been run since the last 1349652SAndreas.Sandberg@ARM.com * update). 1359652SAndreas.Sandberg@ARM.com */ 1369651SAndreas.Sandberg@ARM.com SimpleThread *thread; 1379651SAndreas.Sandberg@ARM.com 1389651SAndreas.Sandberg@ARM.com /** ThreadContext object, provides an interface for external 1399651SAndreas.Sandberg@ARM.com * objects to modify this thread's state. 1409651SAndreas.Sandberg@ARM.com */ 1419651SAndreas.Sandberg@ARM.com ThreadContext *tc; 1429651SAndreas.Sandberg@ARM.com 1439651SAndreas.Sandberg@ARM.com KvmVM &vm; 1449651SAndreas.Sandberg@ARM.com 1459651SAndreas.Sandberg@ARM.com protected: 1469753Sandreas@sandberg.pp.se /** 1479753Sandreas@sandberg.pp.se * 1489753Sandreas@sandberg.pp.se * @dot 1499753Sandreas@sandberg.pp.se * digraph { 1509753Sandreas@sandberg.pp.se * Idle; 1519753Sandreas@sandberg.pp.se * Running; 1529753Sandreas@sandberg.pp.se * RunningService; 1539753Sandreas@sandberg.pp.se * RunningServiceCompletion; 1549753Sandreas@sandberg.pp.se * 1559753Sandreas@sandberg.pp.se * Idle -> Idle; 1569753Sandreas@sandberg.pp.se * Idle -> Running [label="activateContext()", URL="\ref activateContext"]; 1579753Sandreas@sandberg.pp.se * Running -> Running [label="tick()", URL="\ref tick"]; 1589753Sandreas@sandberg.pp.se * Running -> RunningService [label="tick()", URL="\ref tick"]; 1599753Sandreas@sandberg.pp.se * Running -> Idle [label="suspendContext()", URL="\ref suspendContext"]; 1609753Sandreas@sandberg.pp.se * Running -> Idle [label="drain()", URL="\ref drain"]; 1619753Sandreas@sandberg.pp.se * Idle -> Running [label="drainResume()", URL="\ref drainResume"]; 1629753Sandreas@sandberg.pp.se * RunningService -> RunningServiceCompletion [label="handleKvmExit()", URL="\ref handleKvmExit"]; 1639753Sandreas@sandberg.pp.se * RunningServiceCompletion -> Running [label="tick()", URL="\ref tick"]; 1649753Sandreas@sandberg.pp.se * RunningServiceCompletion -> RunningService [label="tick()", URL="\ref tick"]; 1659753Sandreas@sandberg.pp.se * } 1669753Sandreas@sandberg.pp.se * @enddot 1679753Sandreas@sandberg.pp.se */ 1689651SAndreas.Sandberg@ARM.com enum Status { 1699753Sandreas@sandberg.pp.se /** Context not scheduled in KVM. 1709753Sandreas@sandberg.pp.se * 1719753Sandreas@sandberg.pp.se * The CPU generally enters this state when the guest execute 1729753Sandreas@sandberg.pp.se * an instruction that halts the CPU (e.g., WFI on ARM or HLT 1739753Sandreas@sandberg.pp.se * on X86) if KVM traps this instruction. Ticks are not 1749753Sandreas@sandberg.pp.se * scheduled in this state. 1759753Sandreas@sandberg.pp.se * 1769753Sandreas@sandberg.pp.se * @see suspendContext() 1779753Sandreas@sandberg.pp.se */ 1789651SAndreas.Sandberg@ARM.com Idle, 1799753Sandreas@sandberg.pp.se /** Running normally. 1809753Sandreas@sandberg.pp.se * 1819753Sandreas@sandberg.pp.se * This is the normal run state of the CPU. KVM will be 1829753Sandreas@sandberg.pp.se * entered next time tick() is called. 1839753Sandreas@sandberg.pp.se */ 1849651SAndreas.Sandberg@ARM.com Running, 1859753Sandreas@sandberg.pp.se /** Requiring service at the beginning of the next cycle. 1869753Sandreas@sandberg.pp.se * 1879753Sandreas@sandberg.pp.se * The virtual machine has exited and requires service, tick() 1889753Sandreas@sandberg.pp.se * will call handleKvmExit() on the next cycle. The next state 1899753Sandreas@sandberg.pp.se * after running service is determined in handleKvmExit() and 1909753Sandreas@sandberg.pp.se * depends on what kind of service the guest requested: 1919753Sandreas@sandberg.pp.se * <ul> 1929753Sandreas@sandberg.pp.se * <li>IO/MMIO: RunningServiceCompletion 1939753Sandreas@sandberg.pp.se * <li>Halt: Idle 1949753Sandreas@sandberg.pp.se * <li>Others: Running 1959753Sandreas@sandberg.pp.se * </ul> 1969753Sandreas@sandberg.pp.se */ 1979753Sandreas@sandberg.pp.se RunningService, 1989753Sandreas@sandberg.pp.se /** Service completion in progress. 1999753Sandreas@sandberg.pp.se * 2009753Sandreas@sandberg.pp.se * The VM has requested service that requires KVM to be 2019753Sandreas@sandberg.pp.se * entered once in order to get to a consistent state. This 2029753Sandreas@sandberg.pp.se * happens in handleKvmExit() or one of its friends after IO 2039753Sandreas@sandberg.pp.se * exits. After executing tick(), the CPU will transition into 2049753Sandreas@sandberg.pp.se * the Running or RunningService state. 2059753Sandreas@sandberg.pp.se */ 2069753Sandreas@sandberg.pp.se RunningServiceCompletion, 2079651SAndreas.Sandberg@ARM.com }; 2089651SAndreas.Sandberg@ARM.com 2099651SAndreas.Sandberg@ARM.com /** CPU run state */ 2109651SAndreas.Sandberg@ARM.com Status _status; 2119651SAndreas.Sandberg@ARM.com 2129651SAndreas.Sandberg@ARM.com /** 2139651SAndreas.Sandberg@ARM.com * Execute the CPU until the next event in the main event queue or 2149651SAndreas.Sandberg@ARM.com * until the guest needs service from gem5. 2159651SAndreas.Sandberg@ARM.com */ 2169753Sandreas@sandberg.pp.se void tick(); 2179651SAndreas.Sandberg@ARM.com 2189651SAndreas.Sandberg@ARM.com /** 2199735Sandreas@sandberg.pp.se * Get the value of the hardware cycle counter in the guest. 2209735Sandreas@sandberg.pp.se * 2219735Sandreas@sandberg.pp.se * This method is supposed to return the total number of cycles 2229735Sandreas@sandberg.pp.se * executed in hardware mode relative to some arbitrary point in 2239735Sandreas@sandberg.pp.se * the past. It's mainly used when estimating the number of cycles 2249735Sandreas@sandberg.pp.se * actually executed by the CPU in kvmRun(). The default behavior 2259735Sandreas@sandberg.pp.se * of this method is to use the cycles performance counter, but 2269735Sandreas@sandberg.pp.se * some architectures may want to use internal registers instead. 2279735Sandreas@sandberg.pp.se * 2289735Sandreas@sandberg.pp.se * @return Number of host cycles executed relative to an undefined 2299735Sandreas@sandberg.pp.se * point in the past. 2309735Sandreas@sandberg.pp.se */ 2319735Sandreas@sandberg.pp.se virtual uint64_t getHostCycles() const; 2329735Sandreas@sandberg.pp.se 2339735Sandreas@sandberg.pp.se /** 2349651SAndreas.Sandberg@ARM.com * Request KVM to run the guest for a given number of ticks. The 2359651SAndreas.Sandberg@ARM.com * method returns the approximate number of ticks executed. 2369651SAndreas.Sandberg@ARM.com * 2379651SAndreas.Sandberg@ARM.com * @note The returned number of ticks can be both larger or 2389651SAndreas.Sandberg@ARM.com * smaller than the requested number of ticks. A smaller number 2399651SAndreas.Sandberg@ARM.com * can, for example, occur when the guest executes MMIO. A larger 2409651SAndreas.Sandberg@ARM.com * number is typically due to performance counter inaccuracies. 2419651SAndreas.Sandberg@ARM.com * 2429753Sandreas@sandberg.pp.se * @note This method is virtual in order to allow implementations 2439753Sandreas@sandberg.pp.se * to check for architecture specific events (e.g., interrupts) 2449753Sandreas@sandberg.pp.se * before entering the VM. 2459753Sandreas@sandberg.pp.se * 2469753Sandreas@sandberg.pp.se * @note It is the response of the caller (normally tick()) to 2479753Sandreas@sandberg.pp.se * make sure that the KVM state is synchronized and that the TC is 2489753Sandreas@sandberg.pp.se * invalidated after entering KVM. 2499753Sandreas@sandberg.pp.se * 25010112Sandreas@sandberg.pp.se * @note This method does not normally cause any state 25110112Sandreas@sandberg.pp.se * transitions. However, if it may suspend the CPU by suspending 25210112Sandreas@sandberg.pp.se * the thread, which leads to a transition to the Idle state. In 25310112Sandreas@sandberg.pp.se * such a case, kvm <i>must not</i> be entered. 25410112Sandreas@sandberg.pp.se * 2559753Sandreas@sandberg.pp.se * @param ticks Number of ticks to execute, set to 0 to exit 2569753Sandreas@sandberg.pp.se * immediately after finishing pending operations. 2579651SAndreas.Sandberg@ARM.com * @return Number of ticks executed (see note) 2589651SAndreas.Sandberg@ARM.com */ 2599753Sandreas@sandberg.pp.se virtual Tick kvmRun(Tick ticks); 2609753Sandreas@sandberg.pp.se 2619753Sandreas@sandberg.pp.se /** 2629753Sandreas@sandberg.pp.se * Request the CPU to run until draining completes. 2639753Sandreas@sandberg.pp.se * 2649753Sandreas@sandberg.pp.se * This function normally calls kvmRun(0) to make KVM finish 2659753Sandreas@sandberg.pp.se * pending MMIO operations. Architecures implementing 2669753Sandreas@sandberg.pp.se * archIsDrained() must override this method. 2679753Sandreas@sandberg.pp.se * 2689753Sandreas@sandberg.pp.se * @see BaseKvmCPU::archIsDrained() 2699753Sandreas@sandberg.pp.se * 2709753Sandreas@sandberg.pp.se * @return Number of ticks executed 2719753Sandreas@sandberg.pp.se */ 2729753Sandreas@sandberg.pp.se virtual Tick kvmRunDrain(); 2739651SAndreas.Sandberg@ARM.com 2749651SAndreas.Sandberg@ARM.com /** 2759651SAndreas.Sandberg@ARM.com * Get a pointer to the kvm_run structure containing all the input 2769651SAndreas.Sandberg@ARM.com * and output parameters from kvmRun(). 2779651SAndreas.Sandberg@ARM.com */ 2789651SAndreas.Sandberg@ARM.com struct kvm_run *getKvmRunState() { return _kvmRun; }; 2799651SAndreas.Sandberg@ARM.com 2809651SAndreas.Sandberg@ARM.com /** 2819651SAndreas.Sandberg@ARM.com * Retrieve a pointer to guest data stored at the end of the 2829651SAndreas.Sandberg@ARM.com * kvm_run structure. This is mainly used for PIO operations 2839651SAndreas.Sandberg@ARM.com * (KVM_EXIT_IO). 2849651SAndreas.Sandberg@ARM.com * 2859651SAndreas.Sandberg@ARM.com * @param offset Offset as specified by the kvm_run structure 2869651SAndreas.Sandberg@ARM.com * @return Pointer to guest data 2879651SAndreas.Sandberg@ARM.com */ 2889651SAndreas.Sandberg@ARM.com uint8_t *getGuestData(uint64_t offset) const { 2899651SAndreas.Sandberg@ARM.com return (uint8_t *)_kvmRun + offset; 2909651SAndreas.Sandberg@ARM.com }; 2919651SAndreas.Sandberg@ARM.com 2929651SAndreas.Sandberg@ARM.com /** 2939651SAndreas.Sandberg@ARM.com * @addtogroup KvmInterrupts 2949651SAndreas.Sandberg@ARM.com * @{ 2959651SAndreas.Sandberg@ARM.com */ 2969651SAndreas.Sandberg@ARM.com /** 2979651SAndreas.Sandberg@ARM.com * Send a non-maskable interrupt to the guest 2989651SAndreas.Sandberg@ARM.com * 2999651SAndreas.Sandberg@ARM.com * @note The presence of this call depends on Kvm::capUserNMI(). 3009651SAndreas.Sandberg@ARM.com */ 3019651SAndreas.Sandberg@ARM.com void kvmNonMaskableInterrupt(); 3029651SAndreas.Sandberg@ARM.com 3039651SAndreas.Sandberg@ARM.com /** 3049651SAndreas.Sandberg@ARM.com * Send a normal interrupt to the guest 3059651SAndreas.Sandberg@ARM.com * 3069651SAndreas.Sandberg@ARM.com * @note Make sure that ready_for_interrupt_injection in kvm_run 3079651SAndreas.Sandberg@ARM.com * is set prior to calling this function. If not, an interrupt 3089651SAndreas.Sandberg@ARM.com * window must be requested by setting request_interrupt_window in 3099651SAndreas.Sandberg@ARM.com * kvm_run to 1 and restarting the guest. 3109651SAndreas.Sandberg@ARM.com * 3119651SAndreas.Sandberg@ARM.com * @param interrupt Structure describing the interrupt to send 3129651SAndreas.Sandberg@ARM.com */ 3139651SAndreas.Sandberg@ARM.com void kvmInterrupt(const struct kvm_interrupt &interrupt); 3149651SAndreas.Sandberg@ARM.com 3159651SAndreas.Sandberg@ARM.com /** @} */ 3169651SAndreas.Sandberg@ARM.com 3179651SAndreas.Sandberg@ARM.com /** @{ */ 3189651SAndreas.Sandberg@ARM.com /** 3199651SAndreas.Sandberg@ARM.com * Get/Set the register state of the guest vCPU 3209651SAndreas.Sandberg@ARM.com * 3219651SAndreas.Sandberg@ARM.com * KVM has two different interfaces for accessing the state of the 3229651SAndreas.Sandberg@ARM.com * guest CPU. One interface updates 'normal' registers and one 3239651SAndreas.Sandberg@ARM.com * updates 'special' registers. The distinction between special 3249651SAndreas.Sandberg@ARM.com * and normal registers isn't very clear and is architecture 3259651SAndreas.Sandberg@ARM.com * dependent. 3269651SAndreas.Sandberg@ARM.com */ 3279651SAndreas.Sandberg@ARM.com void getRegisters(struct kvm_regs ®s) const; 3289651SAndreas.Sandberg@ARM.com void setRegisters(const struct kvm_regs ®s); 3299651SAndreas.Sandberg@ARM.com void getSpecialRegisters(struct kvm_sregs ®s) const; 3309651SAndreas.Sandberg@ARM.com void setSpecialRegisters(const struct kvm_sregs ®s); 3319651SAndreas.Sandberg@ARM.com /** @} */ 3329651SAndreas.Sandberg@ARM.com 3339651SAndreas.Sandberg@ARM.com /** @{ */ 3349651SAndreas.Sandberg@ARM.com /** 3359651SAndreas.Sandberg@ARM.com * Get/Set the guest FPU/vector state 3369651SAndreas.Sandberg@ARM.com */ 3379651SAndreas.Sandberg@ARM.com void getFPUState(struct kvm_fpu &state) const; 3389651SAndreas.Sandberg@ARM.com void setFPUState(const struct kvm_fpu &state); 3399651SAndreas.Sandberg@ARM.com /** @} */ 3409651SAndreas.Sandberg@ARM.com 3419651SAndreas.Sandberg@ARM.com /** @{ */ 3429651SAndreas.Sandberg@ARM.com /** 3439651SAndreas.Sandberg@ARM.com * Get/Set single register using the KVM_(SET|GET)_ONE_REG API. 3449651SAndreas.Sandberg@ARM.com * 3459651SAndreas.Sandberg@ARM.com * @note The presence of this call depends on Kvm::capOneReg(). 3469651SAndreas.Sandberg@ARM.com */ 3479651SAndreas.Sandberg@ARM.com void setOneReg(uint64_t id, const void *addr); 3489651SAndreas.Sandberg@ARM.com void setOneReg(uint64_t id, uint64_t value) { setOneReg(id, &value); } 3499651SAndreas.Sandberg@ARM.com void setOneReg(uint64_t id, uint32_t value) { setOneReg(id, &value); } 3509651SAndreas.Sandberg@ARM.com void getOneReg(uint64_t id, void *addr) const; 3519651SAndreas.Sandberg@ARM.com uint64_t getOneRegU64(uint64_t id) const { 3529651SAndreas.Sandberg@ARM.com uint64_t value; 3539651SAndreas.Sandberg@ARM.com getOneReg(id, &value); 3549651SAndreas.Sandberg@ARM.com return value; 3559651SAndreas.Sandberg@ARM.com } 3569651SAndreas.Sandberg@ARM.com uint32_t getOneRegU32(uint64_t id) const { 3579651SAndreas.Sandberg@ARM.com uint32_t value; 3589651SAndreas.Sandberg@ARM.com getOneReg(id, &value); 3599651SAndreas.Sandberg@ARM.com return value; 3609651SAndreas.Sandberg@ARM.com } 3619651SAndreas.Sandberg@ARM.com /** @} */ 3629651SAndreas.Sandberg@ARM.com 3639651SAndreas.Sandberg@ARM.com /** 3649651SAndreas.Sandberg@ARM.com * Get and format one register for printout. 3659651SAndreas.Sandberg@ARM.com * 3669651SAndreas.Sandberg@ARM.com * This function call getOneReg() to retrieve the contents of one 3679651SAndreas.Sandberg@ARM.com * register and automatically formats it for printing. 3689651SAndreas.Sandberg@ARM.com * 3699651SAndreas.Sandberg@ARM.com * @note The presence of this call depends on Kvm::capOneReg(). 3709651SAndreas.Sandberg@ARM.com */ 3719651SAndreas.Sandberg@ARM.com std::string getAndFormatOneReg(uint64_t id) const; 3729651SAndreas.Sandberg@ARM.com 3739651SAndreas.Sandberg@ARM.com /** @{ */ 3749651SAndreas.Sandberg@ARM.com /** 3759651SAndreas.Sandberg@ARM.com * Update the KVM state from the current thread context 3769651SAndreas.Sandberg@ARM.com * 3779651SAndreas.Sandberg@ARM.com * The base CPU calls this method before starting the guest CPU 3789651SAndreas.Sandberg@ARM.com * when the contextDirty flag is set. The architecture dependent 3799651SAndreas.Sandberg@ARM.com * CPU implementation is expected to update all guest state 3809651SAndreas.Sandberg@ARM.com * (registers, special registers, and FPU state). 3819651SAndreas.Sandberg@ARM.com */ 3829651SAndreas.Sandberg@ARM.com virtual void updateKvmState() = 0; 3839651SAndreas.Sandberg@ARM.com 3849651SAndreas.Sandberg@ARM.com /** 3859651SAndreas.Sandberg@ARM.com * Update the current thread context with the KVM state 3869651SAndreas.Sandberg@ARM.com * 3879651SAndreas.Sandberg@ARM.com * The base CPU after the guest updates any of the KVM state. In 3889651SAndreas.Sandberg@ARM.com * practice, this happens after kvmRun is called. The architecture 3899651SAndreas.Sandberg@ARM.com * dependent code is expected to read the state of the guest CPU 3909651SAndreas.Sandberg@ARM.com * and update gem5's thread state. 3919651SAndreas.Sandberg@ARM.com */ 3929651SAndreas.Sandberg@ARM.com virtual void updateThreadContext() = 0; 3939652SAndreas.Sandberg@ARM.com 3949652SAndreas.Sandberg@ARM.com /** 3959652SAndreas.Sandberg@ARM.com * Update a thread context if the KVM state is dirty with respect 3969652SAndreas.Sandberg@ARM.com * to the cached thread context. 3979652SAndreas.Sandberg@ARM.com */ 3989652SAndreas.Sandberg@ARM.com void syncThreadContext(); 3999652SAndreas.Sandberg@ARM.com 4009652SAndreas.Sandberg@ARM.com /** 4019652SAndreas.Sandberg@ARM.com * Update the KVM if the thread context is dirty. 4029652SAndreas.Sandberg@ARM.com */ 4039652SAndreas.Sandberg@ARM.com void syncKvmState(); 4049651SAndreas.Sandberg@ARM.com /** @} */ 4059651SAndreas.Sandberg@ARM.com 4069651SAndreas.Sandberg@ARM.com /** @{ */ 4079651SAndreas.Sandberg@ARM.com /** 4089651SAndreas.Sandberg@ARM.com * Main kvmRun exit handler, calls the relevant handleKvmExit* 4099651SAndreas.Sandberg@ARM.com * depending on exit type. 4109651SAndreas.Sandberg@ARM.com * 4119651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the exit request 4129651SAndreas.Sandberg@ARM.com */ 4139651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExit(); 4149651SAndreas.Sandberg@ARM.com 4159651SAndreas.Sandberg@ARM.com /** 4169651SAndreas.Sandberg@ARM.com * The guest performed a legacy IO request (out/inp on x86) 4179651SAndreas.Sandberg@ARM.com * 4189651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the IO request 4199651SAndreas.Sandberg@ARM.com */ 4209651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitIO(); 4219651SAndreas.Sandberg@ARM.com 4229651SAndreas.Sandberg@ARM.com /** 4239651SAndreas.Sandberg@ARM.com * The guest requested a monitor service using a hypercall 4249651SAndreas.Sandberg@ARM.com * 4259651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the hypercall 4269651SAndreas.Sandberg@ARM.com */ 4279651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitHypercall(); 4289651SAndreas.Sandberg@ARM.com 4299651SAndreas.Sandberg@ARM.com /** 4309651SAndreas.Sandberg@ARM.com * The guest exited because an interrupt window was requested 4319651SAndreas.Sandberg@ARM.com * 4329651SAndreas.Sandberg@ARM.com * The guest exited because an interrupt window was requested 4339651SAndreas.Sandberg@ARM.com * (request_interrupt_window in the kvm_run structure was set to 1 4349651SAndreas.Sandberg@ARM.com * before calling kvmRun) and it is now ready to receive 4359651SAndreas.Sandberg@ARM.com * 4369651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the IRQ 4379651SAndreas.Sandberg@ARM.com */ 4389651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitIRQWindowOpen(); 4399651SAndreas.Sandberg@ARM.com 4409651SAndreas.Sandberg@ARM.com /** 4419651SAndreas.Sandberg@ARM.com * An unknown architecture dependent error occurred when starting 4429651SAndreas.Sandberg@ARM.com * the vCPU 4439651SAndreas.Sandberg@ARM.com * 4449651SAndreas.Sandberg@ARM.com * The kvm_run data structure contains the hardware error 4459651SAndreas.Sandberg@ARM.com * code. The defaults behavior of this method just prints the HW 4469651SAndreas.Sandberg@ARM.com * error code and panics. Architecture dependent implementations 4479651SAndreas.Sandberg@ARM.com * may want to override this method to provide better, 4489651SAndreas.Sandberg@ARM.com * hardware-aware, error messages. 4499651SAndreas.Sandberg@ARM.com * 4509651SAndreas.Sandberg@ARM.com * @return Number of ticks delay the next CPU tick 4519651SAndreas.Sandberg@ARM.com */ 4529651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitUnknown(); 4539651SAndreas.Sandberg@ARM.com 4549651SAndreas.Sandberg@ARM.com /** 4559651SAndreas.Sandberg@ARM.com * An unhandled virtualization exception occured 4569651SAndreas.Sandberg@ARM.com * 4579651SAndreas.Sandberg@ARM.com * Some KVM virtualization drivers return unhandled exceptions to 4589651SAndreas.Sandberg@ARM.com * the user-space monitor. This interface is currently only used 4599651SAndreas.Sandberg@ARM.com * by the Intel VMX KVM driver. 4609651SAndreas.Sandberg@ARM.com * 4619651SAndreas.Sandberg@ARM.com * @return Number of ticks delay the next CPU tick 4629651SAndreas.Sandberg@ARM.com */ 4639651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitException(); 4649651SAndreas.Sandberg@ARM.com 4659651SAndreas.Sandberg@ARM.com /** 4669651SAndreas.Sandberg@ARM.com * KVM failed to start the virtualized CPU 4679651SAndreas.Sandberg@ARM.com * 4689651SAndreas.Sandberg@ARM.com * The kvm_run data structure contains the hardware-specific error 4699651SAndreas.Sandberg@ARM.com * code. 4709651SAndreas.Sandberg@ARM.com * 4719651SAndreas.Sandberg@ARM.com * @return Number of ticks delay the next CPU tick 4729651SAndreas.Sandberg@ARM.com */ 4739651SAndreas.Sandberg@ARM.com virtual Tick handleKvmExitFailEntry(); 4749651SAndreas.Sandberg@ARM.com /** @} */ 4759651SAndreas.Sandberg@ARM.com 4769651SAndreas.Sandberg@ARM.com /** 4779753Sandreas@sandberg.pp.se * Is the architecture specific code in a state that prevents 4789753Sandreas@sandberg.pp.se * draining? 4799753Sandreas@sandberg.pp.se * 4809753Sandreas@sandberg.pp.se * This method should return false if there are any pending events 4819753Sandreas@sandberg.pp.se * in the guest vCPU that won't be carried over to the gem5 state 4829753Sandreas@sandberg.pp.se * and thus will prevent correct checkpointing or CPU handover. It 4839753Sandreas@sandberg.pp.se * might, for example, check for pending interrupts that have been 4849753Sandreas@sandberg.pp.se * passed to the vCPU but not acknowledged by the OS. Architecures 4859753Sandreas@sandberg.pp.se * implementing this method <i>must</i> override 4869753Sandreas@sandberg.pp.se * kvmRunDrain(). 4879753Sandreas@sandberg.pp.se * 4889753Sandreas@sandberg.pp.se * @see BaseKvmCPU::kvmRunDrain() 4899753Sandreas@sandberg.pp.se * 4909753Sandreas@sandberg.pp.se * @return true if the vCPU is drained, false otherwise. 4919753Sandreas@sandberg.pp.se */ 4929753Sandreas@sandberg.pp.se virtual bool archIsDrained() const { return true; } 4939753Sandreas@sandberg.pp.se 4949753Sandreas@sandberg.pp.se /** 4959651SAndreas.Sandberg@ARM.com * Inject a memory mapped IO request into gem5 4969651SAndreas.Sandberg@ARM.com * 4979651SAndreas.Sandberg@ARM.com * @param paddr Physical address 4989651SAndreas.Sandberg@ARM.com * @param data Pointer to the source/destination buffer 4999651SAndreas.Sandberg@ARM.com * @param size Memory access size 5009651SAndreas.Sandberg@ARM.com * @param write True if write, False if read 5019651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the memory access 5029651SAndreas.Sandberg@ARM.com */ 5039651SAndreas.Sandberg@ARM.com Tick doMMIOAccess(Addr paddr, void *data, int size, bool write); 5049651SAndreas.Sandberg@ARM.com 5059753Sandreas@sandberg.pp.se /** @{ */ 5069753Sandreas@sandberg.pp.se /** 5079753Sandreas@sandberg.pp.se * Set the signal mask used in kvmRun() 5089753Sandreas@sandberg.pp.se * 5099753Sandreas@sandberg.pp.se * This method allows the signal mask of the thread executing 5109753Sandreas@sandberg.pp.se * kvmRun() to be overridden inside the actual system call. This 5119753Sandreas@sandberg.pp.se * allows us to mask timer signals used to force KVM exits while 5129753Sandreas@sandberg.pp.se * in gem5. 5139753Sandreas@sandberg.pp.se * 5149753Sandreas@sandberg.pp.se * The signal mask can be disabled by setting it to NULL. 5159753Sandreas@sandberg.pp.se * 5169753Sandreas@sandberg.pp.se * @param mask Signals to mask 5179753Sandreas@sandberg.pp.se */ 5189753Sandreas@sandberg.pp.se void setSignalMask(const sigset_t *mask); 5199753Sandreas@sandberg.pp.se /** @} */ 5209651SAndreas.Sandberg@ARM.com 5219651SAndreas.Sandberg@ARM.com /** 5229651SAndreas.Sandberg@ARM.com * @addtogroup KvmIoctl 5239651SAndreas.Sandberg@ARM.com * @{ 5249651SAndreas.Sandberg@ARM.com */ 5259651SAndreas.Sandberg@ARM.com /** 5269651SAndreas.Sandberg@ARM.com * vCPU ioctl interface. 5279651SAndreas.Sandberg@ARM.com * 5289651SAndreas.Sandberg@ARM.com * @param request KVM vCPU request 5299651SAndreas.Sandberg@ARM.com * @param p1 Optional request parameter 5309651SAndreas.Sandberg@ARM.com * 5319651SAndreas.Sandberg@ARM.com * @return -1 on error (error number in errno), ioctl dependent 5329651SAndreas.Sandberg@ARM.com * value otherwise. 5339651SAndreas.Sandberg@ARM.com */ 5349651SAndreas.Sandberg@ARM.com int ioctl(int request, long p1) const; 5359651SAndreas.Sandberg@ARM.com int ioctl(int request, void *p1) const { 5369651SAndreas.Sandberg@ARM.com return ioctl(request, (long)p1); 5379651SAndreas.Sandberg@ARM.com } 5389651SAndreas.Sandberg@ARM.com int ioctl(int request) const { 5399651SAndreas.Sandberg@ARM.com return ioctl(request, 0L); 5409651SAndreas.Sandberg@ARM.com } 5419651SAndreas.Sandberg@ARM.com /** @} */ 5429651SAndreas.Sandberg@ARM.com 5439688Sandreas@sandberg.pp.se 5449688Sandreas@sandberg.pp.se /** 5459688Sandreas@sandberg.pp.se * KVM memory port. Uses the default MasterPort behavior, but 5469688Sandreas@sandberg.pp.se * panics on timing accesses. 5479688Sandreas@sandberg.pp.se */ 5489688Sandreas@sandberg.pp.se class KVMCpuPort : public MasterPort 5499688Sandreas@sandberg.pp.se { 5509688Sandreas@sandberg.pp.se 5519688Sandreas@sandberg.pp.se public: 5529688Sandreas@sandberg.pp.se KVMCpuPort(const std::string &_name, BaseKvmCPU *_cpu) 5539688Sandreas@sandberg.pp.se : MasterPort(_name, _cpu) 5549688Sandreas@sandberg.pp.se { } 5559688Sandreas@sandberg.pp.se 5569688Sandreas@sandberg.pp.se protected: 5579688Sandreas@sandberg.pp.se bool recvTimingResp(PacketPtr pkt) 5589688Sandreas@sandberg.pp.se { 5599688Sandreas@sandberg.pp.se panic("The KVM CPU doesn't expect recvTimingResp!\n"); 5609688Sandreas@sandberg.pp.se return true; 5619688Sandreas@sandberg.pp.se } 5629688Sandreas@sandberg.pp.se 56310713Sandreas.hansson@arm.com void recvReqRetry() 5649688Sandreas@sandberg.pp.se { 56510713Sandreas.hansson@arm.com panic("The KVM CPU doesn't expect recvReqRetry!\n"); 5669688Sandreas@sandberg.pp.se } 5679688Sandreas@sandberg.pp.se 5689688Sandreas@sandberg.pp.se }; 5699688Sandreas@sandberg.pp.se 5709651SAndreas.Sandberg@ARM.com /** Port for data requests */ 5719688Sandreas@sandberg.pp.se KVMCpuPort dataPort; 5729651SAndreas.Sandberg@ARM.com 5739651SAndreas.Sandberg@ARM.com /** Unused dummy port for the instruction interface */ 5749688Sandreas@sandberg.pp.se KVMCpuPort instPort; 5759651SAndreas.Sandberg@ARM.com 5769651SAndreas.Sandberg@ARM.com /** 5779651SAndreas.Sandberg@ARM.com * Is the gem5 context dirty? Set to true to force an update of 5789651SAndreas.Sandberg@ARM.com * the KVM vCPU state upon the next call to kvmRun(). 5799651SAndreas.Sandberg@ARM.com */ 5809652SAndreas.Sandberg@ARM.com bool threadContextDirty; 5819652SAndreas.Sandberg@ARM.com 5829652SAndreas.Sandberg@ARM.com /** 5839652SAndreas.Sandberg@ARM.com * Is the KVM state dirty? Set to true to force an update of 5849652SAndreas.Sandberg@ARM.com * the KVM vCPU state upon the next call to kvmRun(). 5859652SAndreas.Sandberg@ARM.com */ 5869652SAndreas.Sandberg@ARM.com bool kvmStateDirty; 5879651SAndreas.Sandberg@ARM.com 5889651SAndreas.Sandberg@ARM.com /** KVM internal ID of the vCPU */ 5899651SAndreas.Sandberg@ARM.com const long vcpuID; 5909651SAndreas.Sandberg@ARM.com 59110114Sandreas@sandberg.pp.se /** ID of the vCPU thread */ 59210114Sandreas@sandberg.pp.se pthread_t vcpuThread; 59310114Sandreas@sandberg.pp.se 5949651SAndreas.Sandberg@ARM.com private: 5959651SAndreas.Sandberg@ARM.com struct TickEvent : public Event 5969651SAndreas.Sandberg@ARM.com { 5979651SAndreas.Sandberg@ARM.com BaseKvmCPU &cpu; 5989651SAndreas.Sandberg@ARM.com 5999651SAndreas.Sandberg@ARM.com TickEvent(BaseKvmCPU &c) 6009651SAndreas.Sandberg@ARM.com : Event(CPU_Tick_Pri), cpu(c) {} 6019651SAndreas.Sandberg@ARM.com 6029651SAndreas.Sandberg@ARM.com void process() { cpu.tick(); } 6039651SAndreas.Sandberg@ARM.com 6049651SAndreas.Sandberg@ARM.com const char *description() const { 6059651SAndreas.Sandberg@ARM.com return "BaseKvmCPU tick"; 6069651SAndreas.Sandberg@ARM.com } 6079651SAndreas.Sandberg@ARM.com }; 6089651SAndreas.Sandberg@ARM.com 6099651SAndreas.Sandberg@ARM.com /** 6109651SAndreas.Sandberg@ARM.com * Service MMIO requests in the mmioRing. 6119651SAndreas.Sandberg@ARM.com * 6129651SAndreas.Sandberg@ARM.com * 6139651SAndreas.Sandberg@ARM.com * @return Number of ticks spent servicing the MMIO requests in 6149651SAndreas.Sandberg@ARM.com * the MMIO ring buffer 6159651SAndreas.Sandberg@ARM.com */ 6169651SAndreas.Sandberg@ARM.com Tick flushCoalescedMMIO(); 6179651SAndreas.Sandberg@ARM.com 6189651SAndreas.Sandberg@ARM.com /** 6199651SAndreas.Sandberg@ARM.com * Setup a signal handler to catch the timer signal used to 6209651SAndreas.Sandberg@ARM.com * switch back to the monitor. 6219651SAndreas.Sandberg@ARM.com */ 6229651SAndreas.Sandberg@ARM.com void setupSignalHandler(); 6239651SAndreas.Sandberg@ARM.com 6249753Sandreas@sandberg.pp.se /** 6259753Sandreas@sandberg.pp.se * Discard a (potentially) pending signal. 6269753Sandreas@sandberg.pp.se * 6279753Sandreas@sandberg.pp.se * @param signum Signal to discard 6289753Sandreas@sandberg.pp.se * @return true if the signal was pending, false otherwise. 6299753Sandreas@sandberg.pp.se */ 6309753Sandreas@sandberg.pp.se bool discardPendingSignal(int signum) const; 6319753Sandreas@sandberg.pp.se 63210073Sandreas@sandberg.pp.se /** 63310073Sandreas@sandberg.pp.se * Thread-specific initialization. 63410073Sandreas@sandberg.pp.se * 63510073Sandreas@sandberg.pp.se * Some KVM-related initialization requires us to know the TID of 63610073Sandreas@sandberg.pp.se * the thread that is going to execute our event queue. For 63710073Sandreas@sandberg.pp.se * example, when setting up timers, we need to know the TID of the 63810073Sandreas@sandberg.pp.se * thread executing in KVM in order to deliver the timer signal to 63910073Sandreas@sandberg.pp.se * that thread. This method is called as the first event in this 64010073Sandreas@sandberg.pp.se * SimObject's event queue. 64110073Sandreas@sandberg.pp.se * 64210073Sandreas@sandberg.pp.se * @see startup 64310073Sandreas@sandberg.pp.se */ 64410073Sandreas@sandberg.pp.se void startupThread(); 64510073Sandreas@sandberg.pp.se 6469753Sandreas@sandberg.pp.se /** Try to drain the CPU if a drain is pending */ 6479753Sandreas@sandberg.pp.se bool tryDrain(); 6489753Sandreas@sandberg.pp.se 6499753Sandreas@sandberg.pp.se /** Execute the KVM_RUN ioctl */ 6509753Sandreas@sandberg.pp.se void ioctlRun(); 6519753Sandreas@sandberg.pp.se 6529651SAndreas.Sandberg@ARM.com /** KVM vCPU file descriptor */ 6539651SAndreas.Sandberg@ARM.com int vcpuFD; 6549651SAndreas.Sandberg@ARM.com /** Size of MMAPed kvm_run area */ 6559651SAndreas.Sandberg@ARM.com int vcpuMMapSize; 6569651SAndreas.Sandberg@ARM.com /** 6579651SAndreas.Sandberg@ARM.com * Pointer to the kvm_run structure used to communicate parameters 6589651SAndreas.Sandberg@ARM.com * with KVM. 6599651SAndreas.Sandberg@ARM.com * 6609651SAndreas.Sandberg@ARM.com * @note This is the base pointer of the MMAPed KVM region. The 6619651SAndreas.Sandberg@ARM.com * first page contains the kvm_run structure. Subsequent pages may 6629651SAndreas.Sandberg@ARM.com * contain other data such as the MMIO ring buffer. 6639651SAndreas.Sandberg@ARM.com */ 6649651SAndreas.Sandberg@ARM.com struct kvm_run *_kvmRun; 6659651SAndreas.Sandberg@ARM.com /** 6669651SAndreas.Sandberg@ARM.com * Coalesced MMIO ring buffer. NULL if coalesced MMIO is not 6679651SAndreas.Sandberg@ARM.com * supported. 6689651SAndreas.Sandberg@ARM.com */ 6699651SAndreas.Sandberg@ARM.com struct kvm_coalesced_mmio_ring *mmioRing; 6709651SAndreas.Sandberg@ARM.com /** Cached page size of the host */ 6719651SAndreas.Sandberg@ARM.com const long pageSize; 6729651SAndreas.Sandberg@ARM.com 6739651SAndreas.Sandberg@ARM.com TickEvent tickEvent; 6749651SAndreas.Sandberg@ARM.com 6759892Sandreas@sandberg.pp.se /** 6769892Sandreas@sandberg.pp.se * Setup an instruction break if there is one pending. 6779892Sandreas@sandberg.pp.se * 6789892Sandreas@sandberg.pp.se * Check if there are pending instruction breaks in the CPU's 6799892Sandreas@sandberg.pp.se * instruction event queue and schedule an instruction break using 6809892Sandreas@sandberg.pp.se * PerfEvent. 6819892Sandreas@sandberg.pp.se * 6829892Sandreas@sandberg.pp.se * @note This method doesn't currently handle the main system 6839892Sandreas@sandberg.pp.se * instruction event queue. 6849892Sandreas@sandberg.pp.se */ 6859892Sandreas@sandberg.pp.se void setupInstStop(); 6869892Sandreas@sandberg.pp.se 6879651SAndreas.Sandberg@ARM.com /** @{ */ 6889892Sandreas@sandberg.pp.se /** Setup hardware performance counters */ 6899892Sandreas@sandberg.pp.se void setupCounters(); 6909892Sandreas@sandberg.pp.se 6919892Sandreas@sandberg.pp.se /** 6929892Sandreas@sandberg.pp.se * Setup the guest instruction counter. 6939892Sandreas@sandberg.pp.se * 6949892Sandreas@sandberg.pp.se * Setup the guest instruction counter and optionally request a 6959892Sandreas@sandberg.pp.se * signal every N instructions executed by the guest. This method 6969892Sandreas@sandberg.pp.se * will re-attach the counter if the counter has already been 6979892Sandreas@sandberg.pp.se * attached and its sampling settings have changed. 6989892Sandreas@sandberg.pp.se * 6999892Sandreas@sandberg.pp.se * @param period Signal period, set to 0 to disable signaling. 7009892Sandreas@sandberg.pp.se */ 7019892Sandreas@sandberg.pp.se void setupInstCounter(uint64_t period = 0); 7029892Sandreas@sandberg.pp.se 7039892Sandreas@sandberg.pp.se /** Currently active instruction count breakpoint */ 7049892Sandreas@sandberg.pp.se uint64_t activeInstPeriod; 7059892Sandreas@sandberg.pp.se 7069892Sandreas@sandberg.pp.se /** 7079892Sandreas@sandberg.pp.se * Guest cycle counter. 7089892Sandreas@sandberg.pp.se * 7099892Sandreas@sandberg.pp.se * This is the group leader of all performance counters measuring 7109892Sandreas@sandberg.pp.se * the guest system. It can be used in conjunction with the 7119892Sandreas@sandberg.pp.se * PerfKvmTimer (see perfControlledByTimer) to trigger exits from 7129892Sandreas@sandberg.pp.se * KVM. 7139892Sandreas@sandberg.pp.se */ 7149651SAndreas.Sandberg@ARM.com PerfKvmCounter hwCycles; 7159892Sandreas@sandberg.pp.se 7169892Sandreas@sandberg.pp.se /** 7179892Sandreas@sandberg.pp.se * Guest instruction counter. 7189892Sandreas@sandberg.pp.se * 7199892Sandreas@sandberg.pp.se * This counter is typically only used to measure the number of 7209892Sandreas@sandberg.pp.se * instructions executed by the guest. However, it can also be 7219892Sandreas@sandberg.pp.se * used to trigger exits from KVM if the configuration script 7229892Sandreas@sandberg.pp.se * requests an exit after a certain number of instructions. 7239892Sandreas@sandberg.pp.se * 7249892Sandreas@sandberg.pp.se * @see setupInstBreak 7259892Sandreas@sandberg.pp.se * @see scheduleInstStop 7269892Sandreas@sandberg.pp.se */ 7279651SAndreas.Sandberg@ARM.com PerfKvmCounter hwInstructions; 7289651SAndreas.Sandberg@ARM.com 7299651SAndreas.Sandberg@ARM.com /** 7309655SAndreas.Sandberg@ARM.com * Does the runTimer control the performance counters? 7319655SAndreas.Sandberg@ARM.com * 7329655SAndreas.Sandberg@ARM.com * The run timer will automatically enable and disable performance 7339655SAndreas.Sandberg@ARM.com * counters if a PerfEvent-based timer is used to control KVM 7349655SAndreas.Sandberg@ARM.com * exits. 7359655SAndreas.Sandberg@ARM.com */ 7369655SAndreas.Sandberg@ARM.com bool perfControlledByTimer; 7379892Sandreas@sandberg.pp.se /** @} */ 7389655SAndreas.Sandberg@ARM.com 7399655SAndreas.Sandberg@ARM.com /** 7409651SAndreas.Sandberg@ARM.com * Timer used to force execution into the monitor after a 7419651SAndreas.Sandberg@ARM.com * specified number of simulation tick equivalents have executed 7429651SAndreas.Sandberg@ARM.com * in the guest. This counter generates the signal specified by 7439651SAndreas.Sandberg@ARM.com * KVM_TIMER_SIGNAL. 7449651SAndreas.Sandberg@ARM.com */ 7459651SAndreas.Sandberg@ARM.com std::unique_ptr<BaseKvmTimer> runTimer; 7469651SAndreas.Sandberg@ARM.com 7479754Sandreas@sandberg.pp.se /** Host factor as specified in the configuration */ 7489651SAndreas.Sandberg@ARM.com float hostFactor; 7499651SAndreas.Sandberg@ARM.com 7509651SAndreas.Sandberg@ARM.com public: 7519651SAndreas.Sandberg@ARM.com /* @{ */ 7529684Sandreas@sandberg.pp.se Stats::Scalar numInsts; 7539651SAndreas.Sandberg@ARM.com Stats::Scalar numVMExits; 7549755Sandreas@sandberg.pp.se Stats::Scalar numVMHalfEntries; 7559755Sandreas@sandberg.pp.se Stats::Scalar numExitSignal; 7569651SAndreas.Sandberg@ARM.com Stats::Scalar numMMIO; 7579651SAndreas.Sandberg@ARM.com Stats::Scalar numCoalescedMMIO; 7589651SAndreas.Sandberg@ARM.com Stats::Scalar numIO; 7599651SAndreas.Sandberg@ARM.com Stats::Scalar numHalt; 7609651SAndreas.Sandberg@ARM.com Stats::Scalar numInterrupts; 7619651SAndreas.Sandberg@ARM.com Stats::Scalar numHypercalls; 7629651SAndreas.Sandberg@ARM.com /* @} */ 7639752Sandreas@sandberg.pp.se 7649752Sandreas@sandberg.pp.se /** Number of instructions executed by the CPU */ 7659752Sandreas@sandberg.pp.se Counter ctrInsts; 7669651SAndreas.Sandberg@ARM.com}; 7679651SAndreas.Sandberg@ARM.com 7689651SAndreas.Sandberg@ARM.com#endif 769