drivers/perf/arm_brbe.c
Source file repositories/reference/linux-study-clean/drivers/perf/arm_brbe.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/perf/arm_brbe.c- Extension
.c- Size
- 23062 bytes
- Lines
- 806
- Domain
- Driver Families
- Bucket
- drivers/perf
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/types.hlinux/bitmap.hlinux/perf/arm_pmu.harm_brbe.h
Detected Declarations
struct brbe_regsetstruct brbe_hw_attrfunction read_sysreg_sfunction read_sysreg_sfunction read_sysreg_sfunction brbe_record_validfunction brbe_invalidfunction brbe_record_is_completefunction brbe_record_is_source_onlyfunction brbe_record_is_target_onlyfunction brbinf_get_in_txfunction brbinf_get_mispredictfunction brbinf_get_lastfailedfunction brbinf_get_cyclesfunction brbinf_get_typefunction brbinf_get_elfunction brbe_invalidatefunction valid_brbe_nrfunction valid_brbe_ccfunction valid_brbe_formatfunction valid_brbidrfunction valid_brbe_versionfunction select_brbe_bankfunction __read_brbe_regsetfunction branch_type_to_brbfcrfunction branch_type_to_brbcrfunction brbe_branch_attr_validfunction brbe_num_branch_recordsfunction brbe_probefunction brbe_enablefunction brbe_disablefunction brbe_set_perf_entry_typefunction brbinf_get_perf_privfunction perf_entry_from_brbe_regsetfunction prepare_event_branch_type_maskfunction filter_branch_privilegefunction filter_branch_typefunction filter_branch_recordfunction brbe_read_filtered_entries
Annotated Snippet
struct brbe_regset {
u64 brbsrc;
u64 brbtgt;
u64 brbinf;
};
#define PERF_BR_ARM64_MAX (PERF_BR_MAX + PERF_BR_NEW_MAX)
struct brbe_hw_attr {
int brbe_version;
int brbe_cc;
int brbe_nr;
int brbe_format;
};
#define BRBE_REGN_CASE(n, case_macro) \
case n: case_macro(n); break
#define BRBE_REGN_SWITCH(x, case_macro) \
do { \
switch (x) { \
BRBE_REGN_CASE(0, case_macro); \
BRBE_REGN_CASE(1, case_macro); \
BRBE_REGN_CASE(2, case_macro); \
BRBE_REGN_CASE(3, case_macro); \
BRBE_REGN_CASE(4, case_macro); \
BRBE_REGN_CASE(5, case_macro); \
BRBE_REGN_CASE(6, case_macro); \
BRBE_REGN_CASE(7, case_macro); \
BRBE_REGN_CASE(8, case_macro); \
BRBE_REGN_CASE(9, case_macro); \
BRBE_REGN_CASE(10, case_macro); \
BRBE_REGN_CASE(11, case_macro); \
BRBE_REGN_CASE(12, case_macro); \
BRBE_REGN_CASE(13, case_macro); \
BRBE_REGN_CASE(14, case_macro); \
BRBE_REGN_CASE(15, case_macro); \
BRBE_REGN_CASE(16, case_macro); \
BRBE_REGN_CASE(17, case_macro); \
BRBE_REGN_CASE(18, case_macro); \
BRBE_REGN_CASE(19, case_macro); \
BRBE_REGN_CASE(20, case_macro); \
BRBE_REGN_CASE(21, case_macro); \
BRBE_REGN_CASE(22, case_macro); \
BRBE_REGN_CASE(23, case_macro); \
BRBE_REGN_CASE(24, case_macro); \
BRBE_REGN_CASE(25, case_macro); \
BRBE_REGN_CASE(26, case_macro); \
BRBE_REGN_CASE(27, case_macro); \
BRBE_REGN_CASE(28, case_macro); \
BRBE_REGN_CASE(29, case_macro); \
BRBE_REGN_CASE(30, case_macro); \
BRBE_REGN_CASE(31, case_macro); \
default: WARN(1, "Invalid BRB* index %d\n", x); \
} \
} while (0)
#define RETURN_READ_BRBSRCN(n) \
return read_sysreg_s(SYS_BRBSRC_EL1(n))
static inline u64 get_brbsrc_reg(int idx)
{
BRBE_REGN_SWITCH(idx, RETURN_READ_BRBSRCN);
return 0;
}
#define RETURN_READ_BRBTGTN(n) \
return read_sysreg_s(SYS_BRBTGT_EL1(n))
static u64 get_brbtgt_reg(int idx)
{
BRBE_REGN_SWITCH(idx, RETURN_READ_BRBTGTN);
return 0;
}
#define RETURN_READ_BRBINFN(n) \
return read_sysreg_s(SYS_BRBINF_EL1(n))
static u64 get_brbinf_reg(int idx)
{
BRBE_REGN_SWITCH(idx, RETURN_READ_BRBINFN);
return 0;
}
static u64 brbe_record_valid(u64 brbinf)
{
return FIELD_GET(BRBINFx_EL1_VALID_MASK, brbinf);
}
static bool brbe_invalid(u64 brbinf)
{
return brbe_record_valid(brbinf) == BRBINFx_EL1_VALID_NONE;
}
Annotation
- Immediate include surface: `linux/types.h`, `linux/bitmap.h`, `linux/perf/arm_pmu.h`, `arm_brbe.h`.
- Detected declarations: `struct brbe_regset`, `struct brbe_hw_attr`, `function read_sysreg_s`, `function read_sysreg_s`, `function read_sysreg_s`, `function brbe_record_valid`, `function brbe_invalid`, `function brbe_record_is_complete`, `function brbe_record_is_source_only`, `function brbe_record_is_target_only`.
- Atlas domain: Driver Families / drivers/perf.
- 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.