tools/perf/tests/shell/record_lbr.sh
Source file repositories/reference/linux-study-clean/tools/perf/tests/shell/record_lbr.sh
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/tests/shell/record_lbr.sh- Extension
.sh- Size
- 3868 bytes
- Lines
- 177
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: tools
- Status
- atlas-only
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
- No C-style include directives detected by the generator.
Detected Declarations
function lbr_callgraph_test
Annotated Snippet
#!/bin/bash
# perf record LBR tests (exclusive)
# SPDX-License-Identifier: GPL-2.0
set -e
ParanoidAndNotRoot() {
[ "$(id -u)" != 0 ] && [ "$(cat /proc/sys/kernel/perf_event_paranoid)" -gt $1 ]
}
if [ ! -f /sys/bus/event_source/devices/cpu/caps/branches ] &&
[ ! -f /sys/bus/event_source/devices/cpu_core/caps/branches ]
then
echo "Skip: only x86 CPUs support LBR"
exit 2
fi
err=0
perfdata=$(mktemp /tmp/__perf_test.perf.data.XXXXX)
cleanup() {
rm -rf "${perfdata}"
rm -rf "${perfdata}".old
rm -rf "${perfdata}".txt
trap - EXIT TERM INT
}
trap_cleanup() {
echo "Unexpected signal in ${FUNCNAME[1]}"
cleanup
exit 1
}
trap trap_cleanup EXIT TERM INT
lbr_callgraph_test() {
test="LBR callgraph"
echo "$test"
if ! perf record -e cycles --call-graph lbr -o "${perfdata}" perf test -w thloop
then
echo "$test [Failed support missing]"
if [ $err -eq 0 ]
then
err=2
fi
return
fi
if ! perf report --stitch-lbr -i "${perfdata}" > "${perfdata}".txt
then
cat "${perfdata}".txt
echo "$test [Failed in perf report]"
err=1
return
fi
echo "$test [Success]"
}
lbr_test() {
local branch_flags=$1
local test="LBR $2 test"
local threshold=$3
local out
local sam_nr
local bs_nr
local zero_nr
local r
Annotation
- Detected declarations: `function lbr_callgraph_test`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: atlas-only.
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.