Class MDebugInfo

src/mdebug.cpp:24–523

};

class MDebugInfo {
public:
    MDebugInfo(const N64Recomp::ElfParsingConfig& config, const char* mdebug_section, uint32_t mdebug_offset) {
        using namespace N64Recomp;
        good_ = false;
        // Read, byteswap and relocate the symbolic header. Relocation here means convert file-relative offsets to section-relative offsets.

        MDebug::HDRR hdrr;
        std::memcpy(&hdrr, mdebug_section, sizeof(MDebug::HDRR));
        hdrr.swap();
        hdrr.relocate(mdebug_offset);

        // Check the magic value and version number are what we expect.

        if (hdrr.magic != MDebug::MAGIC || hdrr.vstamp != 0) {
            fmt::print(stderr, "Warning: Found an mdebug section with bad magic value or version (magic={} version={}). Skipping.\n", hdrr.magic, hdrr.vstamp);
            return;
        }

        // Read the various records that are relevant for collecting static symbols and where they are declared.

        std::vector<MDebug::FDR> fdrs = hdrr.read_fdrs(mdebug_section);
        std::vector<MDebug::AUX> all_auxs = hdrr.read_auxs(mdebug_section);
        std::vector<MDebug::PDR> all_pdrs = hdrr.read_pdrs(mdebug_section);
        std::vector<MDebug::SYMR> all_symrs = hdrr.read_symrs(mdebug_section);
        
        // For each file descriptor
        for (size_t fdr_index = 0; fdr_index < fdrs.size(); fdr_index++) {
            MDebug::FDR& fdr = fdrs[fdr_index];
            MDebugSymbol pending_sym{};
            bool pending_sym_ready = false;

            auto flush_pending_sym = [&]() {
                if (pending_sym_ready) {
                    // Handle ignored symbols.
                    pending_sym.ignored = config.ignored_syms.contains(pending_sym.name);
                    // Add the symbol.
                    add_symbol(fdr_index, std::move(pending_sym));
                }
                pending_sym_ready = false;
            };

            const char* fdr_name = fdr.get_name(mdebug_section + hdrr.cbSsOffset);
            add_file(fdr_name);

            // For every symbol record in the file descriptor record.
            for (auto symr : fdr.get_symrs(all_symrs)) {
                MDebug::ST type = symr.get_st();
                MDebug::SC storage_class = symr.get_sc();

                switch (type) {
                    case MDebug::ST_PROC:
                    case MDebug::ST_STATICPROC:
                        flush_pending_sym();
                        if (symr.value != 0) {
                            pending_sym.name = fdr.get_string(mdebug_section + hdrr.cbSsOffset, symr.iss);
                            pending_sym.address = symr.value;
                            pending_sym.size = 0;