How withsecureopensource/chainsaw works
Chainsaw is a command-line Windows forensic triage tool. Investigators provide artefacts and detection rules, then search or hunt for matches and emit reports; separate analysis commands inspect event-log gaps, Shimcache timelines, and SRUM usage. The graph preserves those documented capabilities and the sampled reader, rule, search, and output layers. Some command implementations and integrations were not fully excerpted, so uncertain connections are omitted rather than inferred.
Main entry points: cli.rs CLI commands · file/mod.rs Artefact reader · hve/mod.rs Registry hive parser · rule/mod.rs Rule loading
Components 27
User workflow
- CLI commands
src/cli.rs - Result output
src/write.rs
Artefact ingestion
- Artefact reader
src/file/mod.rs - EVTX parser
src/file/evtx.rs - Registry hive parser
src/file/hve/mod.rs - Amcache parser
src/file/hve/amcache.rs - Shimcache parser
src/file/hve/shimcache.rs - SRUM parsers
src/file/hve/srum.rs - ESE database parser
src/file/esedb/mod.rs - MFT parser
src/file/mft.rs
Search and detection
- String and regex search
src/search.rs - Rule hunting
src/hunt.rs - Rule loading
src/rule/mod.rs - Sigma conversion
src/rule/sigma.rs - Chainsaw rules
src/rule/chainsaw.rs - TAU matching support
src/ext/tau.rs - Document values
src/value.rs
Forensic analysis
- EVTX analysis
src/analyse/evtx.rs - Event-log gaps
src/analyse/gaps.rs - Shimcache timeline
src/analyse/shimcache.rs - SRUM analysis
src/analyse/srum.rs - Reports
src/cli.rs
Other components
- Investigator
- Windows artefacts
- Detection rule files
rules - Sigma mappings
mappings - SRUM ESE database
Connections 34
- Investigator → CLI commands: runs commands
README.md - Windows artefacts → Artefact reader: provides files
src/file/mod.rs - CLI commands → Artefact reader: loads artefacts
src/cli.rs - Artefact reader → EVTX parser: dispatches EVTX
src/file/mod.rs - Artefact reader → Registry hive parser: dispatches hives
src/file/mod.rs - Artefact reader → MFT parser: dispatches MFT
src/file/mod.rs - Registry hive parser → Amcache parser: provides hive data
src/file/hve/mod.rs - Registry hive parser → Shimcache parser: provides hive data
src/file/hve/mod.rs - Registry hive parser → SRUM parsers: provides hive data
src/file/hve/mod.rs - CLI commands → String and regex search: starts search
src/cli.rs - CLI commands → Rule hunting: starts hunt
src/cli.rs - CLI commands → EVTX analysis: starts analysis
src/cli.rs - CLI commands → Event-log gaps: starts analysis
src/cli.rs - CLI commands → Shimcache timeline: starts analysis
src/cli.rs - CLI commands → SRUM analysis: starts analysis
src/cli.rs - Rule hunting → Rule loading: loads rules
src/hunt.rs - Rule loading → Sigma conversion: converts Sigma
src/rule/mod.rs - Rule loading → Chainsaw rules: loads custom rules
src/rule/mod.rs - Rule loading → TAU matching support: uses matching support
src/rule/mod.rs - Rule hunting → Artefact reader: reads documents
src/hunt.rs - String and regex search → Artefact reader: reads documents
src/search.rs - Rule hunting → Document values: matches documents
src/hunt.rs - String and regex search → Document values: matches documents
- Detection rule files → Rule loading: supplies rules
README.md - Sigma mappings → Sigma conversion: supplies mappings
README.md - EVTX analysis → EVTX parser: analyses logs
src/analyse/evtx.rs - Event-log gaps → EVTX parser: checks log gaps
src/analyse/gaps.rs - Shimcache timeline → Registry hive parser: reads hive data
src/analyse/shimcache.rs - Shimcache timeline → Amcache parser: enriches timeline
- SRUM analysis → SRUM parsers: analyses SRUM
src/analyse/srum.rs - SRUM analysis → ESE database parser: reads tables
src/analyse/srum.rs - SRUM ESE database → ESE database parser: contains records
README.md - CLI commands → Result output: formats results
src/cli.rs - Result output → Reports: emits reports
README.md