kernel.cpp 42 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088
  1. // Copyright 2021 yuzu Emulator Project
  2. // Licensed under GPLv2 or any later version
  3. // Refer to the license.txt file included.
  4. #include <array>
  5. #include <atomic>
  6. #include <bitset>
  7. #include <functional>
  8. #include <memory>
  9. #include <thread>
  10. #include <unordered_set>
  11. #include <utility>
  12. #include "common/assert.h"
  13. #include "common/logging/log.h"
  14. #include "common/microprofile.h"
  15. #include "common/thread.h"
  16. #include "common/thread_worker.h"
  17. #include "core/arm/arm_interface.h"
  18. #include "core/arm/cpu_interrupt_handler.h"
  19. #include "core/arm/exclusive_monitor.h"
  20. #include "core/core.h"
  21. #include "core/core_timing.h"
  22. #include "core/core_timing_util.h"
  23. #include "core/cpu_manager.h"
  24. #include "core/device_memory.h"
  25. #include "core/hardware_properties.h"
  26. #include "core/hle/kernel/init/init_slab_setup.h"
  27. #include "core/hle/kernel/k_client_port.h"
  28. #include "core/hle/kernel/k_handle_table.h"
  29. #include "core/hle/kernel/k_memory_layout.h"
  30. #include "core/hle/kernel/k_memory_manager.h"
  31. #include "core/hle/kernel/k_process.h"
  32. #include "core/hle/kernel/k_resource_limit.h"
  33. #include "core/hle/kernel/k_scheduler.h"
  34. #include "core/hle/kernel/k_shared_memory.h"
  35. #include "core/hle/kernel/k_slab_heap.h"
  36. #include "core/hle/kernel/k_thread.h"
  37. #include "core/hle/kernel/kernel.h"
  38. #include "core/hle/kernel/physical_core.h"
  39. #include "core/hle/kernel/service_thread.h"
  40. #include "core/hle/kernel/svc_results.h"
  41. #include "core/hle/kernel/time_manager.h"
  42. #include "core/hle/lock.h"
  43. #include "core/hle/result.h"
  44. #include "core/hle/service/sm/sm.h"
  45. #include "core/memory.h"
  46. MICROPROFILE_DEFINE(Kernel_SVC, "Kernel", "SVC", MP_RGB(70, 200, 70));
  47. namespace Kernel {
  48. struct KernelCore::Impl {
  49. explicit Impl(Core::System& system_, KernelCore& kernel_)
  50. : time_manager{system_}, object_list_container{kernel_}, system{system_} {}
  51. void SetMulticore(bool is_multi) {
  52. is_multicore = is_multi;
  53. }
  54. void Initialize(KernelCore& kernel) {
  55. global_scheduler_context = std::make_unique<Kernel::GlobalSchedulerContext>(kernel);
  56. global_handle_table = std::make_unique<Kernel::KHandleTable>(kernel);
  57. global_handle_table->Initialize(KHandleTable::MaxTableSize);
  58. is_phantom_mode_for_singlecore = false;
  59. InitializePhysicalCores();
  60. // Derive the initial memory layout from the emulated board
  61. Init::InitializeSlabResourceCounts(kernel);
  62. KMemoryLayout memory_layout;
  63. DeriveInitialMemoryLayout(memory_layout);
  64. Init::InitializeSlabHeaps(system, memory_layout);
  65. // Initialize kernel memory and resources.
  66. InitializeSystemResourceLimit(kernel, system.CoreTiming(), memory_layout);
  67. InitializeMemoryLayout(memory_layout);
  68. InitializePageSlab();
  69. InitializeSchedulers();
  70. InitializeSuspendThreads();
  71. InitializePreemption(kernel);
  72. RegisterHostThread();
  73. }
  74. void InitializeCores() {
  75. for (u32 core_id = 0; core_id < Core::Hardware::NUM_CPU_CORES; core_id++) {
  76. cores[core_id].Initialize(current_process->Is64BitProcess());
  77. system.Memory().SetCurrentPageTable(*current_process, core_id);
  78. }
  79. }
  80. void Shutdown() {
  81. // Shutdown all processes.
  82. if (current_process) {
  83. current_process->Finalize();
  84. current_process->Close();
  85. current_process = nullptr;
  86. }
  87. process_list.clear();
  88. // Close all open server ports.
  89. std::unordered_set<KServerPort*> server_ports_;
  90. {
  91. std::lock_guard lk(server_ports_lock);
  92. server_ports_ = server_ports;
  93. server_ports.clear();
  94. }
  95. for (auto* server_port : server_ports_) {
  96. server_port->Close();
  97. }
  98. // Close all open server sessions.
  99. std::unordered_set<KServerSession*> server_sessions_;
  100. {
  101. std::lock_guard lk(server_sessions_lock);
  102. server_sessions_ = server_sessions;
  103. server_sessions.clear();
  104. }
  105. for (auto* server_session : server_sessions_) {
  106. server_session->Close();
  107. }
  108. // Ensure that the object list container is finalized and properly shutdown.
  109. object_list_container.Finalize();
  110. // Ensures all service threads gracefully shutdown.
  111. service_threads.clear();
  112. next_object_id = 0;
  113. next_kernel_process_id = KProcess::InitialKIPIDMin;
  114. next_user_process_id = KProcess::ProcessIDMin;
  115. next_thread_id = 1;
  116. cores.clear();
  117. global_handle_table->Finalize();
  118. global_handle_table.reset();
  119. preemption_event = nullptr;
  120. for (auto& iter : named_ports) {
  121. iter.second->Close();
  122. }
  123. named_ports.clear();
  124. exclusive_monitor.reset();
  125. // Cleanup persistent kernel objects
  126. auto CleanupObject = [](KAutoObject* obj) {
  127. if (obj) {
  128. obj->Close();
  129. obj = nullptr;
  130. }
  131. };
  132. CleanupObject(hid_shared_mem);
  133. CleanupObject(font_shared_mem);
  134. CleanupObject(irs_shared_mem);
  135. CleanupObject(time_shared_mem);
  136. CleanupObject(system_resource_limit);
  137. for (u32 core_id = 0; core_id < Core::Hardware::NUM_CPU_CORES; core_id++) {
  138. if (suspend_threads[core_id]) {
  139. suspend_threads[core_id]->Close();
  140. suspend_threads[core_id] = nullptr;
  141. }
  142. schedulers[core_id]->Finalize();
  143. schedulers[core_id].reset();
  144. }
  145. // Next host thead ID to use, 0-3 IDs represent core threads, >3 represent others
  146. next_host_thread_id = Core::Hardware::NUM_CPU_CORES;
  147. // Track kernel objects that were not freed on shutdown
  148. {
  149. std::lock_guard lk(registered_objects_lock);
  150. if (registered_objects.size()) {
  151. LOG_WARNING(Kernel, "{} kernel objects were dangling on shutdown!",
  152. registered_objects.size());
  153. registered_objects.clear();
  154. }
  155. }
  156. }
  157. void InitializePhysicalCores() {
  158. exclusive_monitor =
  159. Core::MakeExclusiveMonitor(system.Memory(), Core::Hardware::NUM_CPU_CORES);
  160. for (u32 i = 0; i < Core::Hardware::NUM_CPU_CORES; i++) {
  161. schedulers[i] = std::make_unique<Kernel::KScheduler>(system, i);
  162. cores.emplace_back(i, system, *schedulers[i], interrupts);
  163. }
  164. }
  165. void InitializeSchedulers() {
  166. for (u32 i = 0; i < Core::Hardware::NUM_CPU_CORES; i++) {
  167. cores[i].Scheduler().Initialize();
  168. }
  169. }
  170. // Creates the default system resource limit
  171. void InitializeSystemResourceLimit(KernelCore& kernel,
  172. const Core::Timing::CoreTiming& core_timing,
  173. const KMemoryLayout& memory_layout) {
  174. system_resource_limit = KResourceLimit::Create(system.Kernel());
  175. system_resource_limit->Initialize(&core_timing);
  176. const auto [total_size, kernel_size] = memory_layout.GetTotalAndKernelMemorySizes();
  177. // If setting the default system values fails, then something seriously wrong has occurred.
  178. ASSERT(system_resource_limit->SetLimitValue(LimitableResource::PhysicalMemory, total_size)
  179. .IsSuccess());
  180. ASSERT(system_resource_limit->SetLimitValue(LimitableResource::Threads, 800).IsSuccess());
  181. ASSERT(system_resource_limit->SetLimitValue(LimitableResource::Events, 900).IsSuccess());
  182. ASSERT(system_resource_limit->SetLimitValue(LimitableResource::TransferMemory, 200)
  183. .IsSuccess());
  184. ASSERT(system_resource_limit->SetLimitValue(LimitableResource::Sessions, 1133).IsSuccess());
  185. system_resource_limit->Reserve(LimitableResource::PhysicalMemory, kernel_size);
  186. // Reserve secure applet memory, introduced in firmware 5.0.0
  187. constexpr u64 secure_applet_memory_size{4_MiB};
  188. ASSERT(system_resource_limit->Reserve(LimitableResource::PhysicalMemory,
  189. secure_applet_memory_size));
  190. // This memory seems to be reserved on hardware, but is not reserved/used by yuzu.
  191. // Likely Horizon OS reserved memory
  192. // TODO(ameerj): Derive the memory rather than hardcode it.
  193. constexpr u64 unknown_reserved_memory{0x2f896000};
  194. ASSERT(system_resource_limit->Reserve(LimitableResource::PhysicalMemory,
  195. unknown_reserved_memory));
  196. }
  197. void InitializePreemption(KernelCore& kernel) {
  198. preemption_event = Core::Timing::CreateEvent(
  199. "PreemptionCallback", [this, &kernel](std::uintptr_t, std::chrono::nanoseconds) {
  200. {
  201. KScopedSchedulerLock lock(kernel);
  202. global_scheduler_context->PreemptThreads();
  203. }
  204. const auto time_interval = std::chrono::nanoseconds{
  205. Core::Timing::msToCycles(std::chrono::milliseconds(10))};
  206. system.CoreTiming().ScheduleEvent(time_interval, preemption_event);
  207. });
  208. const auto time_interval =
  209. std::chrono::nanoseconds{Core::Timing::msToCycles(std::chrono::milliseconds(10))};
  210. system.CoreTiming().ScheduleEvent(time_interval, preemption_event);
  211. }
  212. void InitializeSuspendThreads() {
  213. for (u32 core_id = 0; core_id < Core::Hardware::NUM_CPU_CORES; core_id++) {
  214. suspend_threads[core_id] = KThread::Create(system.Kernel());
  215. ASSERT(KThread::InitializeHighPriorityThread(system, suspend_threads[core_id], {}, {},
  216. core_id)
  217. .IsSuccess());
  218. suspend_threads[core_id]->SetName(fmt::format("SuspendThread:{}", core_id));
  219. }
  220. }
  221. void MakeCurrentProcess(KProcess* process) {
  222. current_process = process;
  223. }
  224. /// Creates a new host thread ID, should only be called by GetHostThreadId
  225. u32 AllocateHostThreadId(std::optional<std::size_t> core_id) {
  226. if (core_id) {
  227. // The first for slots are reserved for CPU core threads
  228. ASSERT(*core_id < Core::Hardware::NUM_CPU_CORES);
  229. return static_cast<u32>(*core_id);
  230. } else {
  231. return next_host_thread_id++;
  232. }
  233. }
  234. /// Gets the host thread ID for the caller, allocating a new one if this is the first time
  235. u32 GetHostThreadId(std::optional<std::size_t> core_id = std::nullopt) {
  236. const thread_local auto host_thread_id{AllocateHostThreadId(core_id)};
  237. return host_thread_id;
  238. }
  239. // Gets the dummy KThread for the caller, allocating a new one if this is the first time
  240. KThread* GetHostDummyThread() {
  241. auto make_thread = [this]() {
  242. std::unique_ptr<KThread> thread = std::make_unique<KThread>(system.Kernel());
  243. KAutoObject::Create(thread.get());
  244. ASSERT(KThread::InitializeDummyThread(thread.get()).IsSuccess());
  245. thread->SetName(fmt::format("DummyThread:{}", GetHostThreadId()));
  246. return thread;
  247. };
  248. thread_local auto thread = make_thread();
  249. return thread.get();
  250. }
  251. /// Registers a CPU core thread by allocating a host thread ID for it
  252. void RegisterCoreThread(std::size_t core_id) {
  253. ASSERT(core_id < Core::Hardware::NUM_CPU_CORES);
  254. const auto this_id = GetHostThreadId(core_id);
  255. if (!is_multicore) {
  256. single_core_thread_id = this_id;
  257. }
  258. }
  259. /// Registers a new host thread by allocating a host thread ID for it
  260. void RegisterHostThread() {
  261. [[maybe_unused]] const auto this_id = GetHostThreadId();
  262. [[maybe_unused]] const auto dummy_thread = GetHostDummyThread();
  263. }
  264. [[nodiscard]] u32 GetCurrentHostThreadID() {
  265. const auto this_id = GetHostThreadId();
  266. if (!is_multicore && single_core_thread_id == this_id) {
  267. return static_cast<u32>(system.GetCpuManager().CurrentCore());
  268. }
  269. return this_id;
  270. }
  271. bool IsPhantomModeForSingleCore() const {
  272. return is_phantom_mode_for_singlecore;
  273. }
  274. void SetIsPhantomModeForSingleCore(bool value) {
  275. ASSERT(!is_multicore);
  276. is_phantom_mode_for_singlecore = value;
  277. }
  278. KThread* GetCurrentEmuThread() {
  279. const auto thread_id = GetCurrentHostThreadID();
  280. if (thread_id >= Core::Hardware::NUM_CPU_CORES) {
  281. return GetHostDummyThread();
  282. }
  283. return schedulers[thread_id]->GetCurrentThread();
  284. }
  285. void DeriveInitialMemoryLayout(KMemoryLayout& memory_layout) {
  286. // Insert the root region for the virtual memory tree, from which all other regions will
  287. // derive.
  288. memory_layout.GetVirtualMemoryRegionTree().InsertDirectly(
  289. KernelVirtualAddressSpaceBase,
  290. KernelVirtualAddressSpaceBase + KernelVirtualAddressSpaceSize - 1);
  291. // Insert the root region for the physical memory tree, from which all other regions will
  292. // derive.
  293. memory_layout.GetPhysicalMemoryRegionTree().InsertDirectly(
  294. KernelPhysicalAddressSpaceBase,
  295. KernelPhysicalAddressSpaceBase + KernelPhysicalAddressSpaceSize - 1);
  296. // Save start and end for ease of use.
  297. const VAddr code_start_virt_addr = KernelVirtualAddressCodeBase;
  298. const VAddr code_end_virt_addr = KernelVirtualAddressCodeEnd;
  299. // Setup the containing kernel region.
  300. constexpr size_t KernelRegionSize = 1_GiB;
  301. constexpr size_t KernelRegionAlign = 1_GiB;
  302. constexpr VAddr kernel_region_start =
  303. Common::AlignDown(code_start_virt_addr, KernelRegionAlign);
  304. size_t kernel_region_size = KernelRegionSize;
  305. if (!(kernel_region_start + KernelRegionSize - 1 <= KernelVirtualAddressSpaceLast)) {
  306. kernel_region_size = KernelVirtualAddressSpaceEnd - kernel_region_start;
  307. }
  308. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  309. kernel_region_start, kernel_region_size, KMemoryRegionType_Kernel));
  310. // Setup the code region.
  311. constexpr size_t CodeRegionAlign = PageSize;
  312. constexpr VAddr code_region_start =
  313. Common::AlignDown(code_start_virt_addr, CodeRegionAlign);
  314. constexpr VAddr code_region_end = Common::AlignUp(code_end_virt_addr, CodeRegionAlign);
  315. constexpr size_t code_region_size = code_region_end - code_region_start;
  316. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  317. code_region_start, code_region_size, KMemoryRegionType_KernelCode));
  318. // Setup board-specific device physical regions.
  319. Init::SetupDevicePhysicalMemoryRegions(memory_layout);
  320. // Determine the amount of space needed for the misc region.
  321. size_t misc_region_needed_size;
  322. {
  323. // Each core has a one page stack for all three stack types (Main, Idle, Exception).
  324. misc_region_needed_size = Core::Hardware::NUM_CPU_CORES * (3 * (PageSize + PageSize));
  325. // Account for each auto-map device.
  326. for (const auto& region : memory_layout.GetPhysicalMemoryRegionTree()) {
  327. if (region.HasTypeAttribute(KMemoryRegionAttr_ShouldKernelMap)) {
  328. // Check that the region is valid.
  329. ASSERT(region.GetEndAddress() != 0);
  330. // Account for the region.
  331. misc_region_needed_size +=
  332. PageSize + (Common::AlignUp(region.GetLastAddress(), PageSize) -
  333. Common::AlignDown(region.GetAddress(), PageSize));
  334. }
  335. }
  336. // Multiply the needed size by three, to account for the need for guard space.
  337. misc_region_needed_size *= 3;
  338. }
  339. // Decide on the actual size for the misc region.
  340. constexpr size_t MiscRegionAlign = KernelAslrAlignment;
  341. constexpr size_t MiscRegionMinimumSize = 32_MiB;
  342. const size_t misc_region_size = Common::AlignUp(
  343. std::max(misc_region_needed_size, MiscRegionMinimumSize), MiscRegionAlign);
  344. ASSERT(misc_region_size > 0);
  345. // Setup the misc region.
  346. const VAddr misc_region_start =
  347. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegion(
  348. misc_region_size, MiscRegionAlign, KMemoryRegionType_Kernel);
  349. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  350. misc_region_start, misc_region_size, KMemoryRegionType_KernelMisc));
  351. // Setup the stack region.
  352. constexpr size_t StackRegionSize = 14_MiB;
  353. constexpr size_t StackRegionAlign = KernelAslrAlignment;
  354. const VAddr stack_region_start =
  355. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegion(
  356. StackRegionSize, StackRegionAlign, KMemoryRegionType_Kernel);
  357. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  358. stack_region_start, StackRegionSize, KMemoryRegionType_KernelStack));
  359. // Determine the size of the resource region.
  360. const size_t resource_region_size = memory_layout.GetResourceRegionSizeForInit();
  361. // Determine the size of the slab region.
  362. const size_t slab_region_size =
  363. Common::AlignUp(Init::CalculateTotalSlabHeapSize(system.Kernel()), PageSize);
  364. ASSERT(slab_region_size <= resource_region_size);
  365. // Setup the slab region.
  366. const PAddr code_start_phys_addr = KernelPhysicalAddressCodeBase;
  367. const PAddr code_end_phys_addr = code_start_phys_addr + code_region_size;
  368. const PAddr slab_start_phys_addr = code_end_phys_addr;
  369. const PAddr slab_end_phys_addr = slab_start_phys_addr + slab_region_size;
  370. constexpr size_t SlabRegionAlign = KernelAslrAlignment;
  371. const size_t slab_region_needed_size =
  372. Common::AlignUp(code_end_phys_addr + slab_region_size, SlabRegionAlign) -
  373. Common::AlignDown(code_end_phys_addr, SlabRegionAlign);
  374. const VAddr slab_region_start =
  375. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegion(
  376. slab_region_needed_size, SlabRegionAlign, KMemoryRegionType_Kernel) +
  377. (code_end_phys_addr % SlabRegionAlign);
  378. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  379. slab_region_start, slab_region_size, KMemoryRegionType_KernelSlab));
  380. // Setup the temp region.
  381. constexpr size_t TempRegionSize = 128_MiB;
  382. constexpr size_t TempRegionAlign = KernelAslrAlignment;
  383. const VAddr temp_region_start =
  384. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegion(
  385. TempRegionSize, TempRegionAlign, KMemoryRegionType_Kernel);
  386. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(temp_region_start, TempRegionSize,
  387. KMemoryRegionType_KernelTemp));
  388. // Automatically map in devices that have auto-map attributes.
  389. for (auto& region : memory_layout.GetPhysicalMemoryRegionTree()) {
  390. // We only care about kernel regions.
  391. if (!region.IsDerivedFrom(KMemoryRegionType_Kernel)) {
  392. continue;
  393. }
  394. // Check whether we should map the region.
  395. if (!region.HasTypeAttribute(KMemoryRegionAttr_ShouldKernelMap)) {
  396. continue;
  397. }
  398. // If this region has already been mapped, no need to consider it.
  399. if (region.HasTypeAttribute(KMemoryRegionAttr_DidKernelMap)) {
  400. continue;
  401. }
  402. // Check that the region is valid.
  403. ASSERT(region.GetEndAddress() != 0);
  404. // Set the attribute to note we've mapped this region.
  405. region.SetTypeAttribute(KMemoryRegionAttr_DidKernelMap);
  406. // Create a virtual pair region and insert it into the tree.
  407. const PAddr map_phys_addr = Common::AlignDown(region.GetAddress(), PageSize);
  408. const size_t map_size =
  409. Common::AlignUp(region.GetEndAddress(), PageSize) - map_phys_addr;
  410. const VAddr map_virt_addr =
  411. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegionWithGuard(
  412. map_size, PageSize, KMemoryRegionType_KernelMisc, PageSize);
  413. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  414. map_virt_addr, map_size, KMemoryRegionType_KernelMiscMappedDevice));
  415. region.SetPairAddress(map_virt_addr + region.GetAddress() - map_phys_addr);
  416. }
  417. Init::SetupDramPhysicalMemoryRegions(memory_layout);
  418. // Insert a physical region for the kernel code region.
  419. ASSERT(memory_layout.GetPhysicalMemoryRegionTree().Insert(
  420. code_start_phys_addr, code_region_size, KMemoryRegionType_DramKernelCode));
  421. // Insert a physical region for the kernel slab region.
  422. ASSERT(memory_layout.GetPhysicalMemoryRegionTree().Insert(
  423. slab_start_phys_addr, slab_region_size, KMemoryRegionType_DramKernelSlab));
  424. // Determine size available for kernel page table heaps, requiring > 8 MB.
  425. const PAddr resource_end_phys_addr = slab_start_phys_addr + resource_region_size;
  426. const size_t page_table_heap_size = resource_end_phys_addr - slab_end_phys_addr;
  427. ASSERT(page_table_heap_size / 4_MiB > 2);
  428. // Insert a physical region for the kernel page table heap region
  429. ASSERT(memory_layout.GetPhysicalMemoryRegionTree().Insert(
  430. slab_end_phys_addr, page_table_heap_size, KMemoryRegionType_DramKernelPtHeap));
  431. // All DRAM regions that we haven't tagged by this point will be mapped under the linear
  432. // mapping. Tag them.
  433. for (auto& region : memory_layout.GetPhysicalMemoryRegionTree()) {
  434. if (region.GetType() == KMemoryRegionType_Dram) {
  435. // Check that the region is valid.
  436. ASSERT(region.GetEndAddress() != 0);
  437. // Set the linear map attribute.
  438. region.SetTypeAttribute(KMemoryRegionAttr_LinearMapped);
  439. }
  440. }
  441. // Get the linear region extents.
  442. const auto linear_extents =
  443. memory_layout.GetPhysicalMemoryRegionTree().GetDerivedRegionExtents(
  444. KMemoryRegionAttr_LinearMapped);
  445. ASSERT(linear_extents.GetEndAddress() != 0);
  446. // Setup the linear mapping region.
  447. constexpr size_t LinearRegionAlign = 1_GiB;
  448. const PAddr aligned_linear_phys_start =
  449. Common::AlignDown(linear_extents.GetAddress(), LinearRegionAlign);
  450. const size_t linear_region_size =
  451. Common::AlignUp(linear_extents.GetEndAddress(), LinearRegionAlign) -
  452. aligned_linear_phys_start;
  453. const VAddr linear_region_start =
  454. memory_layout.GetVirtualMemoryRegionTree().GetRandomAlignedRegionWithGuard(
  455. linear_region_size, LinearRegionAlign, KMemoryRegionType_None, LinearRegionAlign);
  456. const u64 linear_region_phys_to_virt_diff = linear_region_start - aligned_linear_phys_start;
  457. // Map and create regions for all the linearly-mapped data.
  458. {
  459. PAddr cur_phys_addr = 0;
  460. u64 cur_size = 0;
  461. for (auto& region : memory_layout.GetPhysicalMemoryRegionTree()) {
  462. if (!region.HasTypeAttribute(KMemoryRegionAttr_LinearMapped)) {
  463. continue;
  464. }
  465. ASSERT(region.GetEndAddress() != 0);
  466. if (cur_size == 0) {
  467. cur_phys_addr = region.GetAddress();
  468. cur_size = region.GetSize();
  469. } else if (cur_phys_addr + cur_size == region.GetAddress()) {
  470. cur_size += region.GetSize();
  471. } else {
  472. cur_phys_addr = region.GetAddress();
  473. cur_size = region.GetSize();
  474. }
  475. const VAddr region_virt_addr =
  476. region.GetAddress() + linear_region_phys_to_virt_diff;
  477. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  478. region_virt_addr, region.GetSize(),
  479. GetTypeForVirtualLinearMapping(region.GetType())));
  480. region.SetPairAddress(region_virt_addr);
  481. KMemoryRegion* virt_region =
  482. memory_layout.GetVirtualMemoryRegionTree().FindModifiable(region_virt_addr);
  483. ASSERT(virt_region != nullptr);
  484. virt_region->SetPairAddress(region.GetAddress());
  485. }
  486. }
  487. // Insert regions for the initial page table region.
  488. ASSERT(memory_layout.GetPhysicalMemoryRegionTree().Insert(
  489. resource_end_phys_addr, KernelPageTableHeapSize, KMemoryRegionType_DramKernelInitPt));
  490. ASSERT(memory_layout.GetVirtualMemoryRegionTree().Insert(
  491. resource_end_phys_addr + linear_region_phys_to_virt_diff, KernelPageTableHeapSize,
  492. KMemoryRegionType_VirtualDramKernelInitPt));
  493. // All linear-mapped DRAM regions that we haven't tagged by this point will be allocated to
  494. // some pool partition. Tag them.
  495. for (auto& region : memory_layout.GetPhysicalMemoryRegionTree()) {
  496. if (region.GetType() == (KMemoryRegionType_Dram | KMemoryRegionAttr_LinearMapped)) {
  497. region.SetType(KMemoryRegionType_DramPoolPartition);
  498. }
  499. }
  500. // Setup all other memory regions needed to arrange the pool partitions.
  501. Init::SetupPoolPartitionMemoryRegions(memory_layout);
  502. // Cache all linear regions in their own trees for faster access, later.
  503. memory_layout.InitializeLinearMemoryRegionTrees(aligned_linear_phys_start,
  504. linear_region_start);
  505. }
  506. void InitializeMemoryLayout(const KMemoryLayout& memory_layout) {
  507. const auto system_pool = memory_layout.GetKernelSystemPoolRegionPhysicalExtents();
  508. const auto applet_pool = memory_layout.GetKernelAppletPoolRegionPhysicalExtents();
  509. const auto application_pool = memory_layout.GetKernelApplicationPoolRegionPhysicalExtents();
  510. // Initialize memory managers
  511. memory_manager = std::make_unique<KMemoryManager>();
  512. memory_manager->InitializeManager(KMemoryManager::Pool::Application,
  513. application_pool.GetAddress(),
  514. application_pool.GetEndAddress());
  515. memory_manager->InitializeManager(KMemoryManager::Pool::Applet, applet_pool.GetAddress(),
  516. applet_pool.GetEndAddress());
  517. memory_manager->InitializeManager(KMemoryManager::Pool::System, system_pool.GetAddress(),
  518. system_pool.GetEndAddress());
  519. // Setup memory regions for emulated processes
  520. // TODO(bunnei): These should not be hardcoded regions initialized within the kernel
  521. constexpr std::size_t hid_size{0x40000};
  522. constexpr std::size_t font_size{0x1100000};
  523. constexpr std::size_t irs_size{0x8000};
  524. constexpr std::size_t time_size{0x1000};
  525. const PAddr hid_phys_addr{system_pool.GetAddress()};
  526. const PAddr font_phys_addr{system_pool.GetAddress() + hid_size};
  527. const PAddr irs_phys_addr{system_pool.GetAddress() + hid_size + font_size};
  528. const PAddr time_phys_addr{system_pool.GetAddress() + hid_size + font_size + irs_size};
  529. hid_shared_mem = KSharedMemory::Create(system.Kernel());
  530. font_shared_mem = KSharedMemory::Create(system.Kernel());
  531. irs_shared_mem = KSharedMemory::Create(system.Kernel());
  532. time_shared_mem = KSharedMemory::Create(system.Kernel());
  533. hid_shared_mem->Initialize(system.DeviceMemory(), nullptr,
  534. {hid_phys_addr, hid_size / PageSize},
  535. Svc::MemoryPermission::None, Svc::MemoryPermission::Read,
  536. hid_phys_addr, hid_size, "HID:SharedMemory");
  537. font_shared_mem->Initialize(system.DeviceMemory(), nullptr,
  538. {font_phys_addr, font_size / PageSize},
  539. Svc::MemoryPermission::None, Svc::MemoryPermission::Read,
  540. font_phys_addr, font_size, "Font:SharedMemory");
  541. irs_shared_mem->Initialize(system.DeviceMemory(), nullptr,
  542. {irs_phys_addr, irs_size / PageSize},
  543. Svc::MemoryPermission::None, Svc::MemoryPermission::Read,
  544. irs_phys_addr, irs_size, "IRS:SharedMemory");
  545. time_shared_mem->Initialize(system.DeviceMemory(), nullptr,
  546. {time_phys_addr, time_size / PageSize},
  547. Svc::MemoryPermission::None, Svc::MemoryPermission::Read,
  548. time_phys_addr, time_size, "Time:SharedMemory");
  549. }
  550. void InitializePageSlab() {
  551. // Allocate slab heaps
  552. user_slab_heap_pages =
  553. std::make_unique<KSlabHeap<Page>>(KSlabHeap<Page>::AllocationType::Guest);
  554. // TODO(ameerj): This should be derived, not hardcoded within the kernel
  555. constexpr u64 user_slab_heap_size{0x3de000};
  556. // Reserve slab heaps
  557. ASSERT(
  558. system_resource_limit->Reserve(LimitableResource::PhysicalMemory, user_slab_heap_size));
  559. // Initialize slab heap
  560. user_slab_heap_pages->Initialize(
  561. system.DeviceMemory().GetPointer(Core::DramMemoryMap::SlabHeapBase),
  562. user_slab_heap_size);
  563. }
  564. KClientPort* CreateNamedServicePort(std::string name) {
  565. auto search = service_interface_factory.find(name);
  566. if (search == service_interface_factory.end()) {
  567. UNIMPLEMENTED();
  568. return {};
  569. }
  570. KClientPort* port = &search->second(system.ServiceManager(), system);
  571. {
  572. std::lock_guard lk(server_ports_lock);
  573. server_ports.insert(&port->GetParent()->GetServerPort());
  574. }
  575. return port;
  576. }
  577. std::atomic<u32> next_object_id{0};
  578. std::atomic<u64> next_kernel_process_id{KProcess::InitialKIPIDMin};
  579. std::atomic<u64> next_user_process_id{KProcess::ProcessIDMin};
  580. std::atomic<u64> next_thread_id{1};
  581. // Lists all processes that exist in the current session.
  582. std::vector<KProcess*> process_list;
  583. KProcess* current_process{};
  584. std::unique_ptr<Kernel::GlobalSchedulerContext> global_scheduler_context;
  585. Kernel::TimeManager time_manager;
  586. Init::KSlabResourceCounts slab_resource_counts{};
  587. KResourceLimit* system_resource_limit{};
  588. std::shared_ptr<Core::Timing::EventType> preemption_event;
  589. // This is the kernel's handle table or supervisor handle table which
  590. // stores all the objects in place.
  591. std::unique_ptr<KHandleTable> global_handle_table;
  592. KAutoObjectWithListContainer object_list_container;
  593. /// Map of named ports managed by the kernel, which can be retrieved using
  594. /// the ConnectToPort SVC.
  595. std::unordered_map<std::string, ServiceInterfaceFactory> service_interface_factory;
  596. NamedPortTable named_ports;
  597. std::unordered_set<KServerPort*> server_ports;
  598. std::unordered_set<KServerSession*> server_sessions;
  599. std::unordered_set<KAutoObject*> registered_objects;
  600. std::mutex server_ports_lock;
  601. std::mutex server_sessions_lock;
  602. std::mutex registered_objects_lock;
  603. std::unique_ptr<Core::ExclusiveMonitor> exclusive_monitor;
  604. std::vector<Kernel::PhysicalCore> cores;
  605. // Next host thead ID to use, 0-3 IDs represent core threads, >3 represent others
  606. std::atomic<u32> next_host_thread_id{Core::Hardware::NUM_CPU_CORES};
  607. // Kernel memory management
  608. std::unique_ptr<KMemoryManager> memory_manager;
  609. std::unique_ptr<KSlabHeap<Page>> user_slab_heap_pages;
  610. // Shared memory for services
  611. Kernel::KSharedMemory* hid_shared_mem{};
  612. Kernel::KSharedMemory* font_shared_mem{};
  613. Kernel::KSharedMemory* irs_shared_mem{};
  614. Kernel::KSharedMemory* time_shared_mem{};
  615. // Threads used for services
  616. std::unordered_set<std::shared_ptr<Kernel::ServiceThread>> service_threads;
  617. std::array<KThread*, Core::Hardware::NUM_CPU_CORES> suspend_threads;
  618. std::array<Core::CPUInterruptHandler, Core::Hardware::NUM_CPU_CORES> interrupts{};
  619. std::array<std::unique_ptr<Kernel::KScheduler>, Core::Hardware::NUM_CPU_CORES> schedulers{};
  620. bool is_multicore{};
  621. bool is_phantom_mode_for_singlecore{};
  622. u32 single_core_thread_id{};
  623. std::array<u64, Core::Hardware::NUM_CPU_CORES> svc_ticks{};
  624. // System context
  625. Core::System& system;
  626. };
  627. KernelCore::KernelCore(Core::System& system) : impl{std::make_unique<Impl>(system, *this)} {}
  628. KernelCore::~KernelCore() = default;
  629. void KernelCore::SetMulticore(bool is_multicore) {
  630. impl->SetMulticore(is_multicore);
  631. }
  632. void KernelCore::Initialize() {
  633. slab_heap_container = std::make_unique<SlabHeapContainer>();
  634. impl->Initialize(*this);
  635. }
  636. void KernelCore::InitializeCores() {
  637. impl->InitializeCores();
  638. }
  639. void KernelCore::Shutdown() {
  640. impl->Shutdown();
  641. }
  642. const KResourceLimit* KernelCore::GetSystemResourceLimit() const {
  643. return impl->system_resource_limit;
  644. }
  645. KResourceLimit* KernelCore::GetSystemResourceLimit() {
  646. return impl->system_resource_limit;
  647. }
  648. KScopedAutoObject<KThread> KernelCore::RetrieveThreadFromGlobalHandleTable(Handle handle) const {
  649. return impl->global_handle_table->GetObject<KThread>(handle);
  650. }
  651. void KernelCore::AppendNewProcess(KProcess* process) {
  652. impl->process_list.push_back(process);
  653. }
  654. void KernelCore::MakeCurrentProcess(KProcess* process) {
  655. impl->MakeCurrentProcess(process);
  656. }
  657. KProcess* KernelCore::CurrentProcess() {
  658. return impl->current_process;
  659. }
  660. const KProcess* KernelCore::CurrentProcess() const {
  661. return impl->current_process;
  662. }
  663. const std::vector<KProcess*>& KernelCore::GetProcessList() const {
  664. return impl->process_list;
  665. }
  666. Kernel::GlobalSchedulerContext& KernelCore::GlobalSchedulerContext() {
  667. return *impl->global_scheduler_context;
  668. }
  669. const Kernel::GlobalSchedulerContext& KernelCore::GlobalSchedulerContext() const {
  670. return *impl->global_scheduler_context;
  671. }
  672. Kernel::KScheduler& KernelCore::Scheduler(std::size_t id) {
  673. return *impl->schedulers[id];
  674. }
  675. const Kernel::KScheduler& KernelCore::Scheduler(std::size_t id) const {
  676. return *impl->schedulers[id];
  677. }
  678. Kernel::PhysicalCore& KernelCore::PhysicalCore(std::size_t id) {
  679. return impl->cores[id];
  680. }
  681. const Kernel::PhysicalCore& KernelCore::PhysicalCore(std::size_t id) const {
  682. return impl->cores[id];
  683. }
  684. size_t KernelCore::CurrentPhysicalCoreIndex() const {
  685. const u32 core_id = impl->GetCurrentHostThreadID();
  686. if (core_id >= Core::Hardware::NUM_CPU_CORES) {
  687. return Core::Hardware::NUM_CPU_CORES - 1;
  688. }
  689. return core_id;
  690. }
  691. Kernel::PhysicalCore& KernelCore::CurrentPhysicalCore() {
  692. u32 core_id = impl->GetCurrentHostThreadID();
  693. ASSERT(core_id < Core::Hardware::NUM_CPU_CORES);
  694. return impl->cores[core_id];
  695. }
  696. const Kernel::PhysicalCore& KernelCore::CurrentPhysicalCore() const {
  697. u32 core_id = impl->GetCurrentHostThreadID();
  698. ASSERT(core_id < Core::Hardware::NUM_CPU_CORES);
  699. return impl->cores[core_id];
  700. }
  701. Kernel::KScheduler* KernelCore::CurrentScheduler() {
  702. u32 core_id = impl->GetCurrentHostThreadID();
  703. if (core_id >= Core::Hardware::NUM_CPU_CORES) {
  704. // This is expected when called from not a guest thread
  705. return {};
  706. }
  707. return impl->schedulers[core_id].get();
  708. }
  709. std::array<Core::CPUInterruptHandler, Core::Hardware::NUM_CPU_CORES>& KernelCore::Interrupts() {
  710. return impl->interrupts;
  711. }
  712. const std::array<Core::CPUInterruptHandler, Core::Hardware::NUM_CPU_CORES>& KernelCore::Interrupts()
  713. const {
  714. return impl->interrupts;
  715. }
  716. Kernel::TimeManager& KernelCore::TimeManager() {
  717. return impl->time_manager;
  718. }
  719. const Kernel::TimeManager& KernelCore::TimeManager() const {
  720. return impl->time_manager;
  721. }
  722. Core::ExclusiveMonitor& KernelCore::GetExclusiveMonitor() {
  723. return *impl->exclusive_monitor;
  724. }
  725. const Core::ExclusiveMonitor& KernelCore::GetExclusiveMonitor() const {
  726. return *impl->exclusive_monitor;
  727. }
  728. KAutoObjectWithListContainer& KernelCore::ObjectListContainer() {
  729. return impl->object_list_container;
  730. }
  731. const KAutoObjectWithListContainer& KernelCore::ObjectListContainer() const {
  732. return impl->object_list_container;
  733. }
  734. void KernelCore::InvalidateAllInstructionCaches() {
  735. for (auto& physical_core : impl->cores) {
  736. physical_core.ArmInterface().ClearInstructionCache();
  737. }
  738. }
  739. void KernelCore::InvalidateCpuInstructionCacheRange(VAddr addr, std::size_t size) {
  740. for (auto& physical_core : impl->cores) {
  741. if (!physical_core.IsInitialized()) {
  742. continue;
  743. }
  744. physical_core.ArmInterface().InvalidateCacheRange(addr, size);
  745. }
  746. }
  747. void KernelCore::PrepareReschedule(std::size_t id) {
  748. // TODO: Reimplement, this
  749. }
  750. void KernelCore::RegisterNamedService(std::string name, ServiceInterfaceFactory&& factory) {
  751. impl->service_interface_factory.emplace(std::move(name), factory);
  752. }
  753. KClientPort* KernelCore::CreateNamedServicePort(std::string name) {
  754. return impl->CreateNamedServicePort(std::move(name));
  755. }
  756. void KernelCore::RegisterServerSession(KServerSession* server_session) {
  757. std::lock_guard lk(impl->server_sessions_lock);
  758. impl->server_sessions.insert(server_session);
  759. }
  760. void KernelCore::UnregisterServerSession(KServerSession* server_session) {
  761. std::lock_guard lk(impl->server_sessions_lock);
  762. impl->server_sessions.erase(server_session);
  763. }
  764. void KernelCore::RegisterKernelObject(KAutoObject* object) {
  765. std::lock_guard lk(impl->registered_objects_lock);
  766. impl->registered_objects.insert(object);
  767. }
  768. void KernelCore::UnregisterKernelObject(KAutoObject* object) {
  769. std::lock_guard lk(impl->registered_objects_lock);
  770. impl->registered_objects.erase(object);
  771. }
  772. bool KernelCore::IsValidNamedPort(NamedPortTable::const_iterator port) const {
  773. return port != impl->named_ports.cend();
  774. }
  775. u32 KernelCore::CreateNewObjectID() {
  776. return impl->next_object_id++;
  777. }
  778. u64 KernelCore::CreateNewThreadID() {
  779. return impl->next_thread_id++;
  780. }
  781. u64 KernelCore::CreateNewKernelProcessID() {
  782. return impl->next_kernel_process_id++;
  783. }
  784. u64 KernelCore::CreateNewUserProcessID() {
  785. return impl->next_user_process_id++;
  786. }
  787. KHandleTable& KernelCore::GlobalHandleTable() {
  788. return *impl->global_handle_table;
  789. }
  790. const KHandleTable& KernelCore::GlobalHandleTable() const {
  791. return *impl->global_handle_table;
  792. }
  793. void KernelCore::RegisterCoreThread(std::size_t core_id) {
  794. impl->RegisterCoreThread(core_id);
  795. }
  796. void KernelCore::RegisterHostThread() {
  797. impl->RegisterHostThread();
  798. }
  799. u32 KernelCore::GetCurrentHostThreadID() const {
  800. return impl->GetCurrentHostThreadID();
  801. }
  802. KThread* KernelCore::GetCurrentEmuThread() const {
  803. return impl->GetCurrentEmuThread();
  804. }
  805. KMemoryManager& KernelCore::MemoryManager() {
  806. return *impl->memory_manager;
  807. }
  808. const KMemoryManager& KernelCore::MemoryManager() const {
  809. return *impl->memory_manager;
  810. }
  811. KSlabHeap<Page>& KernelCore::GetUserSlabHeapPages() {
  812. return *impl->user_slab_heap_pages;
  813. }
  814. const KSlabHeap<Page>& KernelCore::GetUserSlabHeapPages() const {
  815. return *impl->user_slab_heap_pages;
  816. }
  817. Kernel::KSharedMemory& KernelCore::GetHidSharedMem() {
  818. return *impl->hid_shared_mem;
  819. }
  820. const Kernel::KSharedMemory& KernelCore::GetHidSharedMem() const {
  821. return *impl->hid_shared_mem;
  822. }
  823. Kernel::KSharedMemory& KernelCore::GetFontSharedMem() {
  824. return *impl->font_shared_mem;
  825. }
  826. const Kernel::KSharedMemory& KernelCore::GetFontSharedMem() const {
  827. return *impl->font_shared_mem;
  828. }
  829. Kernel::KSharedMemory& KernelCore::GetIrsSharedMem() {
  830. return *impl->irs_shared_mem;
  831. }
  832. const Kernel::KSharedMemory& KernelCore::GetIrsSharedMem() const {
  833. return *impl->irs_shared_mem;
  834. }
  835. Kernel::KSharedMemory& KernelCore::GetTimeSharedMem() {
  836. return *impl->time_shared_mem;
  837. }
  838. const Kernel::KSharedMemory& KernelCore::GetTimeSharedMem() const {
  839. return *impl->time_shared_mem;
  840. }
  841. void KernelCore::Suspend(bool in_suspention) {
  842. const bool should_suspend = exception_exited || in_suspention;
  843. {
  844. KScopedSchedulerLock lock(*this);
  845. const auto state = should_suspend ? ThreadState::Runnable : ThreadState::Waiting;
  846. for (u32 core_id = 0; core_id < Core::Hardware::NUM_CPU_CORES; core_id++) {
  847. impl->suspend_threads[core_id]->SetState(state);
  848. impl->suspend_threads[core_id]->SetWaitReasonForDebugging(
  849. ThreadWaitReasonForDebugging::Suspended);
  850. }
  851. }
  852. }
  853. bool KernelCore::IsMulticore() const {
  854. return impl->is_multicore;
  855. }
  856. void KernelCore::ExceptionalExit() {
  857. exception_exited = true;
  858. Suspend(true);
  859. }
  860. void KernelCore::EnterSVCProfile() {
  861. impl->svc_ticks[CurrentPhysicalCoreIndex()] = MicroProfileEnter(MICROPROFILE_TOKEN(Kernel_SVC));
  862. }
  863. void KernelCore::ExitSVCProfile() {
  864. MicroProfileLeave(MICROPROFILE_TOKEN(Kernel_SVC), impl->svc_ticks[CurrentPhysicalCoreIndex()]);
  865. }
  866. std::weak_ptr<Kernel::ServiceThread> KernelCore::CreateServiceThread(const std::string& name) {
  867. auto service_thread = std::make_shared<Kernel::ServiceThread>(*this, 1, name);
  868. impl->service_threads.emplace(service_thread);
  869. return service_thread;
  870. }
  871. void KernelCore::ReleaseServiceThread(std::weak_ptr<Kernel::ServiceThread> service_thread) {
  872. if (auto strong_ptr = service_thread.lock()) {
  873. impl->service_threads.erase(strong_ptr);
  874. }
  875. }
  876. Init::KSlabResourceCounts& KernelCore::SlabResourceCounts() {
  877. return impl->slab_resource_counts;
  878. }
  879. const Init::KSlabResourceCounts& KernelCore::SlabResourceCounts() const {
  880. return impl->slab_resource_counts;
  881. }
  882. bool KernelCore::IsPhantomModeForSingleCore() const {
  883. return impl->IsPhantomModeForSingleCore();
  884. }
  885. void KernelCore::SetIsPhantomModeForSingleCore(bool value) {
  886. impl->SetIsPhantomModeForSingleCore(value);
  887. }
  888. Core::System& KernelCore::System() {
  889. return impl->system;
  890. }
  891. const Core::System& KernelCore::System() const {
  892. return impl->system;
  893. }
  894. } // namespace Kernel