// Copyright 2013 Dolphin Emulator Project // Licensed under GPLv2 // Refer to the license.txt file included. #pragma once #include "Common.h" #include "MemoryUtil.h" // Everything that needs to generate code should inherit from this. // You get memory management for free, plus, you can use all emitter functions without // having to prefix them with gen-> or something similar. // Example implementation: // class JIT : public CodeBlock, public JitInterface {} class CodeBlockCommon { public: CodeBlockCommon() : region(nullptr), region_size(0) {} virtual ~CodeBlockCommon() {} bool IsInSpace(const u8 *ptr) { return (ptr >= region) && (ptr < (region + region_size)); } virtual void SetCodePtr(u8 *ptr) = 0; virtual const u8 *GetCodePtr() const = 0; u8 *GetBasePtr() { return region; } size_t GetOffset(const u8 *ptr) const { return ptr - region; } protected: u8 *region; size_t region_size; }; template class CodeBlock : public CodeBlockCommon, public T { private: CodeBlock(const CodeBlock &) = delete; void operator=(const CodeBlock &) = delete; // A privately used function to set the executable RAM space to something invalid. // For debugging usefulness it should be used to set the RAM to a host specific breakpoint instruction virtual void PoisonMemory(int offset) = 0; public: CodeBlock() : writeStart_(nullptr) {} virtual ~CodeBlock() { if (region) FreeCodeSpace(); } // Call this before you generate any code. void AllocCodeSpace(int size) { region_size = size; // The protection will be set to RW if PlatformIsWXExclusive. region = (u8*)AllocateExecutableMemory(region_size); T::SetCodePointer(region); } // Always clear code space with breakpoints, so that if someone accidentally executes // uninitialized, it just breaks into the debugger. void ClearCodeSpace(int offset) { if (PlatformIsWXExclusive()) { ProtectMemoryPages(region, region_size, MEM_PROT_READ | MEM_PROT_WRITE); } // If not WX Exclusive, no need to call ProtectMemoryPages because we never change the protection from RWX. PoisonMemory(offset); ResetCodePtr(offset); if (PlatformIsWXExclusive()) { // Need to re-protect the part we didn't clear. ProtectMemoryPages(region, offset, MEM_PROT_READ | MEM_PROT_EXEC); } } // BeginWrite/EndWrite assume that we keep appending. // If you don't specify a size and we later encounter an executable non-writable block, we're screwed. // These CANNOT be nested. We rely on the memory protection starting at READ|WRITE after start and reset. void BeginWrite(size_t sizeEstimate = 1) { #ifdef _DEBUG if (writeStart_) { PanicAlert("Can't nest BeginWrite calls"); } #endif // In case the last block made the current page exec/no-write, let's fix that. if (PlatformIsWXExclusive()) { writeStart_ = GetCodePtr(); ProtectMemoryPages(writeStart_, sizeEstimate, MEM_PROT_READ | MEM_PROT_WRITE); } } void EndWrite() { // OK, we're done. Re-protect the memory we touched. if (PlatformIsWXExclusive() && writeStart_ != nullptr) { const uint8_t *end = GetCodePtr(); ProtectMemoryPages(writeStart_, end - writeStart_, MEM_PROT_READ | MEM_PROT_EXEC); writeStart_ = nullptr; } } // Call this when shutting down. Don't rely on the destructor, even though it'll do the job. void FreeCodeSpace() { ProtectMemoryPages(region, region_size, MEM_PROT_READ | MEM_PROT_WRITE); FreeMemoryPages(region, region_size); region = nullptr; region_size = 0; } void SetCodePtr(u8 *ptr) override { T::SetCodePointer(ptr); } const u8 *GetCodePtr() const override { return T::GetCodePointer(); } void ResetCodePtr(int offset) { T::SetCodePointer(region + offset); } size_t GetSpaceLeft() const { return region_size - (T::GetCodePointer() - region); } private: const uint8_t *writeStart_; };