tools/perf/tests/shell/amd-ibs-swfilt.sh
Source file repositories/reference/linux-study-clean/tools/perf/tests/shell/amd-ibs-swfilt.sh
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/tests/shell/amd-ibs-swfilt.sh- Extension
.sh- Size
- 2464 bytes
- Lines
- 93
- 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
# AMD IBS software filtering
ParanoidAndNotRoot() {
[ "$(id -u)" != 0 ] && [ "$(cat /proc/sys/kernel/perf_event_paranoid)" -gt $1 ]
}
echo "check availability of IBS swfilt"
# check if IBS PMU is available
if [ ! -d /sys/bus/event_source/devices/ibs_op ]; then
echo "[SKIP] IBS PMU does not exist"
exit 2
fi
# check if IBS PMU has swfilt format
if [ ! -f /sys/bus/event_source/devices/ibs_op/format/swfilt ]; then
echo "[SKIP] IBS PMU does not have swfilt"
exit 2
fi
echo "run perf record with modifier and swfilt"
err=0
# setting any modifiers should fail
perf record -B -e ibs_op//u -o /dev/null true 2> /dev/null
if [ $? -eq 0 ]; then
echo "[FAIL] IBS PMU should not accept exclude_kernel"
exit 1
fi
# setting it with swfilt should be fine
perf record -B -e ibs_op/swfilt/u -o /dev/null true
if [ $? -ne 0 ]; then
echo "[FAIL] IBS op PMU cannot handle swfilt for exclude_kernel"
exit 1
fi
if ! ParanoidAndNotRoot 1
then
# setting it with swfilt=1 should be fine
perf record -B -e ibs_op/swfilt=1/k -o /dev/null true
if [ $? -ne 0 ]; then
echo "[FAIL] IBS op PMU cannot handle swfilt for exclude_user"
exit 1
fi
else
echo "[SKIP] not root and perf_event_paranoid too high for exclude_user"
err=2
fi
# check ibs_fetch PMU as well
perf record -B -e ibs_fetch/swfilt/u -o /dev/null true
if [ $? -ne 0 ]; then
echo "[FAIL] IBS fetch PMU cannot handle swfilt for exclude_kernel"
exit 1
fi
# check system wide recording
if ! ParanoidAndNotRoot 0
then
perf record -aB --synth=no -e ibs_op/swfilt/k -o /dev/null true
if [ $? -ne 0 ]; then
echo "[FAIL] IBS op PMU cannot handle swfilt in system-wide mode"
exit 1
fi
else
echo "[SKIP] not root and perf_event_paranoid too high for system-wide/exclude_user"
err=2
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.