Skip to content

docs: surface command mode as a core feature + soften Falco loader claim#66

Merged
ErenAri merged 1 commit into
mainfrom
docs/command-mode-visibility-and-claim-fix
Jun 29, 2026
Merged

docs: surface command mode as a core feature + soften Falco loader claim#66
ErenAri merged 1 commit into
mainfrom
docs/command-mode-visibility-and-claim-fix

Conversation

@ErenAri

@ErenAri ErenAri commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #65 — fixes how the work reads, not the code.

1. Command mode wasn't surfaced as a core feature

The README "Implemented:" list led with .bpf.o validation and never mentioned
bpfcompat test --command, so the binary/loader-path capability (which #65
actually shipped) read as missing. Added explicit bullets making clear:

  • command mode takes your loader's exit code as the verdict;
  • the bundled C/libbpf validator is not used — it tests the real userspace
    loader path (distinct from behavior mode, which layers a smoke command on top
    of a validator load);
  • plus the known-tricky kernel library.

2. Softened an overclaim

"validates Falco's modern_bpf probe exactly as Falco's own loader runs it"

bpfcompat mirrors libpman's loader contract (runtime-sized maps, helper-gated
program variants, trial-probed iterators declared in a manifest) — it does not run
Falco's loader binary. Reworded in the README and the Falco case study, and point
at command mode as the way to run that exact binary.

Docs-only.

🤖 Generated with Claude Code

Two fixes prompted by review of how the work reads (not the code):

- The "Implemented:" list never mentioned command/binary validation, so the
  capability shipped in #65 read as not-a-core-feature. Add explicit bullets for
  `--command` mode (verdict = your loader's exit code; the bundled validator is
  NOT used — tests the real userspace loader path) and the known-tricky kernel
  library.
- Soften the overclaim "validates Falco's modern_bpf probe exactly as Falco's
  own loader runs it." bpfcompat mirrors libpman's loader contract (runtime-sized
  maps, helper-gated program variants, trial-probed iterators via a manifest); it
  does not run Falco's loader binary. Reworded in README and the Falco case study,
  pointing at command mode as the way to run that exact binary.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ErenAri ErenAri merged commit c790219 into main Jun 29, 2026
7 checks passed
@ErenAri ErenAri deleted the docs/command-mode-visibility-and-claim-fix branch June 29, 2026 19:33
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