tools/perf/tests/shell/ftrace.sh
Source file repositories/reference/linux-study-clean/tools/perf/tests/shell/ftrace.sh
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/tests/shell/ftrace.sh- Extension
.sh- Size
- 2272 bytes
- Lines
- 87
- 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 ftrace tests
# SPDX-License-Identifier: GPL-2.0
set -e
# perf ftrace commands only works for root
if [ "$(id -u)" != 0 ]; then
echo "perf ftrace test [Skipped: no permission]"
exit 2
fi
output=$(mktemp /tmp/__perf_test.ftrace.XXXXXX)
cleanup() {
rm -f "${output}"
trap - EXIT TERM INT
}
trap_cleanup() {
cleanup
exit 1
}
trap trap_cleanup EXIT TERM INT
# this will be set in test_ftrace_trace()
target_function=
test_ftrace_list() {
echo "perf ftrace list test"
perf ftrace -F > "${output}"
# this will be used in test_ftrace_trace()
sleep_functions=$(grep 'sys_.*sleep$' "${output}")
echo "syscalls for sleep:"
echo "${sleep_functions}"
echo "perf ftrace list test [Success]"
}
test_ftrace_trace() {
echo "perf ftrace trace test"
perf ftrace trace --graph-opts depth=5 sleep 0.1 > "${output}"
# it should have some function name contains 'sleep'
grep "^#" "${output}"
grep -F 'sleep()' "${output}"
# find actual syscall function name
for FN in ${sleep_functions}; do
if grep -q "${FN}" "${output}"; then
target_function="${FN}"
echo "perf ftrace trace test [Success]"
return
fi
done
echo "perf ftrace trace test [Failure: sleep syscall not found]"
exit 1
}
test_ftrace_latency() {
echo "perf ftrace latency test"
echo "target function: ${target_function}"
perf ftrace latency -T "${target_function}" sleep 0.1 > "${output}"
grep "^#" "${output}"
grep "###" "${output}"
echo "perf ftrace latency test [Success]"
}
test_ftrace_profile() {
echo "perf ftrace profile test"
perf ftrace profile --graph-opts depth=5 sleep 0.1 > "${output}"
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.