Atmosphere/libraries/libmesosphere/include/mesosphere/kern_k_debug_base.hpp

/*
 * Copyright (c) Atmosphère-NX
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms and conditions of the GNU General Public License,
 * version 2, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
#pragma once
#include <mesosphere/kern_common.hpp>
#include <mesosphere/kern_k_synchronization_object.hpp>
#include <mesosphere/kern_k_process.hpp>
#include <mesosphere/kern_k_event_info.hpp>
#include <mesosphere/kern_k_light_lock.hpp>

namespace ams::kern {

    class KDebugBase : public KSynchronizationObject {
        protected:
            using DebugEventList = util::IntrusiveListBaseTraits<KEventInfo>::ListType;
        private:
            DebugEventList m_event_info_list;
            u32 m_continue_flags;
            KSharedAutoObject<KProcess> m_process_holder;
            KLightLock m_lock;
            KProcess::State m_old_process_state;
            bool m_is_attached;
        public:
            explicit KDebugBase() { /* ... */ }
        protected:
            bool Is64Bit() const;
        public:
            void Initialize();
            void Finalize();

            Result Attach(KProcess *process);
            Result BreakProcess();
            Result TerminateProcess();

            Result ContinueDebug(const u32 flags, const u64 *thread_ids, size_t num_thread_ids);

            Result QueryMemoryInfo(ams::svc::MemoryInfo *out_memory_info, ams::svc::PageInfo *out_page_info, KProcessAddress address);
            Result ReadMemory(KProcessAddress buffer, KProcessAddress address, size_t size);
            Result WriteMemory(KProcessAddress buffer, KProcessAddress address, size_t size);

            Result GetThreadContext(ams::svc::ThreadContext *out, u64 thread_id, u32 context_flags);
            Result SetThreadContext(const ams::svc::ThreadContext &ctx, u64 thread_id, u32 context_flags);

            Result GetRunningThreadInfo(ams::svc::LastThreadContext *out_context, u64 *out_thread_id);

            Result GetDebugEventInfo(ams::svc::lp64::DebugEventInfo *out);
            Result GetDebugEventInfo(ams::svc::ilp32::DebugEventInfo *out);

            ALWAYS_INLINE bool IsAttached() const {
                return m_is_attached;
            }

            ALWAYS_INLINE bool OpenProcess() {
                return m_process_holder.Open();
            }

            ALWAYS_INLINE void CloseProcess() {
                return m_process_holder.Close();
            }

            ALWAYS_INLINE KProcess *GetProcessUnsafe() const {
                return m_process_holder.Get();
            }
        private:
            void PushDebugEvent(ams::svc::DebugEvent event, const uintptr_t *params, size_t num_params);
            void EnqueueDebugEventInfo(KEventInfo *info);

            template<typename T> requires (std::same_as<T, ams::svc::lp64::DebugEventInfo> || std::same_as<T, ams::svc::ilp32::DebugEventInfo>)
            Result GetDebugEventInfoImpl(T *out);
        public:
            virtual bool IsSignaled() const override;
        private:
            /* NOTE: This is public/virtual override in Nintendo's kernel. */
            void OnFinalizeSynchronizationObject();
        private:
            static Result ProcessDebugEvent(ams::svc::DebugEvent event, const uintptr_t *params, size_t num_params);
        public:
            static Result OnDebugEvent(ams::svc::DebugEvent event, const uintptr_t *params, size_t num_params);
            static Result OnExitProcess(KProcess *process);
            static Result OnTerminateProcess(KProcess *process);
            static Result OnExitThread(KThread *thread);
            static KEventInfo *CreateDebugEvent(ams::svc::DebugEvent event, u64 thread_id, const uintptr_t *params, size_t num_params);
    };

}