Description
Running kernel tracing programs locally requires configuring custom volumes (e.g., /sys/kernel/debug), permissions (CAP_SYS_ADMIN), and mounting properties on target nodes. We want to publish a developer troubleshooting reference within our documentation directory showing how to quickly debug local setup blocks.
Proposed Scope
- Document diagnostic commands (e.g.
mount | grep bpffs, checking if /sys/kernel/debug is populated).
- Detail how to check if local container frameworks run on virtualization platforms (such as WS2/WSL systems or macOS Docker mounts) that require additional translation setups.
- Deliver a 3-step checklist showing how to identify if the local kernel meets the BTF requirements (
/sys/kernel/btf/vmlinux).
Expected Files to Modify
- Create
/sentinelml/docs/troubleshooting.md or extend README.md / CONTRIBUTING.md.
Verification Steps
- Ensure all markdown tables and commands render cleanly in standard viewer parsers.
Description
Running kernel tracing programs locally requires configuring custom volumes (e.g.,
/sys/kernel/debug), permissions (CAP_SYS_ADMIN), and mounting properties on target nodes. We want to publish a developer troubleshooting reference within our documentation directory showing how to quickly debug local setup blocks.Proposed Scope
mount | grep bpffs, checking if/sys/kernel/debugis populated)./sys/kernel/btf/vmlinux).Expected Files to Modify
/sentinelml/docs/troubleshooting.mdor extendREADME.md/CONTRIBUTING.md.Verification Steps