syscall verify performs read-only forensic verification of a recorded session. It checks internal consistency and evidence interpretability. It does not repair, migrate, rewrite, checkpoint, normalize, or complete missing evidence.
Run verification
What verification checks
Checks are bounded and use paged reads rather than loading an unbounded event table.
Unsupported or future schema versions produce an
unable_to_verify report with DB_SCHEMA_UNSUPPORTED when the version can be read safely. Verification does not query unknown structures or run migrations.
Assessment meanings
valid does not mean collection was complete, the kernel was trustworthy, or the database is authentic. It means the checks that could run found no contradictions.
Exit codes
Automation should use these codes, not scrape text.
Finding shape
Each finding has:- Stable
code. - Severity:
info,warning,error, orcritical. - Title and detail.
- Evidence context.
- Recommendation.
Activity finding codes
Additional lifecycle, accounting, schema, and scan findings are defined by the verification engine. Treat error and critical findings as contradictions, not as stylistic warnings.
Bounded reporting
Events are scanned in deterministic batches. Findings are bounded. If a limit is exceeded, the report marks truncation explicitly with findings such asFINDINGS_TRUNCATED. A truncated report is limited, not silently complete.
Verify an export
Export verification is a separate operation:0 when valid and 1 when invalid.
Legacy v1 packages with a manifest self-entry are reported as warnings. verify-export does not prove that the original database was authentic or untampered before export, and it is not a digital signature or chain of custody.
What verification cannot do
- Prove runtime correctness or that every event was captured.
- Recover missing events, provenance, or identity.
- Prove that the kernel or host was uncompromised.
- Provide adversarial tamper evidence.
- Prove that a file path resolved to the file ultimately accessed.
- Turn a connect attempt into an established session.