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