tools/perf/util/dwarf-regs.c
Source file repositories/reference/linux-study-clean/tools/perf/util/dwarf-regs.c
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/util/dwarf-regs.c- Extension
.c- Size
- 6005 bytes
- Lines
- 238
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
Dependency Surface
stdlib.hstring.hdebug.hdwarf-regs.helf.herrno.hlinux/kernel.h../arch/x86/include/dwarf-regs-table.h../arch/arm/include/dwarf-regs-table.h../arch/arm64/include/dwarf-regs-table.h../arch/sh/include/dwarf-regs-table.h../arch/powerpc/include/dwarf-regs-table.h../arch/riscv/include/dwarf-regs-table.h../arch/s390/include/dwarf-regs-table.h../arch/sparc/include/dwarf-regs-table.h../arch/xtensa/include/dwarf-regs-table.h../arch/mips/include/dwarf-regs-table.h../arch/loongarch/include/dwarf-regs-table.h
Detected Declarations
function __get_dwarf_regnumfunction get_dwarf_regnumfunction get_libdw_frame_nregsfunction get_dwarf_regnum_for_perf_regnum
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0
/*
* dwarf-regs.c : Mapping of DWARF debug register numbers into register names.
*
* Written by: Masami Hiramatsu <mhiramat@kernel.org>
*/
#include <stdlib.h>
#include <string.h>
#include <debug.h>
#include <dwarf-regs.h>
#include <elf.h>
#include <errno.h>
#include <linux/kernel.h>
/* Define const char * {arch}_register_tbl[] */
#define DEFINE_DWARF_REGSTR_TABLE
#include "../arch/x86/include/dwarf-regs-table.h"
#include "../arch/arm/include/dwarf-regs-table.h"
#include "../arch/arm64/include/dwarf-regs-table.h"
#include "../arch/sh/include/dwarf-regs-table.h"
#include "../arch/powerpc/include/dwarf-regs-table.h"
#include "../arch/riscv/include/dwarf-regs-table.h"
#include "../arch/s390/include/dwarf-regs-table.h"
#include "../arch/sparc/include/dwarf-regs-table.h"
#include "../arch/xtensa/include/dwarf-regs-table.h"
#include "../arch/mips/include/dwarf-regs-table.h"
#include "../arch/loongarch/include/dwarf-regs-table.h"
/* Return architecture dependent register string (for kprobe-tracer) */
const char *get_dwarf_regstr(unsigned int n, unsigned int machine, unsigned int flags)
{
#define __get_dwarf_regstr(tbl, n) (((n) < ARRAY_SIZE(tbl)) ? (tbl)[(n)] : NULL)
if (machine == EM_NONE) {
/* Generic arch - use host arch */
machine = EM_HOST;
}
switch (machine) {
case EM_386:
return __get_dwarf_regstr(x86_32_regstr_tbl, n);
case EM_X86_64:
return __get_dwarf_regstr(x86_64_regstr_tbl, n);
case EM_ARM:
return __get_dwarf_regstr(arm_regstr_tbl, n);
case EM_AARCH64:
return __get_dwarf_regstr(aarch64_regstr_tbl, n);
case EM_CSKY:
return __get_csky_regstr(n, flags);
case EM_SH:
return __get_dwarf_regstr(sh_regstr_tbl, n);
case EM_S390:
return __get_dwarf_regstr(s390_regstr_tbl, n);
case EM_PPC:
case EM_PPC64:
return __get_dwarf_regstr(powerpc_regstr_tbl, n);
case EM_RISCV:
return __get_dwarf_regstr(riscv_regstr_tbl, n);
case EM_SPARC:
case EM_SPARCV9:
return __get_dwarf_regstr(sparc_regstr_tbl, n);
case EM_XTENSA:
return __get_dwarf_regstr(xtensa_regstr_tbl, n);
case EM_MIPS:
return __get_dwarf_regstr(mips_regstr_tbl, n);
case EM_LOONGARCH:
return __get_dwarf_regstr(loongarch_regstr_tbl, n);
default:
pr_err("ELF MACHINE %x is not supported.\n", machine);
}
return NULL;
#undef __get_dwarf_regstr
}
static int __get_dwarf_regnum(const char *const *regstr, size_t num_regstr, const char *name)
{
for (size_t i = 0; i < num_regstr; i++) {
if (regstr[i] && !strcmp(regstr[i], name))
return i;
}
return -ENOENT;
}
/* Return DWARF register number from architecture register name */
int get_dwarf_regnum(const char *name, unsigned int machine, unsigned int flags)
{
char *regname = strdup(name);
int reg = -1;
char *p;
Annotation
- Immediate include surface: `stdlib.h`, `string.h`, `debug.h`, `dwarf-regs.h`, `elf.h`, `errno.h`, `linux/kernel.h`, `../arch/x86/include/dwarf-regs-table.h`.
- Detected declarations: `function __get_dwarf_regnum`, `function get_dwarf_regnum`, `function get_libdw_frame_nregs`, `function get_dwarf_regnum_for_perf_regnum`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.