2014-05-10 02:11:18 +00:00
|
|
|
// Copyright 2014 Citra Emulator Project / PPSSPP Project
|
2014-12-17 05:38:14 +00:00
|
|
|
// Licensed under GPLv2 or any later version
|
2014-11-19 08:49:13 +00:00
|
|
|
// Refer to the license.txt file included.
|
2014-05-10 02:11:18 +00:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2020-03-01 16:14:17 +00:00
|
|
|
#include <array>
|
2019-12-08 03:09:20 +00:00
|
|
|
#include <memory>
|
2018-09-02 15:58:58 +00:00
|
|
|
#include <string>
|
|
|
|
#include <unordered_map>
|
2019-11-25 01:15:51 +00:00
|
|
|
#include <vector>
|
2020-07-16 17:51:51 +00:00
|
|
|
#include "core/arm/cpu_interrupt_handler.h"
|
2020-03-01 16:14:17 +00:00
|
|
|
#include "core/hardware_properties.h"
|
2020-04-09 01:06:37 +00:00
|
|
|
#include "core/hle/kernel/memory/memory_types.h"
|
2018-08-28 16:30:33 +00:00
|
|
|
#include "core/hle/kernel/object.h"
|
|
|
|
|
2019-03-05 17:28:10 +00:00
|
|
|
namespace Core {
|
2020-03-01 16:14:17 +00:00
|
|
|
class CPUInterruptHandler;
|
2020-01-25 22:55:32 +00:00
|
|
|
class ExclusiveMonitor;
|
2019-03-05 17:28:10 +00:00
|
|
|
class System;
|
2020-01-26 20:14:18 +00:00
|
|
|
} // namespace Core
|
2019-03-05 17:28:10 +00:00
|
|
|
|
2019-02-12 17:32:15 +00:00
|
|
|
namespace Core::Timing {
|
2019-02-14 17:42:58 +00:00
|
|
|
class CoreTiming;
|
2018-08-28 16:30:33 +00:00
|
|
|
struct EventType;
|
2019-02-14 17:42:58 +00:00
|
|
|
} // namespace Core::Timing
|
2014-05-10 02:11:18 +00:00
|
|
|
|
2014-05-20 22:13:25 +00:00
|
|
|
namespace Kernel {
|
|
|
|
|
2020-04-09 01:06:37 +00:00
|
|
|
namespace Memory {
|
|
|
|
class MemoryManager;
|
|
|
|
template <typename T>
|
|
|
|
class SlabHeap;
|
|
|
|
} // namespace Memory
|
|
|
|
|
2018-09-02 15:58:58 +00:00
|
|
|
class ClientPort;
|
2020-12-03 02:08:35 +00:00
|
|
|
class GlobalSchedulerContext;
|
2018-08-28 16:30:33 +00:00
|
|
|
class HandleTable;
|
2020-01-25 22:55:32 +00:00
|
|
|
class PhysicalCore;
|
2018-08-28 16:30:33 +00:00
|
|
|
class Process;
|
|
|
|
class ResourceLimit;
|
2020-12-03 02:08:35 +00:00
|
|
|
class KScheduler;
|
2020-04-09 01:06:37 +00:00
|
|
|
class SharedMemory;
|
2020-12-15 08:41:48 +00:00
|
|
|
class ServiceThread;
|
2020-02-11 21:36:39 +00:00
|
|
|
class Synchronization;
|
2020-12-31 07:01:08 +00:00
|
|
|
class KThread;
|
2020-02-14 14:56:27 +00:00
|
|
|
class TimeManager;
|
2018-08-28 16:30:33 +00:00
|
|
|
|
|
|
|
/// Represents a single instance of the kernel.
|
|
|
|
class KernelCore {
|
2018-09-02 15:58:58 +00:00
|
|
|
private:
|
2019-11-25 01:15:51 +00:00
|
|
|
using NamedPortTable = std::unordered_map<std::string, std::shared_ptr<ClientPort>>;
|
2018-09-02 15:58:58 +00:00
|
|
|
|
2018-08-28 16:30:33 +00:00
|
|
|
public:
|
2019-03-05 17:28:10 +00:00
|
|
|
/// Constructs an instance of the kernel using the given System
|
|
|
|
/// instance as a context for any necessary system-related state,
|
|
|
|
/// such as threads, CPU core state, etc.
|
|
|
|
///
|
|
|
|
/// @post After execution of the constructor, the provided System
|
|
|
|
/// object *must* outlive the kernel instance itself.
|
|
|
|
///
|
|
|
|
explicit KernelCore(Core::System& system);
|
2018-08-28 16:30:33 +00:00
|
|
|
~KernelCore();
|
|
|
|
|
|
|
|
KernelCore(const KernelCore&) = delete;
|
|
|
|
KernelCore& operator=(const KernelCore&) = delete;
|
|
|
|
|
|
|
|
KernelCore(KernelCore&&) = delete;
|
|
|
|
KernelCore& operator=(KernelCore&&) = delete;
|
|
|
|
|
2020-03-09 02:39:41 +00:00
|
|
|
/// Sets if emulation is multicore or single core, must be set before Initialize
|
|
|
|
void SetMulticore(bool is_multicore);
|
|
|
|
|
2018-08-28 16:30:33 +00:00
|
|
|
/// Resets the kernel to a clean slate for use.
|
2019-03-05 17:28:10 +00:00
|
|
|
void Initialize();
|
2018-08-28 16:30:33 +00:00
|
|
|
|
2020-11-13 19:11:12 +00:00
|
|
|
/// Initializes the CPU cores.
|
|
|
|
void InitializeCores();
|
|
|
|
|
2018-08-28 16:30:33 +00:00
|
|
|
/// Clears all resources in use by the kernel instance.
|
|
|
|
void Shutdown();
|
|
|
|
|
2018-11-19 17:54:06 +00:00
|
|
|
/// Retrieves a shared pointer to the system resource limit instance.
|
2019-11-25 01:15:51 +00:00
|
|
|
std::shared_ptr<ResourceLimit> GetSystemResourceLimit() const;
|
2018-08-28 16:30:33 +00:00
|
|
|
|
|
|
|
/// Retrieves a shared pointer to a Thread instance within the thread wakeup handle table.
|
2020-12-31 07:01:08 +00:00
|
|
|
std::shared_ptr<KThread> RetrieveThreadFromGlobalHandleTable(Handle handle) const;
|
2018-08-28 16:30:33 +00:00
|
|
|
|
|
|
|
/// Adds the given shared pointer to an internal list of active processes.
|
2019-11-25 01:15:51 +00:00
|
|
|
void AppendNewProcess(std::shared_ptr<Process> process);
|
2018-08-28 16:30:33 +00:00
|
|
|
|
2018-09-07 00:34:51 +00:00
|
|
|
/// Makes the given process the new current process.
|
2018-10-10 04:42:10 +00:00
|
|
|
void MakeCurrentProcess(Process* process);
|
2018-09-07 00:34:51 +00:00
|
|
|
|
2018-10-10 04:42:10 +00:00
|
|
|
/// Retrieves a pointer to the current process.
|
|
|
|
Process* CurrentProcess();
|
2018-09-07 00:34:51 +00:00
|
|
|
|
2018-10-10 04:42:10 +00:00
|
|
|
/// Retrieves a const pointer to the current process.
|
|
|
|
const Process* CurrentProcess() const;
|
2018-09-07 00:34:51 +00:00
|
|
|
|
2019-03-20 19:03:52 +00:00
|
|
|
/// Retrieves the list of processes.
|
2019-11-25 01:15:51 +00:00
|
|
|
const std::vector<std::shared_ptr<Process>>& GetProcessList() const;
|
2019-03-20 19:03:52 +00:00
|
|
|
|
2019-03-29 21:02:57 +00:00
|
|
|
/// Gets the sole instance of the global scheduler
|
2020-12-03 02:08:35 +00:00
|
|
|
Kernel::GlobalSchedulerContext& GlobalSchedulerContext();
|
2019-03-29 21:02:57 +00:00
|
|
|
|
|
|
|
/// Gets the sole instance of the global scheduler
|
2020-12-03 02:08:35 +00:00
|
|
|
const Kernel::GlobalSchedulerContext& GlobalSchedulerContext() const;
|
2019-03-29 21:02:57 +00:00
|
|
|
|
2020-02-14 02:04:10 +00:00
|
|
|
/// Gets the sole instance of the Scheduler assoviated with cpu core 'id'
|
2020-12-03 02:08:35 +00:00
|
|
|
Kernel::KScheduler& Scheduler(std::size_t id);
|
2020-02-14 02:04:10 +00:00
|
|
|
|
|
|
|
/// Gets the sole instance of the Scheduler assoviated with cpu core 'id'
|
2020-12-03 02:08:35 +00:00
|
|
|
const Kernel::KScheduler& Scheduler(std::size_t id) const;
|
2020-02-14 02:04:10 +00:00
|
|
|
|
2020-01-25 22:55:32 +00:00
|
|
|
/// Gets the an instance of the respective physical CPU core.
|
|
|
|
Kernel::PhysicalCore& PhysicalCore(std::size_t id);
|
|
|
|
|
|
|
|
/// Gets the an instance of the respective physical CPU core.
|
|
|
|
const Kernel::PhysicalCore& PhysicalCore(std::size_t id) const;
|
|
|
|
|
2020-02-25 02:04:12 +00:00
|
|
|
/// Gets the sole instance of the Scheduler at the current running core.
|
2020-12-03 02:08:35 +00:00
|
|
|
Kernel::KScheduler* CurrentScheduler();
|
2020-02-25 02:04:12 +00:00
|
|
|
|
|
|
|
/// Gets the an instance of the current physical CPU core.
|
|
|
|
Kernel::PhysicalCore& CurrentPhysicalCore();
|
|
|
|
|
|
|
|
/// Gets the an instance of the current physical CPU core.
|
|
|
|
const Kernel::PhysicalCore& CurrentPhysicalCore() const;
|
|
|
|
|
2020-02-14 14:56:27 +00:00
|
|
|
/// Gets the an instance of the TimeManager Interface.
|
|
|
|
Kernel::TimeManager& TimeManager();
|
|
|
|
|
|
|
|
/// Gets the an instance of the TimeManager Interface.
|
|
|
|
const Kernel::TimeManager& TimeManager() const;
|
|
|
|
|
2020-01-25 22:55:32 +00:00
|
|
|
/// Stops execution of 'id' core, in order to reschedule a new thread.
|
|
|
|
void PrepareReschedule(std::size_t id);
|
|
|
|
|
|
|
|
Core::ExclusiveMonitor& GetExclusiveMonitor();
|
|
|
|
|
|
|
|
const Core::ExclusiveMonitor& GetExclusiveMonitor() const;
|
|
|
|
|
2020-03-01 16:14:17 +00:00
|
|
|
std::array<Core::CPUInterruptHandler, Core::Hardware::NUM_CPU_CORES>& Interrupts();
|
|
|
|
|
|
|
|
const std::array<Core::CPUInterruptHandler, Core::Hardware::NUM_CPU_CORES>& Interrupts() const;
|
|
|
|
|
2020-01-25 22:55:32 +00:00
|
|
|
void InvalidateAllInstructionCaches();
|
|
|
|
|
2020-11-14 07:20:32 +00:00
|
|
|
void InvalidateCpuInstructionCacheRange(VAddr addr, std::size_t size);
|
|
|
|
|
2018-09-02 15:58:58 +00:00
|
|
|
/// Adds a port to the named port table
|
2019-11-25 01:15:51 +00:00
|
|
|
void AddNamedPort(std::string name, std::shared_ptr<ClientPort> port);
|
2018-09-02 15:58:58 +00:00
|
|
|
|
|
|
|
/// Finds a port within the named port table with the given name.
|
|
|
|
NamedPortTable::iterator FindNamedPort(const std::string& name);
|
|
|
|
|
|
|
|
/// Finds a port within the named port table with the given name.
|
|
|
|
NamedPortTable::const_iterator FindNamedPort(const std::string& name) const;
|
|
|
|
|
|
|
|
/// Determines whether or not the given port is a valid named port.
|
|
|
|
bool IsValidNamedPort(NamedPortTable::const_iterator port) const;
|
|
|
|
|
2020-02-14 13:30:53 +00:00
|
|
|
/// Gets the current host_thread/guest_thread handle.
|
2020-02-22 14:27:40 +00:00
|
|
|
Core::EmuThreadHandle GetCurrentEmuThreadID() const;
|
2020-02-14 13:30:53 +00:00
|
|
|
|
|
|
|
/// Gets the current host_thread handle.
|
2020-02-22 14:27:40 +00:00
|
|
|
u32 GetCurrentHostThreadID() const;
|
2020-02-14 13:30:53 +00:00
|
|
|
|
|
|
|
/// Register the current thread as a CPU Core Thread.
|
|
|
|
void RegisterCoreThread(std::size_t core_id);
|
|
|
|
|
|
|
|
/// Register the current thread as a non CPU core thread.
|
|
|
|
void RegisterHostThread();
|
|
|
|
|
2020-04-09 01:06:37 +00:00
|
|
|
/// Gets the virtual memory manager for the kernel.
|
|
|
|
Memory::MemoryManager& MemoryManager();
|
|
|
|
|
|
|
|
/// Gets the virtual memory manager for the kernel.
|
|
|
|
const Memory::MemoryManager& MemoryManager() const;
|
|
|
|
|
|
|
|
/// Gets the slab heap allocated for user space pages.
|
|
|
|
Memory::SlabHeap<Memory::Page>& GetUserSlabHeapPages();
|
|
|
|
|
|
|
|
/// Gets the slab heap allocated for user space pages.
|
|
|
|
const Memory::SlabHeap<Memory::Page>& GetUserSlabHeapPages() const;
|
|
|
|
|
|
|
|
/// Gets the shared memory object for HID services.
|
|
|
|
Kernel::SharedMemory& GetHidSharedMem();
|
|
|
|
|
|
|
|
/// Gets the shared memory object for HID services.
|
|
|
|
const Kernel::SharedMemory& GetHidSharedMem() const;
|
|
|
|
|
|
|
|
/// Gets the shared memory object for font services.
|
|
|
|
Kernel::SharedMemory& GetFontSharedMem();
|
|
|
|
|
|
|
|
/// Gets the shared memory object for font services.
|
|
|
|
const Kernel::SharedMemory& GetFontSharedMem() const;
|
|
|
|
|
|
|
|
/// Gets the shared memory object for IRS services.
|
|
|
|
Kernel::SharedMemory& GetIrsSharedMem();
|
|
|
|
|
|
|
|
/// Gets the shared memory object for IRS services.
|
|
|
|
const Kernel::SharedMemory& GetIrsSharedMem() const;
|
|
|
|
|
|
|
|
/// Gets the shared memory object for Time services.
|
|
|
|
Kernel::SharedMemory& GetTimeSharedMem();
|
|
|
|
|
|
|
|
/// Gets the shared memory object for Time services.
|
|
|
|
const Kernel::SharedMemory& GetTimeSharedMem() const;
|
|
|
|
|
2020-02-25 02:04:12 +00:00
|
|
|
/// Suspend/unsuspend the OS.
|
|
|
|
void Suspend(bool in_suspention);
|
|
|
|
|
|
|
|
/// Exceptional exit the OS.
|
|
|
|
void ExceptionalExit();
|
|
|
|
|
2020-03-10 17:13:39 +00:00
|
|
|
bool IsMulticore() const;
|
|
|
|
|
2020-03-12 20:48:43 +00:00
|
|
|
void EnterSVCProfile();
|
|
|
|
|
|
|
|
void ExitSVCProfile();
|
|
|
|
|
2020-12-15 08:41:48 +00:00
|
|
|
/**
|
|
|
|
* Creates an HLE service thread, which are used to execute service routines asynchronously.
|
|
|
|
* While these are allocated per ServerSession, these need to be owned and managed outside of
|
|
|
|
* ServerSession to avoid a circular dependency.
|
|
|
|
* @param name String name for the ServerSession creating this thread, used for debug purposes.
|
|
|
|
* @returns The a weak pointer newly created service thread.
|
|
|
|
*/
|
|
|
|
std::weak_ptr<Kernel::ServiceThread> CreateServiceThread(const std::string& name);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Releases a HLE service thread, instructing KernelCore to free it. This should be called when
|
|
|
|
* the ServerSession associated with the thread is destroyed.
|
|
|
|
* @param service_thread Service thread to release.
|
|
|
|
*/
|
|
|
|
void ReleaseServiceThread(std::weak_ptr<Kernel::ServiceThread> service_thread);
|
|
|
|
|
2018-08-28 16:30:33 +00:00
|
|
|
private:
|
|
|
|
friend class Object;
|
|
|
|
friend class Process;
|
2020-12-31 07:01:08 +00:00
|
|
|
friend class KThread;
|
2018-08-28 16:30:33 +00:00
|
|
|
|
|
|
|
/// Creates a new object ID, incrementing the internal object ID counter.
|
|
|
|
u32 CreateNewObjectID();
|
|
|
|
|
|
|
|
/// Creates a new process ID, incrementing the internal process ID counter;
|
2019-06-10 04:28:33 +00:00
|
|
|
u64 CreateNewKernelProcessID();
|
|
|
|
|
|
|
|
/// Creates a new process ID, incrementing the internal process ID counter;
|
|
|
|
u64 CreateNewUserProcessID();
|
2018-08-28 16:30:33 +00:00
|
|
|
|
|
|
|
/// Creates a new thread ID, incrementing the internal thread ID counter.
|
2018-12-19 03:37:01 +00:00
|
|
|
u64 CreateNewThreadID();
|
2018-08-28 16:30:33 +00:00
|
|
|
|
2020-02-14 13:30:53 +00:00
|
|
|
/// Provides a reference to the global handle table.
|
|
|
|
Kernel::HandleTable& GlobalHandleTable();
|
2018-08-28 16:30:33 +00:00
|
|
|
|
2020-02-14 13:30:53 +00:00
|
|
|
/// Provides a const reference to the global handle table.
|
|
|
|
const Kernel::HandleTable& GlobalHandleTable() const;
|
2014-06-11 02:43:50 +00:00
|
|
|
|
2018-08-28 16:30:33 +00:00
|
|
|
struct Impl;
|
|
|
|
std::unique_ptr<Impl> impl;
|
2020-02-25 02:04:12 +00:00
|
|
|
bool exception_exited{};
|
2018-08-28 16:30:33 +00:00
|
|
|
};
|
2014-06-11 02:43:50 +00:00
|
|
|
|
2017-07-21 04:52:50 +00:00
|
|
|
} // namespace Kernel
|