Skip to content

docs: document ptrace_scope requirement for shell hook registration#10

Merged
moukrea merged 2 commits intomainfrom
docs/ptrace-scope-requirement
Mar 27, 2026
Merged

docs: document ptrace_scope requirement for shell hook registration#10
moukrea merged 2 commits intomainfrom
docs/ptrace-scope-requirement

Conversation

@moukrea
Copy link
Copy Markdown
Owner

@moukrea moukrea commented Mar 27, 2026

Summary

  • Document kernel.yama.ptrace_scope=0 as a requirement for shell hook registration
  • Add fix instructions (temporary and permanent) to the Requirements section
  • Add troubleshooting hint in the shell hook section for discoverability

Ubuntu and some other distributions default to ptrace_scope=1, which silently prevents pidfd_getfd from adopting PTY sessions — causing snag list to always return empty after hook setup.

@moukrea moukrea merged commit a9f907c into main Mar 27, 2026
4 checks passed
@moukrea moukrea deleted the docs/ptrace-scope-requirement branch March 27, 2026 11:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant