tools/perf/util/arm64-frame-pointer-unwind-support.c
Source file repositories/reference/linux-study-clean/tools/perf/util/arm64-frame-pointer-unwind-support.c
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/util/arm64-frame-pointer-unwind-support.c- Extension
.c- Size
- 1942 bytes
- Lines
- 72
- 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.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
arm64-frame-pointer-unwind-support.hcallchain.hevent.hunwind.hstring.h../../arch/arm64/include/uapi/asm/perf_regs.h
Detected Declarations
struct entriesfunction get_leaf_frame_caller_enabledfunction add_entryfunction get_leaf_frame_caller_aarch64
Annotated Snippet
struct entries {
u64 stack[2];
size_t length;
};
#define SMPL_REG_MASK(b) (1ULL << (b))
static bool get_leaf_frame_caller_enabled(struct perf_sample *sample)
{
struct regs_dump *regs;
if (callchain_param.record_mode != CALLCHAIN_FP)
return false;
regs = perf_sample__user_regs(sample);
return regs->regs && regs->mask & SMPL_REG_MASK(PERF_REG_ARM64_LR);
}
static int add_entry(struct unwind_entry *entry, void *arg)
{
struct entries *entries = arg;
entries->stack[entries->length++] = entry->ip;
return 0;
}
u64 get_leaf_frame_caller_aarch64(struct perf_sample *sample, struct thread *thread, int usr_idx)
{
int ret;
struct entries entries = {};
struct regs_dump old_regs, *regs;
if (!get_leaf_frame_caller_enabled(sample))
return 0;
/*
* If PC and SP are not recorded, get the value of PC from the stack
* and set its mask. SP is not used when doing the unwinding but it
* still needs to be set to prevent failures.
*/
regs = perf_sample__user_regs(sample);
memcpy(&old_regs, regs, sizeof(*regs));
if (!(regs->mask & SMPL_REG_MASK(PERF_REG_ARM64_PC))) {
regs->cache_mask |= SMPL_REG_MASK(PERF_REG_ARM64_PC);
regs->cache_regs[PERF_REG_ARM64_PC] = sample->callchain->ips[usr_idx+1];
}
if (!(regs->mask & SMPL_REG_MASK(PERF_REG_ARM64_SP))) {
regs->cache_mask |= SMPL_REG_MASK(PERF_REG_ARM64_SP);
regs->cache_regs[PERF_REG_ARM64_SP] = 0;
}
ret = unwind__get_entries(add_entry, &entries, thread, sample, 2, true);
memcpy(regs, &old_regs, sizeof(*regs));
if (ret || entries.length != 2)
return ret;
return callchain_param.order == ORDER_CALLER ? entries.stack[0] : entries.stack[1];
}
Annotation
- Immediate include surface: `arm64-frame-pointer-unwind-support.h`, `callchain.h`, `event.h`, `unwind.h`, `string.h`, `../../arch/arm64/include/uapi/asm/perf_regs.h`.
- Detected declarations: `struct entries`, `function get_leaf_frame_caller_enabled`, `function add_entry`, `function get_leaf_frame_caller_aarch64`.
- 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.