tools/perf/tests/shell/trace_btf_enum.sh
Source file repositories/reference/linux-study-clean/tools/perf/tests/shell/trace_btf_enum.sh
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/tests/shell/trace_btf_enum.sh- Extension
.sh- Size
- 1807 bytes
- Lines
- 80
- 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
- No top-level syscall, struct, function, initcall, or export declaration detected by the generator.
Annotated Snippet
#!/bin/bash
# perf trace enum augmentation tests
# SPDX-License-Identifier: GPL-2.0
err=0
syscall="landlock_add_rule"
non_syscall="timer:hrtimer_start"
TESTPROG="perf test -w landlock"
# shellcheck source=lib/probe.sh
. "$(dirname $0)"/lib/probe.sh
skip_if_no_perf_trace || exit 2
[ "$(id -u)" = 0 ] || exit 2
check_vmlinux() {
echo "Checking if vmlinux exists"
if [ ! -f /sys/kernel/btf/vmlinux ]
then
echo "trace+enum test [Skipped missing vmlinux BTF support]"
err=2
fi
}
check_permissions() {
if perf trace -e $syscall $TESTPROG 2>&1 | grep -q "Operation not permitted"
then
echo "trace+enum test [Skipped permissions]"
err=2
fi
}
trace_landlock() {
echo "Tracing syscall ${syscall}"
# test flight just to see if landlock_add_rule is available
if ! perf trace $TESTPROG 2>&1 | grep -q landlock
then
echo "No landlock system call found, skipping to non-syscall tracing."
return
fi
output="$(perf trace -e $syscall $TESTPROG 2>&1)"
if echo "$output" | grep -q -E ".*landlock_add_rule\(ruleset_fd: 11, rule_type: (LANDLOCK_RULE_PATH_BENEATH|LANDLOCK_RULE_NET_PORT), rule_attr: 0x[a-f0-9]+, flags: 45\) = -1.*"
then
err=0
else
printf "[syscall failure] Failed to trace syscall $syscall, output:\n$output\n"
err=1
fi
}
trace_non_syscall() {
echo "Tracing non-syscall tracepoint ${non_syscall}"
output="$(perf trace -e $non_syscall --max-events=1 2>&1)"
if echo "$output" | grep -q -E '.*timer:hrtimer_.*\(.*mode: HRTIMER_MODE_.*\)$'
then
err=0
else
printf "[tracepoint failure] Failed to trace tracepoint $non_syscall, output:\n$output\n"
err=1
fi
}
check_vmlinux
if [ $err = 0 ]; then
check_permissions
fi
Annotation
- 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.