2014-05-10 04:11:18 +02:00
|
|
|
// Copyright 2014 Citra Emulator Project / PPSSPP Project
|
2014-12-17 06:38:14 +01:00
|
|
|
// Licensed under GPLv2 or any later version
|
2014-11-19 09:49:13 +01:00
|
|
|
// Refer to the license.txt file included.
|
2014-05-10 04:11:18 +02:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2019-12-08 04:09:20 +01:00
|
|
|
#include <memory>
|
2018-09-02 17:58:58 +02:00
|
|
|
#include <string>
|
|
|
|
#include <unordered_map>
|
2019-11-25 02:15:51 +01:00
|
|
|
#include <vector>
|
2020-04-09 03:06:37 +02:00
|
|
|
#include "core/hle/kernel/memory/memory_types.h"
|
2018-08-28 18:30:33 +02:00
|
|
|
#include "core/hle/kernel/object.h"
|
|
|
|
|
2019-03-05 18:28:10 +01:00
|
|
|
namespace Core {
|
2020-02-22 15:27:40 +01:00
|
|
|
struct EmuThreadHandle;
|
2020-01-25 23:55:32 +01:00
|
|
|
class ExclusiveMonitor;
|
2019-03-05 18:28:10 +01:00
|
|
|
class System;
|
2020-01-26 21:14:18 +01:00
|
|
|
} // namespace Core
|
2019-03-05 18:28:10 +01:00
|
|
|
|
2019-02-12 18:32:15 +01:00
|
|
|
namespace Core::Timing {
|
2019-02-14 18:42:58 +01:00
|
|
|
class CoreTiming;
|
2018-08-28 18:30:33 +02:00
|
|
|
struct EventType;
|
2019-02-14 18:42:58 +01:00
|
|
|
} // namespace Core::Timing
|
2014-05-10 04:11:18 +02:00
|
|
|
|
2014-05-21 00:13:25 +02:00
|
|
|
namespace Kernel {
|
|
|
|
|
2020-04-09 03:06:37 +02:00
|
|
|
namespace Memory {
|
|
|
|
class MemoryManager;
|
|
|
|
template <typename T>
|
|
|
|
class SlabHeap;
|
|
|
|
} // namespace Memory
|
|
|
|
|
2019-03-05 17:54:06 +01:00
|
|
|
class AddressArbiter;
|
2018-09-02 17:58:58 +02:00
|
|
|
class ClientPort;
|
2019-10-12 16:13:25 +02:00
|
|
|
class GlobalScheduler;
|
2018-08-28 18:30:33 +02:00
|
|
|
class HandleTable;
|
2020-01-25 23:55:32 +01:00
|
|
|
class PhysicalCore;
|
2018-08-28 18:30:33 +02:00
|
|
|
class Process;
|
|
|
|
class ResourceLimit;
|
2020-02-14 03:04:10 +01:00
|
|
|
class Scheduler;
|
2020-04-09 03:06:37 +02:00
|
|
|
class SharedMemory;
|
2020-02-11 22:36:39 +01:00
|
|
|
class Synchronization;
|
2018-08-28 18:30:33 +02:00
|
|
|
class Thread;
|
2020-02-14 15:56:27 +01:00
|
|
|
class TimeManager;
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Represents a single instance of the kernel.
|
|
|
|
class KernelCore {
|
2018-09-02 17:58:58 +02:00
|
|
|
private:
|
2019-11-25 02:15:51 +01:00
|
|
|
using NamedPortTable = std::unordered_map<std::string, std::shared_ptr<ClientPort>>;
|
2018-09-02 17:58:58 +02:00
|
|
|
|
2018-08-28 18:30:33 +02:00
|
|
|
public:
|
2019-03-05 18:28:10 +01: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 18:30:33 +02:00
|
|
|
~KernelCore();
|
|
|
|
|
|
|
|
KernelCore(const KernelCore&) = delete;
|
|
|
|
KernelCore& operator=(const KernelCore&) = delete;
|
|
|
|
|
|
|
|
KernelCore(KernelCore&&) = delete;
|
|
|
|
KernelCore& operator=(KernelCore&&) = delete;
|
|
|
|
|
|
|
|
/// Resets the kernel to a clean slate for use.
|
2019-03-05 18:28:10 +01:00
|
|
|
void Initialize();
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Clears all resources in use by the kernel instance.
|
|
|
|
void Shutdown();
|
|
|
|
|
2018-11-19 18:54:06 +01:00
|
|
|
/// Retrieves a shared pointer to the system resource limit instance.
|
2019-11-25 02:15:51 +01:00
|
|
|
std::shared_ptr<ResourceLimit> GetSystemResourceLimit() const;
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Retrieves a shared pointer to a Thread instance within the thread wakeup handle table.
|
2020-02-14 14:30:53 +01:00
|
|
|
std::shared_ptr<Thread> RetrieveThreadFromGlobalHandleTable(Handle handle) const;
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Adds the given shared pointer to an internal list of active processes.
|
2019-11-25 02:15:51 +01:00
|
|
|
void AppendNewProcess(std::shared_ptr<Process> process);
|
2018-08-28 18:30:33 +02:00
|
|
|
|
2018-09-07 02:34:51 +02:00
|
|
|
/// Makes the given process the new current process.
|
2018-10-10 06:42:10 +02:00
|
|
|
void MakeCurrentProcess(Process* process);
|
2018-09-07 02:34:51 +02:00
|
|
|
|
2018-10-10 06:42:10 +02:00
|
|
|
/// Retrieves a pointer to the current process.
|
|
|
|
Process* CurrentProcess();
|
2018-09-07 02:34:51 +02:00
|
|
|
|
2018-10-10 06:42:10 +02:00
|
|
|
/// Retrieves a const pointer to the current process.
|
|
|
|
const Process* CurrentProcess() const;
|
2018-09-07 02:34:51 +02:00
|
|
|
|
2019-03-20 20:03:52 +01:00
|
|
|
/// Retrieves the list of processes.
|
2019-11-25 02:15:51 +01:00
|
|
|
const std::vector<std::shared_ptr<Process>>& GetProcessList() const;
|
2019-03-20 20:03:52 +01:00
|
|
|
|
2019-03-29 22:02:57 +01:00
|
|
|
/// Gets the sole instance of the global scheduler
|
|
|
|
Kernel::GlobalScheduler& GlobalScheduler();
|
|
|
|
|
|
|
|
/// Gets the sole instance of the global scheduler
|
|
|
|
const Kernel::GlobalScheduler& GlobalScheduler() const;
|
|
|
|
|
2020-02-14 03:04:10 +01:00
|
|
|
/// Gets the sole instance of the Scheduler assoviated with cpu core 'id'
|
|
|
|
Kernel::Scheduler& Scheduler(std::size_t id);
|
|
|
|
|
|
|
|
/// Gets the sole instance of the Scheduler assoviated with cpu core 'id'
|
|
|
|
const Kernel::Scheduler& Scheduler(std::size_t id) const;
|
|
|
|
|
2020-01-25 23:55:32 +01: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-11 22:36:39 +01:00
|
|
|
/// Gets the an instance of the Synchronization Interface.
|
|
|
|
Kernel::Synchronization& Synchronization();
|
|
|
|
|
|
|
|
/// Gets the an instance of the Synchronization Interface.
|
|
|
|
const Kernel::Synchronization& Synchronization() const;
|
|
|
|
|
2020-02-14 15:56:27 +01: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 23:55:32 +01: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;
|
|
|
|
|
|
|
|
void InvalidateAllInstructionCaches();
|
|
|
|
|
2018-09-02 17:58:58 +02:00
|
|
|
/// Adds a port to the named port table
|
2019-11-25 02:15:51 +01:00
|
|
|
void AddNamedPort(std::string name, std::shared_ptr<ClientPort> port);
|
2018-09-02 17:58:58 +02: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 14:30:53 +01:00
|
|
|
/// Gets the current host_thread/guest_thread handle.
|
2020-02-22 15:27:40 +01:00
|
|
|
Core::EmuThreadHandle GetCurrentEmuThreadID() const;
|
2020-02-14 14:30:53 +01:00
|
|
|
|
|
|
|
/// Gets the current host_thread handle.
|
2020-02-22 15:27:40 +01:00
|
|
|
u32 GetCurrentHostThreadID() const;
|
2020-02-14 14:30:53 +01: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 03:06:37 +02: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;
|
|
|
|
|
2018-08-28 18:30:33 +02:00
|
|
|
private:
|
|
|
|
friend class Object;
|
|
|
|
friend class Process;
|
|
|
|
friend class Thread;
|
|
|
|
|
|
|
|
/// 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 06:28:33 +02:00
|
|
|
u64 CreateNewKernelProcessID();
|
|
|
|
|
|
|
|
/// Creates a new process ID, incrementing the internal process ID counter;
|
|
|
|
u64 CreateNewUserProcessID();
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Creates a new thread ID, incrementing the internal thread ID counter.
|
2018-12-19 04:37:01 +01:00
|
|
|
u64 CreateNewThreadID();
|
2018-08-28 18:30:33 +02:00
|
|
|
|
|
|
|
/// Retrieves the event type used for thread wakeup callbacks.
|
2019-11-27 03:48:56 +01:00
|
|
|
const std::shared_ptr<Core::Timing::EventType>& ThreadWakeupCallbackEventType() const;
|
2018-08-28 18:30:33 +02:00
|
|
|
|
2020-02-14 14:30:53 +01:00
|
|
|
/// Provides a reference to the global handle table.
|
|
|
|
Kernel::HandleTable& GlobalHandleTable();
|
2018-08-28 18:30:33 +02:00
|
|
|
|
2020-02-14 14:30:53 +01:00
|
|
|
/// Provides a const reference to the global handle table.
|
|
|
|
const Kernel::HandleTable& GlobalHandleTable() const;
|
2014-06-11 04:43:50 +02:00
|
|
|
|
2018-08-28 18:30:33 +02:00
|
|
|
struct Impl;
|
|
|
|
std::unique_ptr<Impl> impl;
|
|
|
|
};
|
2014-06-11 04:43:50 +02:00
|
|
|
|
2017-07-21 06:52:50 +02:00
|
|
|
} // namespace Kernel
|